@claudexor/orchestrator 3.20.1 → 3.23.0

package/dist/continuation-custody.d.ts

@@ -0,0 +1,57 @@
+import type { EventLog } from "@claudexor/event-log";
+import { type EnvelopeCustody, type RunOutcomeFacts, type WorkspaceEnvelope } from "@claudexor/schema";
+import { type CreateEnvelopeOptions, type WorkspaceManager } from "@claudexor/workspace";
+import type { CandidateRun } from "./candidateEvidence.js";
+import type { ContinueFromSource } from "./continue-from.js";
+import type { AnnouncedRunContext } from "./runTerminalContext.js";
+/** The per-attempt native session capsule file, written by the in-run
+ * continuation loop when `started` reports a native session id. */
+export declare function sessionCapsuleFile(attemptDir: string): string;
+/** What the daemon hands a run about continuation (`RunInput.continuation`). */
+export interface RunContinuation {
+    /** Keep this run's stopped work for `continueFrom`. Only a daemon-owned run
+     * sets it: only the daemon admits a successor or discards a kept envelope. */
+    retain: boolean;
+    /** The predecessor's retained envelope this run adopts (`continueFrom`). */
+    adopt?: EnvelopeCustody | null;
+    /** The predecessor whose work the first candidate attempt continues
+     * (`continueFrom`); consumed by that attempt (`continue-from.ts`). */
+    from?: ContinueFromSource | null;
+}
+/**
+ * The custody hooks of one run's candidate slot: `envelope` creates (or, for a
+ * `continueFrom` successor, adopts) the candidate's envelope; `settle` keeps or
+ * stages it until the final run outcome. Only a daemon-owned, single-candidate,
+ * mutating run (`keepable`) records custody; every other run keeps today's
+ * create/dispose behaviour.
+ */
+export declare function forRun(input: {
+    continuation?: RunContinuation;
+    signal?: AbortSignal;
+}, keepable: boolean, runId: string, paths: {
+    root: string;
+    attemptsDir: string;
+}, log?: EventLog): {
+    envelope: (wsm: WorkspaceManager, opts: CreateEnvelopeOptions) => Promise<{
+        id: string;
+        task_id: string;
+        attempt_id: string;
+        repo_root: string;
+        base_ref: string | null;
+        base_sha: string | null;
+        worktree_path: string;
+        branch_name: string | null;
+        workspace_kind?: "directory" | "git" | undefined;
+        scope_paths?: string[] | undefined;
+        home_dir: string;
+        harness_config_dirs: Record<string, string>;
+        policy_profile: string;
+        dirty_policy: "refuse" | "snapshot";
+        created_at: string;
+    }>;
+    settle: (wsm: WorkspaceManager, env: WorkspaceEnvelope, runs: readonly (CandidateRun | undefined)[]) => Promise<void>;
+    finish: (facts: RunOutcomeFacts) => Promise<void>;
+};
+/** Settle custody after the strategy and Delegate budget verdict, before terminal publication. */
+export declare function flushContinuationTerminal(context: AnnouncedRunContext, facts: RunOutcomeFacts): Promise<void>;
+//# sourceMappingURL=continuation-custody.d.ts.map

package/dist/continuation-custody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-custody.d.ts","sourceRoot":"","sources":["../src/continuation-custody.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAOL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAOnE;mEACmE;AACnE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B;kFAC8E;IAC9E,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B;0EACsE;IACtE,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE;IAAE,YAAY,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,EAC/D,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAC5C,GAAG,CAAC,EAAE,QAAQ;oBAyBU,gBAAgB,QAAQ,qBAAqB;;;;;;;;;;;;;;;;;kBAY5D,gBAAgB,OAChB,iBAAiB,QAChB,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE;oBA/BlB,eAAe;EAsC7C;AA0FD,kGAAkG;AAClG,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/continuation-custody.js

@@ -0,0 +1,151 @@
+/**
+ * Envelope custody of a single-candidate Agent run (A9, PLAN §2.2).
+ *
+ * Start: a `continueFrom` successor adopts its predecessor's retained envelope
+ * (same path, base and files); any other single-candidate mutating run gets a
+ * fresh isolated envelope with `live` custody recorded before the harness runs.
+ * End: the envelope is kept (`retained`) when the work stopped unfinished
+ * (a non-success run terminal, or a needs_input / incomplete report) AND there is
+ * something to continue (a tree that differs from its base, or a native
+ * session capsule); otherwise it is disposed as before. Race candidates,
+ * synthesis, review and in-place envelopes are untouched.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { RunResumable, } from "@claudexor/schema";
+import { adoptRetainedEnvelope, envelopeBaseOf, envelopeTreeChanged, readEnvelopeCustody, retainForContinuation, retainedEnvelopeOfRun, } from "@claudexor/workspace";
+/** The per-attempt native session capsule file, written by the in-run
+ * continuation loop when `started` reports a native session id. */
+export function sessionCapsuleFile(attemptDir) {
+    return join(attemptDir, "session-capsule.json");
+}
+/**
+ * The custody hooks of one run's candidate slot: `envelope` creates (or, for a
+ * `continueFrom` successor, adopts) the candidate's envelope; `settle` keeps or
+ * stages it until the final run outcome. Only a daemon-owned, single-candidate,
+ * mutating run (`keepable`) records custody; every other run keeps today's
+ * create/dispose behaviour.
+ */
+export function forRun(input, keepable, runId, paths, log) {
+    const holder = input.continuation?.retain && keepable ? { runId, runDir: paths.root } : null;
+    const pending = new Map();
+    const finish = async (facts) => {
+        for (const { wsm, env, runs } of pending.values()) {
+            await settleCandidateEnvelope(wsm, env, {
+                runs,
+                signal: input.signal,
+                attemptsDir: paths.attemptsDir,
+                log,
+                facts,
+            });
+            pending.delete(env.id);
+        }
+    };
+    if (holder && log) {
+        log.deferTerminal();
+        pendingRuns.set(log, finish);
+    }
+    return {
+        envelope: async (wsm, opts) => {
+            const env = await candidateEnvelope(wsm, holder, holder ? (input.continuation?.adopt ?? null) : null, opts);
+            if (holder && readEnvelopeCustody(envelopeBaseOf(env))?.holder_run_id === holder.runId)
+                pending.set(env.id, { wsm, env, runs: [] });
+            return env;
+        },
+        settle: async (wsm, env, runs) => {
+            if (pending.has(env.id))
+                pending.set(env.id, { wsm, env, runs });
+            else
+                await wsm.dispose(env);
+        },
+        finish,
+    };
+}
+/**
+ * The candidate's envelope: the predecessor's retained envelope when `adopt`
+ * hands one over (adoption transfers custody, never deletes), else a new one —
+ * with `live` custody when `holder` says this run may keep it.
+ */
+async function candidateEnvelope(wsm, holder, adopt, opts) {
+    if (!holder || opts.inPlace || opts.workspaceKind === "directory")
+        return wsm.create(opts);
+    if (adopt)
+        return adoptRetainedEnvelope(adopt, holder);
+    return wsm.create({ ...opts, custody: holder });
+}
+/** Why the candidate's work is unfinished (null = unfinished, cause not known
+ * at this layer), or undefined when it finished. */
+function unfinishedCause(run, signal, facts) {
+    if (signal?.aborted)
+        return signal.reason === "wall_clock_exceeded" ? "wall_clock" : "cancelled";
+    const state = run?.telemetry.outcome?.workState?.state;
+    if (state === "needs_input")
+        return "input_required";
+    if (facts.lifecycle !== "succeeded")
+        return facts.reason === "context_capacity_exhausted"
+            ? "context_exhausted"
+            : (run?.resumable?.cause ?? null);
+    return state === "incomplete" ? null : undefined;
+}
+async function worthKeeping(env, run, attemptsDir) {
+    if (run && run.diff.trim().length > 0)
+        return true;
+    const attempts = new Set([env.attempt_id, ...(run ? [run.attemptId] : [])]);
+    if ([...attempts].some((id) => existsSync(sessionCapsuleFile(join(attemptsDir, id))))) {
+        return true;
+    }
+    return (await envelopeTreeChanged(env)) === true;
+}
+/**
+ * End of a candidate: keep or dispose its envelope. Only an envelope under
+ * this run's `live` custody can be kept; everything else is disposed exactly
+ * as before. Keeping is durable before the run's terminal is reported and is
+ * disclosed with a `workspace.retained` event (disk use measured once).
+ */
+async function settleCandidateEnvelope(wsm, env, ctx) {
+    const custody = readEnvelopeCustody(envelopeBaseOf(env));
+    if (custody?.state !== "live" || custody.envelope.id !== env.id)
+        return wsm.dispose(env);
+    const run = ctx.runs.find((candidate) => candidate?.reviewCwd === env.worktree_path);
+    const cause = unfinishedCause(run, ctx.signal, ctx.facts);
+    if (cause === undefined || !(await worthKeeping(env, run, ctx.attemptsDir))) {
+        return wsm.dispose(env);
+    }
+    const holder = { runId: custody.holder_run_id, runDir: custody.holder_run_dir };
+    const retained = retainForContinuation(env, holder, cause);
+    // The terminal `resumable` block (written after this settle) names the kept tree.
+    // Deferred terminal payloads share these workspace objects, including a
+    // resumableOnFailure promoted by the final budget verdict.
+    for (const resumable of [run?.resumable, run?.resumableOnFailure])
+        if (resumable)
+            Object.assign(resumable.workspace, { kind: "retained_envelope", root: env.worktree_path });
+    ctx.log?.emit("workspace.retained", {
+        attempt_id: run?.attemptId ?? env.attempt_id,
+        root: env.worktree_path,
+        cause,
+        bytes: retained.bytes,
+    });
+}
+const pendingRuns = new WeakMap();
+/** Settle custody after the strategy and Delegate budget verdict, before terminal publication. */
+export async function flushContinuationTerminal(context, facts) {
+    const finish = pendingRuns.get(context.log);
+    try {
+        if (finish) {
+            await finish(facts);
+            const kept = retainedEnvelopeOfRun(context.paths.root, context.runId);
+            const path = join(context.paths.finalDir, "resumable.yaml");
+            const resumable = RunResumable.safeParse(context.store.readYaml(path)).data;
+            if (kept && resumable)
+                context.store.writeYaml(path, {
+                    ...resumable,
+                    workspace: { kind: "retained_envelope", root: kept.envelope.worktree_path },
+                });
+        }
+    }
+    finally {
+        pendingRuns.delete(context.log);
+        context.log.flushDeferredTerminal();
+    }
+}
+//# sourceMappingURL=continuation-custody.js.map

package/dist/continuation-custody.js.map

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

package/dist/continuation-evidence-io.d.ts

@@ -0,0 +1,18 @@
+import type { ResumableCause } from "@claudexor/schema";
+import type { EvidenceIndexInput, EvidenceIndexSources, EvidenceSteering, EvidenceToolCall } from "./continuation-evidence.js";
+type Row = Record<string, unknown>;
+/** Pair typed use ids within a native try; ambiguous ids remain unresolved. */
+export declare function toolCallIndex(events: readonly Row[]): EvidenceToolCall[];
+/** Admitted steering messages of a run, with delivery status, in admission order. */
+export declare function steeringFromRunLog(runDir: string, attemptId?: string): EvidenceSteering[];
+/** Resolve the pure builder's input from the run dir plus the loop's in-memory facts. */
+export declare function collectEvidenceIndexInput(sources: EvidenceIndexSources, extras: {
+    cause: ResumableCause;
+    retainedOutput: string;
+    diffStat: string | null;
+    completed?: boolean;
+}): EvidenceIndexInput;
+/** `git diff`-style file list from a unified diff: one line per changed path. */
+export declare function diffStatFromPatch(diff: string): string | null;
+export {};
+//# sourceMappingURL=continuation-evidence-io.d.ts.map

package/dist/continuation-evidence-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-evidence-io.d.ts","sourceRoot":"","sources":["../src/continuation-evidence-io.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAEpC,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAqCnC,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,EAAE,GAAG,gBAAgB,EAAE,CAsCxE;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkBzF;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE;IACN,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA,kBAAkB,CA8CpB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D"}

package/dist/continuation-evidence-io.js

@@ -0,0 +1,167 @@
+/**
+ * Evidence-index collector — the I/O half of `continuation-evidence.ts`.
+ *
+ * Reads the predecessor's durable record (the run's `events.jsonl` and, for
+ * read-only attempts, the attempt's own `events.jsonl`) into the pure
+ * builder's input: tool calls paired by try/session and typed use id (legacy
+ * results without an id close the oldest open call), and admitted steering
+ * messages with their delivery status (`message.delivered` = confirmed; an
+ * `accepted` row with no closing = uncertain; refused = not sent), and the
+ * absolute artifact paths. Never throws: unreadable evidence yields an empty
+ * index section, never a failed continuation.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+function readRows(path) {
+    if (!existsSync(path))
+        return [];
+    try {
+        return readFileSync(path, "utf8")
+            .split("\n")
+            .filter((line) => line.trim())
+            .flatMap((line) => {
+            try {
+                const parsed = JSON.parse(line);
+                return parsed && typeof parsed === "object" ? [parsed] : [];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function asRow(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+/** The attempt's harness events: attempt-local log first, else the run log filtered by attempt. */
+function attemptHarnessEvents(runDir, attemptId) {
+    const own = readRows(join(runDir, "attempts", attemptId, "events.jsonl"));
+    if (own.length > 0)
+        return own;
+    return readRows(join(runDir, "events.jsonl")).flatMap((row) => {
+        const payload = asRow(row["payload"]);
+        return row["type"] === "harness.event" && payload && payload["attempt_id"] === attemptId
+            ? [payload]
+            : [];
+    });
+}
+/** Pair typed use ids within a native try; ambiguous ids remain unresolved. */
+export function toolCallIndex(events) {
+    const calls = [];
+    for (const ev of events) {
+        const tool = asRow(ev["tool"]);
+        const id = typeof tool?.["use_id"] === "string" ? tool["use_id"] : null;
+        const target = typeof tool?.["target"] === "string" ? tool["target"] : null;
+        // A file edit the vendor reports twice (codex: started, then completed) is
+        // one call per path; the later frame for the same path is the completion
+        // (one codex item may carry several paths under one id).
+        const sameEdit = ev["type"] === "file_change" && id !== null
+            ? calls.filter((entry) => entry.id === id &&
+                entry.session === ev["session_id"] &&
+                (target === null || entry.call.target === target))
+            : [];
+        if (sameEdit.length > 0) {
+            const open = sameEdit.find((entry) => !entry.call.resolved);
+            if (open)
+                open.call.resolved = true;
+        }
+        else if (ev["type"] === "tool_call" || (ev["type"] === "file_change" && tool)) {
+            const name = typeof tool?.["name"] === "string" && tool["name"].trim()
+                ? tool["name"]
+                : typeof ev["text"] === "string" && ev["text"].trim()
+                    ? ev["text"].split("\n")[0].slice(0, 80)
+                    : "tool";
+            calls.push({ call: { name, target, resolved: false }, session: ev["session_id"], id });
+        }
+        else if (ev["type"] === "tool_result") {
+            const open = calls.filter((entry) => !entry.call.resolved && entry.session === ev["session_id"]);
+            const matched = id === null ? open.slice(0, 1) : open.filter((entry) => entry.id === id);
+            if (matched.length === 1)
+                matched[0].call.resolved = true;
+        }
+    }
+    return calls.map((entry) => entry.call);
+}
+/** Admitted steering messages of a run, with delivery status, in admission order. */
+export function steeringFromRunLog(runDir, attemptId) {
+    const byId = new Map();
+    for (const row of readRows(join(runDir, "events.jsonl"))) {
+        const payload = asRow(row["payload"]);
+        const rowAttempt = payload?.["attempt_id"] ?? row["attempt_id"];
+        if (attemptId !== undefined && typeof rowAttempt === "string" && rowAttempt !== attemptId)
+            continue;
+        const id = typeof payload?.["message_id"] === "string" ? payload["message_id"] : null;
+        const text = typeof payload?.["text"] === "string" ? payload["text"] : null;
+        if (!id || text === null)
+            continue;
+        const entry = byId.get(id) ?? { text, delivery: "uncertain", refused: false };
+        if (row["type"] === "message.accepted")
+            byId.set(id, entry);
+        else if (row["type"] === "message.delivered")
+            byId.set(id, { ...entry, delivery: "confirmed" });
+        else if (row["type"] === "message.refused")
+            byId.set(id, { ...entry, refused: true });
+    }
+    return [...byId.values()]
+        .filter((entry) => !entry.refused)
+        .map(({ text, delivery }) => ({ text, delivery }));
+}
+/** Resolve the pure builder's input from the run dir plus the loop's in-memory facts. */
+export function collectEvidenceIndexInput(sources, extras) {
+    const attemptDir = join(sources.runDir, "attempts", sources.attemptId);
+    const eventsLog = join(sources.runDir, "events.jsonl");
+    const attemptPatch = join(attemptDir, "patch.diff");
+    const patch = existsSync(attemptPatch)
+        ? attemptPatch
+        : join(sources.runDir, "final", "patch.diff");
+    const current = {
+        cause: extras.cause,
+        ...(extras.completed ? { completed: true } : {}),
+        workOrder: sources.workOrder,
+        steering: sources.steering.length > 0
+            ? sources.steering
+            : steeringFromRunLog(sources.runDir, sources.attemptId),
+        retainedOutput: extras.retainedOutput,
+        toolCalls: toolCallIndex(attemptHarnessEvents(sources.runDir, sources.attemptId)),
+        diffStat: extras.diffStat,
+        artifacts: {
+            eventsLog: existsSync(eventsLog) ? eventsLog : null,
+            attemptDir: existsSync(attemptDir) ? attemptDir : null,
+            patch: existsSync(patch) ? patch : null,
+        },
+    };
+    const preceding = sources.predecessors?.map((source) => collectEvidenceIndexInput(source, {
+        cause: extras.cause,
+        retainedOutput: source.retainedOutput,
+        diffStat: source.diffStat,
+    })) ?? [];
+    if (preceding.length === 0)
+        return current;
+    const all = [...preceding, current];
+    return {
+        ...current,
+        steering: all.flatMap((input) => input.steering),
+        retainedOutput: all
+            .map((input) => input.retainedOutput)
+            .filter(Boolean)
+            .join("\n\n"),
+        toolCalls: all.flatMap((input) => input.toolCalls),
+        diffStat: [...new Set(all.flatMap((input) => input.diffStat?.split("\n") ?? []))].join("\n") || null,
+        predecessorArtifacts: preceding.map((input) => input.artifacts),
+    };
+}
+/** `git diff`-style file list from a unified diff: one line per changed path. */
+export function diffStatFromPatch(diff) {
+    if (!diff.trim())
+        return null;
+    const files = diff
+        .split("\n")
+        .filter((line) => line.startsWith("diff --git "))
+        .map((line) => line.slice("diff --git ".length).split(" b/").pop() ?? line)
+        .filter((path) => path.trim());
+    return files.length ? files.map((path) => `- ${path}`).join("\n") : null;
+}
+//# sourceMappingURL=continuation-evidence-io.js.map

package/dist/continuation-evidence-io.js.map

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

package/dist/continuation-evidence.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Evidence-index packet builder — PURE (A10).
+ *
+ * When no native carrier exists (the vendor refused the moved session, the
+ * adapter cannot move, the mind asked for a re-brief), the successor is a
+ * FRESH vendor session re-grounded by an EVIDENCE INDEX: the original work
+ * order, admitted steering (live messages) with their delivery status, the
+ * retained assistant output, a tool-call index (name, completed / unresolved),
+ * the diff stat and absolute paths to the predecessor's event log and attempt
+ * artifacts readable from the new environment. Bounded inline with honest
+ * truncation (`summarized` is true also when a single section was cut). No
+ * second summarizer, no recap model call.
+ *
+ * This is NOT the thread continuation packet (`continuity.ts`
+ * `buildContinuation`, INV-137): thread turns and the D-16d context-exhaustion
+ * continuation keep that packet; the evidence index serves in-run packet hops
+ * and `continueFrom`.
+ */
+import type { ResumableCause } from "@claudexor/schema";
+/** Admitted steering message of the predecessor (POST /v2/runs/:id/messages). */
+export interface EvidenceSteering {
+    text: string;
+    /** confirmed: the vendor echoed it into its history; uncertain: it may not have been delivered. */
+    delivery: "confirmed" | "uncertain";
+}
+/** Where the I/O collector reads the predecessor's evidence. */
+export interface EvidenceIndexSources {
+    runDir: string;
+    attemptId: string;
+    workOrder: string;
+    steering: EvidenceSteering[];
+    /** Earlier runs, oldest first; each keeps its own tool-result pairing boundary. */
+    predecessors?: readonly PredecessorEvidenceSource[];
+}
+export type PredecessorEvidenceSource = Omit<EvidenceIndexSources, "predecessors"> & {
+    retainedOutput: string;
+    diffStat: string | null;
+};
+export interface EvidenceToolCall {
+    name: string;
+    target: string | null;
+    /** False when the call never saw its result (cut off). */
+    resolved: boolean;
+}
+/** Fully-resolved inputs of the pure builder (the collector reads them from the run dir). */
+export interface EvidenceIndexInput {
+    cause: ResumableCause;
+    completed?: boolean;
+    workOrder: string;
+    steering: EvidenceSteering[];
+    /** The retained assistant output (`final/retained-output.md` or the attempt's answer), "" when none. */
+    retainedOutput: string;
+    toolCalls: EvidenceToolCall[];
+    /** `git diff --stat`-style file list of the predecessor's tree, null when unknown. */
+    diffStat: string | null;
+    /** Absolute paths readable from the new environment; null when absent. */
+    artifacts: {
+        eventsLog: string | null;
+        attemptDir: string | null;
+        patch: string | null;
+    };
+    predecessorArtifacts?: EvidenceIndexInput["artifacts"][];
+}
+export interface EvidenceIndex {
+    /** The packet body delivered to the successor (bounded). */
+    markdown: string;
+    /** True when any section was truncated or collapsed. */
+    summarized: boolean;
+    toolCalls: number;
+    unresolvedToolCalls: number;
+    bytes: number;
+}
+/** Per-section verbatim budget. */
+export declare const EVIDENCE_SECTION_BUDGET_BYTES: number;
+/** Whole-index budget; the tool index collapses to counts past it. */
+export declare const EVIDENCE_TOTAL_BUDGET_BYTES: number;
+/** Tool rows kept verbatim before the index collapses to counts. */
+export declare const EVIDENCE_TOOL_ROWS = 60;
+/** Pure: render the bounded evidence index for a packet carrier. */
+export declare function buildEvidenceIndex(input: EvidenceIndexInput): EvidenceIndex;
+//# sourceMappingURL=continuation-evidence.d.ts.map

package/dist/continuation-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-evidence.d.ts","sourceRoot":"","sources":["../src/continuation-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,QAAQ,EAAE,WAAW,GAAG,WAAW,CAAC;CACrC;AAED,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,mFAAmF;IACnF,YAAY,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACrD;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,GAAG;IACnF,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,wGAAwG;IACxG,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0EAA0E;IAC1E,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzF,oBAAoB,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mCAAmC;AACnC,eAAO,MAAM,6BAA6B,QAAW,CAAC;AACtD,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,QAAY,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAqCrC,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAgF3E"}

package/dist/continuation-evidence.js

@@ -0,0 +1,122 @@
+/** Per-section verbatim budget. */
+export const EVIDENCE_SECTION_BUDGET_BYTES = 8 * 1024;
+/** Whole-index budget; the tool index collapses to counts past it. */
+export const EVIDENCE_TOTAL_BUDGET_BYTES = 24 * 1024;
+/** Tool rows kept verbatim before the index collapses to counts. */
+export const EVIDENCE_TOOL_ROWS = 60;
+function bytes(text) {
+    return Buffer.byteLength(text, "utf8");
+}
+/** Truncate to at most `maxBytes` UTF-8 bytes on a safe char boundary. */
+function bound(text, maxBytes) {
+    if (bytes(text) <= maxBytes)
+        return { text, cut: false };
+    const marker = "\n…[truncated]";
+    const buf = Buffer.from(text, "utf8").subarray(0, Math.max(0, maxBytes - bytes(marker)));
+    for (let trim = 0; trim <= 3 && trim <= buf.length; trim += 1) {
+        try {
+            const decoded = new TextDecoder("utf-8", { fatal: true }).decode(trim === 0 ? buf : buf.subarray(0, buf.length - trim));
+            return { text: `${decoded}${marker}`, cut: true };
+        }
+        catch {
+            /* prefix ended inside a scalar; back off */
+        }
+    }
+    return { text: `${buf.toString("utf8")}${marker}`, cut: true };
+}
+const CAUSE_LINE = {
+    vendor_limit: "a usage limit on its account",
+    pool_exhausted: "every account's usage limit",
+    pinned_limit: "the pinned account's usage limit",
+    transport: "a process death",
+    context_exhausted: "context exhaustion",
+    wall_clock: "the wall-clock deadline",
+    cancelled: "a cancel",
+    host_restart: "a host restart",
+    input_required: "a request for input",
+    other: "an interruption",
+};
+/** Pure: render the bounded evidence index for a packet carrier. */
+export function buildEvidenceIndex(input) {
+    let summarized = false;
+    const section = (text) => {
+        const b = bound(text.trim(), EVIDENCE_SECTION_BUDGET_BYTES);
+        summarized ||= b.cut;
+        return b.text;
+    };
+    const unresolved = input.toolCalls.filter((call) => !call.resolved);
+    const parts = [
+        input.completed
+            ? "# Evidence index of the previous work"
+            : "# Evidence index of the interrupted work",
+        "",
+        input.completed
+            ? "This index records the completed predecessor's work order, messages and actions. Check the current workspace before relying on its changes."
+            : `The previous process stopped (${CAUSE_LINE[input.cause]}) before finishing. This index is mechanical evidence of what it was asked, told and did; it is not a summary. The workspace is as it was left.`,
+        "",
+        "## Original work order",
+        "",
+        section(input.workOrder) || "(empty)",
+        "",
+    ];
+    if (input.steering.length > 0) {
+        parts.push("## Messages sent while it ran", "");
+        for (const [index, message] of input.steering.entries()) {
+            const delivery = message.delivery === "confirmed"
+                ? "delivered"
+                : "delivery uncertain — reconcile against the work, do not replay blindly";
+            parts.push(`### Message ${index + 1} (${delivery})`, "", section(message.text), "");
+        }
+    }
+    parts.push("## Retained assistant output", "");
+    parts.push(input.retainedOutput.trim() ? section(input.retainedOutput) : "(no output retained)");
+    parts.push("", "## Tool calls", "");
+    if (input.toolCalls.length === 0) {
+        parts.push("(none recorded)");
+    }
+    else if (input.toolCalls.length > EVIDENCE_TOOL_ROWS) {
+        summarized = true;
+        parts.push(`${input.toolCalls.length} tool calls recorded, ${unresolved.length} without a recorded result (cut off). The last ${EVIDENCE_TOOL_ROWS} follow:`, "", ...input.toolCalls.slice(-EVIDENCE_TOOL_ROWS).map(toolRow));
+    }
+    else {
+        parts.push(...input.toolCalls.map(toolRow));
+    }
+    parts.push("", "## Changed files", "");
+    parts.push(input.diffStat && input.diffStat.trim() ? section(input.diffStat) : "(no diff stat)");
+    const refs = [input.artifacts, ...(input.predecessorArtifacts ?? [])]
+        .flatMap((artifacts) => [
+        artifacts.eventsLog && `- Event log: ${artifacts.eventsLog}`,
+        artifacts.attemptDir && `- Attempt artifacts: ${artifacts.attemptDir}`,
+        artifacts.patch && `- Patch so far: ${artifacts.patch}`,
+    ])
+        .filter((line) => typeof line === "string");
+    const footer = [
+        "",
+        "",
+        "## Full evidence",
+        "",
+        refs.length ? section(refs.join("\n")) : "(no artifact paths available)",
+        "",
+        `Tool calls: ${input.toolCalls.length}; unresolved: ${unresolved.length}.`,
+        "",
+    ].join("\n");
+    const prose = parts
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trimEnd();
+    const total = bound(prose, EVIDENCE_TOTAL_BUDGET_BYTES - bytes(footer));
+    summarized ||= total.cut;
+    const markdown = total.text + footer;
+    return {
+        markdown,
+        summarized,
+        toolCalls: input.toolCalls.length,
+        unresolvedToolCalls: unresolved.length,
+        bytes: bytes(markdown),
+    };
+}
+function toolRow(call) {
+    const target = call.target ? ` — ${call.target.replace(/\s+/g, " ").slice(0, 160)}` : "";
+    return `- ${call.name}${target} (${call.resolved ? "completed" : "unresolved: no result recorded"})`;
+}
+//# sourceMappingURL=continuation-evidence.js.map