@dougbots/avenor-pi 0.10.4 → 0.11.0

package/dist/index.js

@@ -2077,12 +2077,14 @@ function createExtension(deps = defaultDeps, options = {}) {
 			promptSnippet: "Dispatch sub-agent runs via avenor (spawn, status, result, inspect, events, follow-up, shutdown)",
 			promptGuidelines: [
 				"Use avenor_spawn to delegate well-defined tasks to sub-agents.",
-				"Use avenor_status with view \"lifecycle\" only to check progress or pending permissions.",
-				"Use avenor_result to wait for and retrieve a sub-agent final result.",
+				"Use avenor_status (view \"lifecycle\") only to check progress or pending permissions.",
+				"Use avenor_result to retrieve the final result of a sub-agent; it waits by default, but set wait=false for runs that already completed.",
 				"Use avenor_inspect to review a bounded transcript and tool activity from a run.",
-				"Use avenor_events only when raw event payloads are specifically needed.",
+				"Use avenor_events only when you specifically need raw event payloads.",
 				"Use avenor_follow_up to iterate on a completed run.",
-				"Use avenor_shutdown when done delegating work."
+				"Use avenor_shutdown when done delegating work.",
+				"When roster_entry is set, the roster selects agent, model, and backend; do not pass those fields alongside it.",
+				"If a roster spawn fails validation or resolution, do not retry the roster: respawn without roster_file/roster_entry. Direct selectors (agent, model, backend) are optional; omission uses runtime defaults."
 			],
 			parameters: Type.Object({
 				agent: Type.Optional(Type.String({ description: "Optional agent name; omission uses the supplied model or runtime defaults" })),
@@ -2103,7 +2105,7 @@ function createExtension(deps = defaultDeps, options = {}) {
 				], { description: "Thinking level; omission uses the backend default" })),
 				backend: Type.Optional(Type.String({ description: "Backend override (defaults to pi for direct mode)" })),
 				roster_file: Type.Optional(Type.String({ description: "Path to the roster map" })),
-				roster_entry: Type.Optional(Type.String({ description: "Roster entry to select" })),
+				roster_entry: Type.Optional(Type.String({ description: "Roster entry to select. Requires roster_file unless a roster context is configured; disables agent, model, and backend" })),
 				server_url: Type.Optional(Type.String({ description: "Backend server URL" })),
 				supervisor_id: Type.Optional(Type.String({ description: "Reuse an existing supervisor by socket path" })),
 				wait: Type.Optional(Type.Boolean({ description: "Block until complete (default true)" }))
@@ -2331,10 +2333,10 @@ function createExtension(deps = defaultDeps, options = {}) {
 		pi.registerTool({
 			name: "avenor_result",
 			label: "Avenor Result",
-			description: "Wait for a run to finish and return its complete final output without transcript or event details.",
+			description: "Retrieve the complete final output of a run without transcript or event details. Waits by default; set wait=false to retrieve an already-completed run without blocking.",
 			parameters: Type.Object({
-				run_id: Type.String({ description: "Run ID to await" }),
-				wait: Type.Optional(Type.Boolean({ description: "Wait for a terminal result (default true)" })),
+				run_id: Type.String({ description: "Run ID or label" }),
+				wait: Type.Optional(Type.Boolean({ description: "Wait for a terminal result (default true); false retrieves the current state without blocking" })),
 				timeout: Type.Optional(Type.String({ description: "Maximum time to wait (e.g. 30s, 5m)" })),
 				supervisor_id: Type.Optional(Type.String({ description: "Reuse an existing supervisor by socket path" }))
 			}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dougbots/avenor-pi",
-  "version": "0.10.4",
+  "version": "0.11.0",
   "type": "module",
   "keywords": [
     "pi-package"
@@ -35,7 +35,7 @@
     "dev": "tsdown --watch"
   },
   "dependencies": {
-    "@dougbots/avenor-core": "^0.10.4"
+    "@dougbots/avenor-core": "^0.11.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.74.0",