@dougbots/avenor-mcp 0.9.0 → 0.10.0

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 { answerPermissionTool, eventsTool, followUpTool, resultTool, shutdownTool, spawnTool, statusTool, validateSpawnSelection } 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"),
@@ -24,6 +24,8 @@ const spawnInputShape = {
 		"max"
 	]).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 +73,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 +91,8 @@ server.registerTool("avenor_spawn", {
 		model,
 		thinking,
 		backend,
+		rosterFile: roster_file,
+		rosterEntry: roster_entry,
 		serverUrl: server_url,
 		supervisorId: supervisor_id
 	});

package/package.json

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