@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/providers/openai-responses-adapter.js

@@ -0,0 +1,109 @@
+import OpenAI from 'openai';
+export class OpenAIResponsesAdapter {
+    providerType = 'codex';
+    client;
+    model;
+    maxOutputTokens;
+    constructor(opts) {
+        this.client = new OpenAI({ apiKey: opts.apiKey, baseURL: opts.baseURL });
+        this.model = opts.model;
+        this.maxOutputTokens = opts.maxOutputTokens;
+    }
+    async turn(input) {
+        const inputItems = this.buildInputItems(input);
+        const response = await this.client.responses.create({
+            model: this.model,
+            instructions: input.systemPrompt,
+            input: inputItems,
+            tools: input.toolDefinitions.length > 0
+                ? input.toolDefinitions.map(d => ({
+                    type: 'function',
+                    name: d.name,
+                    description: d.description,
+                    parameters: d.schema,
+                    strict: false,
+                }))
+                : undefined,
+            max_output_tokens: this.maxOutputTokens,
+        });
+        const reasoning = response.usage?.output_tokens_details?.reasoning_tokens ?? 0;
+        const usage = {
+            inputTokens: response.usage?.input_tokens ?? 0,
+            outputTokens: (response.usage?.output_tokens ?? 0) + reasoning,
+            cachedReadTokens: response.usage?.input_tokens_details?.cached_tokens ?? 0,
+            cachedNonReadTokens: 0,
+        };
+        const outputItems = (response.output ?? []);
+        const assistantText = outputItems
+            .filter((it) => it.type === 'message')
+            .flatMap((it) => it.content ?? [])
+            .filter((c) => c.type === 'output_text')
+            .map((c) => c.text)
+            .join('');
+        const toolCalls = outputItems
+            .filter((it) => it.type === 'function_call')
+            .map((it) => {
+            let inputObj;
+            try {
+                inputObj = JSON.parse(it.arguments ?? '{}');
+            }
+            catch (e) {
+                inputObj = {
+                    __mma_invalid_arguments: it.arguments,
+                    __mma_parse_error: e.message,
+                };
+            }
+            return {
+                id: it.call_id,
+                name: it.name,
+                input: inputObj,
+            };
+        });
+        // Compute finishReason: the Responses API uses response.status.
+        // 'completed' means the model produced a final response (stop).
+        // If there are tool calls, the model is waiting for tool outputs.
+        const status = response.status;
+        let finishReason;
+        if (toolCalls.length > 0) {
+            finishReason = 'tool_use';
+        }
+        else if (status === 'completed') {
+            finishReason = 'stop';
+        }
+        else if (status === 'incomplete' || status === 'cancelled') {
+            finishReason = 'max_tokens';
+        }
+        else {
+            finishReason = 'error';
+        }
+        return { assistantText, toolCalls, usage, finishReason };
+    }
+    buildInputItems(input) {
+        const items = [];
+        for (const t of input.priorTurns) {
+            // Assistant message with text content
+            items.push({ role: 'assistant', content: t.assistantText });
+            // Each tool call + its result as a function_call / function_call_output pair.
+            // The Responses API requires both items so the model can see its tool history.
+            for (let ci = 0; ci < t.toolCalls.length; ci++) {
+                const c = t.toolCalls[ci];
+                const callId = c.id ?? `call_${input.priorTurns.indexOf(t)}_${ci}`;
+                items.push({
+                    type: 'function_call',
+                    call_id: callId,
+                    name: c.name,
+                    arguments: JSON.stringify(c.input),
+                });
+                items.push({
+                    type: 'function_call_output',
+                    call_id: callId,
+                    output: typeof c.result === 'string' ? c.result : JSON.stringify(c.result ?? null),
+                });
+            }
+        }
+        // Current user message
+        items.push({ role: 'user', content: input.userMessage });
+        return items;
+    }
+}
+//# sourceMappingURL=openai-responses-adapter.js.map

package/dist/providers/openai-responses-adapter.js.map

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

package/dist/providers/openai-usage-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-usage-interceptor.d.ts","sourceRoot":"","sources":["../../src/providers/openai-usage-interceptor.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,IAAI,aAAa,CAAC;IAC1B;mFAC+E;IAC/E,gBAAgB,IAAI,OAAO,CAAC;CAC7B;AAmBD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAoF1E"}

package/dist/providers/openai-usage-interceptor.js

@@ -0,0 +1,121 @@
+// HTTP-level usage capture for openai-compatible providers, independent of
+// @openai/agents' internal aggregation.
+//
+// Why this exists: the @openai/agents SDK's stream consumer
+// (node_modules/@openai/agents-openai/dist/openaiChatCompletionsStreaming.js
+// line ~38) overwrites its local `usage` variable on every SSE chunk:
+//
+//     usage = chunk.usage || undefined;
+//
+// For OpenAI proper this is benign — only the final `[DONE]`-adjacent chunk
+// carries usage, so the last write is the right one. For DeepSeek (and
+// likely other openai-compatible providers) with multi-turn tool-use, later
+// chunks can have `usage:undefined` AFTER an earlier chunk reported real
+// numbers, wiping the captured usage. The SDK then ends with
+// `state.usage.inputTokens=0`, costUSD=0, despite real tokens having
+// flowed. Telemetry first surfaced this on DeepSeek-as-reviewer calls —
+// every call logged 21+ turns and zero tokens, untraceable until the SDK
+// source was inspected.
+//
+// Fix: wrap the OpenAI client's `chat.completions.create` so we see the
+// raw HTTP response (or the raw SSE stream) BEFORE the SDK consumes it, and
+// accumulate usage into an out-of-band counter the runner can read at
+// result-time as a source-of-truth fallback. The wrapper does not modify
+// SDK-visible behavior — it observes only.
+function addUsage(acc, u) {
+    return {
+        promptTokens: acc.promptTokens + (u.prompt_tokens ?? 0),
+        completionTokens: acc.completionTokens + (u.completion_tokens ?? 0),
+        cachedReadTokens: acc.cachedReadTokens + (u.prompt_tokens_details?.cached_tokens ?? 0),
+        reasoningTokens: acc.reasoningTokens + (u.completion_tokens_details?.reasoning_tokens ?? 0),
+        responses: acc.responses + 1,
+    };
+}
+/** Wrap an OpenAI client so usage from every chat.completions.create response
+ *  is captured into the returned UsageAccumulator.
+ *
+ *  Mutates `client.chat.completions.create` in place. The wrapped client is
+ *  otherwise unchanged — same return shapes, same error behavior. The SDK
+ *  sees the same response stream byte-for-byte (we tee, we don't transform).
+ */
+export function wrapClientForUsageCapture(client) {
+    let acc = {
+        promptTokens: 0,
+        completionTokens: 0,
+        cachedReadTokens: 0,
+        reasoningTokens: 0,
+        responses: 0,
+    };
+    let observedNonZero = false;
+    const observe = (u) => {
+        if (!u)
+            return;
+        const before = acc;
+        acc = addUsage(acc, u);
+        // hasObservedUsage flips true the first time a response carries real
+        // input or output tokens. Counters can stay at 0 for empty responses
+        // (auth failures, immediate refusals) — those don't count as evidence
+        // that the provider IS reporting usage.
+        if ((u.prompt_tokens ?? 0) > 0 || (u.completion_tokens ?? 0) > 0) {
+            observedNonZero = true;
+        }
+        void before;
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const completions = client.chat.completions;
+    const originalCreate = completions.create.bind(completions);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    completions.create = async function wrappedCreate(...args) {
+        const result = await originalCreate(...args);
+        // Non-streaming branch: result is a ChatCompletion object with usage.
+        // Detect via the presence of `choices` (eagerly resolved) and `usage`.
+        if (result && typeof result === 'object' && Array.isArray(result.choices)) {
+            observe(result.usage);
+            return result;
+        }
+        // Streaming branch: result is an AsyncIterable of chunks. We wrap the
+        // iterator so each yielded chunk's usage feeds the accumulator without
+        // changing what the SDK sees.
+        if (result && typeof result[Symbol.asyncIterator] === 'function') {
+            const inner = result;
+            // Build a thin wrapper that preserves the original async-iterable
+            // identity (so the SDK can still .controller-abort if it does), but
+            // observes usage on every chunk that has it. Note: we accumulate the
+            // FIRST non-null usage we see from each request (chunks-with-usage are
+            // typically only 1 per stream, sent on the [DONE] frame). If a
+            // provider sends multiple usage frames, we add each one — that matches
+            // the cumulative semantics.
+            const wrapped = {
+                async *[Symbol.asyncIterator]() {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    let lastUsage;
+                    for await (const chunk of inner) {
+                        if (chunk && chunk.usage) {
+                            lastUsage = chunk.usage;
+                        }
+                        yield chunk;
+                    }
+                    // Accumulate at end-of-stream so multiple intra-stream `usage`
+                    // chunks (DeepSeek behavior) don't double-count. The last seen
+                    // usage is the cumulative-for-this-request value the provider
+                    // wanted us to see.
+                    observe(lastUsage);
+                },
+            };
+            // Some SDK call sites poke at `.controller` on the stream object for
+            // abort handling. Forward it if present.
+            const ctrl = result.controller;
+            if (ctrl !== undefined)
+                wrapped.controller = ctrl;
+            return wrapped;
+        }
+        // Unknown shape (shouldn't happen for chat.completions.create) — pass
+        // through unmodified.
+        return result;
+    };
+    return {
+        snapshot: () => ({ ...acc }),
+        hasObservedUsage: () => observedNonZero,
+    };
+}
+//# sourceMappingURL=openai-usage-interceptor.js.map

package/dist/providers/openai-usage-interceptor.js.map

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

package/dist/providers/prevention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prevention.d.ts","sourceRoot":"","sources":["../../src/providers/prevention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wBAAgB,iBAAiB,IAAI,MAAM,CA8C1C;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAQpE;AAED,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,MAAM,WAAW,8BAA8B;IAC7C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,8BAA8B,GAAG,MAAM,CAWpF;AAED,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,+BAA+B,GAAG,MAAM,CAMtF;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,CAYlF"}

package/dist/providers/prevention.js

@@ -0,0 +1,108 @@
+/**
+ * Sub-agent prevention layer.
+ *
+ * Provides the strong default system prompt, the budget hint preamble,
+ * and the periodic re-grounding message that the runners inject to keep
+ * the model focused. The goal is to make the first attempt succeed.
+ *
+ * All builders here MUST be deterministic: same input → byte-identical
+ * output. No Date.now(), no Math.random(), no environment variable
+ * leakage. Tests in tests/runners/prevention.test.ts assert this.
+ *
+ * See spec Part A.1 for the design rationale.
+ */
+export function buildSystemPrompt() {
+    return [
+        'You are a sub-agent completing a single task end-to-end. Read these rules before you begin any tool calls.',
+        '',
+        'The deliverable. Your final assistant message — and only your final assistant message — is what gets returned to the caller. Intermediate tool outputs and earlier turns are discarded. Your final message must be complete, substantive, and in plain text. Content inside <think> tags is stripped — only plain text reaches the caller.',
+        '',
+        'Plan before you act. Before your first tool call, identify (1) what the task is asking for, (2) its success criteria (output format, required sections, acceptance tests), (3) what files or information you need, and (4) how many tool calls you expect. State this plan in your first assistant message.',
+        '',
+        'Tool rules:',
+        '- Use grep to locate content. Use readFile when you need the full file context that grep cannot provide.',
+        '- Read each file at most once. Note relevant parts in your assistant messages for later reference. Exception: re-read after editing to confirm the edit landed.',
+        '- Use glob to find files by name, then grep to search inside them.',
+        '- Batch grep patterns: use regex alternation (a|b|c) in one call, not separate calls per pattern.',
+        '- Use edit_file to modify part of a file. Provide enough surrounding context in oldContent to match exactly one location. Use write_file only to create new files or rewrite an entire file.',
+        '',
+        'Shell rules:',
+        '- Use run_shell to run tests, build, and execute any command-line task the brief requires.',
+        '- In parallel tasks, run targeted tests (e.g., "npx vitest run tests/specific.test.ts") instead of full suites (e.g., "npm test").',
+        '- Use edit_file or write_file for all file modifications. Shell-based edits (sed, awk, perl -i) are error-prone and not tracked by the harness.',
+        '- Only install packages, run destructive commands, or modify system state when the task explicitly requests it.',
+        '',
+        'Progress and completion:',
+        '- Write findings as you discover them in your assistant turns. This is saved in the scratchpad and recovered if the run is interrupted.',
+        '- Always execute tool calls you describe. If you write "let me check X next", call the tool immediately or produce your final answer.',
+        '- If you hit a problem (tool failure, missing file, unclear task), produce a partial answer explaining what you found and what blocked you.',
+        '',
+        'Output format: if the task specifies a format, follow it exactly. Match headers, table structures, prefixes (e.g., "start with # Gap Report:"), and section order. The caller validates the format.',
+        '',
+        'If you wrote, modified, or deleted files, your structured report MUST include a `commit:` block as a JSON object with these fields:',
+        '',
+        '  {',
+        '    "type": "feat" | "fix" | "refactor" | "test" | "docs" | "chore" | "style",',
+        '    "scope": "<optional, 1-24 chars: lowercase letters, digits, dot, underscore, slash, hyphen; must start with letter or digit>",',
+        '    "subject": "<1-50 chars, lowercase first letter, no trailing colon, no leading/trailing whitespace>",',
+        '    "body": "<optional multi-paragraph plain text explaining WHY>"',
+        '  }',
+        '',
+        'Examples:',
+        '  type: "feat", scope: "core", subject: "add x"',
+        '  type: "refactor", scope: "lifecycle", subject: "extract Y from Z"',
+        '  type: "fix", subject: "guard against undefined"',
+        '',
+        'Do NOT write narrative ("Now I\'m going to...") in the subject. The runner will compose `<type>(<scope>): <subject>` as the commit message; your subject becomes the commit subject line verbatim.',
+        '',
+        'If you did not write any files, omit the commit block entirely.',
+    ].join('\n');
+}
+export function buildBudgetHint(opts) {
+    const timeMin = Math.round(opts.timeoutMs / 60_000);
+    const parts = [`Budget: you have ${timeMin} minutes for this task.`];
+    if (opts.maxCostUSD !== undefined) {
+        parts.push(`Cost ceiling: $${opts.maxCostUSD}.`);
+    }
+    parts.push('Work efficiently. Write findings as you go.');
+    return parts.join(' ');
+}
+export const RE_GROUNDING_INTERVAL_TURNS = 10;
+export function buildReGroundingMessage(opts) {
+    const excerpt = opts.originalPromptExcerpt.slice(0, 200);
+    const elapsedMin = Math.round(opts.elapsedMs / 60_000);
+    const totalMin = Math.round(opts.timeoutMs / 60_000);
+    return [
+        `Reminder: your task is "${excerpt}${opts.originalPromptExcerpt.length > 200 ? '...' : ''}".`,
+        `Elapsed: ${elapsedMin} of ${totalMin} minutes.`,
+        `Tool calls: ${opts.toolCallsSoFar}. Files read: ${opts.filesReadSoFar}.`,
+        'Start drafting your final answer now.',
+        'Use your remaining time to fill gaps, then finalize.',
+    ].join(' ');
+}
+/**
+ * Nudge message the runner injects when the watchdog crosses its
+ * `warning` threshold (see supervision.checkWatchdogThreshold). The text
+ * is deliberately terse: the model is already close to the soft limit, so
+ * we tell it to stop exploring and produce a final answer from whatever
+ * it has gathered. Kept here so every runner (openai, claude, codex)
+ * uses byte-identical wording.
+ */
+export function buildBudgetPressureNudge(opts) {
+    return (`Budget pressure: you have used approximately ${opts.inputTokens} ` +
+        `input tokens out of a soft limit of ${opts.softLimit}. ` +
+        `Produce your complete final answer now with whatever you have gathered.`);
+}
+export function buildFormatConstraintSuffix(constraints) {
+    if (!constraints.inputFormat && !constraints.outputFormat)
+        return '';
+    const parts = [];
+    if (constraints.inputFormat) {
+        parts.push(`input format: ${constraints.inputFormat}`);
+    }
+    if (constraints.outputFormat) {
+        parts.push(`output format: ${constraints.outputFormat}`);
+    }
+    return '\n\n' + parts.join(' ');
+}
+//# sourceMappingURL=prevention.js.map

package/dist/providers/prevention.js.map

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

package/dist/providers/provider-factory.d.ts

@@ -0,0 +1,13 @@
+import type { AgentType, Provider, MultiModelConfig } from '../types.js';
+import type { RunnerAdapter } from './runner-adapter.js';
+export declare function __setCoreTestProviderOverride(provider: Provider | null): void;
+export declare function __setCoreTestProviderOverrideMap(map: Map<string, Provider> | null): void;
+export declare function buildAdapter(agentConfig: {
+    type: 'openai-compatible' | 'claude' | 'claude-compatible' | 'codex';
+    model: string;
+    baseUrl?: string;
+    apiKey?: string;
+    apiKeyEnv?: string;
+}): RunnerAdapter;
+export declare function createProvider(slot: AgentType, config: MultiModelConfig): Provider;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/providers/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/providers/provider-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAa,gBAAgB,EAAkB,MAAM,aAAa,CAAC;AAOpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAG7E;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,IAAI,CAGxF;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE;IACxC,IAAI,EAAE,mBAAmB,GAAG,QAAQ,GAAG,mBAAmB,GAAG,OAAO,CAAC;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,aAAa,CA+BhB;AAQD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CA4ElF"}

package/dist/providers/provider-factory.js

@@ -0,0 +1,127 @@
+import { RunnerShell } from './runner-shell.js';
+import { AnthropicMessagesAdapter } from './anthropic-messages-adapter.js';
+import { OpenAIChatAdapter } from './openai-chat-adapter.js';
+import { OpenAIResponsesAdapter } from './openai-responses-adapter.js';
+import { makeToolDefinitions } from './tool-definitions.js';
+let coreTestProviderOverride = null;
+let coreTestProviderOverrideMap = null;
+function assertTestProviderEnabled() {
+    if (process.env.MMAGENT_TEST_PROVIDER_OVERRIDE !== '1') {
+        throw new Error('MMAGENT_TEST_PROVIDER_OVERRIDE must be set to 1 to use the test provider override');
+    }
+}
+export function __setCoreTestProviderOverride(provider) {
+    assertTestProviderEnabled();
+    coreTestProviderOverride = provider;
+}
+export function __setCoreTestProviderOverrideMap(map) {
+    assertTestProviderEnabled();
+    coreTestProviderOverrideMap = map;
+}
+export function buildAdapter(agentConfig) {
+    const apiKey = agentConfig.apiKey
+        ?? (agentConfig.apiKeyEnv ? process.env[agentConfig.apiKeyEnv] : undefined);
+    const maxOutputTokens = 4096;
+    switch (agentConfig.type) {
+        case 'claude':
+        case 'claude-compatible':
+            return new AnthropicMessagesAdapter({
+                apiKey: apiKey || 'not-needed',
+                baseURL: agentConfig.baseUrl,
+                model: agentConfig.model,
+                maxOutputTokens,
+                providerType: agentConfig.type,
+            });
+        case 'openai-compatible':
+            return new OpenAIChatAdapter({
+                apiKey: apiKey || 'not-needed',
+                baseURL: agentConfig.baseUrl,
+                model: agentConfig.model,
+                maxOutputTokens,
+                providerType: 'openai-compatible',
+            });
+        case 'codex':
+            return new OpenAIResponsesAdapter({
+                apiKey: apiKey || 'not-needed',
+                baseURL: agentConfig.baseUrl,
+                model: agentConfig.model,
+                maxOutputTokens,
+            });
+    }
+}
+const SYSTEM_PROMPT = [
+    'You are a software engineering agent with access to file-system and shell tools.',
+    'Work step-by-step. Read files before editing them.',
+    'When you have completed the task, produce a final answer summarizing what you did.',
+].join('\n');
+export function createProvider(slot, config) {
+    if (coreTestProviderOverrideMap?.has(slot))
+        return coreTestProviderOverrideMap.get(slot);
+    if (coreTestProviderOverride)
+        return coreTestProviderOverride;
+    const agentConfig = config.agents[slot];
+    if (!agentConfig) {
+        throw new Error(`Unknown agent slot: "${slot}". Config must have "standard" and "complex".`);
+    }
+    const providerConfig = agentConfig;
+    const defaults = config.defaults;
+    const run = async (prompt, options = {}) => {
+        try {
+            const cwd = options.cwd ?? process.cwd();
+            const toolMode = options.tools ?? defaults.tools ?? 'full';
+            const maxTurns = 50;
+            const toolDefinitions = toolMode !== 'none'
+                ? makeToolDefinitions({ cwd })
+                : [];
+            const effectiveSystemPrompt = options.instructionsSuffix
+                ? `${SYSTEM_PROMPT}\n\n${options.instructionsSuffix}`
+                : SYSTEM_PROMPT;
+            const adapter = buildAdapter(agentConfig);
+            const shell = new RunnerShell(adapter);
+            const result = await shell.run({
+                systemPrompt: effectiveSystemPrompt,
+                userMessage: prompt,
+                toolDefinitions,
+                maxTurns,
+                cwd,
+            });
+            const toolCallSummaries = result.toolCalls.map(tc => {
+                const inputPreview = typeof tc.input === 'object' && tc.input !== null
+                    ? JSON.stringify(tc.input).slice(0, 120)
+                    : String(tc.input ?? '').slice(0, 120);
+                return `${tc.name}(${inputPreview})`;
+            });
+            return {
+                output: result.finalAssistantText,
+                status: result.workerStatus === 'done' ? 'ok' : 'incomplete',
+                usage: result.usage,
+                turns: result.toolCalls.length,
+                filesRead: [],
+                filesWritten: [],
+                toolCalls: toolCallSummaries,
+                outputIsDiagnostic: false,
+                escalationLog: [],
+                parsedFindings: null,
+                workerStatus: result.workerStatus,
+                errorCode: result.errorCode,
+            };
+        }
+        catch (err) {
+            return {
+                output: `Sub-agent error: ${err instanceof Error ? err.message : String(err)}`,
+                status: 'error',
+                usage: { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 },
+                turns: 0,
+                filesRead: [],
+                filesWritten: [],
+                toolCalls: [],
+                outputIsDiagnostic: true,
+                escalationLog: [],
+                parsedFindings: null,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    };
+    return { name: slot, config: providerConfig, run };
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/providers/provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","sourceRoot":"","sources":["../../src/providers/provider-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,IAAI,wBAAwB,GAAoB,IAAI,CAAC;AACrD,IAAI,2BAA2B,GAAiC,IAAI,CAAC;AAErE,SAAS,yBAAyB;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,GAAG,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAyB;IACrE,yBAAyB,EAAE,CAAC;IAC5B,wBAAwB,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,GAAiC;IAChF,yBAAyB,EAAE,CAAC;IAC5B,2BAA2B,GAAG,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAM5B;IACC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM;WAC5B,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAG,IAAI,CAAC;IAE7B,QAAQ,WAAW,CAAC,IAAI,EAAE,CAAC;QACzB,KAAK,QAAQ,CAAC;QACd,KAAK,mBAAmB;YACtB,OAAO,IAAI,wBAAwB,CAAC;gBAClC,MAAM,EAAE,MAAM,IAAI,YAAY;gBAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,eAAe;gBACf,YAAY,EAAE,WAAW,CAAC,IAAI;aAC/B,CAAC,CAAC;QACL,KAAK,mBAAmB;YACtB,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,MAAM,EAAE,MAAM,IAAI,YAAY;gBAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,eAAe;gBACf,YAAY,EAAE,mBAAmB;aAClC,CAAC,CAAC;QACL,KAAK,OAAO;YACV,OAAO,IAAI,sBAAsB,CAAC;gBAChC,MAAM,EAAE,MAAM,IAAI,YAAY;gBAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,eAAe;aAChB,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,MAAM,aAAa,GAAG;IACpB,kFAAkF;IAClF,oDAAoD;IACpD,oFAAoF;CACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,MAAwB;IACtE,IAAI,2BAA2B,EAAE,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IAC1F,IAAI,wBAAwB;QAAE,OAAO,wBAAwB,CAAC;IAE9D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,+CAA+C,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,cAAc,GAAG,WAAwC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEjC,MAAM,GAAG,GAAG,KAAK,EAAE,MAAc,EAAE,UAAsB,EAAE,EAAsB,EAAE;QACjF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,IAAI,MAAM,CAAC;YAC3D,MAAM,QAAQ,GAAG,EAAE,CAAC;YAEpB,MAAM,eAAe,GAAG,QAAQ,KAAK,MAAM;gBACzC,CAAC,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC;gBAC9B,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,qBAAqB,GAAG,OAAO,CAAC,kBAAkB;gBACtD,CAAC,CAAC,GAAG,aAAa,OAAO,OAAO,CAAC,kBAAkB,EAAE;gBACrD,CAAC,CAAC,aAAa,CAAC;YAElB,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;YAEvC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC;gBAC7B,YAAY,EAAE,qBAAqB;gBACnC,WAAW,EAAE,MAAM;gBACnB,eAAe;gBACf,QAAQ;gBACR,GAAG;aACJ,CAAC,CAAC;YAEH,MAAM,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;gBAClD,MAAM,YAAY,GAAG,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,IAAI,EAAE,CAAC,KAAK,KAAK,IAAI;oBACpE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACxC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACzC,OAAO,GAAG,EAAE,CAAC,IAAI,IAAI,YAAY,GAAG,CAAC;YACvC,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,kBAAkB;gBACjC,MAAM,EAAE,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;gBAC5D,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;gBAC9B,SAAS,EAAE,EAAE;gBACb,YAAY,EAAE,EAAE;gBAChB,SAAS,EAAE,iBAAiB;gBAC5B,kBAAkB,EAAE,KAAK;gBACzB,aAAa,EAAE,EAAE;gBACjB,cAAc,EAAE,IAAI;gBACpB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBAC9E,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE;gBACvF,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,EAAE;gBACb,YAAY,EAAE,EAAE;gBAChB,SAAS,EAAE,EAAE;gBACb,kBAAkB,EAAE,IAAI;gBACxB,aAAa,EAAE,EAAE;gBACjB,cAAc,EAAE,IAAI;gBACpB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;AACrD,CAAC"}

package/dist/providers/runner-adapter.d.ts

@@ -0,0 +1,42 @@
+import type { TokenUsage } from '../providers/runner-types.js';
+import type { ToolDefinition } from './runner-shell-types.js';
+export interface AdapterTurnRecord {
+    assistantText: string;
+    toolCalls: Array<{
+        name: string;
+        input: unknown;
+        result: unknown;
+    }>;
+}
+export interface AdapterTurnInput {
+    systemPrompt: string;
+    userMessage: string;
+    priorTurns: AdapterTurnRecord[];
+    toolDefinitions: ToolDefinition[];
+    capabilities: AdapterCapabilities;
+    abortSignal?: AbortSignal;
+    deadlineMs?: number;
+}
+export interface AdapterTurnResult {
+    assistantText: string;
+    toolCalls: {
+        name: string;
+        input: unknown;
+    }[];
+    usage: TokenUsage;
+    finishReason: 'stop' | 'tool_use' | 'max_tokens' | 'error';
+    errorCode?: string;
+}
+export interface AdapterCapabilities {
+    cache_control: boolean;
+    thinking: boolean;
+    vision: boolean;
+    tool_use: boolean;
+    streaming: boolean;
+    other: string[];
+}
+export interface RunnerAdapter {
+    readonly providerType: 'claude' | 'claude-compatible' | 'openai' | 'openai-compatible' | 'codex';
+    turn(input: AdapterTurnInput): Promise<AdapterTurnResult>;
+}
+//# sourceMappingURL=runner-adapter.d.ts.map

package/dist/providers/runner-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-adapter.d.ts","sourceRoot":"","sources":["../../src/providers/runner-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,YAAY,EAAE,mBAAmB,CAAC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC9C,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,QAAQ,GAAG,mBAAmB,GAAG,QAAQ,GAAG,mBAAmB,GAAG,OAAO,CAAC;IACjG,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D"}

package/dist/providers/runner-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner-adapter.js.map

package/dist/providers/runner-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-adapter.js","sourceRoot":"","sources":["../../src/providers/runner-adapter.ts"],"names":[],"mappings":""}

package/dist/providers/runner-shell-types.d.ts

@@ -0,0 +1,37 @@
+import type { TokenUsage } from './runner-types.js';
+export type WorkerStatus = 'done' | 'done_with_concerns' | 'needs_context' | 'blocked' | 'failed';
+export interface RunInput {
+    systemPrompt: string;
+    userMessage: string;
+    toolDefinitions: ToolDefinition[];
+    maxTurns: number;
+    cwd: string;
+    capabilities?: import('./runner-adapter.js').AdapterCapabilities;
+    abortSignal?: AbortSignal;
+    deadlineMs?: number;
+}
+export interface RunResult {
+    workerStatus: WorkerStatus;
+    finalAssistantText: string;
+    toolCalls: ToolCall[];
+    usage: TokenUsage;
+    errorCode?: ErrorCode;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    schema: object;
+    execute(input: unknown, ctx: ExecutionContext): Promise<unknown>;
+}
+export interface ExecutionContext {
+    cwd: string;
+    callCache: Map<string, unknown>;
+}
+export interface ToolCall {
+    name: string;
+    input: unknown;
+    result?: unknown;
+    id?: string;
+}
+export type ErrorCode = string;
+//# sourceMappingURL=runner-shell-types.d.ts.map

package/dist/providers/runner-shell-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-shell-types.d.ts","sourceRoot":"","sources":["../../src/providers/runner-shell-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,oBAAoB,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElG,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,qBAAqB,EAAE,mBAAmB,CAAC;IACjE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC"}

package/dist/providers/runner-shell-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner-shell-types.js.map

package/dist/providers/runner-shell-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-shell-types.js","sourceRoot":"","sources":["../../src/providers/runner-shell-types.ts"],"names":[],"mappings":""}

package/dist/providers/runner-shell.d.ts

@@ -0,0 +1,8 @@
+import type { RunInput, RunResult } from './runner-shell-types.js';
+import type { RunnerAdapter } from './runner-adapter.js';
+export declare class RunnerShell {
+    private adapter;
+    constructor(adapter: RunnerAdapter);
+    run(input: RunInput): Promise<RunResult>;
+}
+//# sourceMappingURL=runner-shell.d.ts.map