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

package/dist/providers/supervision.d.ts

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

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

package/dist/providers/supervision.js

@@ -1,272 +0,0 @@
-export function validateCoverage(text, expected) {
-    if (expected.minSections !== undefined) {
-        const pattern = expected.sectionPattern ?? '^## ';
-        let re;
-        try {
-            re = new RegExp(pattern, 'gm');
-        }
-        catch (err) {
-            return {
-                valid: false,
-                kind: 'insufficient_coverage',
-                reason: `invalid sectionPattern regex: ${err instanceof Error ? err.message : String(err)}`,
-            };
-        }
-        const count = (text.match(re) ?? []).length;
-        if (count < expected.minSections) {
-            return {
-                valid: false,
-                kind: 'insufficient_coverage',
-                reason: `only ${count} sections found, expected at least ${expected.minSections}`,
-            };
-        }
-    }
-    if (expected.requiredMarkers?.length) {
-        const missing = expected.requiredMarkers.filter((marker) => !text.includes(marker));
-        if (missing.length > 0) {
-            const preview = missing.slice(0, 5).join(', ');
-            const extra = missing.length > 5 ? ` (+${missing.length - 5} more)` : '';
-            return {
-                valid: false,
-                kind: 'insufficient_coverage',
-                reason: `only ${expected.requiredMarkers.length - missing.length} of ${expected.requiredMarkers.length} required markers found, missing: ${preview}${extra}`,
-            };
-        }
-    }
-    return { valid: true };
-}
-const DEFAULT_MIN_LENGTH = 10;
-/** Tail window (chars) inspected by `endsWithContinuation` for continuation phrases. */
-const CONTINUATION_TAIL_WINDOW = 80;
-/** Tail length (chars) quoted back to the model in the re-prompt via `result.tail`. */
-const REPROMPT_TAIL_QUOTE = 60;
-/**
- * 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 const THINKING_DIAGNOSTIC_MARKER = '[model final message contained only <think>...</think> reasoning, no plain-text answer]';
-const CONTINUATION_PHRASES = [
-    'let me',
-    'let me check',
-    'let me read',
-    'let me look',
-    'next i',
-    "i'll continue",
-    'i need to',
-    "now i'll",
-    'i should also',
-    'checking',
-    "i'll now",
-];
-const FRAGMENT_PUNCTUATION = [':', ',', '…'];
-const TERMINAL_PUNCTUATION = ['.', '!', '?', '`', ')', ']', '}'];
-const MARKDOWN_HINTS = [/^#{1,6} /m, /^- /m, /^\d+\. /m, /```/];
-function endsWithContinuation(tail) {
-    const lower = tail.toLowerCase();
-    return CONTINUATION_PHRASES.some((p) => lower.endsWith(p) || lower.includes(p));
-}
-function endsWithFragmentPunctuation(text) {
-    const trimmed = text.trimEnd();
-    return FRAGMENT_PUNCTUATION.some((p) => trimmed.endsWith(p));
-}
-function hasMarkdownStructure(text) {
-    return MARKDOWN_HINTS.some((re) => re.test(text));
-}
-function endsWithTerminalPunctuation(text) {
-    const trimmed = text.trimEnd();
-    if (trimmed.length === 0)
-        return false;
-    const last = trimmed[trimmed.length - 1];
-    return TERMINAL_PUNCTUATION.includes(last);
-}
-// Detector order:
-//   empty → thinking_only → fragment (always, up to FRAGMENT_MAX_LENGTH) →
-//   long-enough → markdown → no_terminator.
-//
-// Fragment detection runs BEFORE the length auto-accept because "let me check..."
-// and "Here is what I found:" are real mid-work stalls regardless of length.
-// But we cap it at FRAGMENT_MAX_LENGTH so a 500-char response that happens to
-// contain "let me" deep inside isn't falsely rejected.
-//
-// The no_terminator check only fires for very short responses (< DEFAULT_MIN_LENGTH)
-// since it's low-value — most short complete answers end with punctuation naturally.
-/** Fragment detection applies to text under this length. Above it, continuation
- *  phrases in the tail are likely part of a valid longer response. */
-const FRAGMENT_MAX_LENGTH = 120;
-export function validateCompletion(text, opts = {}) {
-    const minLength = opts.minLength ?? DEFAULT_MIN_LENGTH;
-    if (!text || text.trim().length === 0) {
-        return { valid: false, kind: 'empty', reason: 'response was empty' };
-    }
-    if (text.trim() === THINKING_DIAGNOSTIC_MARKER) {
-        return {
-            valid: false,
-            kind: 'thinking_only',
-            reason: 'response contained only <think> reasoning content',
-        };
-    }
-    const trimmed = text.trim();
-    const tail = trimmed.slice(-CONTINUATION_TAIL_WINDOW);
-    // Fragment detection: catches real mid-work stalls ("let me check...",
-    // "Here is what I found:") regardless of length, up to FRAGMENT_MAX_LENGTH.
-    // Above that cap, continuation phrases are likely part of a valid response.
-    if (trimmed.length < FRAGMENT_MAX_LENGTH) {
-        if (endsWithFragmentPunctuation(trimmed) || endsWithContinuation(tail)) {
-            return {
-                valid: false,
-                kind: 'fragment',
-                reason: 'response ends like an exploration fragment',
-                tail: trimmed.slice(-REPROMPT_TAIL_QUOTE),
-            };
-        }
-    }
-    // Long enough → trust the response.
-    if (trimmed.length >= minLength) {
-        return { valid: true };
-    }
-    // Very short responses (< minLength, currently 10 chars): valid only with
-    // markdown structure or terminal punctuation.
-    if (hasMarkdownStructure(trimmed)) {
-        return { valid: true };
-    }
-    if (!endsWithTerminalPunctuation(trimmed)) {
-        return {
-            valid: false,
-            kind: 'no_terminator',
-            reason: 'response is very short and has no terminal punctuation or markdown structure',
-            tail: trimmed.slice(-REPROMPT_TAIL_QUOTE),
-        };
-    }
-    return { valid: true };
-}
-export function buildRePrompt(result) {
-    if (result.valid) {
-        throw new Error('buildRePrompt called on a valid response — this is a bug');
-    }
-    switch (result.kind) {
-        case 'empty':
-            return [
-                'Your previous response was empty. You did not produce a final answer to the task',
-                'and did not call any tools. Please respond again with your complete final answer',
-                'as plain text in this assistant message. The final answer is what gets returned',
-                'to the caller — there are no follow-up turns after you produce it. If you are not',
-                'yet done, call the tools you need first; otherwise produce the final answer now.',
-            ].join(' ');
-        case 'thinking_only':
-            return [
-                'Your previous response contained only <think>... reasoning, with no',
-                'plain-text answer outside the tags. The reasoning tags are stripped before the',
-                'response is returned to the caller, so a thinking-only response is equivalent',
-                'to no response at all. Please respond again with your complete final answer as',
-                'plain text outside any reasoning tags.',
-            ].join(' ');
-        case 'fragment': {
-            const tail = result.tail ?? '';
-            return [
-                `Your previous response was an exploration fragment (it ended with "${tail}")`,
-                'rather than a final answer. You appear to have stopped mid-thought instead of',
-                'completing the task. Either: (a) continue exploring by calling the tools you',
-                'need, then produce your final answer, or (b) produce your complete final answer',
-                'now with whatever you have gathered so far — partial answers are acceptable and',
-                'useful, empty responses are not. Your final answer must be a plain-text',
-                'assistant message, not a tool call and not a thinking block.',
-            ].join(' ');
-        }
-        case 'no_terminator': {
-            const tail = result.tail ?? '';
-            return [
-                `Your previous response appears to have stopped mid-thought (it ended with`,
-                `"${tail}"). Please produce your complete final answer with terminal punctuation`,
-                'or proper markdown structure. If you are still working, call the tools you need',
-                'first; otherwise produce the final answer now.',
-            ].join(' ');
-        }
-        case 'insufficient_coverage':
-            return `Your previous answer was structurally valid but does not cover everything the brief required: ${result.reason}. Continue your report by addressing the missing items. Do NOT restart from the beginning — append the missing sections to what you already wrote.`;
-        default:
-            return 'Your previous response was incomplete. Please produce your complete final answer as plain text.';
-    }
-}
-/**
- * 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 function sameDegenerateOutput(a, b) {
-    return a.trim() === b.trim();
-}
-/**
- * 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 function resolveInputTokenSoftLimit(config, profile) {
-    return config.inputTokenSoftLimit ?? profile.inputTokenSoftLimit;
-}
-/**
- * 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 function validateSubAgentOutput(text, opts = {}) {
-    // 1. Degeneracy checks
-    const completion = validateCompletion(text);
-    if (!completion.valid &&
-        (completion.kind === 'empty' || completion.kind === 'thinking_only')) {
-        return completion;
-    }
-    // 2-3. expectedCoverage — most authoritative when declared
-    if (opts.expectedCoverage) {
-        const coverage = validateCoverage(text, opts.expectedCoverage);
-        if (!coverage.valid)
-            return coverage;
-        return { valid: true };
-    }
-    // 4. workerStatus: 'done' + work evidence → trust it
-    if (opts.workerStatus === 'done' && (opts.hasCompletedWork || opts.hasFileArtifacts || opts.skipCompletionHeuristic)) {
-        return { valid: true };
-    }
-    // 5. workerStatus: 'done' without evidence → trust if output passes heuristic
-    if (opts.workerStatus === 'done') {
-        return completion;
-    }
-    // 6. done_with_concerns + work evidence → trust it
-    if (opts.workerStatus === 'done_with_concerns' && (opts.hasCompletedWork || opts.hasFileArtifacts)) {
-        return { valid: true };
-    }
-    // 7. skipCompletionHeuristic or hasCompletedWork without workerStatus
-    if (opts.skipCompletionHeuristic || opts.hasCompletedWork) {
-        return { valid: true };
-    }
-    // 8. Fall through to heuristic
-    return completion;
-}
-//# sourceMappingURL=supervision.js.map

package/dist/providers/supervision.js.map

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

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

@@ -1,28 +0,0 @@
-/**
- * TextScratchpad — accumulates assistant text emissions across turns of a
- * sub-agent run. The runner appends text from each turn so that, on any
- * termination (clean exit, abort, timeout, error), the salvage layer can
- * return the best buffered text instead of an empty string.
- *
- * See docs/superpowers/specs/2026-04-10-subagent-completion-supervision-design.md
- * Part A.2.1 for the design rationale.
- */
-export declare class TextScratchpad {
-    private turns;
-    /** Record a non-empty text emission for the given turn. Empty/whitespace
-     *  emissions are ignored — they have no salvage value. */
-    append(turn: number, text: string): void;
-    isEmpty(): boolean;
-    /** All buffered text concatenated, in turn order, separated by a fixed
-     *  delimiter. Used as the salvage payload when no clean final answer
-     *  was produced. */
-    toString(): string;
-    /** The most recent buffered emission. Empty string if isEmpty(). */
-    latest(): string;
-    /** The longest buffered emission across all turns. Empty string if
-     *  isEmpty(). Used by the escalation layer to pick the best salvageable
-     *  result across multiple provider attempts. */
-    longest(): string;
-    reset(): void;
-}
-//# sourceMappingURL=text-scratchpad.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"text-scratchpad.d.ts","sourceRoot":"","sources":["../../src/providers/text-scratchpad.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAwC;IAErD;8DAC0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxC,OAAO,IAAI,OAAO;IAIlB;;wBAEoB;IACpB,QAAQ,IAAI,MAAM;IAIlB,oEAAoE;IACpE,MAAM,IAAI,MAAM;IAIhB;;oDAEgD;IAChD,OAAO,IAAI,MAAM;IASjB,KAAK,IAAI,IAAI;CAGd"}

package/dist/providers/text-scratchpad.js

@@ -1,49 +0,0 @@
-/**
- * TextScratchpad — accumulates assistant text emissions across turns of a
- * sub-agent run. The runner appends text from each turn so that, on any
- * termination (clean exit, abort, timeout, error), the salvage layer can
- * return the best buffered text instead of an empty string.
- *
- * See docs/superpowers/specs/2026-04-10-subagent-completion-supervision-design.md
- * Part A.2.1 for the design rationale.
- */
-export class TextScratchpad {
-    turns = [];
-    /** Record a non-empty text emission for the given turn. Empty/whitespace
-     *  emissions are ignored — they have no salvage value. */
-    append(turn, text) {
-        if (!text || text.trim().length === 0)
-            return;
-        this.turns.push({ turn, text });
-    }
-    isEmpty() {
-        return this.turns.length === 0;
-    }
-    /** All buffered text concatenated, in turn order, separated by a fixed
-     *  delimiter. Used as the salvage payload when no clean final answer
-     *  was produced. */
-    toString() {
-        return this.turns.map((t) => t.text).join('\n\n---\n\n');
-    }
-    /** The most recent buffered emission. Empty string if isEmpty(). */
-    latest() {
-        return this.turns.length === 0 ? '' : this.turns[this.turns.length - 1].text;
-    }
-    /** The longest buffered emission across all turns. Empty string if
-     *  isEmpty(). Used by the escalation layer to pick the best salvageable
-     *  result across multiple provider attempts. */
-    longest() {
-        if (this.turns.length === 0)
-            return '';
-        let best = this.turns[0].text;
-        for (const t of this.turns) {
-            if (t.text.length > best.length)
-                best = t.text;
-        }
-        return best;
-    }
-    reset() {
-        this.turns = [];
-    }
-}
-//# sourceMappingURL=text-scratchpad.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"text-scratchpad.js","sourceRoot":"","sources":["../../src/providers/text-scratchpad.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IACjB,KAAK,GAAqC,EAAE,CAAC;IAErD;8DAC0D;IAC1D,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;wBAEoB;IACpB,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC;IAED,oEAAoE;IACpE,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,CAAC;IAED;;oDAEgD;IAChD,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;gBAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/providers/tool-definitions.d.ts

@@ -1,6 +0,0 @@
-import type { ToolDefinition } from './runner-shell-types.js';
-export declare function makeToolDefinitions(opts: {
-    cwd: string;
-    allowedHosts?: Set<string>;
-}): ToolDefinition[];
-//# sourceMappingURL=tool-definitions.d.ts.map

package/dist/providers/tool-definitions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../src/providers/tool-definitions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAiC9D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG,cAAc,EAAE,CAyMnB"}