@dougbots/avenor-mcp 0.9.0 → 0.10.1

package/README.md

@@ -94,19 +94,37 @@ Start a new agent run.
 
 | Parameter | Required | Description |
 |---|---|---|
-| `agent` | yes | Agent to invoke: `codex`, `claude`, `gemini`, `butler` |
+| `agent` | no | Agent to invoke; omission uses the supplied model or runtime defaults |
 | `repo_dir` | yes | Working directory for the agent |
 | `prompt` | no | Prompt text (mutually exclusive with `prompt_file`) |
 | `prompt_file` | no | Path to a prompt file |
 | `label` | no | Human-readable label for this run |
 | `timeout` | no | Duration string (`5m`, `1h`, `90s`) |
 | `model` | no | Model override for the agent |
+| `thinking` | no | Run-level reasoning control; unsupported effective backends reject explicit values |
 | `backend` | no | Backend override (`opencode-http`, `opencode-acp`, `codex-app-server`, `agy`) |
+| `roster_file` | no | Path to a top-level roster map |
+| `roster_entry` | no | Key within `roster_file`; selects the complete backend/agent/model identity |
 | `server_url` | no | Backend server URL, required by `opencode-http` unless configured by environment |
 | `supervisor_id` | no | Supervisor ID for multi-supervisor setups |
 
 Returns `{ run_id, label, supervisor_id }`. The `run_id` is what you pass to the other tools.
 
+#### Direct and roster modes
+
+Use both `roster_file` and `roster_entry` for roster mode. A roster entry requires `backend` plus at least one of `agent` or `model`, and cannot be mixed with direct `agent`, `model`, or `backend` fields. Direct mode permits all three identity fields to be omitted independently, including a backend-only request; omitted values use runtime defaults.
+
+```json
+{
+  "repo_dir": "/repo",
+  "prompt": "Analyze the repository",
+  "roster_file": "/repo/roster.json",
+  "roster_entry": "planner"
+}
+```
+
+The roster map is strict and currently supports only `backend`, `agent`, and `model` in each entry. `system` and `thinking` are not roster fields. The `thinking` argument remains run-level and is validated against the effective backend chosen by the direct request or roster entry. A resumed session cannot switch to a different backend.
+
 ### `avenor_status`
 
 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.

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, resultTool, shutdownTool, spawnTool, statusTool } from "@dougbots/avenor-core";
+import { THINKING_LEVELS, answerPermissionTool, eventsTool, followUpTool, resultTool, shutdownTool, spawnTool, statusTool, validateSpawnSelection, workflowCompleteTool, workflowEventsTool, workflowGateTool, workflowInspectTool, workflowStatusTool, workflowWaitTool } from "@dougbots/avenor-core";
 //#region src/spawn-schema.ts
 const spawnInputShape = {
 	agent: z.string().optional().describe("Optional agent name; omission uses the supplied model or runtime defaults"),
@@ -14,16 +14,10 @@ const spawnInputShape = {
 	label: z.string().optional().describe("Human-readable label for this run"),
 	timeout: z.string().optional().describe("Timeout duration (e.g. 5m, 1h)"),
 	model: z.string().optional().describe("Model override"),
-	thinking: z.enum([
-		"off",
-		"minimal",
-		"low",
-		"medium",
-		"high",
-		"xhigh",
-		"max"
-	]).optional().describe("Thinking level; omission uses the backend default and unsupported backends reject explicit values"),
+	thinking: z.enum(THINKING_LEVELS).optional().describe("Thinking level; omission uses the backend default and unsupported backends reject explicit values"),
 	backend: z.string().optional().describe("Backend override"),
+	roster_file: z.string().optional().describe("Path to the roster map"),
+	roster_entry: z.string().optional().describe("Roster entry to select"),
 	server_url: z.string().optional().describe("Backend server URL"),
 	supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
 };
@@ -71,7 +65,14 @@ const server = new McpServer({
 server.registerTool("avenor_spawn", {
 	description: "Spawn a new agent run with an optional canonical thinking level; unsupported backends reject explicit values",
 	inputSchema: spawnInputShape
-}, async ({ repo_dir, agent, prompt, prompt_file, label, timeout, model, thinking, backend, server_url, supervisor_id }) => {
+}, async ({ repo_dir, agent, prompt, prompt_file, label, timeout, model, thinking, backend, roster_file, roster_entry, server_url, supervisor_id }) => {
+	validateSpawnSelection({
+		agent,
+		model,
+		backend,
+		roster_file,
+		roster_entry
+	});
 	return spawnTool({
 		agent,
 		dir: repo_dir,
@@ -82,6 +83,8 @@ server.registerTool("avenor_spawn", {
 		model,
 		thinking,
 		backend,
+		rosterFile: roster_file,
+		rosterEntry: roster_entry,
 		serverUrl: server_url,
 		supervisorId: supervisor_id
 	});
@@ -178,6 +181,113 @@ server.registerTool("avenor_shutdown", {
 		force
 	});
 });
+server.registerTool("avenor_workflow_status", {
+	description: "Get lightweight status for a workflow instance",
+	inputSchema: {
+		workflow_id: z.string().describe("Workflow ID"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async ({ workflow_id, supervisor_id }) => {
+	return workflowStatusTool({
+		workflowId: workflow_id,
+		supervisorId: supervisor_id
+	});
+});
+server.registerTool("avenor_workflow_wait", {
+	description: "Wait for a workflow to reach a terminal state or until timeout",
+	inputSchema: {
+		workflow_id: z.string().describe("Workflow ID"),
+		timeout: z.string().optional().describe("Timeout (e.g. 30s, 5m)"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async ({ workflow_id, timeout, supervisor_id }) => {
+	return workflowWaitTool({
+		workflowId: workflow_id,
+		timeout,
+		supervisorId: supervisor_id
+	});
+});
+server.registerTool("avenor_workflow_inspect", {
+	description: "Return the full instance detail for a workflow",
+	inputSchema: {
+		workflow_id: z.string().describe("Workflow ID"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async ({ workflow_id, supervisor_id }) => {
+	return workflowInspectTool({
+		workflowId: workflow_id,
+		supervisorId: supervisor_id
+	});
+});
+server.registerTool("avenor_workflow_events", {
+	description: "Read log events from a workflow instance's event log",
+	inputSchema: {
+		workflow_id: z.string().describe("Workflow ID"),
+		after_seq: z.number().optional().describe("Only include events after this sequence number"),
+		limit: z.number().optional().describe("Max events to return (default 50)"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async ({ workflow_id, after_seq, limit, supervisor_id }) => {
+	return workflowEventsTool({
+		workflowId: workflow_id,
+		afterSeq: after_seq,
+		limit,
+		supervisorId: supervisor_id
+	});
+});
+server.registerTool("avenor_workflow_complete", {
+	description: "Atomically complete a machine/external handoff activation",
+	inputSchema: {
+		workflow_id: z.string().describe("Workflow ID"),
+		node_id: z.string().describe("Node ID"),
+		activation_id: z.string().describe("Activation ID"),
+		attempt_id: z.string().describe("Attempt ID"),
+		lease_id: z.string().describe("Lease ID"),
+		owner_token: z.string().describe("Owner token"),
+		outcome: z.string().describe("Outcome"),
+		outputs: z.unknown().optional().describe("Outputs"),
+		artifacts: z.unknown().optional().describe("Artifacts"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async (args) => {
+	const { supervisor_id, ...rest } = args;
+	return workflowCompleteTool({
+		...rest,
+		supervisorId: supervisor_id
+	});
+});
+server.registerTool("avenor_workflow_gate", {
+	description: "Record a gate decision on a parked awaiting_gate activation",
+	inputSchema: {
+		workflow_id: z.string().describe("Workflow ID"),
+		node_id: z.string().describe("Node ID"),
+		gate_id: z.string().describe("Gate ID"),
+		activation_id: z.string().describe("Activation ID"),
+		operation: z.enum([
+			"satisfy",
+			"reject",
+			"waive",
+			"external_result"
+		]).describe("Gate operation"),
+		actor: z.string().optional().describe("Actor"),
+		reason: z.string().optional().describe("Reason"),
+		outcome: z.string().optional().describe("Outcome"),
+		subject: z.unknown().optional().describe("Subject"),
+		poll_id: z.string().optional().describe("Poll ID"),
+		source: z.string().optional().describe("Source"),
+		result: z.string().optional().describe("Result"),
+		response_hash: z.string().optional().describe("Response hash"),
+		observed_at: z.string().optional().describe("Observed at"),
+		evidence_ids: z.array(z.string()).optional().describe("Evidence IDs"),
+		supervisor_id: z.string().optional().describe("Supervisor ID for multi-supervisor mode")
+	}
+}, async (args) => {
+	const { supervisor_id, ...rest } = args;
+	return workflowGateTool({
+		...rest,
+		supervisorId: supervisor_id
+	});
+});
 if (import.meta.main) if (process.env.MCP_TRANSPORT !== "sse") {
 	const transport = new StdioServerTransport();
 	await server.connect(transport);

package/package.json

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