Explain actor protocol
explain_actor_protocolDescribe an actor's protocol: message constructors, state type, init params, and per-handler effect rows. Use it to learn how to talk to an actor or what each handler may do.
Instructions
Describe one actor's protocol: its message type and constructors, state type, init parameters and effects, per-handler effect rows, and the declared effect summary. Use it to learn how to talk to an actor or what each handler may do; use emit_actor_effect_graph for the actors, supervisors, and tools it reaches transitively, and lookup_definition if you only need its location. Returns actor with name, line, state, message (name, constructors), init (params, effects), handlers (message, effects), and effects; types and rows carry a display string. actor_name resolves like any symbol: a local actor, a selectively imported one, or Qualifier.name through a use; module and file name the defining module. Read-only: compiles the file's directory in memory (cached until a sibling changes) and writes or executes nothing. Failures are isError results with a stable error.code: file_not_found, read_error, invalid_params, and, for every tool but check_file, parse_error or check_error carrying coded diagnostics in error.data.diagnostics (the shape check_file returns).
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": {
"actor_name": "<actor_name>",
"file": "<file>"
},
"name": "explain_actor_protocol"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Path to a .hird source file, absolute or relative to the server's working directory. Every .hird file in its directory is compiled with it as one program, so imported names resolve; answers may name a sibling file. | |
| actor_name | Yes | The actor's name, as the file would write it (`Planner`, `Fleet.Planner`): a local actor, or a sibling module's as `Qualifier.name` through `use Mod` (or `Module.name` for any module of the program). An unknown name fails with `not_found` and `error.data.available_actors`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | ||
| actor | Yes | ||
| module | Yes |