@claudexor/orchestrator 3.1.1 → 3.2.0

package/dist/root-ledger.d.ts

@@ -0,0 +1,13 @@
+import { BudgetLedger } from "@claudexor/budget";
+import type { EventLog } from "@claudexor/event-log";
+import type { QuotaSnapshot, TaskContract } from "@claudexor/schema";
+import type { DelegationBudgetAuthority } from "./delegationBudgetAuthority.js";
+import type { RunInput } from "./orchestrator.js";
+export declare function createRootLedger(args: {
+    input: RunInput;
+    contract: TaskContract;
+    log: EventLog;
+    authority?: DelegationBudgetAuthority;
+    quotaSnapshots: readonly QuotaSnapshot[];
+}): BudgetLedger;
+//# sourceMappingURL=root-ledger.d.ts.map

package/dist/root-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-ledger.d.ts","sourceRoot":"","sources":["../src/root-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,QAAQ,CAAC;IACd,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,GAAG,YAAY,CAiCf"}

package/dist/root-ledger.js

@@ -0,0 +1,21 @@
+import { BudgetLedger } from "@claudexor/budget";
+export function createRootLedger(args) {
+    const onCashSettled = (cashSpendUsd, valuationUsd, cashEstimated, valuationKnowledge) => args.log.emit("budget.cash", {
+        cash_spend_usd: cashSpendUsd,
+        valuation_usd: valuationUsd,
+        estimated: cashEstimated,
+        valuation_knowledge: valuationKnowledge,
+    });
+    const ledger = args.input.delegatedFromRunId
+        ? args.authority?.attachChild(args.input.delegatedFromRunId, args.input.delegationAdmissionId ?? "", args.input.runId, args.contract.task_id, onCashSettled)
+        : new BudgetLedger(args.contract.budget.paid_budget, undefined, { onCashSettled });
+    if (!ledger) {
+        throw Object.assign(new Error(`delegated run ${args.contract.task_id} has no daemon-lifetime budget authority for parent ${args.input.delegatedFromRunId}`), { code: "delegation_budget_parent_unavailable", status: 409 });
+    }
+    if (args.input.delegatedFromRunId)
+        args.input.onDelegatedLedgerAttached?.();
+    for (const snapshot of args.quotaSnapshots)
+        ledger.observeQuotaSnapshot(snapshot);
+    return ledger;
+}
+//# sourceMappingURL=root-ledger.js.map

package/dist/root-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-ledger.js","sourceRoot":"","sources":["../src/root-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMjD,MAAM,UAAU,gBAAgB,CAAC,IAMhC;IACC,MAAM,aAAa,GAAG,CACpB,YAAoB,EACpB,YAAoB,EACpB,aAAsB,EACtB,kBAAqD,EACrD,EAAE,CACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE;QAC3B,cAAc,EAAE,YAAY;QAC5B,aAAa,EAAE,YAAY;QAC3B,SAAS,EAAE,aAAa;QACxB,mBAAmB,EAAE,kBAAkB;KACxC,CAAC,CAAC;IACL,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB;QAC1C,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CACzB,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAC7B,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,EAAE,EACtC,IAAI,CAAC,KAAK,CAAC,KAAM,EACjB,IAAI,CAAC,QAAQ,CAAC,OAAO,EACrB,aAAa,CACd;QACH,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACrF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CACP,iBAAiB,IAAI,CAAC,QAAQ,CAAC,OAAO,uDAAuD,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAC7H,EACD,EAAE,IAAI,EAAE,sCAAsC,EAAE,MAAM,EAAE,GAAG,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB;QAAE,IAAI,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,CAAC;IAC5E,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc;QAAE,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/routing-failure.d.ts

@@ -0,0 +1,6 @@
+/** Classify typed routing refusal separately from provider availability. */
+export declare function routingFailureClassification(err: unknown): {
+    category: "config_error" | "harness_unavailable";
+    nextActions?: string[];
+};
+//# sourceMappingURL=routing-failure.d.ts.map

package/dist/routing-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-failure.d.ts","sourceRoot":"","sources":["../src/routing-failure.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG;IAC1D,QAAQ,EAAE,cAAc,GAAG,qBAAqB,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CASA"}

package/dist/routing-failure.js

@@ -0,0 +1,12 @@
+import { harnessFailureNextActions } from "./harnessFailure.js";
+/** Classify typed routing refusal separately from provider availability. */
+export function routingFailureClassification(err) {
+    const isPreflightRefusal = !!err &&
+        typeof err === "object" &&
+        err.code === "routing_preflight_refused";
+    if (isPreflightRefusal) {
+        return { category: "config_error", nextActions: harnessFailureNextActions("config_error") };
+    }
+    return { category: "harness_unavailable" };
+}
+//# sourceMappingURL=routing-failure.js.map

package/dist/routing-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-failure.js","sourceRoot":"","sources":["../src/routing-failure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,4EAA4E;AAC5E,MAAM,UAAU,4BAA4B,CAAC,GAAY;IAIvD,MAAM,kBAAkB,GACtB,CAAC,CAAC,GAAG;QACL,OAAO,GAAG,KAAK,QAAQ;QACtB,GAA0B,CAAC,IAAI,KAAK,2BAA2B,CAAC;IACnE,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,yBAAyB,CAAC,cAAc,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC;AAC7C,CAAC"}

package/dist/run-bounded.d.ts

@@ -0,0 +1,3 @@
+/** Run work with bounded concurrency while preserving each item's source index. */
+export declare function runBounded<T>(items: T[], limit: number, work: (item: T, index: number) => Promise<void>): Promise<void>;
+//# sourceMappingURL=run-bounded.d.ts.map

package/dist/run-bounded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-bounded.d.ts","sourceRoot":"","sources":["../src/run-bounded.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAsB,UAAU,CAAC,CAAC,EAChC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/run-bounded.js

@@ -0,0 +1,23 @@
+/** Run work with bounded concurrency while preserving each item's source index. */
+export async function runBounded(items, limit, work) {
+    if (items.length === 0)
+        return;
+    const concurrency = Math.max(1, Math.min(limit, items.length));
+    let next = 0;
+    const workers = Array.from({ length: concurrency }, async () => {
+        for (;;) {
+            const idx = next++;
+            if (idx >= items.length)
+                return;
+            await work(items[idx], idx);
+        }
+    });
+    // Do not let the first rejected worker release resources that its already
+    // admitted siblings still use. Preserve failure semantics, but only rethrow
+    // after every worker has settled.
+    const settled = await Promise.allSettled(workers);
+    const rejected = settled.find((result) => result.status === "rejected");
+    if (rejected)
+        throw rejected.reason;
+}
+//# sourceMappingURL=run-bounded.js.map

package/dist/run-bounded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-bounded.js","sourceRoot":"","sources":["../src/run-bounded.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAU,EACV,KAAa,EACb,IAA+C;IAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,IAAI,EAAE;QAC7D,SAAS,CAAC;YACR,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;YACnB,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAChC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,0EAA0E;IAC1E,4EAA4E;IAC5E,kCAAkC;IAClC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAC3B,CAAC,MAAM,EAAmC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAC1E,CAAC;IACF,IAAI,QAAQ;QAAE,MAAM,QAAQ,CAAC,MAAM,CAAC;AACtC,CAAC"}

package/dist/run-input-resolution.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedConfig, RoutingGoal } from "@claudexor/schema";
+import type { RunInput } from "./orchestrator.js";
+export interface RunInputResolutionDeps {
+    config: ResolvedConfig;
+    registryIds: Iterable<string>;
+    routingGoal?: RoutingGoal;
+}
+/** Resolve stable pool, primary, model, web, and routing defaults once per run. */
+export declare function resolveRunInputDefaults(input: RunInput, deps: RunInputResolutionDeps): RunInput;
+//# sourceMappingURL=run-input-resolution.d.ts.map

package/dist/run-input-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-input-resolution.d.ts","sourceRoot":"","sources":["../src/run-input-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,GAAG,QAAQ,CAqF/F"}

package/dist/run-input-resolution.js

@@ -0,0 +1,88 @@
+import { HarnessUnavailableError } from "@claudexor/core";
+import { noProjectRepoRoot } from "@claudexor/util";
+/** Resolve stable pool, primary, model, web, and routing defaults once per run. */
+export function resolveRunInputDefaults(input, deps) {
+    if (input.contextMode === "off" &&
+        !(input.mode === "ask" && input.repoRoot === noProjectRepoRoot())) {
+        throw new Error("contextMode 'off' is only supported for Ask without a repoRoot");
+    }
+    const cfg = deps.config;
+    const configuredPool = cfg.global.routing.eligible_harnesses;
+    const harnesses = input.harnesses ?? (configuredPool.length > 0 ? configuredPool : undefined);
+    const explicitPrimary = input.primaryHarness;
+    const configPrimary = cfg.global.routing.primary_harness;
+    const primaryHarness = explicitPrimary ??
+        (input.harnesses?.length === 1 ? input.harnesses[0] : undefined) ??
+        configPrimary ??
+        undefined;
+    if (primaryHarness && harnesses?.length && !harnesses.includes(primaryHarness)) {
+        if (explicitPrimary) {
+            throw new Error(`primary harness '${explicitPrimary}' is not in the eligible harness pool (${harnesses.join(", ")}); ` +
+                `pass --primary-harness as one of [${harnesses.join(", ")}], or add '${explicitPrimary}' to --harness`);
+        }
+        throw new HarnessUnavailableError(`ambiguous primary harness: the configured default primary '${primaryHarness}' is not in the selected pool [${harnesses.join(", ")}], ` +
+            `and no --primary-harness was given. Pin one explicitly, e.g. \`--primary-harness ${harnesses[0]}\` ` +
+            `(or another of [${harnesses.join(", ")}]).`);
+    }
+    if (input.web && input.externalContextPolicy && input.web !== input.externalContextPolicy) {
+        throw new Error(`contradictory web policy: web='${input.web}' vs externalContextPolicy='${input.externalContextPolicy}' (pass one, or equal values)`);
+    }
+    const web = input.web ?? input.externalContextPolicy ?? "auto";
+    // Materialize this iterable exactly once: registry.keys() is repeatable, but
+    // embedders are allowed to supply any Iterable. The same frozen universe is
+    // also the lane snapshot for a pure Auto pool, whose eventual lanes are not
+    // known until routing but whose Settings defaults must already be immutable.
+    const knownHarnessIds = [...new Set(deps.registryIds)];
+    const knownHarnessIdSet = new Set(knownHarnessIds);
+    validateHarnessMap("models", input.models, knownHarnessIds, knownHarnessIdSet);
+    validateHarnessMap("efforts", input.efforts, knownHarnessIds, knownHarnessIdSet);
+    const snapshotLaneIds = harnesses ?? knownHarnessIds;
+    const models = { ...input.models };
+    if (input.model) {
+        const scalarTarget = primaryHarness ?? (harnesses?.length === 1 ? harnesses[0] : undefined);
+        if (!scalarTarget) {
+            throw new Error(`a scalar model ('${input.model}') is ambiguous without a primary harness: ` +
+                `the pool is ${harnesses?.length ? `[${harnesses.join(", ")}]` : "auto-resolved"} — ` +
+                `set a primary harness, pass exactly one --harness, or use a harness-scoped model map`);
+        }
+        models[scalarTarget] ??= input.model;
+    }
+    const harnessCfg = cfg.global.harnesses;
+    for (const harnessId of snapshotLaneIds) {
+        const defaultModel = harnessCfg[harnessId]?.default_model;
+        if (defaultModel)
+            models[harnessId] ??= defaultModel;
+    }
+    const efforts = { ...input.efforts };
+    for (const harnessId of snapshotLaneIds) {
+        const effort = input.effort ?? harnessCfg[harnessId]?.effort;
+        if (effort)
+            efforts[harnessId] ??= effort;
+    }
+    return {
+        ...input,
+        harnesses,
+        primaryHarness,
+        primaryHarnessExplicit: explicitPrimary !== undefined,
+        model: undefined,
+        models,
+        effort: undefined,
+        efforts,
+        routingGoal: input.routingGoal ??
+            deps.routingGoal ??
+            cfg.project.budget?.routing_goal ??
+            cfg.global.routing.goal ??
+            "auto",
+        web,
+        externalContextPolicy: web,
+    };
+}
+function validateHarnessMap(name, values, knownHarnessIds, knownHarnessIdSet) {
+    for (const key of Object.keys(values ?? {})) {
+        if (knownHarnessIdSet.has(key))
+            continue;
+        throw new Error(`${name} map names unknown harness '${key}' (registered: ${[...knownHarnessIds].sort().join(", ")}); ` +
+            `run \`claudexor harness list --all\``);
+    }
+}
+//# sourceMappingURL=run-input-resolution.js.map

package/dist/run-input-resolution.js.map

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

package/dist/runEventLog.d.ts

@@ -0,0 +1,48 @@
+import type { ArtifactStore, RunPaths } from "@claudexor/artifact-store";
+import type { BudgetLedger } from "@claudexor/budget";
+import { EventLog } from "@claudexor/event-log";
+import type { ModeKind, QuotaSnapshot, RunEvent, TaskContract } from "@claudexor/schema";
+import type { DelegationBudgetAuthority } from "./delegationBudgetAuthority.js";
+import type { RunInput } from "./orchestrator.js";
+import { type AnnouncedRunContext } from "./runTerminalContext.js";
+interface RunEventLogInput {
+    threadId?: string;
+    onEventPersist?: (event: RunEvent) => void;
+    onEvent?: (event: RunEvent) => void;
+}
+interface RunAnnouncementInput {
+    input: RunInput;
+    contract: TaskContract;
+    quotaSnapshots: readonly QuotaSnapshot[];
+    store: ArtifactStore;
+    authority?: DelegationBudgetAuthority;
+    runId: string;
+    taskId: string;
+    mode: ModeKind;
+    phase: "race" | "convergence" | "plan" | "report";
+    prompt: string;
+}
+/** Keep durable-journal and live-observer callback ordering identical at every run entry point. */
+export declare function createRunEventLog(eventsPath: string, runId: string, taskId: string, input: RunEventLogInput): EventLog;
+/**
+ * Everything after EventLog construction and before `run.created` persists is
+ * still pre-announce: a ledger or durable-sink refusal must escape without the
+ * terminal safety net. Release live-writer ownership across that whole window
+ * so a failed startup cannot strand the run path behind the duplicate-owner
+ * fence.
+ */
+export declare function prepareRunAnnouncement<T>(log: EventLog, prepare: () => T): T;
+/**
+ * One startup boundary for every run strategy. A delegated ledger must be
+ * attached before run.created (X339), while caller-visible publication must
+ * wait until that event reaches the durable sink. Arm the whole-run terminal
+ * guard before any later preamble callback/event can fail.
+ */
+export declare function beginAnnouncedRun(start: RunAnnouncementInput, announce: (context: AnnouncedRunContext) => void): {
+    store: ArtifactStore;
+    paths: RunPaths;
+    log: EventLog;
+    ledger: BudgetLedger;
+};
+export {};
+//# sourceMappingURL=runEventLog.d.ts.map

package/dist/runEventLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runEventLog.d.ts","sourceRoot":"","sources":["../src/runEventLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEzF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAExF,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,QAAQ,CASV;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAO5E;AAcD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAC/C;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAyBhF"}

package/dist/runEventLog.js

@@ -0,0 +1,63 @@
+import { EventLog } from "@claudexor/event-log";
+import { redactSecrets, safeInvoke } from "@claudexor/util";
+import { createRootLedger } from "./root-ledger.js";
+import { announcedRunContext } from "./runTerminalContext.js";
+/** Keep durable-journal and live-observer callback ordering identical at every run entry point. */
+export function createRunEventLog(eventsPath, runId, taskId, input) {
+    return new EventLog(eventsPath, runId, taskId, input.onEventPersist, input.threadId, input.onEvent);
+}
+/**
+ * Everything after EventLog construction and before `run.created` persists is
+ * still pre-announce: a ledger or durable-sink refusal must escape without the
+ * terminal safety net. Release live-writer ownership across that whole window
+ * so a failed startup cannot strand the run path behind the duplicate-owner
+ * fence.
+ */
+export function prepareRunAnnouncement(log, prepare) {
+    try {
+        return prepare();
+    }
+    catch (error) {
+        log.dispose();
+        throw error;
+    }
+}
+function announcePreparedProjectGitInitialization(input, log) {
+    const result = input.projectGitInitialization;
+    if (!result || (!result.initialized && !result.baselineCommitted))
+        return;
+    log.emit("project.git.initialized", {
+        repo_root: input.repoRoot,
+        initialized: result.initialized,
+        baseline_committed: result.baselineCommitted,
+        gitignore_seeded: result.gitignoreSeeded,
+        head_sha: result.headSha,
+    });
+}
+/**
+ * One startup boundary for every run strategy. A delegated ledger must be
+ * attached before run.created (X339), while caller-visible publication must
+ * wait until that event reaches the durable sink. Arm the whole-run terminal
+ * guard before any later preamble callback/event can fail.
+ */
+export function beginAnnouncedRun(start, announce) {
+    const { input, contract, quotaSnapshots, store, authority, runId, taskId, mode, phase } = start;
+    const paths = store.createRun(runId);
+    const log = createRunEventLog(paths.eventsPath, runId, taskId, input);
+    const ledger = prepareRunAnnouncement(log, () => {
+        const preparedLedger = createRootLedger({
+            input,
+            contract,
+            log,
+            authority,
+            quotaSnapshots,
+        });
+        log.emit("run.created", { mode, prompt: redactSecrets(start.prompt) });
+        return preparedLedger;
+    });
+    announce(announcedRunContext({ log, store, paths, runId, taskId, mode, phase }, ledger, () => authority?.hasParent(runId) === true));
+    safeInvoke(input.onRunStart, { runId, taskId, runDir: paths.root });
+    announcePreparedProjectGitInitialization(input, log);
+    return { store, paths, log, ledger };
+}
+//# sourceMappingURL=runEventLog.js.map

package/dist/runEventLog.js.map

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

package/dist/runFacts.d.ts

@@ -0,0 +1,23 @@
+import { type RunFacts, type RunOutcomeFacts } from "@claudexor/schema";
+import type { AnnouncedRunContext } from "./runTerminals.js";
+import { buildRunFacts } from "./runFactsBuilder.js";
+export { buildRunFacts };
+export interface PreparedRunFactsReceipt {
+    facts: RunFacts;
+    /** Publish telemetry compatibility + the canonical receipt commit marker. */
+    commit: () => void;
+    /** Restore the exact pre-commit marker/telemetry bytes after event failure. */
+    rollback: () => void;
+}
+/**
+ * Prepare the validated receipt before terminal append. EventLog owns the
+ * commit boundary and invokes rollback if the terminal cannot become durable.
+ */
+export declare function prepareRunFactsReceipt(ctx: AnnouncedRunContext, terminalOutcome: RunOutcomeFacts): PreparedRunFactsReceipt;
+/**
+ * A terminal-facts contradiction is itself a failed run. This minimal receipt
+ * deliberately does not trust the contradictory artifact graph, but still
+ * gives every surface a valid, fail-closed canonical outcome.
+ */
+export declare function prepareRunFactsFailureReceipt(ctx: AnnouncedRunContext, failureOutcome: RunOutcomeFacts): PreparedRunFactsReceipt;
+//# sourceMappingURL=runFacts.d.ts.map

package/dist/runFacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFacts.d.ts","sourceRoot":"","sources":["../src/runFacts.ts"],"names":[],"mappings":"AAYA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,QAAQ,CAAC;IAChB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AA6HD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,mBAAmB,EACxB,eAAe,EAAE,eAAe,GAC/B,uBAAuB,CAEzB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,mBAAmB,EACxB,cAAc,EAAE,eAAe,GAC9B,uBAAuB,CAoCzB"}

package/dist/runFacts.js

@@ -0,0 +1,179 @@
+import { randomUUID } from "node:crypto";
+import { closeSync, constants, fsyncSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { RunTelemetry, SCHEMA_VERSION, requiredActionsFor, validateRunFactsInvariants, } from "@claudexor/schema";
+import { nowIso } from "@claudexor/util";
+import { buildRunFacts } from "./runFactsBuilder.js";
+import { terminalFactsFailurePresentation } from "./runFactsPresentation.js";
+export { buildRunFacts };
+function textSnapshot(path) {
+    try {
+        return { existed: true, text: readFileSync(path, "utf8") };
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { existed: false, text: "" };
+        }
+        throw error;
+    }
+}
+function restoreSnapshot(path, prior) {
+    if (!prior.existed) {
+        let removed = false;
+        try {
+            unlinkSync(path);
+            removed = true;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        if (removed)
+            fsyncParentDirectory(dirname(path));
+        return;
+    }
+    replaceTextAtomically(path, prior.text);
+}
+function fsyncParentDirectory(parent) {
+    const parentFd = openSync(parent, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+    try {
+        fsyncSync(parentFd);
+    }
+    finally {
+        closeSync(parentFd);
+    }
+}
+function replaceTextAtomically(path, text) {
+    const parent = dirname(path);
+    const tmp = join(parent, `.run-facts-restore-${randomUUID()}.tmp`);
+    let fileFd = null;
+    try {
+        fileFd = openSync(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+        writeFileSync(fileFd, text, "utf8");
+        fsyncSync(fileFd);
+        closeSync(fileFd);
+        fileFd = null;
+        renameSync(tmp, path);
+        fsyncParentDirectory(parent);
+    }
+    finally {
+        if (fileFd !== null)
+            closeSync(fileFd);
+        try {
+            unlinkSync(tmp);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+}
+function writeYamlAtomically(ctx, path, value) {
+    const parent = dirname(path);
+    const tmp = join(parent, `.run-facts-${randomUUID()}.tmp`);
+    try {
+        ctx.store.writeYaml(tmp, value);
+        const fileFd = openSync(tmp, constants.O_RDONLY | constants.O_NOFOLLOW);
+        try {
+            fsyncSync(fileFd);
+        }
+        finally {
+            closeSync(fileFd);
+        }
+        renameSync(tmp, path);
+        fsyncParentDirectory(parent);
+    }
+    finally {
+        try {
+            unlinkSync(tmp);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+}
+function persistPreparedRunFacts(ctx, facts) {
+    const telemetryPath = join(ctx.paths.finalDir, "telemetry.yaml");
+    const receiptPath = join(ctx.paths.finalDir, "run_facts.yaml");
+    const parsedTelemetry = RunTelemetry.safeParse(ctx.store.readYaml(telemetryPath));
+    const telemetry = parsedTelemetry.success ? parsedTelemetry.data : null;
+    const embedded = telemetry ? RunTelemetry.parse({ ...telemetry, run_facts: facts }) : null;
+    let priorTelemetry = null;
+    let priorReceipt = null;
+    let committed = false;
+    let rolledBack = false;
+    const rollback = () => {
+        if (rolledBack)
+            return;
+        if (priorReceipt)
+            restoreSnapshot(receiptPath, priorReceipt);
+        if (priorTelemetry)
+            restoreSnapshot(telemetryPath, priorTelemetry);
+        rolledBack = true;
+    };
+    const commit = () => {
+        if (committed)
+            return;
+        if (rolledBack)
+            throw new Error("cannot commit a rolled-back RunFacts receipt");
+        priorTelemetry = textSnapshot(telemetryPath);
+        priorReceipt = textSnapshot(receiptPath);
+        if (embedded)
+            writeYamlAtomically(ctx, telemetryPath, embedded);
+        // Land the canonical marker last, after its telemetry compatibility copy.
+        writeYamlAtomically(ctx, receiptPath, facts);
+        committed = true;
+    };
+    return { facts, commit, rollback };
+}
+/**
+ * Prepare the validated receipt before terminal append. EventLog owns the
+ * commit boundary and invokes rollback if the terminal cannot become durable.
+ */
+export function prepareRunFactsReceipt(ctx, terminalOutcome) {
+    return persistPreparedRunFacts(ctx, buildRunFacts(ctx, terminalOutcome));
+}
+/**
+ * A terminal-facts contradiction is itself a failed run. This minimal receipt
+ * deliberately does not trust the contradictory artifact graph, but still
+ * gives every surface a valid, fail-closed canonical outcome.
+ */
+export function prepareRunFactsFailureReceipt(ctx, failureOutcome) {
+    const facts = validateRunFactsInvariants({
+        schema_version: SCHEMA_VERSION,
+        run_id: ctx.runId,
+        task_id: ctx.taskId,
+        mode: ctx.mode,
+        outcome: failureOutcome,
+        deliverable: {
+            present: false,
+            kind: null,
+            path: null,
+            producer_attempt_id: null,
+        },
+        presentation: terminalFactsFailurePresentation(ctx),
+        participants: { planners: 0, attempts: [] },
+        gates: {
+            configured: false,
+            required: 0,
+            total: 0,
+            executed: false,
+            state: "not_configured",
+            receipt_attempt_id: null,
+        },
+        review: {
+            state: failureOutcome.review,
+            blocker_ids: [],
+            blockers: 0,
+        },
+        apply: {
+            eligibility: null,
+            operator_decision_present: false,
+        },
+        required_actions: requiredActionsFor(failureOutcome, false),
+        generated_at: nowIso(),
+    });
+    return persistPreparedRunFacts(ctx, facts);
+}
+//# sourceMappingURL=runFacts.js.map

package/dist/runFacts.js.map

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

package/dist/runFactsBuilder.d.ts

@@ -0,0 +1,5 @@
+import { RunFacts, type RunOutcomeFacts } from "@claudexor/schema";
+import type { AnnouncedRunContext } from "./runTerminals.js";
+/** Build and validate the terminal projection from canonical artifacts. */
+export declare function buildRunFacts(ctx: AnnouncedRunContext, terminalOutcome: RunOutcomeFacts): RunFacts;
+//# sourceMappingURL=runFactsBuilder.d.ts.map

package/dist/runFactsBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFactsBuilder.d.ts","sourceRoot":"","sources":["../src/runFactsBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,QAAQ,EAQR,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAmZ7D,2EAA2E;AAC3E,wBAAgB,aAAa,CAC3B,GAAG,EAAE,mBAAmB,EACxB,eAAe,EAAE,eAAe,GAC/B,QAAQ,CAgHV"}