@zhixuan92/multi-model-agent-core 4.3.0 → 4.4.0

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

@@ -1,121 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,44 +0,0 @@
-/**
- * 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.
- */
-import type { FormatConstraints } from '../types.js';
-export declare function buildSystemPrompt(): string;
-export interface BuildBudgetHintOptions {
-    timeoutMs: number;
-    maxCostUSD?: number;
-}
-export declare function buildBudgetHint(opts: BuildBudgetHintOptions): string;
-export declare const RE_GROUNDING_INTERVAL_TURNS = 10;
-export interface BuildReGroundingMessageOptions {
-    originalPromptExcerpt: string;
-    elapsedMs: number;
-    timeoutMs: number;
-    toolCallsSoFar: number;
-    filesReadSoFar: number;
-}
-export declare function buildReGroundingMessage(opts: BuildReGroundingMessageOptions): string;
-export interface BuildBudgetPressureNudgeOptions {
-    inputTokens: number;
-    softLimit: number;
-}
-/**
- * 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 declare function buildBudgetPressureNudge(opts: BuildBudgetPressureNudgeOptions): string;
-export declare function buildFormatConstraintSuffix(constraints: FormatConstraints): string;
-//# sourceMappingURL=prevention.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,108 +0,0 @@
-/**
- * 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

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

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

@@ -1,91 +0,0 @@
-import type { TokenUsage } from './runner-types.js';
-import type { EventEmitter } from '../events/event-emitter.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;
-    /** Bus for per-turn / per-runner-call observability events. When present,
-     *  shell + adapter emit `runner_turn_started` / `runner_response_received`
-     *  / `runner_turn_completed` events so VerboseLogChannel surfaces them
-     *  on stderr in real time during a long task run. */
-    bus?: EventEmitter;
-    /** Identifies the in-flight batch in emitted events. */
-    batchId?: string;
-    /** Identifies which task within a batch is running. Carried through to
-     *  every emitted event so polling can show per-task progress when a
-     *  batch has multiple parallel tasks. */
-    taskIndex?: number;
-    /** Tier label (`'standard'` | `'complex'`) included in emitted events. */
-    tier?: string;
-    /** Provider model id included in emitted events. */
-    model?: string;
-    /** Lifecycle stage label (e.g. 'Implementing', 'Spec review'). Surfaced
-     *  on the running-headline polling response so the main agent's poll
-     *  loop shows which lifecycle stage is currently active. */
-    stageLabel?: string;
-    /** When set, ask the provider to attach a cache_control marker to the
-     *  system prompt so the prefix can be reused by subsequent calls.
-     *  Honored by adapters that expose explicit cache control (Anthropic);
-     *  no-op on adapters that auto-cache (OpenAI) or don't cache (codex). */
-    cacheControl?: {
-        type: 'ephemeral';
-    };
-    /** Wall-clock guard threaded from LifecycleContext. When present, the
-     *  runner-shell calls guard.checkOrThrow() before each tool execution so
-     *  long-running shell/network calls can't drift past the per-task budget. */
-    wallClockGuard?: {
-        checkOrThrow(): void;
-    };
-}
-export interface RunResult {
-    workerStatus: WorkerStatus;
-    finalAssistantText: string;
-    toolCalls: ToolCall[];
-    usage: TokenUsage;
-    errorCode?: ErrorCode;
-    /** Number of LLM turns executed (one per adapter.turn() call). Distinct
-     *  from toolCalls.length — a turn can return multiple tool calls or none. */
-    turns: number;
-    /** Wall-clock for the entire shell.run() invocation. */
-    durationMs: number;
-    /** Files read during this run (paths from successful read_file/readFile tool calls). */
-    filesRead: string[];
-    /** Files written during this run (paths from successful write_file/writeFile/edit_file tool calls). */
-    filesWritten: string[];
-    /** A4b §2a (4.2.2+): worker write attempts that failed the path-validity
-     *  filter — shell heredoc commands, absolute paths, paths containing
-     *  shell metacharacters. NOT real, verifiable disk artifacts. The
-     *  lifecycle layer drains this into LifecycleContext.diagnostics for
-     *  the `writes_unverifiable` daemon-log message; not surfaced on the
-     *  public HTTP envelope. Optional so legacy consumers / mocks compile
-     *  without setting the field. */
-    filesWrittenRejected?: string[];
-    /** USD cost computed from usage tokens and the model's rate card.
-     *  null when the model isn't in the rate-card registry (treated as honest-null
-     *  by the wire, not zero). */
-    costUSD: number | null;
-}
-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

@@ -1 +0,0 @@
-{"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;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,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;IACpB;;;yDAGqD;IACrD,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;6CAEyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;gEAE4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;6EAGyE;IACzE,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IACrC;;iFAE6E;IAC7E,cAAc,CAAC,EAAE;QAAE,YAAY,IAAI,IAAI,CAAA;KAAE,CAAC;CAC3C;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;IACtB;iFAC6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uGAAuG;IACvG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;;qCAMiC;IACjC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;kCAE8B;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;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

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

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

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

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

@@ -1,67 +0,0 @@
-import type { RunInput, RunResult } from './runner-shell-types.js';
-import type { RunnerAdapter, AdapterCapabilities } from './runner-adapter.js';
-export declare function shellCommandWritesFs(command: string): boolean;
-export declare class RunnerShell {
-    private adapter;
-    /** Default model id used for cost computation when input.model is absent.
-     *  Reviewer/annotator engines call shell.run() without setting input.model,
-     *  so without this default every reviewer-side stage would record costUSD=null. */
-    private defaultModel?;
-    constructor(adapter: RunnerAdapter, 
-    /** Default model id used for cost computation when input.model is absent.
-     *  Reviewer/annotator engines call shell.run() without setting input.model,
-     *  so without this default every reviewer-side stage would record costUSD=null. */
-    defaultModel?: string | undefined);
-    run(input: RunInput): Promise<RunResult>;
-    /**
-     * Cache-warmer call: sends one minimal turn with the cached prefix so the
-     * upstream provider's prompt cache writes the prefix. Subsequent fan-out
-     * sub-workers using the same prefix serve from cache.
-     *
-     * The user message is a single token ("ready") and the assistant response
-     * is discarded. For providers that don't honor `cache_control` (codex,
-     * future providers), this still runs but produces no measurable cache
-     * benefit.
-     *
-     * Bounded by an internal 10-min hard cap (5-min soft warning) so a slow
-     * or hanging warmer cannot blow the route's overall wall-clock. On cap
-     * hit, the warmer returns with capHit=true and the dispatcher proceeds
-     * to fan-out WITHOUT cache priming — sub-workers will pay full input
-     * cost but the route still completes (correctness > optimization).
-     */
-    prime(systemPrompt: string, opts: PrimeOptions): Promise<PrimeResult>;
-}
-export interface PrimeOptions {
-    cwd: string;
-    cacheControl?: {
-        type: 'ephemeral';
-    };
-    abortSignal?: AbortSignal;
-    deadlineMs?: number;
-    capabilities?: AdapterCapabilities;
-    bus?: import('../events/event-emitter.js').EventEmitter;
-    batchId?: string;
-    taskIndex?: number;
-    tier?: string;
-    stageLabel?: string;
-}
-export interface PrimeResult {
-    /** Whether the warmer attempted to register a cacheable prefix
-     *  (i.e. opts.cacheControl was set and the call returned). The actual
-     *  cache effectiveness surfaces in subsequent sub-worker
-     *  cachedReadTokens, NOT here — see criteria_fanout_summary's
-     *  totalCachedReadTokens / cacheHitConfirmed. */
-    cacheControlSent: boolean;
-    /** True iff the warmer hit the 10-min hard cap and was force-aborted.
-     *  Dispatcher proceeds to fan-out anyway; sub-workers pay full input
-     *  cost since no cache was primed. */
-    capHit: boolean;
-    durationMs: number;
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-        cachedReadTokens: number;
-        cachedNonReadTokens: number;
-    };
-}
-//# sourceMappingURL=runner-shell.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"runner-shell.d.ts","sourceRoot":"","sources":["../../src/providers/runner-shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAA8B,MAAM,yBAAyB,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAwC,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA0EpH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAaD,qBAAa,WAAW;IAEpB,OAAO,CAAC,OAAO;IACf;;uFAEmF;IACnF,OAAO,CAAC,YAAY,CAAC;gBAJb,OAAO,EAAE,aAAa;IAC9B;;uFAEmF;IAC3E,YAAY,CAAC,EAAE,MAAM,YAAA;IAGzB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAwR9C;;;;;;;;;;;;;;;OAeG;IACG,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CA2G5E;AAQD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IACrC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,GAAG,CAAC,EAAE,OAAO,4BAA4B,EAAE,YAAY,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;qDAIiD;IACjD,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;0CAEsC;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7G"}