@claudexor/orchestrator 1.0.1

package/dist/runSupport.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Run-support helpers: transient retry pacing, gate-derived protected paths,
+ * prompt constraints, harness-event redaction/payload projection, and the
+ * run summary/findings renderers. Pure functions — no orchestrator state.
+ */
+import type { HarnessEvent, ModeKind, ProtectedPathApproval, ReviewFinding } from "@claudexor/schema";
+import type { EventLog } from "@claudexor/event-log";
+import type { CandidateEvidence } from "@claudexor/arbitration";
+import type { BudgetObservation, InteractionAnswerSet } from "@claudexor/schema";
+/**
+ * Relay cross-share: the prior planners' plans, injected into a later
+ * planner's prompt so the harnesses CONVERGE on an aligned plan instead of
+ * each planning in isolation. `runPlan` already iterates planners
+ * sequentially, so each leg after the first sees what the earlier ones
+ * proposed and is asked to reconcile/extend them (not blindly repeat).
+ */
+export declare function relayPriorPlansSection(plans: {
+    id: string;
+    text: string;
+}[]): string;
+export interface TransientRetryPolicy {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+}
+export declare function transientRetryDelayMs(nativeDelayMs: number | null, policy: TransientRetryPolicy, retryIndex: number): number;
+export declare function gateProtectedPaths(commands: string[]): string[];
+export declare function promptWithProtectedPathConstraint(prompt: string, protectedPaths: string[], autoProtectedPaths?: string[], approvals?: ProtectedPathApproval[]): string;
+export declare function sleep(ms: number): Promise<void>;
+export declare function redactHarnessEvent(ev: HarnessEvent): HarnessEvent;
+export declare function harnessEventPayload(harnessId: string, attemptId: string, ev: HarnessEvent): Record<string, unknown>;
+/**
+ * Deduplicate the known "final result repeats the last streamed message" shape
+ * (adjacent only). Legitimately repeated earlier messages are preserved — a
+ * whole-array dedupe would silently merge real output.
+ */
+export declare function pushUniqueText(parts: string[], text: string): void;
+export declare function formatFindings(findings: ReviewFinding[]): string;
+export declare function renderSummary(runId: string, mode: ModeKind, decision: {
+    winner: string | null;
+    status: string;
+    outcome?: string;
+    why_winner: string;
+    apply_recommendation: string;
+}, evidences: CandidateEvidence[], synthReason: string, reviewVerified: boolean): string;
+/** Pure read: a referenced run's decision/work_product status, or null. */
+export declare function readRunStatus(repoRoot: string, runId: string): string | null;
+/** Pure read: a referenced run's recorded patch diff, or null. */
+export declare function readRunPatch(repoRoot: string, runId: string): string | null;
+/** Config-derived runtime knobs (pure projections of ResolvedConfig). */
+export interface ResolvedConfigLike {
+    global: {
+        routing: {
+            env_inheritance: "mirror_native" | "clean";
+        };
+        runtime: {
+            transient_retry: {
+                max_retries: number;
+                initial_delay_ms: number;
+                max_delay_ms: number;
+            };
+            reviewer_timeout_ms: number;
+            harness_inactivity_timeout_ms: number;
+        };
+    };
+}
+export declare function envInheritance(cfg: ResolvedConfigLike): "mirror_native" | "clean";
+export declare function transientRetryPolicy(cfg: ResolvedConfigLike): TransientRetryPolicy;
+export declare function reviewerTimeoutMs(cfg: ResolvedConfigLike): number;
+export declare function harnessInactivityTimeoutMs(cfg: ResolvedConfigLike): number;
+/** Typed auth-switch disclosure: adapters mark auth_switched on a message;
+ * the run event log gets the typed route.fallback payload. */
+export declare function observeAuthSwitch(log: EventLog | undefined, harnessId: string, attemptId: string, ev: HarnessEvent): void;
+/** Observe ALL budget/quota signals from one harness event and disclose
+ * quota pressure ONCE per attempt (crossing semantics). One owner — the
+ * agent, plan, and read-only loops all consume this instead of pasting the
+ * loop (critic finding: triplicated logic drifts). */
+export declare function observeBudgetSignals(ledger: {
+    observe(o: BudgetObservation): void;
+}, log: {
+    emit(type: string, payload: Record<string, unknown>): unknown;
+} | undefined, harnessId: string, attemptId: string, ev: HarnessEvent, state: {
+    quotaPressureDisclosed: boolean;
+}): void;
+/** Stall rotation with an HONEST route event: picks via
+ * pickStallRotationIdx and emits route.fallback.started only when the idx
+ * actually moved — STAY (every alternative cooling) is a retry, not a
+ * fallback. Returns the (possibly unchanged) idx. */
+export declare function rotateOnStall(poolIds: string[], currentIdx: number, ledger: {
+    headroom(id: string): number;
+    cooldownActive(id: string): boolean;
+}, tried: ReadonlySet<string>, log: {
+    emit(type: string, payload: Record<string, unknown>): unknown;
+}, fromHarness: string | null): number;
+/** Stall-rotation pick: UNTRIED candidates first (the caller's exhaustion
+ * check counts distinct harnesses, so headroom alone could ping-pong between
+ * two strong harnesses and starve a third), then by remaining rate-window
+ * headroom, cooldowns excluded, round-robin order among equals. Pure. */
+export declare function pickStallRotationIdx(poolIds: string[], currentIdx: number, ledger: {
+    headroom(id: string): number;
+    cooldownActive(id: string): boolean;
+}, tried?: ReadonlySet<string>): number;
+/** Routing metrics: one settled sample per CLEAN attempt (advisory input;
+ * failures never fail the run). Errored/cancelled attempts are NOT samples —
+ * a fast-failing harness must not earn a flattering latency average (the
+ * router divides by latency). Duration = stream time only (gates excluded). */
+export declare function recordCleanAttemptMetrics(configDir: string, harnessId: string, sample: {
+    costUsd: number;
+    streamMs: number;
+    errored: boolean;
+    aborted: boolean;
+}): void;
+/** Build the ISOLATED-ENVELOPE sub-run input for an orchestrate SAFE step
+ * (start_run/race): inPlace forced false, no thread binding, no nested
+ * autonomy, recursion depth incremented. Pure construction; the caller
+ * asserts the envelope invariant. */
+export declare function buildEnvelopeSubInput<T extends {
+    repoRoot: string;
+    portfolio?: unknown;
+    web?: unknown;
+    externalContextPolicy?: unknown;
+    signal?: AbortSignal;
+    orchestrateDepth?: number;
+}>(input: T, call: {
+    tool: "start_run" | "race";
+    prompt: string;
+    mode?: string;
+    n?: number;
+    harness?: string | null;
+}, remainingUsd: number | null): {
+    repoRoot: string;
+    prompt: string;
+    mode: "agent" | "ask" | "plan" | "audit" | "orchestrate";
+    n: number | undefined;
+    harnesses: string[] | undefined;
+    portfolio: unknown;
+    maxUsd: number | null;
+    web: unknown;
+    externalContextPolicy: unknown;
+    signal: AbortSignal | undefined;
+    inPlace: boolean;
+    threadId: undefined;
+    executionRoot: undefined;
+    autonomy: undefined;
+    resumeSessions: undefined;
+    onSessionObserved: undefined;
+    orchestrateDepth: number;
+};
+/**
+ * Deliver typed answers to a referenced pending interaction for the
+ * orchestrate `answer_question` SAFE step (read-only w.r.t. the tree). The
+ * daemon owns the live registry; without an injected service this context
+ * cannot reach it, so SKIP honestly.
+ *
+ * INVARIANT: safe sub-runs are NON-interactive (their sub-input omits
+ * onInteraction, so a start_run/race sub-run never raises an interaction and
+ * nothing registers under its run id). The only pending interactions
+ * therefore belong to the ORCHESTRATE run itself, so `input.runId` is the
+ * correct registry key. If sub-runs are ever made interactive, the
+ * answer_question plan call MUST carry the target sub-run id instead (the
+ * registry is keyed by runId+interactionId).
+ */
+export declare function deliverPlanAnswer(input: {
+    runId?: string;
+    answerInteraction?: (runId: string, interactionId: string, answers: InteractionAnswerSet) => Promise<boolean> | boolean;
+}, call: {
+    interaction_id: string;
+    answers: Array<{
+        question_id: string;
+        selected_labels: string[];
+        free_text: string | null;
+    }>;
+}): Promise<{
+    status: "done" | "skipped";
+    runId: null;
+    detail: string;
+}>;
+//# sourceMappingURL=runSupport.d.ts.map

package/dist/runSupport.d.ts.map

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

package/dist/runSupport.js

@@ -0,0 +1,372 @@
+import { FallbackReason as FallbackReasonSchema, RouteFallbackPayload as RouteFallbackPayloadSchema } from "@claudexor/schema";
+import { isBlocking } from "@claudexor/schema";
+import { redactSecrets } from "@claudexor/util";
+import { observationsFromEvent, recordHarnessMetric } from "@claudexor/budget";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ArtifactStore } from "@claudexor/artifact-store";
+/**
+ * Relay cross-share: the prior planners' plans, injected into a later
+ * planner's prompt so the harnesses CONVERGE on an aligned plan instead of
+ * each planning in isolation. `runPlan` already iterates planners
+ * sequentially, so each leg after the first sees what the earlier ones
+ * proposed and is asked to reconcile/extend them (not blindly repeat).
+ */
+export function relayPriorPlansSection(plans) {
+    if (plans.length === 0)
+        return "";
+    // No silent truncation: a relayed plan cut at the cap carries an explicit
+    // in-band marker so the next planner KNOWS it saw a prefix, not the whole.
+    const CAP = 4000;
+    const blocks = plans
+        .map((p) => {
+        const cut = p.text.length > CAP;
+        const body = cut ? `${p.text.slice(0, CAP)}\n[... plan truncated at ${CAP} chars — the source run's plan artifact carries the full text]` : p.text;
+        return `### Plan already proposed by ${p.id}\n${body}`;
+    })
+        .join("\n\n");
+    return `\n\n---\nOTHER HARNESSES HAVE ALREADY PROPOSED PLANS FOR THIS SAME TASK (below). Read them, then produce YOUR plan: build on what is solid, RECONCILE the differences, and EXPLICITLY call out where you disagree and why. Do not blindly repeat them — converge toward one aligned plan.\n\n${blocks}\n---\n`;
+}
+export function transientRetryDelayMs(nativeDelayMs, policy, retryIndex) {
+    const fallback = policy.initialDelayMs * 2 ** retryIndex;
+    const delay = nativeDelayMs ?? fallback;
+    return Math.min(delay, policy.maxDelayMs);
+}
+export function gateProtectedPaths(commands) {
+    if (commands.length === 0)
+        return [];
+    const paths = new Set([
+        "package.json",
+        "**/package.json",
+        "test/**",
+        "tests/**",
+        "__tests__/**",
+        "**/*.test.*",
+        "**/*.spec.*",
+    ]);
+    for (const command of commands) {
+        for (const raw of command.split(/\s+/)) {
+            const token = raw.trim().replace(/^['"]|['"]$/g, "");
+            if (!token ||
+                token.startsWith("-") ||
+                token.includes("=") ||
+                token.includes("://") ||
+                token.startsWith("/"))
+                continue;
+            if (!token.includes("/") && !token.includes("."))
+                continue;
+            const clean = token.replace(/^[./]+/, "").replace(/[),;]+$/g, "");
+            if (!clean || clean === "package.json")
+                continue;
+            const testish = clean.startsWith("test/") ||
+                clean.startsWith("tests/") ||
+                clean.startsWith("__tests__/") ||
+                clean.includes(".test.") ||
+                clean.includes(".spec.");
+            if (testish)
+                paths.add(clean.endsWith("/") ? `${clean}**` : clean);
+        }
+    }
+    return [...paths];
+}
+export function promptWithProtectedPathConstraint(prompt, protectedPaths, autoProtectedPaths = [], approvals = []) {
+    if (protectedPaths.length === 0 && autoProtectedPaths.length === 0)
+        return prompt;
+    const specLines = protectedPaths.length
+        ? [
+            "",
+            "Engine constraint: do not edit spec/config protected paths unless the frozen task contract explicitly asks for it. Protected paths:",
+            ...protectedPaths.slice(0, 20).map((p) => `- ${p}`),
+        ]
+        : [];
+    const approvalLines = approvals.length
+        ? [
+            "",
+            "Approved auto-protected gate/test path changes for this run:",
+            ...approvals.slice(0, 20).map((a) => `- ${a.path}${a.reason ? ` (${a.reason})` : ""}`),
+        ]
+        : [];
+    const autoLines = autoProtectedPaths.length
+        ? [
+            "",
+            "Engine constraint: do not edit auto-protected gate/test paths, test commands, or package test scripts unless the user explicitly asked to change tests. Auto-protected paths:",
+            ...autoProtectedPaths.slice(0, 20).map((p) => `- ${p}`),
+            ...approvalLines,
+        ]
+        : [];
+    return [
+        prompt,
+        ...specLines,
+        ...autoLines,
+    ].join("\n");
+}
+export function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function redactHarnessEvent(ev) {
+    try {
+        return JSON.parse(redactSecrets(JSON.stringify(ev)));
+    }
+    catch {
+        return {
+            ...ev,
+            text: ev.text ? redactSecrets(ev.text) : undefined,
+            error: ev.error ? redactSecrets(ev.error) : undefined,
+            payload: ev.payload ? { redacted: true } : undefined,
+        };
+    }
+}
+export function harnessEventPayload(harnessId, attemptId, ev) {
+    const safe = redactHarnessEvent(ev);
+    const title = safe.error ??
+        safe.text ??
+        (safe.usage
+            ? `usage: ${safe.usage.input_tokens ?? 0} in / ${safe.usage.output_tokens ?? 0} out`
+            : safe.type);
+    return {
+        harness_id: harnessId,
+        attempt_id: attemptId,
+        session_id: safe.session_id,
+        type: safe.type,
+        title: String(title).slice(0, 500),
+        text: safe.text,
+        error: safe.error,
+        usage: safe.usage,
+        observed_model: safe.observed_model,
+        tool: safe.tool,
+        interaction: safe.interaction,
+        payload: safe.payload,
+    };
+}
+/**
+ * Deduplicate the known "final result repeats the last streamed message" shape
+ * (adjacent only). Legitimately repeated earlier messages are preserved — a
+ * whole-array dedupe would silently merge real output.
+ */
+export function pushUniqueText(parts, text) {
+    const normalized = text.trim();
+    if (!normalized)
+        return;
+    const last = parts[parts.length - 1]?.trim();
+    if (last === normalized)
+        return;
+    parts.push(normalized);
+}
+export function formatFindings(findings) {
+    if (findings.length === 0)
+        return "(no findings recorded)";
+    return findings
+        .map((f) => `- [${f.severity}/${f.status}] ${f.claim}` +
+        (f.evidence.files.length > 0
+            ? ` (${f.evidence.files.map((x) => x.path).join(", ")})`
+            : "") +
+        (f.proposed_fix ? ` -> fix: ${f.proposed_fix}` : ""))
+        .join("\n");
+}
+export function renderSummary(runId, mode, decision, evidences, synthReason, reviewVerified) {
+    return ([
+        `# Run ${runId} (${mode})`,
+        "",
+        `- Status: ${decision.status}`,
+        `- Outcome: ${decision.outcome ?? "unknown"}`,
+        `- Winner: ${decision.winner ?? "none"}`,
+        `- Apply: ${decision.apply_recommendation}`,
+        `- Review verified (cross-family): ${reviewVerified}`,
+        `- Synthesis: ${synthReason}`,
+        "",
+        "## Candidates",
+        ...evidences.map((e) => `- ${e.label} (${e.attemptId}): gates ${e.testsPassed}/${e.testsTotal}, blockers ${e.findings.filter((f) => isBlocking(f)).length}, cleanReview ${e.finalReviewClean}`),
+        "",
+        "## Why winner",
+        decision.why_winner,
+    ].join("\n") + "\n");
+}
+/** Pure read: a referenced run's decision/work_product status, or null. */
+export function readRunStatus(repoRoot, runId) {
+    const store = new ArtifactStore(repoRoot);
+    const sub = store.runPaths(runId);
+    const decision = store.readYaml(join(sub.arbitrationDir, "decision.yaml"));
+    const wp = store.readYaml(join(sub.finalDir, "work_product.yaml"));
+    if (!decision && !wp)
+        return null;
+    const parts = [];
+    if (decision?.status)
+        parts.push(`decision=${decision.status}`);
+    if (wp?.meta?.["result_kind"])
+        parts.push(`result_kind=${String(wp.meta["result_kind"])}`);
+    if (wp?.meta?.["apply_state"])
+        parts.push(`apply_state=${String(wp.meta["apply_state"])}`);
+    return parts.length > 0 ? parts.join(", ") : `run ${runId}: artifacts present`;
+}
+/** Pure read: a referenced run's recorded patch diff, or null. */
+export function readRunPatch(repoRoot, runId) {
+    const store = new ArtifactStore(repoRoot);
+    const sub = store.runPaths(runId);
+    const path = join(sub.finalDir, "patch.diff");
+    return existsSync(path) ? readFileSync(path, "utf8") : null;
+}
+export function envInheritance(cfg) {
+    return cfg.global.routing.env_inheritance;
+}
+export function transientRetryPolicy(cfg) {
+    const c = cfg.global.runtime.transient_retry;
+    return { maxRetries: c.max_retries, initialDelayMs: c.initial_delay_ms, maxDelayMs: c.max_delay_ms };
+}
+export function reviewerTimeoutMs(cfg) {
+    return cfg.global.runtime.reviewer_timeout_ms;
+}
+export function harnessInactivityTimeoutMs(cfg) {
+    return cfg.global.runtime.harness_inactivity_timeout_ms;
+}
+/** Typed auth-switch disclosure: adapters mark auth_switched on a message;
+ * the run event log gets the typed route.fallback payload. */
+export function observeAuthSwitch(log, harnessId, attemptId, ev) {
+    if (!log || ev.type !== "message" || ev.payload?.["auth_switched"] !== true)
+        return;
+    // Most auth_switched markers mean the preferred auth route was unavailable,
+    // so the default reason is `auth_unavailable`. Adapters may override with a
+    // more specific typed reason, e.g. `readiness_preferred` when auto selects a
+    // smoke-proven route for reliability/cost transparency.
+    const overrideReason = FallbackReasonSchema.safeParse(ev.payload?.["reason"]);
+    try {
+        log.emit("route.fallback.auth_switched", RouteFallbackPayloadSchema.parse({
+            from_harness: harnessId,
+            to_harness: harnessId,
+            from_auth_mode: ev.payload?.["from_auth_mode"],
+            to_auth_mode: ev.payload?.["to_auth_mode"],
+            reason: overrideReason.success ? overrideReason.data : "auth_unavailable",
+            attempt_id: attemptId,
+        }));
+    }
+    catch {
+        /* a malformed marker must not fail the run */
+    }
+}
+/** Observe ALL budget/quota signals from one harness event and disclose
+ * quota pressure ONCE per attempt (crossing semantics). One owner — the
+ * agent, plan, and read-only loops all consume this instead of pasting the
+ * loop (critic finding: triplicated logic drifts). */
+export function observeBudgetSignals(ledger, log, harnessId, attemptId, ev, state) {
+    for (const obs of observationsFromEvent(harnessId, ev)) {
+        ledger.observe(obs);
+        if (obs.kind === "used_percent" && (obs.used_percent ?? 0) >= 50 && !state.quotaPressureDisclosed) {
+            state.quotaPressureDisclosed = true;
+            log?.emit("budget.quota_pressure", {
+                harness_id: harnessId,
+                attempt_id: attemptId,
+                used_percent: obs.used_percent,
+                resets_at: obs.resets_at ?? null,
+            });
+        }
+    }
+}
+/** Stall rotation with an HONEST route event: picks via
+ * pickStallRotationIdx and emits route.fallback.started only when the idx
+ * actually moved — STAY (every alternative cooling) is a retry, not a
+ * fallback. Returns the (possibly unchanged) idx. */
+export function rotateOnStall(poolIds, currentIdx, ledger, tried, log, fromHarness) {
+    const pickedIdx = pickStallRotationIdx(poolIds, currentIdx, ledger, tried);
+    if (pickedIdx !== currentIdx) {
+        log.emit("route.fallback.started", {
+            from_harness: fromHarness,
+            to_harness: poolIds[pickedIdx],
+            reason: "stall",
+            headroom: ledger.headroom(poolIds[pickedIdx]),
+        });
+    }
+    return pickedIdx;
+}
+/** Stall-rotation pick: UNTRIED candidates first (the caller's exhaustion
+ * check counts distinct harnesses, so headroom alone could ping-pong between
+ * two strong harnesses and starve a third), then by remaining rate-window
+ * headroom, cooldowns excluded, round-robin order among equals. Pure. */
+export function pickStallRotationIdx(poolIds, currentIdx, ledger, tried = new Set()) {
+    if (poolIds.length === 0)
+        return currentIdx; // total: never NaN via %0
+    const rank = (candidates) => candidates.sort((a, b) => ledger.headroom(b.id) - ledger.headroom(a.id) ||
+        ((a.idx - currentIdx + poolIds.length) % poolIds.length) -
+            ((b.idx - currentIdx + poolIds.length) % poolIds.length))[0];
+    const eligible = poolIds
+        .map((id, idx) => ({ id, idx }))
+        .filter(({ idx, id }) => idx !== currentIdx && !ledger.cooldownActive(id));
+    const next = rank(eligible.filter(({ id }) => !tried.has(id))) ?? rank(eligible);
+    // Every alternative cooling: STAY — retrying the stalled-but-not-throttled
+    // current harness beats hopping onto a known rate-limited one.
+    return next ? next.idx : currentIdx;
+}
+/** Routing metrics: one settled sample per CLEAN attempt (advisory input;
+ * failures never fail the run). Errored/cancelled attempts are NOT samples —
+ * a fast-failing harness must not earn a flattering latency average (the
+ * router divides by latency). Duration = stream time only (gates excluded). */
+export function recordCleanAttemptMetrics(configDir, harnessId, sample) {
+    if (sample.errored || sample.aborted)
+        return;
+    recordHarnessMetric(configDir, harnessId, {
+        costUsd: sample.costUsd > 0 ? sample.costUsd : null,
+        durationMs: sample.streamMs,
+    });
+}
+/** Build the ISOLATED-ENVELOPE sub-run input for an orchestrate SAFE step
+ * (start_run/race): inPlace forced false, no thread binding, no nested
+ * autonomy, recursion depth incremented. Pure construction; the caller
+ * asserts the envelope invariant. */
+export function buildEnvelopeSubInput(input, call, remainingUsd) {
+    return {
+        repoRoot: input.repoRoot,
+        prompt: call.prompt,
+        mode: (call.tool === "start_run" ? (call.mode ?? "agent") : "agent"),
+        n: call.tool === "race" ? call.n : undefined,
+        harnesses: call.tool === "start_run" && call.harness ? [call.harness] : undefined,
+        portfolio: input.portfolio,
+        // Aggregate budget: the sub-run gets only the REMAINING headroom.
+        maxUsd: remainingUsd,
+        web: input.web,
+        externalContextPolicy: input.externalContextPolicy,
+        signal: input.signal,
+        // SAFETY: isolated envelope, never the live in-place thread tree.
+        inPlace: false,
+        threadId: undefined,
+        executionRoot: undefined,
+        autonomy: undefined,
+        resumeSessions: undefined,
+        onSessionObserved: undefined,
+        orchestrateDepth: (input.orchestrateDepth ?? 0) + 1,
+    };
+}
+/**
+ * Deliver typed answers to a referenced pending interaction for the
+ * orchestrate `answer_question` SAFE step (read-only w.r.t. the tree). The
+ * daemon owns the live registry; without an injected service this context
+ * cannot reach it, so SKIP honestly.
+ *
+ * INVARIANT: safe sub-runs are NON-interactive (their sub-input omits
+ * onInteraction, so a start_run/race sub-run never raises an interaction and
+ * nothing registers under its run id). The only pending interactions
+ * therefore belong to the ORCHESTRATE run itself, so `input.runId` is the
+ * correct registry key. If sub-runs are ever made interactive, the
+ * answer_question plan call MUST carry the target sub-run id instead (the
+ * registry is keyed by runId+interactionId).
+ */
+export async function deliverPlanAnswer(input, call) {
+    if (!input.answerInteraction) {
+        return { status: "skipped", runId: null, detail: "no live interaction surface in this context" };
+    }
+    const delivered = await input.answerInteraction(input.runId ?? "", call.interaction_id, {
+        interaction_id: call.interaction_id,
+        answers: call.answers.map((a) => ({
+            question_id: a.question_id,
+            selected_labels: a.selected_labels,
+            free_text: a.free_text,
+        })),
+    });
+    return {
+        status: delivered ? "done" : "skipped",
+        runId: null,
+        detail: delivered
+            ? `delivered answers to ${call.interaction_id}`
+            : `interaction ${call.interaction_id} not found / already resolved`,
+    };
+}
+//# sourceMappingURL=runSupport.js.map

package/dist/runSupport.js.map

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

package/dist/runTerminals.d.ts

@@ -0,0 +1,56 @@
+import type { ModeKind } from "@claudexor/schema";
+import type { ArtifactStore } from "@claudexor/artifact-store";
+import type { EventLog } from "@claudexor/event-log";
+import type { OrchestratorResult } from "./orchestrator.js";
+export interface AnnouncedRunContext {
+    log: EventLog;
+    store: ArtifactStore;
+    paths: ReturnType<ArtifactStore["runPaths"]>;
+    runId: string;
+    taskId: string;
+    mode: ModeKind;
+    /** Failure phase label when the net has to stamp the terminal. */
+    phase: string;
+    /** Settled ledger spend snapshot — failure/cancel terminals must account
+     * for money already spent exactly like success terminals do. */
+    spend?: () => number;
+}
+export declare function writeFailure(store: ArtifactStore, paths: ReturnType<ArtifactStore["runPaths"]>, failure: {
+    phase: string;
+    category: string;
+    safeMessage: string;
+    harnessId?: string;
+    attemptId?: string;
+    rawDetailRef?: string;
+    logRefs?: string[];
+    eventRefs?: string[];
+    runDir?: string;
+    nextActions?: string[];
+}): void;
+/**
+ * Terminal result for a cancelled run: emits run.failed with status
+ * "cancelled" so every mode ends consistently. `writeTelemetry` carries the
+ * PARTIAL attempt telemetry collected before the abort — a cancelled run
+ * must still account for what it spent and observed; it used to be
+ * written only by convergence.
+ */
+export declare function cancelledResult(log: EventLog, runId: string, taskId: string, mode: ModeKind, runDir: string, candidates: {
+    attemptId: string;
+    harnessId: string;
+    status: string;
+}[], writeTelemetry?: () => void, spendUsd?: number | null): OrchestratorResult;
+/**
+ * Terminal safety net for an unexpected throw in a post-announce phase.
+ * Every run must end with failure.yaml + summary + a terminal run.failed
+ * event.
+ */
+export declare function failTerminally(log: EventLog, store: ArtifactStore, paths: ReturnType<ArtifactStore["runPaths"]>, runId: string, taskId: string, mode: ModeKind, phase: string, err: unknown, spendUsd?: number | null): OrchestratorResult;
+/**
+ * Whole-strategy terminal net: run `body`; if it throws AFTER announcing,
+ * stamp terminal artifacts instead of orphaning the run. Pre-announce throws
+ * keep the loud-request contract (the caller gets the error; no run dir
+ * exists). An abort surfaced as a throw is a CANCELLED terminal, not an
+ * internal failure.
+ */
+export declare function guardAnnouncedRun(signal: AbortSignal | undefined, body: (announce: (a: AnnouncedRunContext) => void) => Promise<OrchestratorResult>): Promise<OrchestratorResult>;
+//# sourceMappingURL=runTerminals.d.ts.map

package/dist/runTerminals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTerminals.d.ts","sourceRoot":"","sources":["../src/runTerminals.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;oEACgE;IAChE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,EAC5C,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GACA,IAAI,CAaN;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EACtE,cAAc,CAAC,EAAE,MAAM,IAAI,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,kBAAkB,CAoBpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,EAC5C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,OAAO,EACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,kBAAkB,CA+BpB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,mBAAmB,KAAK,IAAI,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAChF,OAAO,CAAC,kBAAkB,CAAC,CAwB7B"}