@dougbots/avenor-mcp 0.4.1 → 0.5.0

package/README.md

@@ -86,7 +86,7 @@ SSE mode restricts incoming requests to `localhost` / `127.0.0.1` / `[::1]` orig
 
 ## Tools
 
-All six tools register under the `avenor_` prefix to avoid collisions with other MCP servers.
+All seven tools register under the `avenor_` prefix to avoid collisions with other MCP servers.
 
 ### `avenor_spawn`
 
@@ -109,15 +109,29 @@ Returns `{ run_id, label, supervisor_id }`. The `run_id` is what you pass to the
 
 ### `avenor_status`
 
-Get the status of one run, or list all runs.
+Get the status of one run, or list all runs. Use the compact `lifecycle` view for progress and pending permission checks; `full` remains the compatibility default.
 
 | Parameter | Required | Description |
 |---|---|---|
 | `run_id` | no | Run ID or label to query. Omit to list all runs. |
+| `view` | no | Response detail: `lifecycle` or `full` (default) |
 | `supervisor_id` | no | Supervisor ID for multi-supervisor setups |
 
 Returns a status object (or array) with `status` being one of `running`, `done`, `failed`, `timeout`, or `killed`. When a run is blocked on a permission request, the response includes a `pending_permission` field with the available options.
 
+### `avenor_result`
+
+Wait for a run to finish and return its bounded final output without transcript or event details.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `run_id` | yes | Run ID or label to await |
+| `wait` | no | Wait for a terminal result (default `true`) |
+| `timeout` | no | Maximum time to wait (for example `30s` or `5m`) |
+| `supervisor_id` | no | Supervisor ID for multi-supervisor setups |
+
+Terminal responses include `ready: true` and `output` when the backend exposed one. A pending permission returns immediately. If the result wait itself expires, the response has `ready: false` and `timed_out: true` without changing the run.
+
 ### `avenor_answer_permission`
 
 Respond to a permission prompt that paused a run.
@@ -171,11 +185,12 @@ Returns `{ ok: true, cleaned_up: [...] }`. Use this when you're done with avenor
 ## Typical workflow
 
 1. **Spawn a run:** `avenor_spawn(agent: "codex", repo_dir: "/path/to/project", prompt: "audit the API routes for auth gaps")`
-2. **Check status:** `avenor_status(run_id: "<id>")` — repeat until status is `done` or an action is needed.
-3. **If permission requested:** run `avenor_answer_permission` with the option you want.
-4. **After completion:** `avenor_events(run_id: "<id>")` to see what happened.
-5. **Optional follow-up:** `avenor_follow_up(run_id: "<id>", message: "now write tests for that")`
-6. **Clean up:** `avenor_shutdown()` when you're finished.
+2. **Check lifecycle when needed:** `avenor_status(run_id: "<id>", view: "lifecycle")` for progress or pending permissions.
+3. **If permission requested:** run `avenor_answer_permission` with the offered option.
+4. **Retrieve the result:** `avenor_result(run_id: "<id>")` waits and returns the bounded final output.
+5. **Inspect history when needed:** `avenor_events(run_id: "<id>")` returns raw recent events.
+6. **Optional follow-up:** `avenor_follow_up(run_id: "<id>", message: "now write tests for that")`
+7. **Clean up:** `avenor_shutdown()` when you're finished.
 
 ## Package structure
 

package/dist/index.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { Hono } from "hono";
 import { z } from "zod";
-import { answerPermissionTool, eventsTool, followUpTool, shutdownTool, spawnTool, statusTool } from "@dougbots/avenor-core";
+import { answerPermissionTool, eventsTool, followUpTool, resultTool, shutdownTool, spawnTool, statusTool } from "@dougbots/avenor-core";
 //#region src/mcp.ts
 const LOCALHOST_ORIGINS = new Set([
 	"localhost",
@@ -74,15 +74,33 @@ server.registerTool("avenor_spawn", {
 	});
 });
 server.registerTool("avenor_status", {
-	description: "Get status of one or all runs",
+	description: "Get lifecycle status of one or all runs. Use lifecycle view for compact polling.",
 	inputSchema: {
 		run_id: z.string().optional().describe("Run ID or label to query"),
+		view: z.enum(["lifecycle", "full"]).optional().describe("Response detail (default full for compatibility)"),
 		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
 	}
-}, async ({ run_id, supervisor_id }) => {
+}, async ({ run_id, view, supervisor_id }) => {
 	return statusTool({
 		runId: run_id,
-		supervisorId: supervisor_id
+		supervisorId: supervisor_id,
+		view
+	});
+});
+server.registerTool("avenor_result", {
+	description: "Wait for a run to finish and return its bounded final output without event details",
+	inputSchema: {
+		run_id: z.string().describe("Run ID or label to await"),
+		wait: z.boolean().optional().describe("Wait for a terminal result (default true)"),
+		timeout: z.string().optional().describe("Maximum time to wait (e.g. 30s, 5m)"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async ({ run_id, wait, timeout, supervisor_id }) => {
+	return resultTool({
+		runId: run_id,
+		supervisorId: supervisor_id,
+		wait,
+		timeout
 	});
 });
 server.registerTool("avenor_answer_permission", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dougbots/avenor-mcp",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -30,7 +30,7 @@
     "dev": "tsdown --watch"
   },
   "dependencies": {
-    "@dougbots/avenor-core": "^0.4.1",
+    "@dougbots/avenor-core": "^0.5.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "hono": "^4.12.19",
     "zod": "^4.4.3"