cap_router_mgr
Source: cap_router_mgr.c components/claw_capabilities/cap_router_mgr/src/cap_router_mgr.c · header: cap_router_mgr.h components/claw_capabilities/cap_router_mgr/include/cap_router_mgr.h · Skill: SKILL.md components/claw_capabilities/cap_router_mgr/skills/cap_router_mgr/SKILL.md
Overview
Section titled “Overview”cap_router_mgr exposes a set of tools to the LLM, allowing the Agent to dynamically add, query, update, and delete Event Router automation rules at runtime. Combined with the rule format described in Dataflow and automation, the LLM can create complex event-driven automation from user instructions.
Tool description
Section titled “Tool description”| Tool ID | Description |
|---|---|
list_router_rules |
List all automation rules as a JSON array |
get_router_rule |
Get one rule by ID |
add_router_rule |
Add a new automation rule |
update_router_rule |
Update an existing automation rule |
delete_router_rule |
Delete one rule by ID |
reload_router_rules |
Reload all rules from disk |
Tool parameters
Section titled “Tool parameters”list_router_rules
Section titled “list_router_rules”No parameters. Returns all rules as a JSON array.
get_router_rule
Section titled “get_router_rule”| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | Rule ID |
add_router_rule
Section titled “add_router_rule”| Parameter | Type | Required | Description |
|---|---|---|---|
rule_json |
string | Yes | Complete rule JSON string |
update_router_rule
Section titled “update_router_rule”| Parameter | Type | Required | Description |
|---|---|---|---|
rule_json |
string | Yes | Complete rule JSON string containing an id field |
delete_router_rule
Section titled “delete_router_rule”| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | ID of the rule to delete |
reload_router_rules
Section titled “reload_router_rules”No parameters. Reloads all rules from the disk file.
Error handling
Section titled “Error handling”All tools return JSON-formatted results:
- Success:
{"ok": true, ...} - Failure:
{"ok": false, "error": "...", "code": "ESP_ERR_*"}
Common errors:
add_router_rulereturnsESP_ERR_INVALID_STATEwhen the ID already exists- Reaching the rule count limit returns
ESP_ERR_INVALID_SIZE - Invalid parameter format returns
ESP_ERR_INVALID_ARG
Group information
Section titled “Group information”| Property | Value |
|---|---|
| Group ID | cap_router_mgr |
| Default LLM-visible | Yes (edge_agent default initial visible group) |
| Tool count | 6 |