openhorse 0.2.19 → 0.2.22

package/dist/runtime/subagents/provider-gate.d.ts

@@ -0,0 +1,99 @@
+/**
+ * SubagentProviderGate: shared concurrency + cooldown for child LLM requests.
+ *
+ * Each child runs its own loop, but all children draw model requests from the
+ * same provider account. The gate bounds concurrent in-flight child execution
+ * and shares cooldown state so that one child's 429/retry-after pauses new
+ * children rather than letting each independently retry into a storm.
+ *
+ * The gate does NOT own per-request diagnostics or fallback model state - those
+ * live in the child's own LLMService. The gate only owns the shared go/no-go.
+ *
+ * R4 semantics:
+ *   - `canReserve(count)` only reports whether the provider is in an
+ *     unrecoverable state (cooldown). Normal concurrency saturation is NOT a
+ *     reason to reject - the policy should let batches queue and let the FIFO
+ *     semaphore bound actual peak concurrency.
+ *   - `acquire(signal?)` queues when slots are full; resolves in FIFO order.
+ *     An abort signal atomically removes the waiter and rejects, with no leaked
+ *     active slot or listener.
+ *   - cooldown has a single wake timer that re-arms on extension; when it
+ *     fires it drains queued waiters so they do not hang after the last
+ *     release during cooldown.
+ */
+export interface ProviderGateOptions {
+    /** Maximum children running concurrently. */
+    maxConcurrent: number;
+    /** Optional clock, injectable for deterministic tests. */
+    now?: () => number;
+    /** Optional timer scheduler (defaults to setTimeout). Injectable for tests. */
+    scheduleTimer?: (fn: () => void, ms: number) => {
+        clear(): void;
+    };
+}
+/** Thrown when an acquire is aborted via its signal. */
+export declare class AcquireAbortedError extends Error {
+    constructor();
+}
+export declare class SubagentProviderGate {
+    private readonly maxConcurrent;
+    private readonly now;
+    private readonly scheduleTimer;
+    private active;
+    private cooldownUntil;
+    private waiters;
+    private cooldownTimer;
+    constructor(options: ProviderGateOptions);
+    /** Whether the provider is currently in a cooldown window. */
+    isInCooldown(): boolean;
+    /** Remaining ms in the current cooldown, or 0. */
+    cooldownRemainingMs(): number;
+    /**
+     * Enter a cooldown after a rate-limit response. New acquires will wait until
+     * the window expires. A longer requested cooldown extends; a shorter one is
+     * ignored if an active cooldown is longer. Re-arms the wake timer so queued
+     * waiters are drained when the cooldown expires (R4: no permanent hang).
+     */
+    enterCooldown(retryAfterMs: number): void;
+    /**
+     * R4: whether the provider can accept new children. Returns false ONLY during
+     * cooldown — normal concurrency saturation is not a rejection reason, because
+     * the FIFO semaphore queues excess tasks and bounds actual peak concurrency
+     * at acquire time.
+     *
+     * NOTE: the `count` parameter is currently unused. It is reserved for future
+     * per-slot reservation checks. Today, policy only needs to know whether the
+     * provider is in an unrecoverable state (cooldown).
+     */
+    canReserve(_count: number): boolean;
+    /** Number of children currently holding a slot. */
+    activeCount(): number;
+    /**
+     * Acquire a slot. Resolves once a slot is free and the provider is not in
+     * cooldown. The caller MUST call `release()` when the child finishes.
+     *
+     * R4: if `signal` is provided and aborts while queued, the waiter is removed
+     * atomically and the promise rejects with {@link AcquireAbortedError}. No
+     * active slot is leaked and the abort listener is removed.
+     *
+     * The slot is claimed synchronously before the waiter's microtask runs, so
+     * `drainWaiters` never over-allocates beyond `maxConcurrent`.
+     */
+    acquire(signal?: AbortSignal): Promise<void>;
+    /** Release a slot and wake the next waiter (if not in cooldown). */
+    release(): void;
+    /**
+     * Wake waiters in FIFO order. For each waiter, the slot is claimed
+     * synchronously (active += 1) BEFORE the promise is resolved, so the
+     * next iteration of the while-loop sees the updated count and won't
+     * over-allocate.
+     */
+    private drainWaiters;
+    /**
+     * Arm (or re-arm) a single timer that fires when the current cooldown
+     * expires, then drains queued waiters. Re-arming on extension keeps a
+     * single pending timer at all times.
+     */
+    private armCooldownTimer;
+}
+//# sourceMappingURL=provider-gate.d.ts.map

package/dist/runtime/subagents/provider-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-gate.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/provider-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;CACnE;AAED,wDAAwD;AACxD,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAUD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoD;IAClF,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAkC;gBAE3C,OAAO,EAAE,mBAAmB;IAUxC,8DAA8D;IAC9D,YAAY,IAAI,OAAO;IAIvB,kDAAkD;IAClD,mBAAmB,IAAI,MAAM;IAI7B;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQzC;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,mDAAmD;IACnD,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;;OAUG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgClD,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAKf;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/runtime/subagents/provider-gate.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * SubagentProviderGate: shared concurrency + cooldown for child LLM requests.
+ *
+ * Each child runs its own loop, but all children draw model requests from the
+ * same provider account. The gate bounds concurrent in-flight child execution
+ * and shares cooldown state so that one child's 429/retry-after pauses new
+ * children rather than letting each independently retry into a storm.
+ *
+ * The gate does NOT own per-request diagnostics or fallback model state - those
+ * live in the child's own LLMService. The gate only owns the shared go/no-go.
+ *
+ * R4 semantics:
+ *   - `canReserve(count)` only reports whether the provider is in an
+ *     unrecoverable state (cooldown). Normal concurrency saturation is NOT a
+ *     reason to reject - the policy should let batches queue and let the FIFO
+ *     semaphore bound actual peak concurrency.
+ *   - `acquire(signal?)` queues when slots are full; resolves in FIFO order.
+ *     An abort signal atomically removes the waiter and rejects, with no leaked
+ *     active slot or listener.
+ *   - cooldown has a single wake timer that re-arms on extension; when it
+ *     fires it drains queued waiters so they do not hang after the last
+ *     release during cooldown.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubagentProviderGate = exports.AcquireAbortedError = void 0;
+/** Thrown when an acquire is aborted via its signal. */
+class AcquireAbortedError extends Error {
+    constructor() {
+        super('Subagent provider gate acquire was aborted');
+        this.name = 'AcquireAbortedError';
+    }
+}
+exports.AcquireAbortedError = AcquireAbortedError;
+class SubagentProviderGate {
+    constructor(options) {
+        this.active = 0;
+        this.cooldownUntil = 0;
+        this.waiters = [];
+        this.cooldownTimer = null;
+        const maxConcurrent = Number(options.maxConcurrent);
+        // N12: guard against NaN/undefined/negative — clamp to 1 as safe minimum.
+        this.maxConcurrent = Number.isFinite(maxConcurrent) && maxConcurrent >= 1
+            ? Math.floor(maxConcurrent)
+            : 1;
+        this.now = options.now ?? (() => Date.now());
+        this.scheduleTimer = options.scheduleTimer ?? defaultScheduleTimer;
+    }
+    /** Whether the provider is currently in a cooldown window. */
+    isInCooldown() {
+        return this.now() < this.cooldownUntil;
+    }
+    /** Remaining ms in the current cooldown, or 0. */
+    cooldownRemainingMs() {
+        return Math.max(0, this.cooldownUntil - this.now());
+    }
+    /**
+     * Enter a cooldown after a rate-limit response. New acquires will wait until
+     * the window expires. A longer requested cooldown extends; a shorter one is
+     * ignored if an active cooldown is longer. Re-arms the wake timer so queued
+     * waiters are drained when the cooldown expires (R4: no permanent hang).
+     */
+    enterCooldown(retryAfterMs) {
+        const until = this.now() + Math.max(0, retryAfterMs);
+        if (until > this.cooldownUntil) {
+            this.cooldownUntil = until;
+            this.armCooldownTimer();
+        }
+    }
+    /**
+     * R4: whether the provider can accept new children. Returns false ONLY during
+     * cooldown — normal concurrency saturation is not a rejection reason, because
+     * the FIFO semaphore queues excess tasks and bounds actual peak concurrency
+     * at acquire time.
+     *
+     * NOTE: the `count` parameter is currently unused. It is reserved for future
+     * per-slot reservation checks. Today, policy only needs to know whether the
+     * provider is in an unrecoverable state (cooldown).
+     */
+    canReserve(_count) {
+        return !this.isInCooldown();
+    }
+    /** Number of children currently holding a slot. */
+    activeCount() {
+        return this.active;
+    }
+    /**
+     * Acquire a slot. Resolves once a slot is free and the provider is not in
+     * cooldown. The caller MUST call `release()` when the child finishes.
+     *
+     * R4: if `signal` is provided and aborts while queued, the waiter is removed
+     * atomically and the promise rejects with {@link AcquireAbortedError}. No
+     * active slot is leaked and the abort listener is removed.
+     *
+     * The slot is claimed synchronously before the waiter's microtask runs, so
+     * `drainWaiters` never over-allocates beyond `maxConcurrent`.
+     */
+    async acquire(signal) {
+        // Already aborted before we even start.
+        if (signal?.aborted)
+            throw new AcquireAbortedError();
+        if (this.canReserve(1) && this.active < this.maxConcurrent) {
+            this.active += 1;
+            return;
+        }
+        await new Promise((resolve, reject) => {
+            const waiter = { resolve, reject, signal };
+            this.waiters.push(waiter);
+            if (signal) {
+                const onAbort = () => {
+                    // Atomically remove this waiter; if it was already claimed by
+                    // drainWaiters (no longer in the queue), the abort is a no-op.
+                    const idx = this.waiters.indexOf(waiter);
+                    if (idx >= 0) {
+                        this.waiters.splice(idx, 1);
+                        reject(new AcquireAbortedError());
+                    }
+                    signal.removeEventListener('abort', onAbort);
+                };
+                waiter.onAbort = onAbort;
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+        });
+        // NOTE: `this.active` was already incremented by drainWaiters when the
+        // slot was claimed synchronously, so we do NOT increment here.
+    }
+    /** Release a slot and wake the next waiter (if not in cooldown). */
+    release() {
+        this.active = Math.max(0, this.active - 1);
+        this.drainWaiters();
+    }
+    /**
+     * Wake waiters in FIFO order. For each waiter, the slot is claimed
+     * synchronously (active += 1) BEFORE the promise is resolved, so the
+     * next iteration of the while-loop sees the updated count and won't
+     * over-allocate.
+     */
+    drainWaiters() {
+        while (this.waiters.length > 0 && !this.isInCooldown() && this.active < this.maxConcurrent) {
+            const next = this.waiters.shift();
+            if (!next)
+                continue;
+            this.active += 1; // claim synchronously before resolving
+            // Remove the abort listener (if any) - the waiter is being fulfilled.
+            if (next.signal && next.onAbort) {
+                next.signal.removeEventListener('abort', next.onAbort);
+            }
+            next.resolve();
+        }
+    }
+    /**
+     * Arm (or re-arm) a single timer that fires when the current cooldown
+     * expires, then drains queued waiters. Re-arming on extension keeps a
+     * single pending timer at all times.
+     */
+    armCooldownTimer() {
+        if (this.cooldownTimer) {
+            this.cooldownTimer.clear();
+            this.cooldownTimer = null;
+        }
+        const remaining = this.cooldownRemainingMs();
+        if (remaining <= 0) {
+            // Cooldown already over - drain immediately.
+            this.drainWaiters();
+            return;
+        }
+        this.cooldownTimer = this.scheduleTimer(() => {
+            this.cooldownTimer = null;
+            this.drainWaiters();
+        }, remaining);
+    }
+}
+exports.SubagentProviderGate = SubagentProviderGate;
+function defaultScheduleTimer(fn, ms) {
+    const handle = setTimeout(fn, ms);
+    // Don't keep the event loop alive solely for a cooldown wake.
+    if (typeof handle === 'object' && handle && 'unref' in handle && typeof handle.unref === 'function') {
+        handle.unref();
+    }
+    return {
+        clear() {
+            clearTimeout(handle);
+        },
+    };
+}
+//# sourceMappingURL=provider-gate.js.map

package/dist/runtime/subagents/provider-gate.js.map

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

package/dist/runtime/subagents/result-parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SubagentResultParser: normalize a child's final text into a fixed schema.
+ *
+ * Children are instructed to emit a single JSON object. In practice they may
+ * wrap it in prose, emit invalid JSON, or omit fields. This parser is the
+ * single chokepoint that produces a well-typed {@link SubtaskResult} regardless
+ * of provider quirks, so the root Agent only ever sees structured data.
+ */
+import type { SubagentRole, SubtaskResult, SubtaskResultStatus } from './types';
+export interface ParsedSubtaskPayload {
+    summary?: unknown;
+    findings?: unknown;
+    files?: unknown;
+    commands?: unknown;
+    verification?: unknown;
+    risks?: unknown;
+}
+/**
+ * Extract the first balanced JSON object from text that may contain prose
+ * around it. Returns the parsed object or null if none is found / invalid.
+ */
+export declare function extractJsonObject(text: string): unknown;
+/**
+ * Parse a child's final text into a {@link SubtaskResult}.
+ *
+ * @param id         Runtime-generated task id.
+ * @param role       The role the child ran as.
+ * @param content    The child's final assistant text (may contain prose + JSON).
+ * @param status     Terminal status. `completed` requires parseable JSON;
+ *                   otherwise the summary records the failure mode.
+ * @param usage      Observed usage; defaults to empty.
+ */
+export declare function parseSubtaskResult(args: {
+    id: string;
+    role: SubagentRole;
+    content: string;
+    status: SubtaskResultStatus;
+    usage?: SubtaskResult['usage'];
+}): SubtaskResult;
+//# sourceMappingURL=result-parser.d.ts.map

package/dist/runtime/subagents/result-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-parser.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/result-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,aAAa,EACb,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAUjB,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmDvD;AAgED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAChC,GAAG,aAAa,CAgEhB"}

package/dist/runtime/subagents/result-parser.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * SubagentResultParser: normalize a child's final text into a fixed schema.
+ *
+ * Children are instructed to emit a single JSON object. In practice they may
+ * wrap it in prose, emit invalid JSON, or omit fields. This parser is the
+ * single chokepoint that produces a well-typed {@link SubtaskResult} regardless
+ * of provider quirks, so the root Agent only ever sees structured data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJsonObject = extractJsonObject;
+exports.parseSubtaskResult = parseSubtaskResult;
+const types_1 = require("./types");
+const MAX_FINDINGS = 20;
+const MAX_FILES = 50;
+const MAX_COMMANDS = 20;
+const MAX_VERIFICATION = 10;
+const MAX_RISKS = 10;
+const MAX_FIELD_LEN = 2000;
+/**
+ * Extract the first balanced JSON object from text that may contain prose
+ * around it. Returns the parsed object or null if none is found / invalid.
+ */
+function extractJsonObject(text) {
+    if (!text)
+        return null;
+    // Iterate over every top-level '{' start position. A child's text may contain
+    // prose with brace fragments (e.g. "{ result above }") before the real JSON
+    // object, so a candidate that is balanced but not valid JSON must not abort
+    // the search — we keep scanning for the next '{'.
+    let searchFrom = 0;
+    while (searchFrom < text.length) {
+        const start = text.indexOf('{', searchFrom);
+        if (start === -1)
+            return null;
+        // Scan for the matching closing brace, respecting nested objects and strings.
+        let depth = 0;
+        let inString = false;
+        let escaped = false;
+        let end = -1;
+        for (let i = start; i < text.length; i++) {
+            const ch = text[i];
+            if (inString) {
+                if (escaped) {
+                    escaped = false;
+                    continue;
+                }
+                if (ch === '\\') {
+                    escaped = true;
+                    continue;
+                }
+                if (ch === '"')
+                    inString = false;
+                continue;
+            }
+            if (ch === '"') {
+                inString = true;
+                continue;
+            }
+            if (ch === '{')
+                depth++;
+            else if (ch === '}') {
+                depth--;
+                if (depth === 0) {
+                    end = i;
+                    break;
+                }
+            }
+        }
+        if (end === -1) {
+            // Unbalanced from this start; try a last-ditch parse of the tail.
+            try {
+                return JSON.parse(text.slice(start));
+            }
+            catch {
+                return null;
+            }
+        }
+        const candidate = text.slice(start, end + 1);
+        try {
+            return JSON.parse(candidate);
+        }
+        catch {
+            // Balanced but not valid JSON (prose fragment). Continue past it.
+            searchFrom = end + 1;
+        }
+    }
+    return null;
+}
+function str(value, max = MAX_FIELD_LEN) {
+    if (typeof value === 'string')
+        return truncate(value.trim(), max);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return '';
+}
+function truncate(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max - 1)}…`;
+}
+function parseFindings(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const obj = item;
+        const title = str(obj.title, 200);
+        if (!title)
+            continue;
+        out.push({
+            title,
+            severity: parseSeverity(obj.severity),
+            evidence: str(obj.evidence, 1500),
+            file: obj.file != null ? str(obj.file, 500) : undefined,
+            line: typeof obj.line === 'number' && Number.isFinite(obj.line) ? Math.max(0, Math.floor(obj.line)) : undefined,
+        });
+        if (out.length >= MAX_FINDINGS)
+            break;
+    }
+    return out;
+}
+function parseSeverity(value) {
+    if (value === 'critical' || value === 'high' || value === 'medium' || value === 'low' || value === 'info') {
+        return value;
+    }
+    return undefined;
+}
+function parseStringArray(raw, max) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        const s = str(item, 500);
+        if (s)
+            out.push(s);
+        if (out.length >= max)
+            break;
+    }
+    return out;
+}
+function parseCommands(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const obj = item;
+        const command = str(obj.command, 500);
+        if (!command)
+            continue;
+        out.push({ command, purpose: str(obj.purpose, 500), executed: false });
+        if (out.length >= MAX_COMMANDS)
+            break;
+    }
+    return out;
+}
+/**
+ * Parse a child's final text into a {@link SubtaskResult}.
+ *
+ * @param id         Runtime-generated task id.
+ * @param role       The role the child ran as.
+ * @param content    The child's final assistant text (may contain prose + JSON).
+ * @param status     Terminal status. `completed` requires parseable JSON;
+ *                   otherwise the summary records the failure mode.
+ * @param usage      Observed usage; defaults to empty.
+ */
+function parseSubtaskResult(args) {
+    const { id, role, content, status } = args;
+    const usage = args.usage ?? types_1.EMPTY_SUBTASK_USAGE;
+    if (status !== 'completed') {
+        return {
+            id,
+            role,
+            status,
+            summary: summarizeFailure(status, content),
+            findings: [],
+            files: [],
+            commands: [],
+            verification: [],
+            risks: [`child did not complete: ${status}`],
+            usage,
+        };
+    }
+    const parsed = extractJsonObject(content);
+    if (!parsed || typeof parsed !== 'object') {
+        return {
+            id,
+            role,
+            status: 'failed',
+            summary: truncate(content.trim() || '(no output)', MAX_FIELD_LEN),
+            findings: [],
+            files: [],
+            commands: [],
+            verification: [],
+            risks: ['child returned non-JSON output'],
+            usage,
+        };
+    }
+    const payload = parsed;
+    const summary = str(payload.summary, MAX_FIELD_LEN);
+    if (!summary) {
+        return {
+            id,
+            role,
+            status: 'failed',
+            summary: truncate(content.trim().slice(0, MAX_FIELD_LEN), MAX_FIELD_LEN),
+            findings: parseFindings(payload.findings),
+            files: [],
+            commands: [],
+            verification: [],
+            risks: ['child output missing required "summary" field'],
+            usage,
+        };
+    }
+    return {
+        id,
+        role,
+        status: 'completed',
+        summary,
+        findings: parseFindings(payload.findings),
+        files: parseStringArray(payload.files, MAX_FILES),
+        commands: parseCommands(payload.commands),
+        verification: parseStringArray(payload.verification, MAX_VERIFICATION),
+        risks: parseStringArray(payload.risks, MAX_RISKS),
+        usage,
+    };
+}
+function summarizeFailure(status, content) {
+    const tail = truncate(content.trim(), 300);
+    switch (status) {
+        case 'timed_out': return `Child timed out. Partial output: ${tail || '(none)'}`;
+        case 'cancelled': return `Child was cancelled. Partial output: ${tail || '(none)'}`;
+        case 'failed': return `Child failed. Output: ${tail || '(none)'}`;
+        case 'rejected': return `Child was rejected by policy before running.`;
+        default: return tail || '(no output)';
+    }
+}
+//# sourceMappingURL=result-parser.js.map

package/dist/runtime/subagents/result-parser.js.map

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

package/dist/runtime/subagents/runner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SubagentRunner: runs a single child agent to completion and parses its result.
+ *
+ * The runner is the boundary between the Supervisor and the shared `query()`
+ * loop. It is deliberately thin: it derives a child abort signal from the
+ * parent, applies a per-child timeout, invokes an injectable `executeQuery`,
+ * and normalizes the outcome through {@link parseSubtaskResult}.
+ *
+ * `executeQuery` is injected so the runner can be tested without a live LLM;
+ * the production binding wraps `query()` with a per-child LLMService.
+ */
+import { buildChildMessages } from './context-builder';
+import type { SubtaskPacket, SubtaskResult, SubtaskUsage } from './types';
+/** A filtered, child-safe tool list with its executor. */
+export interface ChildToolSet {
+    /** Resolved tool definitions the child may call. */
+    tools: unknown[];
+    /** Tool name -> executor. */
+    toolExecutor: (name: string, args: Record<string, unknown>, abortSignal?: AbortSignal) => Promise<string>;
+}
+/** Injectable child query function. Returns the final assistant text + usage. */
+export type ExecuteChildQuery = (messages: ReturnType<typeof buildChildMessages>, toolSet: ChildToolSet, abortSignal: AbortSignal) => Promise<{
+    content: string;
+    usage: SubtaskUsage;
+}>;
+export interface SubagentRunnerDeps {
+    /** Canonical project root. */
+    cwd: string;
+    /** Canonical scope paths (already validated). */
+    canonicalScopePaths?: string[];
+    /** Filtered child tools + executor. */
+    toolSet: ChildToolSet;
+    /** Injectable query binding (production wraps query(); tests mock it). */
+    executeQuery: ExecuteChildQuery;
+    /** Per-child wall-clock timeout. */
+    timeoutMs: number;
+    /** Parent abort signal; child abort is derived from it. */
+    parentAbortSignal?: AbortSignal;
+    /** Optional read-only context inputs forwarded to the context builder. */
+    rootObjectiveSummary?: string;
+    modelLabel?: string;
+}
+export interface RunSubtaskOutcome {
+    result: SubtaskResult;
+    /** Whether the child was aborted by the parent (vs its own timeout). */
+    parentCancelled: boolean;
+}
+/**
+ * Run one child subtask to a terminal state. Never throws: every failure mode
+ * (timeout, cancel, error, non-JSON output) is normalized into a SubtaskResult.
+ */
+export declare function runSubtask(packet: SubtaskPacket, deps: SubagentRunnerDeps, taskId: string): Promise<RunSubtaskOutcome>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runtime/subagents/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,YAAY,EACb,MAAM,SAAS,CAAC;AA4BjB,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,6BAA6B;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3G;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC/C,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,WAAW,KACrB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,uCAAuC;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,YAAY,EAAE,iBAAiB,CAAC;IAChC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CA6H5B"}