@dougbots/avenor-pi 0.15.0 → 0.16.1

package/README.md

@@ -112,13 +112,17 @@ Available tools for LLM sub-agent management:
 
 | Tool | Description |
 |---|---|
-| `avenor_spawn` | Dispatch an agent run (blocking or fire-and-forget). Uses the `pi` backend by default in direct mode; accepts optional `agent`, `model`, `prompt`, `dir`, `roster_file`, and `roster_entry`. |
+| `avenor_spawn` | Dispatch an agent run (blocking or fire-and-forget). Uses the `pi` backend by default in direct mode; accepts optional `agent`, `model`, `prompt`, `dir`, `roster_file`, and `roster_entry`. In host mode, spawns to this process's singleton supervisor (the default) receive a parent broker note for `avenor_message`. Non-local and nested spawns need an address supplied in the brief; their asks are not forwarded to the parent. |
 | `avenor_status` | Get status of a run or all runs; use `view="lifecycle"` for compact progress and permission checks |
 | `avenor_result` | Wait for a run and return its complete final output without transcript details |
 | `avenor_inspect` | Review a bounded transcript, tool activity, permissions, and final output |
 | `avenor_answer_permission` | Answer a pending permission request |
-| `avenor_follow_up` | Resume a completed run with a follow-up message |
+| `avenor_message` | One messaging tool with an explicit `action`: `tell`, `ask`, `reply`, `resume`, `withdraw` or `control_reply`. Every result states the outcome and, for a failed ask, whether it can still be withdrawn. |
+| `avenor_peers` | One peers tool with an explicit `action`: `list` (the default), `rename` or `last`. `last` returns the target's last agent message with its stop reason, or the empty result when the target has no completed turn yet. |
 | `avenor_events` | Read events from a run |
+| `avenor_kill` | Kill a run |
+| `avenor_workflow_status`, `avenor_workflow_wait`, `avenor_workflow_inspect`, `avenor_workflow_events`, `avenor_workflow_complete`, `avenor_workflow_gate`, `avenor_workflow_controller_status` | Inspect and drive workflow instances |
+| `avenor_workflow_cancel` | Cancel a workflow instance (`workflow_id`, `actor`, `reason`) |
 | `avenor_shutdown` | Shut down the avenor supervisor |
 
 ### Direct and roster spawns
@@ -194,7 +198,7 @@ is not an `avenor_spawn` parameter and applies only to Pi-backed child runs.
 2. tool call returns       →  completion preview with status + session_id
 3. avenor_result           →  retrieve the complete final output when needed
 4. avenor_inspect          →  inspect transcript and tool details when needed
-5. avenor_follow_up        →  optionally iterate
+5. avenor_message           →  action "resume" to optionally iterate
 6. avenor_shutdown         →  clean up when finished
 ```
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { InspectResult, StatusResult, Supervisor, answerPermissionTool, attachOwner, brokerReceiveTool, brokerReplyTool, dial, eventsTool, followUpTool, inspectTool, killTool, observeRun, resultTool, shutdownTool, spawnTool, statusTool, workflowCompleteTool, workflowControllerStatusTool, workflowEventsTool, workflowGateTool, workflowInspectTool, workflowReadyTool, workflowStatusTool, workflowWaitTool } from "@dougbots/avenor-core";
+import { InspectResult, MessageProvider, StatusResult, Supervisor, answerPermissionTool, attachOwner, brokerReceiveTool, dial, eventsTool, getSupervisorClient, inspectTool, killTool, messageTool, observeRun, resultTool, shutdownTool, spawnTool, statusTool, workflowCancelTool, workflowCompleteTool, workflowControllerStatusTool, workflowEventsTool, workflowGateTool, workflowInspectTool, workflowReadyTool, workflowStatusTool, workflowWaitTool } from "@dougbots/avenor-core";
 import { EventBus, ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 //#region src/subagent-broker.d.ts
@@ -122,11 +122,10 @@ interface ExtensionDeps {
   statusTool: typeof statusTool;
   eventsTool: typeof eventsTool;
   answerPermissionTool: typeof answerPermissionTool;
-  followUpTool: typeof followUpTool;
+  messageTool: typeof messageTool;
   inspectTool: typeof inspectTool;
   resultTool: typeof resultTool;
   brokerReceiveTool: typeof brokerReceiveTool;
-  brokerReplyTool: typeof brokerReplyTool;
   shutdownTool: typeof shutdownTool;
   killTool: typeof killTool;
   workflowStatusTool: typeof workflowStatusTool;
@@ -137,6 +136,11 @@ interface ExtensionDeps {
   workflowGateTool: typeof workflowGateTool;
   workflowControllerStatusTool: typeof workflowControllerStatusTool;
   workflowReadyTool: typeof workflowReadyTool;
+  workflowCancelTool: typeof workflowCancelTool;
+  /** Resolve the bound provider for one supervisor, creating it on demand. */
+  hostProviderFor?: (supervisorId: string | undefined) => Promise<MessageProvider>;
+  /** Dial a supervisor for the default host provider; tests inject a fake client. */
+  getSupervisorClient?: typeof getSupervisorClient;
   observeRun: typeof observeRun;
   dial: typeof dial;
   attachOwner: typeof attachOwner;