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

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

@@ -0,0 +1 @@
+{"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,EAA6D,MAAM,qBAAqB,CAAC;AAMpH,qBAAa,WAAW;IACV,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEpC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;CA0E/C"}

package/dist/providers/runner-shell.js

@@ -0,0 +1,78 @@
+const DEFAULT_CAPABILITIES = {
+    cache_control: false, thinking: false, vision: false, tool_use: true, streaming: false, other: [],
+};
+export class RunnerShell {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async run(input) {
+        const ctx = { cwd: input.cwd, callCache: new Map() };
+        const usage = { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 };
+        const allToolCalls = [];
+        const history = [];
+        let finalText = '';
+        let stoppedByAdapter = false;
+        for (let turn = 0; turn < input.maxTurns; turn++) {
+            if (input.abortSignal?.aborted) {
+                return {
+                    workerStatus: 'blocked',
+                    finalAssistantText: '',
+                    toolCalls: allToolCalls,
+                    usage,
+                    errorCode: 'aborted',
+                };
+            }
+            const turnResult = await this.adapter.turn({
+                systemPrompt: input.systemPrompt,
+                userMessage: input.userMessage,
+                priorTurns: history,
+                toolDefinitions: input.toolDefinitions,
+                capabilities: input.capabilities ?? DEFAULT_CAPABILITIES,
+                abortSignal: input.abortSignal,
+                deadlineMs: input.deadlineMs,
+            });
+            usage.inputTokens += turnResult.usage.inputTokens;
+            usage.outputTokens += turnResult.usage.outputTokens;
+            usage.cachedReadTokens += turnResult.usage.cachedReadTokens;
+            usage.cachedNonReadTokens += turnResult.usage.cachedNonReadTokens;
+            finalText = turnResult.assistantText;
+            const turnRecord = {
+                assistantText: turnResult.assistantText,
+                toolCalls: [],
+            };
+            if (turnResult.toolCalls.length === 0) {
+                history.push(turnRecord);
+                stoppedByAdapter = true;
+                break;
+            }
+            for (const call of turnResult.toolCalls) {
+                const def = input.toolDefinitions.find(d => d.name === call.name);
+                let result;
+                if (!def) {
+                    result = { error: `unknown tool: ${call.name}` };
+                }
+                else {
+                    try {
+                        result = await def.execute(call.input, ctx);
+                    }
+                    catch (err) {
+                        result = { error: `tool execution failed: ${err instanceof Error ? err.message : String(err)}` };
+                    }
+                }
+                const enriched = { name: call.name, input: call.input, result };
+                allToolCalls.push(enriched);
+                turnRecord.toolCalls.push(enriched);
+            }
+            history.push(turnRecord);
+        }
+        return {
+            workerStatus: stoppedByAdapter ? 'done' : 'blocked',
+            finalAssistantText: finalText,
+            toolCalls: allToolCalls,
+            usage,
+            ...(stoppedByAdapter ? {} : { errorCode: 'max_turns_exhausted' }),
+        };
+    }
+}
+//# sourceMappingURL=runner-shell.js.map

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

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

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

@@ -0,0 +1,174 @@
+import type { ContextBlockStore } from '../stores/context-block-tool.js';
+import type { AgentType, Effort, FormatConstraints, SandboxPolicy, TaskSpec, ToolMode } from '../types.js';
+import type { ResearchToolDefinition } from '../research/types.js';
+export type RunStatus = 'ok' | 'incomplete' | 'timeout' | 'api_aborted' | 'api_error' | 'provider_transport_failure' | 'error' | 'brief_too_vague' | 'cost_exceeded' | 'unavailable';
+/** Canonical 4-field token-count shape. reasoningTokens are summed into
+ *  outputTokens by each runner before emitting. totalTokens, cachedTokens,
+ *  and per-provider breakdowns are computed on demand — they are not stored. */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cachedReadTokens: number;
+    cachedNonReadTokens: number;
+}
+/** Cost fields kept separate from TokenUsage. These are NOT token counts;
+ *  they live on RunResult alongside usage. */
+export interface CostBreakdown {
+    costUSD: number | null;
+    /** Actual cost minus estimated parent cost. Negative = worker cheaper (savings). */
+    costDeltaVsParentUSD: number | null;
+}
+export interface TerminationReason {
+    /** Why the task stopped. 'finished' means the worker returned normally — check
+     *  workerSelfAssessment for the worker's own view of completion. */
+    cause: 'finished' | 'incomplete' | 'timeout' | 'cost_exceeded' | 'time_ceiling' | 'degenerate_exhausted' | 'api_error' | 'provider_transport_failure' | 'api_aborted' | 'brief_too_vague' | 'error';
+    turnsUsed: number;
+    hasFileArtifacts: boolean;
+    usedShell: boolean;
+    workerSelfAssessment: 'done' | 'done_with_concerns' | 'needs_context' | 'blocked' | 'failed' | 'review_loop_capped' | null;
+    wasPromoted: boolean;
+    /** Wall-clock ms elapsed when the termination condition tripped.
+     *  Populated for time_ceiling aborts; omitted for other causes. */
+    wallClockMs?: number;
+}
+/**
+ * Single provider-attempt record inside an escalation chain. The orchestrator
+ * (`delegateWithEscalation`) pushes one entry per `provider.run(...)` call.
+ */
+export interface AttemptRecord {
+    provider: string;
+    status: RunStatus;
+    turns: number;
+    inputTokens: number;
+    outputTokens: number;
+    costUSD: number | null;
+    /** Character count of the canonical orchestrator-side initial brief. */
+    initialPromptLengthChars: number;
+    /** sha256 hex of the canonical orchestrator-side initial brief. */
+    initialPromptHash: string;
+    /** Why this attempt was abandoned, if it was. Empty if status === 'ok'. */
+    reason?: string;
+}
+export interface RunOptions {
+    tools?: ToolMode;
+    timeoutMs?: number;
+    cwd?: string;
+    effort?: Effort;
+    sandboxPolicy?: SandboxPolicy;
+    expectedCoverage?: TaskSpec['expectedCoverage'];
+    skipCompletionHeuristic?: boolean;
+    /** Optional callback invoked by runners and the escalation orchestrator to
+     *  stream in-flight internal progress events. */
+    onProgress?: (event: InternalRunnerEvent) => void;
+    /** Called exactly once per attempt when the runner has assembled the
+     *  canonical orchestrator-side initial brief. */
+    onInitialRequest?: (meta: {
+        lengthChars: number;
+        sha256: string;
+    }) => void;
+    mainModel?: string;
+    maxCostUSD?: number;
+    formatConstraints?: FormatConstraints;
+    /** External abort signal — when fired, the runner force-salvages and
+     *  returns a `timeout` result via the same path as the per-call timeout.
+     *  Used by the orchestrator's stall watchdog. */
+    abortSignal?: AbortSignal;
+    /** Run mode: 'standard' for normal execution, 'review' for typed
+     *  structured output review via Agent.outputType. Default 'standard'. */
+    runMode?: 'standard' | 'review';
+    /** Optional task-specific tool injection. When present, runners merge
+     *  these tools into the worker's tool surface ON TOP OF whatever
+     *  `tools: ToolMode` would normally produce. Runners MUST treat
+     *  undefined as a no-op. */
+    customToolset?: ResearchToolDefinition[];
+    /** Appended to Agent.instructions (or the equivalent system-level prompt
+     *  in each runner) after the standard prevention-layer system prompt.
+     *  Used by the reviewer path so the stable review rubric sits in the
+     *  system layer (cacheable) while the variable evidence stays in the
+     *  user message. */
+    instructionsSuffix?: string;
+    /** Hints for prompt-cache behaviour. Runners interpret these as
+     *  provider-specific cache markers (e.g. Claude ephemeral cache_control). */
+    cacheHints?: {
+        cacheableSystemPrompt?: boolean;
+    };
+}
+/** Runtime dependencies for `runTasks`. */
+export interface RunTasksRuntime {
+    contextBlockStore?: ContextBlockStore;
+}
+/** Internal progress events emitted by runners and the escalation orchestrator. */
+export type InternalRunnerEvent = {
+    kind: 'worker_start';
+    model: string;
+    providerType: 'claude' | 'claude-compatible' | 'openai' | 'openai-compatible' | 'codex';
+    tier: AgentType;
+} | {
+    kind: 'turn_start';
+    turn: number;
+    provider: string;
+    model: string;
+} | {
+    kind: 'tool_call';
+    turn: number;
+    toolSummary: string;
+} | {
+    kind: 'text_emission';
+    turn: number;
+    chars: number;
+    preview: string;
+} | {
+    kind: 'turn_complete';
+    turn: number;
+    cumulativeInputTokens: number;
+    cumulativeOutputTokens: number;
+    cumulativeCachedReadTokens?: number;
+    cumulativeCachedNonReadTokens?: number;
+    cumulativeReasoningTokens?: number;
+} | {
+    kind: 'injection';
+    injectionType: 'reground' | 'supervise_empty' | 'supervise_thinking' | 'supervise_fragment' | 'supervise_insufficient_coverage';
+    turn: number;
+    contentLengthChars: number;
+} | {
+    kind: 'escalation_start';
+    previousProvider: string;
+    previousReason: string;
+    nextProvider: string;
+} | {
+    kind: 'retry';
+    attempt: number;
+    previousStatus: RunStatus;
+    delayMs: number;
+} | {
+    kind: 'done';
+    status: RunStatus;
+};
+/** Single progress event shape emitted by ActivityTracker during task execution. */
+export type ProgressEvent = {
+    kind: 'heartbeat';
+    elapsed: string;
+    provider: string;
+    idleSinceLlmMs: number;
+    idleSinceToolMs: number;
+    idleSinceTextMs: number;
+    stage: 'implementing' | 'spec_review' | 'spec_rework' | 'quality_review' | 'quality_rework' | 'verifying' | 'diff_review' | 'committing' | 'terminal';
+    stageIndex: number;
+    stageCount: number;
+    reviewRound?: number;
+    attemptCap?: number;
+    progress: {
+        filesRead: number;
+        filesWritten: number;
+        toolCalls: number;
+    };
+    costUSD: number | null;
+    costDeltaVsParentUSD: number | null;
+    final: boolean;
+    headline: string;
+    /** Per-stage idle time (ms since last LLM/tool/text event in the current stage). */
+    stageIdleMs: number;
+    /** Lightweight state snapshot for use by recordHeartbeat to update BatchRegistry. */
+    snapshot: import('../stores/batch-registry.js').HeadlineSnapshot;
+};
+//# sourceMappingURL=runner-types.d.ts.map

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

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

package/dist/providers/runner-types.js

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

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

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

package/dist/providers/scratchpad-salvager.d.ts

@@ -0,0 +1,19 @@
+import type { TextScratchpad } from '../providers/text-scratchpad.js';
+export interface SalvageInput {
+    scratchpad: TextScratchpad;
+    reason: string;
+    provider?: string;
+    model?: string;
+    turnsUsed?: number;
+}
+export interface SalvageResult {
+    output: string;
+    empty: boolean;
+    source: 'latest' | 'longest' | 'diagnostic';
+    diagnostic: string;
+}
+export declare class ScratchpadSalvager {
+    salvage(input: SalvageInput): SalvageResult;
+    private _diagnostic;
+}
+//# sourceMappingURL=scratchpad-salvager.d.ts.map

package/dist/providers/scratchpad-salvager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-salvager.d.ts","sourceRoot":"","sources":["../../src/providers/scratchpad-salvager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAgC3C,OAAO,CAAC,WAAW;CAepB"}

package/dist/providers/scratchpad-salvager.js

@@ -0,0 +1,44 @@
+export class ScratchpadSalvager {
+    salvage(input) {
+        const { scratchpad, reason, provider, model, turnsUsed } = input;
+        const latest = scratchpad.latest();
+        if (latest) {
+            return {
+                output: latest,
+                empty: false,
+                source: 'latest',
+                diagnostic: this._diagnostic(reason, provider, model, turnsUsed, 'latest'),
+            };
+        }
+        const longest = scratchpad.longest();
+        if (longest) {
+            return {
+                output: longest,
+                empty: false,
+                source: 'longest',
+                diagnostic: this._diagnostic(reason, provider, model, turnsUsed, 'longest'),
+            };
+        }
+        const diag = this._diagnostic(reason, provider, model, turnsUsed, 'diagnostic');
+        return {
+            output: diag,
+            empty: true,
+            source: 'diagnostic',
+            diagnostic: diag,
+        };
+    }
+    _diagnostic(reason, provider, model, turnsUsed, source) {
+        const parts = ['[ScratchpadSalvager] agent terminated without a clean final answer'];
+        if (provider)
+            parts.push(`provider=${provider}`);
+        if (model)
+            parts.push(`model=${model}`);
+        parts.push(`reason=${reason}`);
+        if (turnsUsed !== undefined)
+            parts.push(`turns=${turnsUsed}`);
+        if (source)
+            parts.push(`salvageSource=${source}`);
+        return parts.join(' ');
+    }
+}
+//# sourceMappingURL=scratchpad-salvager.js.map

package/dist/providers/scratchpad-salvager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-salvager.js","sourceRoot":"","sources":["../../src/providers/scratchpad-salvager.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,kBAAkB;IAC7B,OAAO,CAAC,KAAmB;QACzB,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QAEjE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC;aAC3E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC;aAC5E,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QAChF,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,IAAI;SACjB,CAAC;IACJ,CAAC;IAEO,WAAW,CACjB,MAAc,EACd,QAAiB,EACjB,KAAc,EACd,SAAkB,EAClB,MAAe;QAEf,MAAM,KAAK,GAAa,CAAC,oEAAoE,CAAC,CAAC;QAC/F,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QACjD,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;QAC/B,IAAI,SAAS,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;QAC9D,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/stall-detector.d.ts

@@ -0,0 +1,22 @@
+/** camelCase tool names (matching tracker.trackToolCall format in definitions.ts)
+ *  that indicate meaningful completed work — file mutations or shell execution. */
+export declare const COMPLETED_WORK_TOOLS: Set<string>;
+/** Maximum consecutive degenerate outputs (empty/thinking-only) before giving up.
+ *  Only counted when the worker has NO `writeFile`/`editFile`/`runShell` yet
+ *  (reads don't count as "completed work"). Workers that read many files before
+ *  they feel ready to write legitimately spend several turns "thinking" first —
+ *  the cap should be generous enough for that pattern. 6 covers heavy-read
+ *  tasks (plan implementation, wide refactors) while still bounding truly-stuck
+ *  runs. Complex-tier runners that hit this cap fast are still bounded by
+ *  maxCostUSD and timeoutMs. */
+export declare const MAX_DEGENERATE_RETRIES = 6;
+/** Number of consecutive turns with no new file interactions before injecting a stall warning. */
+export declare const STALL_DETECTION_TURNS = 5;
+export declare function extractToolName(toolCallEntry: string): string;
+export declare function hasCompletedWork(toolCalls: string[]): boolean;
+/** Detect if the worker is making the same tool calls repeatedly (stuck in a loop). */
+export declare function detectToolCallLoop(toolCalls: string[], windowSize?: number): boolean;
+/** Detect if the worker has stalled — no new file interactions over consecutive turns.
+ *  Caller maintains a counter of consecutive stall turns and resets it when new activity happens. */
+export declare function hasNewFileActivity(filesReadBefore: number, filesWrittenBefore: number, filesReadNow: number, filesWrittenNow: number): boolean;
+//# sourceMappingURL=stall-detector.d.ts.map

package/dist/providers/stall-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detector.d.ts","sourceRoot":"","sources":["../../src/providers/stall-detector.ts"],"names":[],"mappings":"AAKA;mFACmF;AACnF,eAAO,MAAM,oBAAoB,aAAiD,CAAC;AAEnF;;;;;;;gCAOgC;AAChC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAE7D;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,CAQvF;AAED;qGACqG;AACrG,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAET"}

package/dist/providers/stall-detector.js

@@ -0,0 +1,43 @@
+// Stall and tool-call activity heuristics, separate from completion-text
+// heuristics in supervision.ts. Used by the supervision loop and the
+// escalation orchestrator to decide when a worker is stuck (looping,
+// no-new-files, no-completed-work).
+/** camelCase tool names (matching tracker.trackToolCall format in definitions.ts)
+ *  that indicate meaningful completed work — file mutations or shell execution. */
+export const COMPLETED_WORK_TOOLS = new Set(['writeFile', 'editFile', 'runShell']);
+/** Maximum consecutive degenerate outputs (empty/thinking-only) before giving up.
+ *  Only counted when the worker has NO `writeFile`/`editFile`/`runShell` yet
+ *  (reads don't count as "completed work"). Workers that read many files before
+ *  they feel ready to write legitimately spend several turns "thinking" first —
+ *  the cap should be generous enough for that pattern. 6 covers heavy-read
+ *  tasks (plan implementation, wide refactors) while still bounding truly-stuck
+ *  runs. Complex-tier runners that hit this cap fast are still bounded by
+ *  maxCostUSD and timeoutMs. */
+export const MAX_DEGENERATE_RETRIES = 6;
+/** Number of consecutive turns with no new file interactions before injecting a stall warning. */
+export const STALL_DETECTION_TURNS = 5;
+export function extractToolName(toolCallEntry) {
+    const parenIndex = toolCallEntry.indexOf('(');
+    return parenIndex === -1 ? toolCallEntry : toolCallEntry.slice(0, parenIndex);
+}
+export function hasCompletedWork(toolCalls) {
+    return toolCalls.some(tc => COMPLETED_WORK_TOOLS.has(extractToolName(tc)));
+}
+/** Detect if the worker is making the same tool calls repeatedly (stuck in a loop). */
+export function detectToolCallLoop(toolCalls, windowSize = 6) {
+    if (windowSize % 2 !== 0)
+        throw new Error('windowSize must be even');
+    if (toolCalls.length < windowSize)
+        return false;
+    const recent = toolCalls.slice(-windowSize);
+    const half = windowSize / 2;
+    const firstHalf = recent.slice(0, half).join('|');
+    const secondHalf = recent.slice(half).join('|');
+    return firstHalf === secondHalf;
+}
+/** Detect if the worker has stalled — no new file interactions over consecutive turns.
+ *  Caller maintains a counter of consecutive stall turns and resets it when new activity happens. */
+export function hasNewFileActivity(filesReadBefore, filesWrittenBefore, filesReadNow, filesWrittenNow) {
+    return filesReadNow > filesReadBefore || filesWrittenNow > filesWrittenBefore;
+}
+//# sourceMappingURL=stall-detector.js.map

package/dist/providers/stall-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detector.js","sourceRoot":"","sources":["../../src/providers/stall-detector.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qEAAqE;AACrE,qEAAqE;AACrE,oCAAoC;AAEpC;mFACmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnF;;;;;;;gCAOgC;AAChC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,UAAU,eAAe,CAAC,aAAqB;IACnD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAmB;IAClD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAAC,SAAmB,EAAE,aAAqB,CAAC;IAC5E,IAAI,UAAU,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACrE,IAAI,SAAS,CAAC,MAAM,GAAG,UAAU;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC,CAAC;IAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,SAAS,KAAK,UAAU,CAAC;AAClC,CAAC;AAED;qGACqG;AACrG,MAAM,UAAU,kBAAkB,CAChC,eAAuB,EACvB,kBAA0B,EAC1B,YAAoB,EACpB,eAAuB;IAEvB,OAAO,YAAY,GAAG,eAAe,IAAI,eAAe,GAAG,kBAAkB,CAAC;AAChF,CAAC"}

package/dist/providers/supervision.d.ts

@@ -0,0 +1,108 @@
+import type { ProviderConfig } from '../types.js';
+import type { TaskSpec } from '../types.js';
+import type { ModelProfile } from '../config/model-profile-registry.js';
+/**
+ * Sub-agent completion supervision.
+ *
+ * The runner calls validateCompletion() after every turn that ends without
+ * a tool call (the SDK signal "agent done"). If the result is degenerate,
+ * the runner injects a re-prompt and continues the loop instead of returning.
+ *
+ * See docs/superpowers/specs/2026-04-10-subagent-completion-supervision-design.md
+ * Parts A.2.2 and A.4 for the full contract.
+ *
+ * --- @openai/agents SDK introspection finding (from Task 1, Step 1) ---
+ * Happy path confirmed. The `@openai/agents` SDK (via @openai/agents-core)
+ * exposes intermediate assistant text on the returned `RunResult`:
+ *   - `result.newItems: RunItem[]` is a discriminated union where entries of
+ *     type `"message_output_item"` are `RunMessageOutputItem` instances with
+ *     `rawItem.role === "assistant"` and `rawItem.content` carrying
+ *     `{ type: "output_text", text: string }` parts (plus `refusal`, `audio`,
+ *     `image`). See node_modules/@openai/agents-core/dist/items.d.ts around
+ *     line 337 (class RunMessageOutputItem) and dist/result.d.ts lines 17-76
+ *     (RunResultData interface — `newItems`, `output`, `history`, `state`).
+ *   - `result.state` additionally holds the full RunState, and
+ *     StreamedRunResult exposes a `RunStreamEvent` async iterator for
+ *     live mid-run observation if we ever need true streaming.
+ * For our scratchpad needs the non-streaming path is sufficient: after any
+ * `agentRun(...)` call (including iterative re-prompt turns), we can iterate
+ * `result.newItems`, pick every `message_output_item`, concatenate its
+ * `output_text` parts, and append the result to the TextScratchpad. This
+ * gives us full intermediate salvage for openai-runner without dropping to
+ * the lower-level OpenAI client or patching hooks. Task 3 should implement
+ * this salvage extraction.
+ * ----------------------------------------------------------------------
+ */
+/** Classification of a degenerate model response, including coverage failures. */
+export type DegenerateKind = 'empty' | 'thinking_only' | 'fragment' | 'no_terminator' | 'insufficient_coverage';
+export interface ValidationResult {
+    valid: boolean;
+    kind?: DegenerateKind;
+    reason?: string;
+    /** Last 60 characters of the trimmed text, used by buildRePrompt. */
+    tail?: string;
+}
+export interface ValidateCompletionOptions {
+    minLength?: number;
+}
+export declare function validateCoverage(text: string, expected: NonNullable<TaskSpec['expectedCoverage']>): ValidationResult;
+/**
+ * Marker returned by `stripThinkingTags` when the entire final message was
+ * `<think>...` reasoning and stripping left nothing. Exported here
+ * (rather than from openai-runner.ts) so that `validateCompletion` can detect
+ * the marker without importing the runner, and so other runners can reuse it
+ * when they implement their own thinking-only salvage. There is exactly one
+ * canonical constant.
+ */
+export declare const THINKING_DIAGNOSTIC_MARKER = "[model final message contained only <think>...</think> reasoning, no plain-text answer]";
+export declare function validateCompletion(text: string, opts?: ValidateCompletionOptions): ValidationResult;
+export declare function buildRePrompt(result: ValidationResult): string;
+/**
+ * Compares two consecutive degenerate outputs for byte equality. Used by
+ * the supervision loop's same-output early-out: if the model produces
+ * identical garbage twice in a row, give up immediately instead of
+ * burning the third retry.
+ */
+export declare function sameDegenerateOutput(a: string, b: string): boolean;
+/**
+ * Resolves the effective inputTokenSoftLimit for a (provider, profile) pair.
+ *
+ * Precedence: `config.inputTokenSoftLimit` (user override) wins over
+ * `profile.inputTokenSoftLimit` (family default).
+ *
+ * Both fields are Zod-validated upstream:
+ *   - `ProviderConfig.inputTokenSoftLimit` — `z.number().int().positive().optional()`
+ *     (see packages/core/src/config/schema.ts)
+ *   - `ModelProfile.inputTokenSoftLimit` — `z.number().int().positive()` (required)
+ *
+ * Because profile is guaranteed to carry a positive integer (DEFAULT_PROFILE
+ * supplies `100_000` when no prefix matches), there is no hardcoded
+ * constant fallback — the DEFAULT_PROFILE value is the de-facto fallback
+ * for unprofiled model IDs.
+ */
+export declare function resolveInputTokenSoftLimit(config: ProviderConfig, profile: ModelProfile): number;
+/**
+ * Coordinator for sub-agent output validation.
+ *
+ * Priority order (most authoritative first):
+ *
+ *   1. `empty` and `thinking_only` always fail — degeneracy checks.
+ *   2. `expectedCoverage` declared and passes → valid (caller-declared, most trustworthy).
+ *   3. `expectedCoverage` declared and fails → invalid.
+ *   4. `workerStatus: 'done'` + (hasCompletedWork or skipCompletionHeuristic) → valid
+ *      (worker says done AND there's evidence of work or caller opted out).
+ *   5. `workerStatus: 'done'` without work evidence → trust if output passes heuristic.
+ *   6. `workerStatus: 'done_with_concerns'` + hasCompletedWork → valid.
+ *   7. `skipCompletionHeuristic` or `hasCompletedWork` (without workerStatus) → valid.
+ *   8. Fall through to `fragment`/`no_terminator` heuristic (last resort).
+ *
+ * `needs_context` and `blocked` are never auto-validated.
+ */
+export declare function validateSubAgentOutput(text: string, opts?: {
+    expectedCoverage?: TaskSpec['expectedCoverage'];
+    skipCompletionHeuristic?: boolean;
+    workerStatus?: 'done' | 'done_with_concerns' | 'needs_context' | 'blocked';
+    hasCompletedWork?: boolean;
+    hasFileArtifacts?: boolean;
+}): ValidationResult;
+//# sourceMappingURL=supervision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.d.ts","sourceRoot":"","sources":["../../src/providers/supervision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,kFAAkF;AAClF,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,eAAe,GACf,UAAU,GACV,eAAe,GACf,uBAAuB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,GAClD,gBAAgB,CAqClB;AAUD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,4FACoD,CAAC;AA0D5F,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,yBAA8B,GACnC,gBAAgB,CAoDlB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqD9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,GACpB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IACJ,gBAAgB,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAChD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,eAAe,GAAG,SAAS,CAAC;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,GACL,gBAAgB,CAuClB"}