@zhixuan92/multi-model-agent-mcp 0.1.3 → 0.2.0

package/README.md

@@ -54,22 +54,24 @@ Provider auth:
 
 ### Claude Code
 
-One command — the client will spawn the server on demand:
+One command — the client will spawn the server on demand. Use `-s user` so the server is available in **every** project on your machine, not just the directory where you ran the command:
 
 ```bash
-claude mcp add multi-model-agent -- npx -y @zhixuan92/multi-model-agent-mcp serve
+claude mcp add multi-model-agent -s user -- npx -y @zhixuan92/multi-model-agent-mcp serve
 ```
 
 If your providers need environment variables:
 
 ```bash
-claude mcp add multi-model-agent \
+claude mcp add multi-model-agent -s user \
   -e OPENAI_API_KEY=sk-... \
   -e ANTHROPIC_API_KEY=sk-ant-... \
   -e MINIMAX_API_KEY=... \
   -- npx -y @zhixuan92/multi-model-agent-mcp serve
 ```
 
+Without `-s user`, `claude mcp add` defaults to local scope and only registers the server in the current project.
+
 ### Claude Desktop
 
 Add to `claude_desktop_config.json`:
@@ -92,6 +94,20 @@ Add to `claude_desktop_config.json`:
 
 Restart your MCP client after changing config.
 
+## Recommended: delegation rule for Claude Code
+
+Claude Code's native `Task` / `Agent` subagents inherit your parent session's expensive model and eat its context window. We ship a drop-in rule file that teaches Claude Code **when** to delegate work through `delegate_tasks` instead — mechanical edits go to free providers, reasoning-tier work escalates only when needed, and independent tasks run in parallel.
+
+Install globally:
+
+```bash
+mkdir -p ~/.claude/rules
+curl -o ~/.claude/rules/multi-model-delegation.md \
+  https://raw.githubusercontent.com/zhixuan312/multi-model-agent/HEAD/docs/claude-code-delegation-rule.md
+```
+
+Restart Claude Code after installing. The full rule — judgment-vs-labor principle, decision procedure, provider routing table, dispatch shape, verification, escalation ladder — lives at [`docs/claude-code-delegation-rule.md`](https://github.com/zhixuan312/multi-model-agent/blob/HEAD/docs/claude-code-delegation-rule.md). Read that file before adapting it to your own provider names.
+
 ## The `delegate_tasks` tool
 
 Accepts an array of tasks and runs them concurrently. Auto-routes each task by capability filter → quality tier filter → cheapest remaining provider, or pin a task to a specific provider.
@@ -124,8 +140,20 @@ Capabilities: `file_read`, `file_write`, `grep`, `glob`, `shell`, `web_search`,
 
 ## Security
 
-- File tools enforce a `cwd-only` sandbox by default — paths are resolved via `fs.realpath` and rejected if outside the task's `cwd`.
-- `runShell` is hard-disabled under `cwd-only`. Set `sandboxPolicy: 'none'` per-provider or per-task to opt in.
+### Sandbox enforcement
+
+The default `sandboxPolicy: "cwd-only"` confines delegated sub-agents to the task's working directory. The check runs inside every file-tool call in the core `assertWithinCwd` helper — violations are surfaced to the model as normal tool errors, so the model can retry with a valid path rather than silently failing.
+
+1. **File reads** are allowed only inside `cwd` and its descendants. Path traversal (`../`, absolute paths outside `cwd`) is rejected.
+2. **File writes** are subject to the same restriction.
+3. **Symlink resolution uses `fs.realpath`.** A symlink inside `cwd` that points outside `cwd` is treated as outside and rejected — the check runs on the resolved real path, not the literal path.
+4. **Nonexistent target paths** resolve by walking back to the nearest existing ancestor and re-applying the check, so symlinks in ancestor directories are still caught.
+5. **`runShell` is hard-disabled** under `cwd-only`. The tool returns an error telling the model to use `readFile` / `writeFile` / `grep` / `glob` / `listFiles` instead. Set `sandboxPolicy: "none"` per-provider or per-task to opt in to shell.
+6. **The check is per-call**, not per-session. Every tool invocation revalidates.
+7. **Errors are surfaced to the model**, not silently swallowed, so the model can observe the rejection and adjust.
+
+### Other hardening
+
 - `readFile` rejects targets larger than 50 MiB; `writeFile` rejects content larger than 100 MiB.
 - The server warns at config-load time if it sees an inline `apiKey` instead of `apiKeyEnv`.
 - The server warns once if `~/.codex/auth.json` is group- or world-readable.

package/dist/cli.d.ts

@@ -4,7 +4,7 @@ import { z } from 'zod';
 import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
 import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
 export declare const SERVER_NAME = "multi-model-agent";
-export declare const SERVER_VERSION = "0.1.0";
+export declare const SERVER_VERSION: string;
 export declare function buildTaskSchema(availableProviders: [string, ...string[]]): z.ZodObject<{
     prompt: z.ZodString;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -41,6 +41,7 @@ export declare function buildTaskSchema(availableProviders: [string, ...string[]
         none: "none";
         "cwd-only": "cwd-only";
     }>>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare function buildMcpServer(config: Parameters<typeof runTasks>[1]): McpServer;
 /**

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,mCAAmC,CAAC;AAGpF,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAC/C,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBxE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,aAyCpE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAuBhE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,mCAAmC,CAAC;AAG3C,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAW/C,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwBxE;AAkCD,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,aAsPpE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAuBhE"}

package/dist/cli.js

@@ -2,6 +2,8 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { randomUUID } from 'node:crypto';
+import { createRequire } from 'node:module';
 import { fileURLToPath } from 'url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -9,9 +11,20 @@ import { z } from 'zod';
 import { loadConfigFromFile } from '@zhixuan92/multi-model-agent-core/config/load';
 import { parseConfig } from '@zhixuan92/multi-model-agent-core/config/schema';
 import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
+import { InMemoryContextBlockStore } from '@zhixuan92/multi-model-agent-core';
 import { renderProviderRoutingMatrix } from './routing/render-provider-routing-matrix.js';
 export const SERVER_NAME = 'multi-model-agent';
-export const SERVER_VERSION = '0.1.0';
+// Read the version from package.json at module load so the MCP server
+// metadata (and tests that assert against it) stays in lockstep with the
+// published npm package version. `createRequire` keeps the JSON read
+// outside tsc's `rootDir: src` constraint and avoids the `with { type:
+// 'json' }` import attribute (which would force us to commit to a
+// specific TS/Node module-resolution combination). The relative path is
+// resolved from the compiled `dist/cli.js` — that sits one level below
+// `packages/mcp/package.json`.
+const packageRequire = createRequire(import.meta.url);
+const pkg = packageRequire('../package.json');
+export const SERVER_VERSION = pkg.version;
 export function buildTaskSchema(availableProviders) {
     return z.object({
         prompt: z.string().describe('Task prompt for the sub-agent'),
@@ -29,8 +42,43 @@ export function buildTaskSchema(availableProviders) {
         effort: z.enum(['none', 'low', 'medium', 'high']).optional()
             .describe("Reasoning effort."),
         sandboxPolicy: z.enum(['none', 'cwd-only']).optional().describe('File-system confinement policy. Default: cwd-only'),
+        contextBlockIds: z.array(z.string()).optional().describe('Optional context block ids previously stored via register_context_block. ' +
+            'The server resolves each id to its stored content and prepends the blocks ' +
+            '(in order, separated by "\\n\\n---\\n\\n") to `prompt` before dispatch. ' +
+            'Use this to avoid re-transmitting long briefs across multiple calls.'),
     });
 }
+/**
+ * Batch cache for `retry_tasks`. Every `delegate_tasks` call stashes the
+ * original `TaskSpec[]` under a UUID so the caller can later ask us to
+ * re-dispatch specific indices without re-transmitting the briefs. Two
+ * bounds:
+ *
+ *   - TTL (30 min from creation): keeps stale batches from lingering
+ *     through a long session. TTL is from-creation (not from-last-access),
+ *     matching `InMemoryContextBlockStore` — a batch used at minute 29
+ *     still dies at minute 30. Access does NOT refresh the expiry.
+ *   - LRU cap (100 entries): prevents unbounded growth from a chatty
+ *     caller that never retries. Eviction is true LRU (least-recently-
+ *     *used*, not least-recently-inserted): a batch that is still being
+ *     retried stays hot and a newer but unused batch will be evicted
+ *     first. This matters when a caller is iterating on one task while
+ *     dispatching unrelated batches in parallel.
+ *
+ * Eviction on TTL is lazy (checked on `retry_tasks` lookup). Eviction on
+ * the LRU cap is eager (runs after every `rememberBatch`).
+ *
+ * LRU implementation note: we use JavaScript's `Map` which preserves
+ * insertion order on iteration. To "touch" an entry on access, we
+ * `delete` it and re-`set` it, which moves it to the end of the
+ * iteration order. `Map.keys().next().value` is then the oldest-*accessed*
+ * entry (not the oldest-inserted entry), giving us O(1) LRU without a
+ * separate priority structure. The helpers `touchBatch` (on access) and
+ * the eviction loop in `rememberBatch` (on insert) are the only two
+ * places that mutate the Map.
+ */
+const BATCH_TTL_MS = 30 * 60 * 1000;
+const BATCH_MAX = 100;
 export function buildMcpServer(config) {
     const providerKeys = Object.keys(config.providers);
     if (providerKeys.length === 0) {
@@ -40,18 +88,200 @@ export function buildMcpServer(config) {
         name: SERVER_NAME,
         version: SERVER_VERSION,
     });
+    // One context-block store per server instance. Persists across calls
+    // within a single `buildMcpServer(...)` lifetime so `register_context_block`
+    // followed by multiple `delegate_tasks` with `contextBlockIds` works.
+    const contextBlockStore = new InMemoryContextBlockStore();
+    // Per-server batch cache for `retry_tasks`. See the LRU comment block
+    // above for eviction semantics.
+    const batchCache = new Map();
+    const rememberBatch = (tasks) => {
+        const id = randomUUID();
+        batchCache.set(id, { tasks, expiresAt: Date.now() + BATCH_TTL_MS });
+        // Evict the least-recently-USED entry (not least-recently-inserted).
+        // `touchBatch` below moves accessed entries to the end of insertion
+        // order, so `keys().next().value` is the true LRU head.
+        while (batchCache.size > BATCH_MAX) {
+            const lru = batchCache.keys().next().value;
+            if (lru)
+                batchCache.delete(lru);
+            else
+                break;
+        }
+        return id;
+    };
+    /**
+     * Mark a batch as recently used by reinserting it at the tail of the
+     * Map's iteration order. `touchBatch` is called on every successful
+     * `retry_tasks` lookup so a frequently-retried batch does not get
+     * evicted by `rememberBatch`'s LRU loop. Does NOT refresh the TTL —
+     * expiry stays at the original creation time.
+     */
+    const touchBatch = (id, entry) => {
+        batchCache.delete(id);
+        batchCache.set(id, entry);
+    };
     const availableProviders = providerKeys;
     server.tool('delegate_tasks', renderProviderRoutingMatrix(config), {
         tasks: z.array(buildTaskSchema(availableProviders)).describe('Array of tasks to execute in parallel'),
-    }, async ({ tasks }) => {
-        const results = await runTasks(tasks, config);
+    }, async ({ tasks }, extra) => {
+        // --- OQ#6 resolution: MCP SDK progress notification API ---
+        //
+        // The @modelcontextprotocol/sdk >= 1.x exposes progress notifications
+        // on the tool-handler `extra` argument: the second parameter of the
+        // tool callback is `RequestHandlerExtra<ServerRequest, ServerNotification>`
+        // (see node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.d.ts
+        // line 173, and server/mcp.d.ts line 250 for `BaseToolCallback`).
+        //
+        // That type carries two things we need:
+        //   1. `extra._meta.progressToken?: string | number` — present iff the
+        //      client opted in by sending `_meta.progressToken` with its
+        //      `tools/call` request (MCP spec: notifications/progress).
+        //   2. `extra.sendNotification(notification)` — a request-scoped sender
+        //      that emits `ServerNotification`s correlated with this call.
+        //      `ServerNotification` is a union that includes
+        //      `ProgressNotificationSchema` with method `"notifications/progress"`
+        //      and params `{ progressToken, progress, total?, message? }`
+        //      (types.d.ts line 954).
+        //
+        // So the bridge is: for each `ProgressEvent` we receive from core, if
+        // the client supplied a `progressToken`, emit one `notifications/progress`
+        // message whose `message` field is a JSON-encoded envelope. This is an
+        // opt-in channel — clients that don't send `progressToken` get zero
+        // notifications, preserving behavior for pre-streaming callers.
+        //
+        // Envelope schema (stable, documented here so clients can parse it):
+        //
+        //     params: {
+        //       progressToken,                // echoed from the request _meta
+        //       progress: <monotonic counter>,// ordinal of this event (1-based)
+        //       message: JSON.stringify({
+        //         taskIndex: <number>,        // index in the original `tasks` array
+        //         event: <ProgressEvent>,     // full ProgressEvent union member
+        //       }),
+        //     }
+        //
+        // `total` is intentionally omitted: we don't know the final event count
+        // in advance. Runners emit events in Tasks 9-11; this commit is plumbing
+        // only and `escalation_start` (emitted by delegateWithEscalation itself)
+        // is the sole observable event in practice.
+        // Runtime guard instead of a raw cast: _meta is typed broadly at the
+        // SDK layer, and a bad client could in principle send a progressToken
+        // of any JSON type. Only `string` / `number` are valid per MCP spec.
+        const rawToken = extra._meta?.progressToken;
+        const progressToken = typeof rawToken === 'string' || typeof rawToken === 'number'
+            ? rawToken
+            : undefined;
+        let progressCounter = 0;
+        const sendProgress = progressToken !== undefined
+            ? (taskIndex, event) => {
+                progressCounter += 1;
+                // Fire-and-forget. We swallow rejections so a broken transport
+                // never corrupts the in-flight tool run — worst case the client
+                // misses a progress tick but still gets the final tool result.
+                extra
+                    .sendNotification({
+                    method: 'notifications/progress',
+                    params: {
+                        progressToken,
+                        progress: progressCounter,
+                        message: JSON.stringify({ taskIndex, event }),
+                    },
+                })
+                    .catch(() => {
+                    /* ignore — progress is best-effort */
+                });
+            }
+            : undefined;
+        // Stash the original task specs in the batch cache BEFORE dispatch
+        // so the returned batchId is valid even if the dispatch itself
+        // throws (so callers can still retry the specific tasks that
+        // produced errors). The cache stores the raw TaskSpec[] — NOT the
+        // expanded forms — because `retry_tasks` will push the same specs
+        // through `runTasks` again, which re-expands against the current
+        // (possibly updated) context-block store.
+        const batchId = rememberBatch(tasks);
+        const results = await runTasks(tasks, config, {
+            onProgress: sendProgress,
+            runtime: { contextBlockStore },
+        });
         const response = {
+            batchId,
             results: results.map((r, i) => ({
                 provider: tasks[i].provider ?? '(auto)',
                 status: r.status,
                 output: r.output,
                 turns: r.turns,
-                files: r.files,
+                filesRead: r.filesRead,
+                filesWritten: r.filesWritten,
+                toolCalls: r.toolCalls,
+                escalationLog: r.escalationLog,
+                usage: r.usage,
+                ...(r.error && { error: r.error }),
+            })),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+        };
+    });
+    server.tool('register_context_block', 'Store a content block under an id (or auto-generated UUID) for reuse in later delegate_tasks calls. ' +
+        'Use this to avoid re-transmitting long briefs on every dispatch. Blocks are referenced from a ' +
+        'task via its `contextBlockIds` array — the server resolves each id to its stored content and ' +
+        'prepends the blocks to the task `prompt` at dispatch time. Blocks live in an in-memory store ' +
+        'with a 30-minute TTL and a 100-entry LRU cap.', {
+        id: z.string().optional().describe('Optional id; auto-generated UUID if omitted'),
+        content: z.string().describe('The content to store'),
+    }, async ({ id, content }) => {
+        const result = contextBlockStore.register(content, { id });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool('retry_tasks', 'Re-run specific tasks from a previous delegate_tasks batch by their indices, without ' +
+        're-transmitting the original briefs. Pass the `batchId` returned by delegate_tasks ' +
+        'and an array of task indices (0-based) to re-dispatch. Batches live in an in-memory ' +
+        'cache with a 30-minute TTL; if the batch has expired, re-dispatch the tasks explicitly ' +
+        'via delegate_tasks.', {
+        batchId: z.string().describe('Batch id returned from a previous delegate_tasks call'),
+        taskIndices: z
+            .array(z.number().int().nonnegative())
+            .describe('Zero-based indices (into the original batch) of the tasks to re-run'),
+    }, async ({ batchId, taskIndices }) => {
+        const batch = batchCache.get(batchId);
+        if (!batch || batch.expiresAt < Date.now()) {
+            // Proactively drop the expired entry so subsequent lookups see
+            // the same "unknown" result and the cache doesn't slowly fill
+            // with stale rows that are never touched again.
+            if (batch)
+                batchCache.delete(batchId);
+            throw new Error(`batch "${batchId}" is unknown or expired — re-dispatch with full task specs via delegate_tasks`);
+        }
+        // Mark this batch as recently used so the LRU eviction in
+        // `rememberBatch` doesn't drop a hot entry when newer batches
+        // arrive. Does NOT refresh TTL — a batch created 29 minutes ago
+        // still dies at minute 30 even if it's retried heavily.
+        touchBatch(batchId, batch);
+        for (const i of taskIndices) {
+            if (i < 0 || i >= batch.tasks.length) {
+                throw new Error(`index ${i} is out of range for batch ${batchId} (size ${batch.tasks.length})`);
+            }
+        }
+        const subset = taskIndices.map((i) => batch.tasks[i]);
+        const results = await runTasks(subset, config, {
+            runtime: { contextBlockStore },
+        });
+        const response = {
+            batchId,
+            results: results.map((r, i) => ({
+                originalIndex: taskIndices[i],
+                provider: subset[i].provider ?? '(auto)',
+                status: r.status,
+                output: r.output,
+                turns: r.turns,
+                filesRead: r.filesRead,
+                filesWritten: r.filesWritten,
+                toolCalls: r.toolCalls,
+                escalationLog: r.escalationLog,
                 usage: r.usage,
                 ...(r.error && { error: r.error }),
             })),

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/routing/render-provider-routing-matrix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-provider-routing-matrix.d.ts","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAkB,MAAM,mCAAmC,CAAC;AAmDtG;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkB5E"}
+{"version":3,"file":"render-provider-routing-matrix.d.ts","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAkB,MAAM,mCAAmC,CAAC;AA0FtG;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoB5E"}

package/dist/routing/render-provider-routing-matrix.js

@@ -20,6 +20,44 @@ Optional 'effort' knob (per task):
   'medium' for balanced, 'low' for fast-but-shallow, 'none' to disable
   thinking entirely on providers that default it on. Omit the field on
   providers that do not support it.`;
+const TOOL_NOTES = `Sub-agent tool notes (apply to every provider):
+- 'grep' accepts a file OR a directory. When given a directory it searches
+  recursively (output is prefixed file:line). Prefer one recursive grep over
+  many readFile calls when the worker needs to find usages or patterns.
+- Worker output is captured from the final assistant message when present,
+  otherwise salvaged from a running scratchpad. You ALWAYS get text back,
+  even on 'incomplete' / 'timeout' / 'api_error' / 'network_error' paths.
+- Tasks that need shell ('pnpm', 'pytest', 'tsc', 'git') only work on
+  providers configured with sandboxPolicy: 'none'. Otherwise keep shell
+  work on the parent session, not in a delegated sub-agent.
+
+Escalation, statuses, streaming, and batch helpers:
+- Auto-routed tasks (no 'provider' set) walk the full capability+tier
+  chain cheapest-first on failure. The chain stops at the first 'ok'.
+  If every provider fails, the best salvage is returned and the
+  per-task 'escalationLog' shows every attempt. Explicit pins
+  ('provider' set) run as a single attempt — pinning opts out.
+- Status values: 'ok', 'incomplete', 'max_turns', 'timeout',
+  'api_aborted', 'api_error', 'network_error', 'error'.
+  'incomplete' = scratchpad salvage after a degenerate completion;
+  'api_aborted' = provider-side abort; 'api_error' = HTTP error with
+  a numeric .status; 'network_error' = transport failure
+  (ECONNREFUSED / ENOTFOUND / /network/i).
+- Streaming: if your MCP client passes '_meta.progressToken' on the
+  tool call, delegate_tasks forwards per-task progress notifications
+  (turn_start, tool_call, text_emission, turn_complete, injection,
+  escalation_start, done) back over the MCP progress channel. No
+  opt-in needed beyond sending the token.
+- Batch helpers: every delegate_tasks response carries a 'batchId'.
+  Use 'retry_tasks' with that batchId + a list of 0-based task
+  indices to re-run just the failing subset without re-transmitting
+  the original briefs. Cache is 30-minute TTL, 100-batch LRU.
+- Long shared context: 'register_context_block' stores a blob of
+  text on the server and returns an id. Pass that id in
+  'contextBlockIds' on any task (alongside 'prompt') and the server
+  prepends the blob to the prompt before dispatch — so long briefs
+  shared across multiple tasks are sent to the parent session only
+  once.`;
 function renderProviderBlock(name, config, capabilities, profile, costSource) {
     const cost = getEffectiveCostTier(config);
     const costSuffix = costSource === 'config' ? ' (from config)' : '';
@@ -58,6 +96,8 @@ export function renderProviderRoutingMatrix(config) {
         blocks.join('\n\n'),
         '',
         ROUTING_RECIPE,
+        '',
+        TOOL_NOTES,
     ].join('\n');
 }
 //# sourceMappingURL=render-provider-routing-matrix.js.map

package/dist/routing/render-provider-routing-matrix.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-provider-routing-matrix.js","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAGlH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;oCAmBa,CAAC;AAErC,SAAS,mBAAmB,CAC1B,IAAY,EACZ,MAAsB,EACtB,YAA0B,EAC1B,OAAqB,EACrB,UAAgC;IAEhC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;IAC3E,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,KAAK,MAAM,CAAC,KAAK,GAAG;QAC3B,YAAY,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrC,WAAW,OAAO,CAAC,IAAI,YAAY,IAAI,GAAG,UAAU,cAAc,WAAW,EAAE;QAC/E,eAAe,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE;QAC7E,MAAM,YAAY,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,UAAU,GAAyB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,OAAO,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,kEAAkE;QAClE,iCAAiC;QACjC,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB,EAAE;QACF,cAAc;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"render-provider-routing-matrix.js","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAGlH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;oCAmBa,CAAC;AAErC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqCX,CAAC;AAET,SAAS,mBAAmB,CAC1B,IAAY,EACZ,MAAsB,EACtB,YAA0B,EAC1B,OAAqB,EACrB,UAAgC;IAEhC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;IAC3E,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,KAAK,MAAM,CAAC,KAAK,GAAG;QAC3B,YAAY,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrC,WAAW,OAAO,CAAC,IAAI,YAAY,IAAI,GAAG,UAAU,cAAc,WAAW,EAAE;QAC/E,eAAe,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE;QAC7E,MAAM,YAAY,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,UAAU,GAAyB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,OAAO,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,kEAAkE;QAClE,iCAAiC;QACjC,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB,EAAE;QACF,cAAc;QACd,EAAE;QACF,UAAU;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhixuan92/multi-model-agent-mcp",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
   "description": "MCP server for multi-model-agent. Exposes a delegate_tasks tool that routes work to Claude, Codex, or OpenAI-compatible sub-agents based on capability, quality tier, and cost.",
@@ -49,7 +49,7 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@zhixuan92/multi-model-agent-core": "^0.1.1",
+    "@zhixuan92/multi-model-agent-core": "^0.2.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^4.0.0"
   }