@zhixuan92/multi-model-agent-mcp 0.1.4 → 0.3.0

package/README.md

@@ -1,6 +1,17 @@
 # @zhixuan92/multi-model-agent-mcp
 
-MCP stdio server for [`multi-model-agent`](https://github.com/zhixuan312/multi-model-agent). Exposes one tool — `delegate_tasks` — that runs work in parallel across multiple LLM providers (Claude, Codex, OpenAI-compatible) and auto-routes each task to the cheapest provider that can handle it.
+MCP stdio server for [`multi-model-agent`](https://github.com/zhixuan312/multi-model-agent). Exposes four tools — `delegate_tasks`, `register_context_block`, `retry_tasks`, and `get_task_output` — that run work in parallel across multiple LLM providers (Claude, Codex, OpenAI-compatible) and auto-route each task to the cheapest provider that can handle it.
+
+## Features
+
+- **Auto-routing**: routes each task by capability filter → quality tier → cheapest qualifying provider
+- **Parallel execution**: independent tasks run concurrently via `Promise.all`
+- **Escalation on failure**: auto-routed tasks walk the full provider chain on failure, stopping at the first success
+- **Scratchpad salvage**: every termination path (incomplete, max_turns, timeout, error) populates output from the runner's scratchpad — no bare failures
+- **Response pagination**: configurable `responseMode` (full/summary/auto) prevents Claude Code inline rendering limits on large combined outputs; use `get_task_output` to fetch individual results from summary-mode batches
+- **Declare enumerable-deliverable coverage** (`expectedCoverage`) and get semantic incompleteness detection via re-prompting
+- **Bounded post-hoc progress traces** (`includeProgressTrace`) for long-running task debugging
+- **Visible cost and time savings**: `parentModel` + `savedCostUSD` per task; `timings` and `aggregateCost` batch-level aggregates for delegation ROI visibility
 
 ## How it works
 
@@ -121,27 +132,48 @@ Accepts an array of tasks and runs them concurrently. Auto-routes each task by c
       "tier": "reasoning",
       "requiredCapabilities": ["file_read", "file_write"],
       "tools": "full",
-      "cwd": "/path/to/project"
+      "cwd": "/path/to/project",
+      "parentModel": "claude-sonnet-4-5",
+      "includeProgressTrace": true
     },
     {
       "prompt": "Write tests for the auth module.",
       "tier": "standard",
       "requiredCapabilities": ["file_read", "file_write", "grep"],
       "tools": "full",
-      "cwd": "/path/to/project"
+      "cwd": "/path/to/project",
+      "expectedCoverage": {
+        "minSections": 3,
+        "sectionPattern": "^Test \\d+:",
+        "requiredMarkers": ["happy path", "edge case"]
+      }
     }
   ]
 }
 ```
 
-Per-task fields: `prompt`, `tier`, `requiredCapabilities`, `provider?`, `tools?`, `maxTurns?`, `timeoutMs?`, `cwd?`, `effort?`, `sandboxPolicy?`.
+Per-task fields: `prompt`, `tier`, `requiredCapabilities`, `provider?`, `tools?`, `maxTurns?`, `timeoutMs?`, `cwd?`, `effort?`, `sandboxPolicy?`, `contextBlockIds?`, `expectedCoverage?`, `includeProgressTrace?`, `parentModel?`.
+
+`expectedCoverage` supports `minSections?`, `sectionPattern?`, and `requiredMarkers?`. `includeProgressTrace` opts a task into returning its bounded post-hoc progress trace. `parentModel` lets the server estimate `savedCostUSD` relative to the calling model.
 
 Capabilities: `file_read`, `file_write`, `grep`, `glob`, `shell`, `web_search`, `web_fetch`.
 
 ## 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

@@ -2,18 +2,21 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
-import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+import type { MultiModelConfig, RunResult, BatchTimings, BatchProgress, BatchAggregateCost } from '@zhixuan92/multi-model-agent-core';
 export declare const SERVER_NAME = "multi-model-agent";
-export declare const SERVER_VERSION = "0.1.0";
+export declare function computeTimings(wallClockMs: number, results: RunResult[]): BatchTimings;
+export declare function computeBatchProgress(results: RunResult[]): BatchProgress;
+export declare function computeAggregateCost(results: RunResult[]): BatchAggregateCost;
+export declare const SERVER_VERSION: string;
 export declare function buildTaskSchema(availableProviders: [string, ...string[]]): z.ZodObject<{
     prompt: z.ZodString;
     provider: z.ZodOptional<z.ZodEnum<{
         [x: string]: string;
     }>>;
     tier: z.ZodEnum<{
-        trivial: "trivial";
-        standard: "standard";
         reasoning: "reasoning";
+        standard: "standard";
+        trivial: "trivial";
     }>;
     requiredCapabilities: z.ZodArray<z.ZodEnum<{
         file_read: "file_read";
@@ -25,24 +28,40 @@ export declare function buildTaskSchema(availableProviders: [string, ...string[]
         web_fetch: "web_fetch";
     }>>;
     tools: z.ZodOptional<z.ZodEnum<{
-        none: "none";
         full: "full";
+        none: "none";
     }>>;
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     cwd: z.ZodOptional<z.ZodString>;
     effort: z.ZodOptional<z.ZodEnum<{
-        low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
+        low: "low";
         none: "none";
     }>>;
     sandboxPolicy: z.ZodOptional<z.ZodEnum<{
         none: "none";
         "cwd-only": "cwd-only";
     }>>;
+    contextBlockIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    expectedCoverage: z.ZodOptional<z.ZodObject<{
+        minSections: z.ZodOptional<z.ZodNumber>;
+        sectionPattern: z.ZodOptional<z.ZodString>;
+        requiredMarkers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    includeProgressTrace: z.ZodOptional<z.ZodBoolean>;
+    parentModel: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare function buildMcpServer(config: Parameters<typeof runTasks>[1]): McpServer;
+export declare function buildMcpServer(config: Parameters<typeof runTasks>[1], options?: {
+    /** Character threshold that triggers auto-switch from 'full' to
+     *  'summary' response mode when the caller uses `responseMode: 'auto'`
+     *  (the default). Defaults to 65_536, tuned for Claude Code's inline
+     *  rendering limit. Precedence (highest first): env var
+     *  MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS > config file
+     *  defaults.largeResponseThresholdChars > this option > default. */
+    largeResponseThresholdChars?: number;
+}): McpServer;
 /**
  * MCP CLI config discovery (owned by MCP, not core):
  * 1. --config <path> argument (explicit)

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,EAGhB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAG3C,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAc/C,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,YAAY,CAItF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,CAgBxE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAyB7E;AAwFD,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwCxE;AAkCD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EACtC,OAAO,CAAC,EAAE;IACR;;;;;wEAKoE;IACpE,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC,aAoXF;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, createHash } 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,128 @@ 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';
+const DEFAULT_LARGE_RESPONSE_THRESHOLD_CHARS = 65_536;
+function parsePositiveInt(s) {
+    if (!s)
+        return undefined;
+    const n = Number.parseInt(s, 10);
+    if (Number.isFinite(n) && n > 0 && String(n) === s.trim())
+        return n;
+    return undefined;
+}
+function sha256Hex(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+export function computeTimings(wallClockMs, results) {
+    const sumOfTaskMs = results.reduce((sum, r) => sum + (r.durationMs ?? 0), 0);
+    const estimatedParallelSavingsMs = Math.max(0, sumOfTaskMs - wallClockMs);
+    return { wallClockMs, sumOfTaskMs, estimatedParallelSavingsMs };
+}
+export function computeBatchProgress(results) {
+    const totalTasks = results.length;
+    const completedTasks = results.filter((r) => r.status === 'ok').length;
+    const incompleteTasks = results.filter((r) => r.status === 'incomplete' || r.status === 'max_turns' || r.status === 'timeout').length;
+    const failedTasks = results.filter((r) => r.status === 'error' ||
+        r.status === 'api_aborted' ||
+        r.status === 'api_error' ||
+        r.status === 'network_error').length;
+    const successPercent = totalTasks === 0 ? 0 : Math.round((completedTasks / totalTasks) * 1000) / 10;
+    return { totalTasks, completedTasks, incompleteTasks, failedTasks, successPercent };
+}
+export function computeAggregateCost(results) {
+    let totalActualCostUSD = 0;
+    let totalSavedCostUSD = 0;
+    let actualCostUnavailableTasks = 0;
+    let savedCostUnavailableTasks = 0;
+    for (const r of results) {
+        if (r.usage.costUSD === null || r.usage.costUSD === undefined) {
+            actualCostUnavailableTasks += 1;
+        }
+        else {
+            totalActualCostUSD += r.usage.costUSD;
+        }
+        if (r.usage.savedCostUSD === null || r.usage.savedCostUSD === undefined) {
+            savedCostUnavailableTasks += 1;
+        }
+        else {
+            totalSavedCostUSD += r.usage.savedCostUSD;
+        }
+    }
+    return {
+        totalActualCostUSD,
+        totalSavedCostUSD,
+        actualCostUnavailableTasks,
+        savedCostUnavailableTasks,
+    };
+}
+function buildFullResponse(batchId, tasks, results, aggregates) {
+    return {
+        batchId,
+        mode: 'full',
+        timings: aggregates.timings,
+        batchProgress: aggregates.batchProgress,
+        aggregateCost: aggregates.aggregateCost,
+        results: results.map((r, i) => ({
+            provider: tasks[i].provider ?? '(auto)',
+            status: r.status,
+            output: r.output,
+            turns: r.turns,
+            durationMs: r.durationMs,
+            filesRead: r.filesRead,
+            filesWritten: r.filesWritten,
+            directoriesListed: r.directoriesListed,
+            toolCalls: r.toolCalls,
+            escalationLog: r.escalationLog,
+            usage: r.usage,
+            ...(r.progressTrace && { progressTrace: r.progressTrace }),
+            ...(r.error && { error: r.error }),
+        })),
+    };
+}
+function buildSummaryResponse(batchId, tasks, results, opts) {
+    return {
+        batchId,
+        mode: 'summary',
+        ...(opts.autoEscaped && {
+            note: `Combined output was ${opts.totalOutputChars} chars (threshold: ${opts.threshold}). Auto-switched to summary mode. Use get_task_output({ batchId, taskIndex }) to fetch individual task outputs.`,
+        }),
+        timings: opts.timings,
+        batchProgress: opts.batchProgress,
+        aggregateCost: opts.aggregateCost,
+        results: results.map((r, i) => ({
+            taskIndex: i,
+            provider: tasks[i].provider ?? '(auto)',
+            status: r.status,
+            outputLength: r.output.length,
+            outputSha256: sha256Hex(r.output),
+            turns: r.turns,
+            durationMs: r.durationMs,
+            filesRead: r.filesRead,
+            filesWritten: r.filesWritten,
+            directoriesListed: r.directoriesListed,
+            toolCalls: r.toolCalls,
+            escalationLog: r.escalationLog,
+            usage: r.usage,
+            ...(r.progressTrace && { progressTrace: r.progressTrace }),
+            ...(r.error && { error: r.error }),
+            _fetchWith: `get_task_output({ batchId: "${batchId}", taskIndex: ${i} })`,
+        })),
+    };
+}
+// 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,37 +150,358 @@ 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.'),
+        expectedCoverage: z.object({
+            minSections: z.number().int().positive().optional()
+                .describe('Minimum section count expected in the output.'),
+            sectionPattern: z.string().optional()
+                .describe('Regex for section headings, applied with the multiline flag.'),
+            requiredMarkers: z.array(z.string()).optional()
+                .describe('Substrings that must all appear somewhere in the output.'),
+        }).optional().describe('Optional caller-declared output expectations used for semantic incompleteness detection.'),
+        includeProgressTrace: z.boolean().optional().describe('Opt in to returning the bounded post-hoc progress trace for this task.'),
+        parentModel: z.string().optional().describe('Optional parent-session model identifier used to estimate savedCostUSD.'),
     });
 }
-export function buildMcpServer(config) {
+/**
+ * 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, options) {
     const providerKeys = Object.keys(config.providers);
     if (providerKeys.length === 0) {
         throw new Error('buildMcpServer requires at least one configured provider.');
     }
+    // Resolve the threshold once at server startup
+    const envThreshold = parsePositiveInt(process.env.MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS);
+    if (process.env.MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS !== undefined && envThreshold === undefined) {
+        process.stderr.write(`[multi-model-agent] warning: MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS=${process.env.MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS} is not a positive integer, ignoring\n`);
+    }
+    const resolvedThreshold = envThreshold
+        ?? config.defaults.largeResponseThresholdChars
+        ?? options?.largeResponseThresholdChars
+        ?? DEFAULT_LARGE_RESPONSE_THRESHOLD_CHARS;
     const server = new McpServer({
         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);
-        const response = {
-            results: results.map((r, i) => ({
-                provider: tasks[i].provider ?? '(auto)',
-                status: r.status,
-                output: r.output,
-                turns: r.turns,
-                files: r.files,
-                usage: r.usage,
-                ...(r.error && { error: r.error }),
-            })),
+        responseMode: z.enum(['full', 'summary', 'auto']).optional().describe(`How to shape the response envelope. 'full' (default via 'auto') includes each task's output inline. ` +
+            `'summary' returns per-task metadata + outputLength + outputSha256, with full outputs fetchable via ` +
+            `get_task_output. 'auto' (the default) returns 'full' when combined output fits under the server's ` +
+            `threshold (default 65 KB; configurable via env / config / buildMcpServer option), otherwise 'summary' ` +
+            `with an auto-escape note.`),
+    }, async ({ tasks, responseMode = 'auto' }, 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 batchStartMs = Date.now();
+        let results = [];
+        try {
+            results = await runTasks(tasks, config, {
+                onProgress: sendProgress,
+                runtime: { contextBlockStore },
+            });
+        }
+        finally {
+            // Always attach `results ?? []` so a mid-flight throw does not leave
+            // a dangling batchCache entry that `get_task_output` can't distinguish
+            // from "dispatch still in progress". Per spec §3.5 / §3.9 item 3.
+            const batchEntry = batchCache.get(batchId);
+            if (batchEntry)
+                batchEntry.results = results;
+        }
+        const wallClockMs = Date.now() - batchStartMs;
+        // Determine effective response mode based on the configurable threshold
+        const totalOutputChars = results.reduce((sum, r) => sum + r.output.length, 0);
+        const effectiveMode = responseMode === 'full'
+            ? 'full'
+            : responseMode === 'summary'
+                ? 'summary'
+                : totalOutputChars > resolvedThreshold
+                    ? 'summary'
+                    : 'full';
+        const timings = computeTimings(wallClockMs, results);
+        const batchProgress = computeBatchProgress(results);
+        const aggregateCost = computeAggregateCost(results);
+        const response = effectiveMode === 'full'
+            ? buildFullResponse(batchId, tasks, results, { timings, batchProgress, aggregateCost })
+            : buildSummaryResponse(batchId, tasks, results, {
+                autoEscaped: responseMode === 'auto' && totalOutputChars > resolvedThreshold,
+                totalOutputChars,
+                threshold: resolvedThreshold,
+                timings,
+                batchProgress,
+                aggregateCost,
+            });
+        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'),
+        responseMode: z.enum(['full', 'summary', 'auto']).optional().describe(`How to shape the response envelope for the retry batch. 'full' returns inline outputs. ` +
+            `'summary' returns outputLength + outputSha256. 'auto' (default) auto-escapes based on threshold.`),
+    }, async ({ batchId, taskIndices, responseMode = 'auto' }) => {
+        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]);
+        // Create a fresh batch for the retried tasks so the original batch
+        // entry is preserved and get_task_output can still retrieve it.
+        const retryBatchId = rememberBatch(subset);
+        const batchStartMs = Date.now();
+        let results = [];
+        try {
+            results = await runTasks(subset, config, {
+                runtime: { contextBlockStore },
+            });
+        }
+        finally {
+            const retryEntry = batchCache.get(retryBatchId);
+            if (retryEntry)
+                retryEntry.results = results;
+        }
+        const wallClockMs = Date.now() - batchStartMs;
+        // Determine effective response mode
+        const totalOutputChars = results.reduce((sum, r) => sum + r.output.length, 0);
+        const effectiveMode = responseMode === 'full'
+            ? 'full'
+            : responseMode === 'summary'
+                ? 'summary'
+                : totalOutputChars > resolvedThreshold
+                    ? 'summary'
+                    : 'full';
+        const timings = computeTimings(wallClockMs, results);
+        const batchProgress = computeBatchProgress(results);
+        const aggregateCost = computeAggregateCost(results);
+        const response = effectiveMode === 'full'
+            ? {
+                ...buildFullResponse(retryBatchId, subset, results, { timings, batchProgress, aggregateCost }),
+                originalBatchId: batchId,
+                originalIndices: taskIndices,
+            }
+            : {
+                ...buildSummaryResponse(retryBatchId, subset, results, {
+                    autoEscaped: responseMode === 'auto' && totalOutputChars > resolvedThreshold,
+                    totalOutputChars,
+                    threshold: resolvedThreshold,
+                    timings,
+                    batchProgress,
+                    aggregateCost,
+                }),
+                originalBatchId: batchId,
+                originalIndices: taskIndices,
+            };
         return {
             content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
         };
     });
+    server.tool('get_task_output', `Retrieve the full text output of a specific task from a previous delegate_tasks batch.
+
+Use this when a prior delegate_tasks response came back with mode: 'summary' and you
+need the actual output of one specific task. The batchId is the one returned at the
+top of that response; taskIndex is 0-based into the original tasks array.
+
+Batches are cached in memory per MCP server instance with a 30-minute TTL from creation
+and a 100-entry LRU cap. Access touches the LRU order but does not refresh TTL. If the
+batch is expired or evicted, re-dispatch via delegate_tasks with the full specs.`, {
+        batchId: z.string().describe('Batch id returned from a previous delegate_tasks call'),
+        taskIndex: z.number().int().nonnegative().describe('Zero-based index of the task within the batch'),
+    }, async ({ batchId, taskIndex }) => {
+        const batch = batchCache.get(batchId);
+        if (!batch || batch.expiresAt < Date.now()) {
+            if (batch)
+                batchCache.delete(batchId);
+            throw new Error(`batch "${batchId}" is unknown or expired — re-dispatch with full task specs via delegate_tasks`);
+        }
+        // Touch LRU order but NOT TTL
+        touchBatch(batchId, batch);
+        if (batch.results === undefined) {
+            throw new Error(`batch "${batchId}" has no stored results — this may indicate a dispatch failure`);
+        }
+        if (taskIndex < 0 || taskIndex >= batch.results.length) {
+            throw new Error(`index ${taskIndex} is out of range for batch ${batchId} (size ${batch.results.length})`);
+        }
+        const result = batch.results[taskIndex];
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ output: result.output }, null, 2) }],
+        };
+    });
     return server;
 }
 /**

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/index.d.ts

@@ -1,2 +1,2 @@
-export { buildMcpServer, buildTaskSchema, SERVER_NAME, SERVER_VERSION } from './cli.js';
+export { buildMcpServer, buildTaskSchema, SERVER_NAME, SERVER_VERSION, computeTimings, computeBatchProgress, computeAggregateCost } from './cli.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { buildMcpServer, buildTaskSchema, SERVER_NAME, SERVER_VERSION } from './cli.js';
+export { buildMcpServer, buildTaskSchema, SERVER_NAME, SERVER_VERSION, computeTimings, computeBatchProgress, computeAggregateCost } from './cli.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

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;AA0JtG;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoB5E"}

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

@@ -20,6 +20,108 @@ 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.
+
+RESPONSE SHAPE (v0.3+): Every delegate_tasks response includes a top-level
+batchId, mode ('full' or 'summary'), timings ({wallClockMs, sumOfTaskMs,
+estimatedParallelSavingsMs}), batchProgress ({totalTasks, completedTasks,
+incompleteTasks, failedTasks, successPercent}), and aggregateCost
+({totalActualCostUSD, totalSavedCostUSD, actualCostUnavailableTasks,
+savedCostUnavailableTasks}). If the combined output across tasks is small,
+mode: 'full' with inline outputs; if it exceeds the server's threshold
+(default 64 KB, configurable via env MULTI_MODEL_LARGE_RESPONSE_THRESHOLD_CHARS
+/ config defaults.largeResponseThresholdChars / buildMcpServer option),
+mode: 'summary' with per-task outputLength + outputSha256 + _fetchWith
+hint — fetch individual outputs with get_task_output({ batchId, taskIndex }).
+Set responseMode: 'full' to force inline, 'summary' to force summary, or
+omit for auto-escape.
+
+COVERAGE DECLARATION (v0.3+): For tasks with enumerable deliverables
+(multi-file refactors, test generation across many functions, multi-PR
+review, per-endpoint reports, per-function test stubs, audit checklists),
+set expectedCoverage on the task spec with either minSections: N,
+sectionPattern: '<regex>' (default ^##), or requiredMarkers: [...] — the
+identifier strings that must all appear in the output. The supervision
+layer will re-prompt the model with specific missing items and classify
+thin responses as insufficient_coverage instead of silently accepting them.
+Do NOT set expectedCoverage for one-shot tasks (bug fixes, single
+implementations, prose, creative writing) — the field is opt-in and has
+no meaning for deliverables you can't enumerate ahead of time.
+
+COST + TIME VISIBILITY (v0.3+): Set parentModel on the task spec (e.g.
+'claude-opus-4-6') to get usage.savedCostUSD — the ESTIMATED cost
+difference vs running the same token volume on that parent model.
+Positive means delegation was cheaper. Both usage.costUSD (actual) and
+usage.savedCostUSD (estimate) are estimates for budgeting and debugging,
+not accounting numbers. Per-task durationMs is always populated.
+Batch-level timings.estimatedParallelSavingsMs tells you how much
+wall-clock time concurrent dispatch bought back vs a hypothetical
+serial for-loop. batchProgress.successPercent is a clean-success rate
+(the batch is always 100% done by the time you see the response —
+successPercent measures how many finished cleanly, NOT progress).
+
+PROGRESS TRACE (v0.3+): Set includeProgressTrace: true on the task spec
+to receive a bounded, priority-trimmed trace of the execution timeline
+in the final RunResult.progressTrace. Useful for post-hoc debugging of
+long-running tasks — did the worker loop through supervision retries,
+where did it stall, did it escalate across providers. The trace is
+trimmed at 80 events and 16 KB; text_emission and tool_call events are
+dropped first under pressure (their content is already in output /
+toolCalls). Boundary events (turn_start, turn_complete, escalation_start,
+injection, done) are never dropped. If trimming fired, a synthetic
+_trimmed marker at the end of the trace reports the dropped count and
+per-kind histogram.
+
+NOTE: progress-events at the MCP protocol level (notifications/progress)
+are emitted correctly by the server and delivered to the MCP client.
+Whether your client renders them live depends on the client — some
+render them as in-flight tool-call status lines, others don't surface
+them to the calling LLM at all. includeProgressTrace gives you the
+full timeline post-hoc regardless of your client's live-rendering
+behavior.
+
+AVAILABLE TOOLS: delegate_tasks (this one), register_context_block
+(stash reusable brief content referenced via TaskSpec.contextBlockIds),
+retry_tasks (re-dispatch specific indices from a previous batch),
+get_task_output (fetch individual task outputs when a response was in
+summary mode).`;
 function renderProviderBlock(name, config, capabilities, profile, costSource) {
     const cost = getEffectiveCostTier(config);
     const costSuffix = costSource === 'config' ? ' (from config)' : '';
@@ -58,6 +160,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAqGJ,CAAC;AAEhB,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.4",
+  "version": "0.3.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,8 +49,8 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@zhixuan92/multi-model-agent-core": "^0.1.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@zhixuan92/multi-model-agent-core": "^0.3.0",
     "zod": "^4.0.0"
   }
 }