Switch the lamp to a session state
set_stateSwitches host LEDs to a defined AI session state—idle, thinking, working, waiting, done, error, or off—so OpenRGB lighting shows the current conversation status.
Instructions
Switch the host LEDs to a conversation state.
state: idle | thinking | working | waiting | done | error | off (aliases such as complete/failed/ask are accepted). All animations are slow, continuous fades - the lamp never strobes. thinking = blue breathing, working = cyan breathing, waiting = amber fade, done = solid green, error = red fade, idle = dim blue breathing, off = lights out. detail is a short note kept in the status output. animate: set to false to freeze the effect.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"state": "<state>"
},
"name": "set_state"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | ||
| detail | No | ||
| animate | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | Yes | ||
| port | Yes | ||
| quota | No | (remaining, total) | |
| ratio | No | ||
| state | Yes | ||
| total | No | ||
| zones | No | ||
| agents | No | all agents currently sharing the lamp | |
| detail | Yes | ||
| device | Yes | ||
| animate | Yes | ||
| control | No | 'global' = the whole strip is controlled as one unit, 'per_led' = every LED is written individually | global |
| percent | No | ||
| agent_id | No | id of this agent in the shared registry | |
| progress | No | 0..1 | |
| restored | No | ||
| led_count | Yes | ||
| remaining | No | ||
| brightness | Yes | ||
| last_error | Yes | ||
| active_mode | Yes | ||
| filled_leds | No | ||
| render_mode | No | 'hardware' = the controller animates on its own, 'per_led' = colours are written LED by LED | per_led |
| state_age_s | Yes | ||
| custom_color | Yes | ||
| display_state | No | state currently shown on the lamp (highest priority of all agents) | idle |
| protocol_version | Yes | ||
| animation_running | Yes |