@claudexor/cli 3.1.2 → 3.2.0

package/dist/run-detail-projections.d.ts

@@ -1,3 +1,11 @@
+import { type ControlPrimaryOutput as ControlPrimaryOutputType, type RunFailure as RunFailureType } from "@claudexor/schema";
+export type PrimaryOutputPresentation = Pick<ControlPrimaryOutputType, "kind" | "path" | "text"> & {
+    truncated?: boolean;
+};
+/** Schema-validate the Control API's single primary-output owner. */
+export declare function projectRunPrimaryOutput(detail: Record<string, unknown> | null): ControlPrimaryOutputType | null;
+/** Inline non-patch output with an honest bounded-preview disclosure. */
+export declare function presentRunPrimaryOutput(output: PrimaryOutputPresentation | null): string | null;
 export type ApplyEligibilityProjection = {
     eligible: boolean;
     state: string | null;
@@ -7,10 +15,25 @@ export type ApplyEligibilityProjection = {
 export declare function projectApplyEligibility(detail: Record<string, unknown> | null): ApplyEligibilityProjection | null;
 export declare function projectRunSpendUsd(detail: Record<string, unknown> | null): number | null;
 export declare function projectRunCouncil(detail: Record<string, unknown> | null): unknown;
+/** Preserve only the schema-owned typed terminal failure. Every surface uses
+ * this projection instead of forwarding an arbitrary failure-shaped object. */
+export declare function projectRunFailure(detail: Record<string, unknown> | null): RunFailureType | null;
 export declare function projectRunLineage(detail: Record<string, unknown> | null): {
     parentRunId: string | null;
     delegatedFromRunId: string | null;
     delegation: Record<string, unknown> | null;
 };
 export declare function projectOutcomeBanner(detail: Record<string, unknown> | null): string | null;
+/** Typed description of a raised post-terminal run-detail problem for surfaces
+ * that must DEGRADE instead of failing the caller (MCP results, ACP turn
+ * results, --json outcome projections): the finished run's result survives with
+ * its runId, and this field discloses WHY its detail projections are absent.
+ * The CLI's own terminal path keeps the raise (renderCliFailure, non-zero
+ * exit) — there the run result IS the process outcome. */
+export interface RunDetailProblem {
+    code: string | null;
+    message: string;
+    retryable: boolean | null;
+}
+export declare function describeRunDetailProblem(error: unknown): RunDetailProblem;
 //# sourceMappingURL=run-detail-projections.d.ts.map

package/dist/run-detail-projections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-detail-projections.d.ts","sourceRoot":"","sources":["../src/run-detail-projections.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,0BAA0B,GAAG,IAAI,CAGnC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAOxF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAGjF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C,CAcA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG1F"}
+{"version":3,"file":"run-detail-projections.d.ts","sourceRoot":"","sources":["../src/run-detail-projections.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,IAAI,wBAAwB,EACrD,KAAK,UAAU,IAAI,cAAc,EAClC,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG;IACjG,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,wBAAwB,GAAG,IAAI,CAGjC;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAO/F;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,0BAA0B,GAAG,IAAI,CAGnC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAOxF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAGjF;AAED;+EAC+E;AAC/E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,cAAc,GAAG,IAAI,CAG/F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C,CAcA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG1F;AAED;;;;;0DAK0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAOzE"}

package/dist/run-detail-projections.js

@@ -1,4 +1,21 @@
-import { CouncilProjection } from "@claudexor/schema";
+import { ControlPrimaryOutput, CouncilProjection, RunFailure, } from "@claudexor/schema";
+import { redactSecrets } from "@claudexor/util";
+/** Schema-validate the Control API's single primary-output owner. */
+export function projectRunPrimaryOutput(detail) {
+    const parsed = ControlPrimaryOutput.safeParse(detail?.["primaryOutput"]);
+    return parsed.success ? parsed.data : null;
+}
+/** Inline non-patch output with an honest bounded-preview disclosure. */
+export function presentRunPrimaryOutput(output) {
+    if (!output || output.kind === "patch" || typeof output.text !== "string")
+        return null;
+    const text = output.text.trim();
+    if (!text)
+        return null;
+    return output.truncated === true
+        ? `${text}\n\n[Inline preview bounded; full artifact: ${output.path}]`
+        : text;
+}
 export function projectApplyEligibility(detail) {
     const value = detail?.["applyEligibility"];
     return value && typeof value === "object" ? value : null;
@@ -14,6 +31,12 @@ export function projectRunCouncil(detail) {
     const parsed = CouncilProjection.safeParse(detail?.["council"]);
     return parsed.success ? parsed.data : null;
 }
+/** Preserve only the schema-owned typed terminal failure. Every surface uses
+ * this projection instead of forwarding an arbitrary failure-shaped object. */
+export function projectRunFailure(detail) {
+    const parsed = RunFailure.safeParse(detail?.["failure"]);
+    return parsed.success ? parsed.data : null;
+}
 export function projectRunLineage(detail) {
     const summary = detail?.["summary"] && typeof detail["summary"] === "object"
         ? detail["summary"]
@@ -30,4 +53,12 @@ export function projectOutcomeBanner(detail) {
     const banner = detail?.["outcomeBanner"];
     return typeof banner === "string" && banner.length > 0 ? banner : null;
 }
+export function describeRunDetailProblem(error) {
+    const record = error && typeof error === "object" ? error : {};
+    return {
+        code: typeof record["code"] === "string" && record["code"] ? record["code"] : null,
+        message: redactSecrets(error instanceof Error ? error.message : String(error)),
+        retryable: typeof record["retryable"] === "boolean" ? record["retryable"] : null,
+    };
+}
 //# sourceMappingURL=run-detail-projections.js.map

package/dist/run-detail-projections.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-detail-projections.js","sourceRoot":"","sources":["../src/run-detail-projections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAStD,MAAM,UAAU,uBAAuB,CACrC,MAAsC;IAEtC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC3C,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAoC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsC;IACvE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,KAAK,GACT,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QACpC,CAAC,CAAE,OAAkC,CAAC,QAAQ;QAC9C,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAsC;IACtE,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAsC;IAKtE,MAAM,OAAO,GACX,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ;QAC1D,CAAC,CAAE,MAAM,CAAC,SAAS,CAA6B;QAChD,CAAC,CAAC,IAAI,CAAC;IACX,OAAO;QACL,WAAW,EAAE,OAAO,OAAO,EAAE,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QACzF,kBAAkB,EAChB,OAAO,OAAO,EAAE,CAAC,oBAAoB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI;QAC5F,UAAU,EACR,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,OAAO,OAAO,CAAC,YAAY,CAAC,KAAK,QAAQ;YAClE,CAAC,CAAE,OAAO,CAAC,YAAY,CAA6B;YACpD,CAAC,CAAC,IAAI;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAsC;IACzE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,CAAC;IACzC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACzE,CAAC"}
+{"version":3,"file":"run-detail-projections.js","sourceRoot":"","sources":["../src/run-detail-projections.ts"],"names":[],"mappings":"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"}

package/dist/run-detail-response.d.ts

@@ -0,0 +1,7 @@
+type JsonResponse = {
+    json(): Promise<unknown>;
+};
+/** Decode and schema-check a successful Control API run-detail response. */
+export declare function readRunDetailResponse(response: JsonResponse): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=run-detail-response.d.ts.map

package/dist/run-detail-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-detail-response.d.ts","sourceRoot":"","sources":["../src/run-detail-response.ts"],"names":[],"mappings":"AAGA,KAAK,YAAY,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAEjD,4EAA4E;AAC5E,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWlC"}

package/dist/run-detail-response.js

@@ -0,0 +1,23 @@
+import { ControlRunDetail } from "@claudexor/schema";
+import { CliError } from "./cli-error.js";
+/** Decode and schema-check a successful Control API run-detail response. */
+export async function readRunDetailResponse(response) {
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        throw invalidRunDetailResponse("run detail endpoint returned malformed JSON");
+    }
+    if (!ControlRunDetail.safeParse(body).success) {
+        throw invalidRunDetailResponse("run detail endpoint returned an invalid response");
+    }
+    return body;
+}
+function invalidRunDetailResponse(message) {
+    return new CliError("operational", message, {
+        code: "invalid_service_response",
+        retryable: true,
+    });
+}
+//# sourceMappingURL=run-detail-response.js.map

package/dist/run-detail-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-detail-response.js","sourceRoot":"","sources":["../src/run-detail-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAsB;IAEtB,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,wBAAwB,CAAC,6CAA6C,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,MAAM,wBAAwB,CAAC,kDAAkD,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAA+B,CAAC;AACzC,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAe;IAC/C,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,OAAO,EAAE;QAC1C,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/run-facts-projection.d.ts

@@ -0,0 +1,22 @@
+import { type ExpectedRunFactsIdentity, type RunFacts as RunFactsType } from "@claudexor/schema";
+import { type ApplyEligibilityProjection } from "./run-detail-projections.js";
+type RunDetail = Record<string, unknown> | null;
+export type { ExpectedRunFactsIdentity } from "@claudexor/schema";
+/** Exact validated terminal receipt from an already-fetched run detail. */
+export declare function projectRunFacts(detail: RunDetail, expected?: ExpectedRunFactsIdentity): RunFactsType | null;
+/**
+ * Shared fields appended to both terminal machine surfaces. RunFacts is
+ * intentionally always present; only a genuinely missing legacy receipt
+ * projects to null, while present malformed data fails loudly.
+ */
+export declare function projectTerminalDetailFields(detail: RunDetail, expected?: ExpectedRunFactsIdentity): {
+    outcomeBanner?: string;
+    applyEligibility?: ApplyEligibilityProjection;
+    runFacts: RunFactsType | null;
+};
+type YamlArtifactReader = {
+    readYaml(path: string): unknown;
+};
+/** Read the canonical immutable RunFacts artifact without reconstructing it. */
+export declare function readRunFactsArtifact(reader: YamlArtifactReader, finalDir: string, expected?: ExpectedRunFactsIdentity): RunFactsType | null;
+//# sourceMappingURL=run-facts-projection.d.ts.map

package/dist/run-facts-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-facts-projection.d.ts","sourceRoot":"","sources":["../src/run-facts-projection.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,IAAI,YAAY,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AAErC,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAKhD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,wBAA6B,GACtC,YAAY,GAAG,IAAI,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,wBAA6B,GACtC;IACD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/B,CAQA;AAED,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,wBAA6B,GACtC,YAAY,GAAG,IAAI,CAmBrB"}

package/dist/run-facts-projection.js

@@ -0,0 +1,86 @@
+import { lstatSync } from "node:fs";
+import { join } from "node:path";
+import { RunFactsInvalidError, validateRunFactsReceipt, } from "@claudexor/schema";
+import { projectApplyEligibility, projectOutcomeBanner, } from "./run-detail-projections.js";
+/** Exact validated terminal receipt from an already-fetched run detail. */
+export function projectRunFacts(detail, expected = {}) {
+    if (!detail)
+        return null;
+    const value = detail["runFacts"];
+    if (value === null || value === undefined)
+        return null;
+    return validateRunFactsReceipt(value, expectedIdentityFromDetail(detail, expected));
+}
+/**
+ * Shared fields appended to both terminal machine surfaces. RunFacts is
+ * intentionally always present; only a genuinely missing legacy receipt
+ * projects to null, while present malformed data fails loudly.
+ */
+export function projectTerminalDetailFields(detail, expected = {}) {
+    const outcomeBanner = projectOutcomeBanner(detail);
+    const applyEligibility = projectApplyEligibility(detail);
+    return {
+        ...(outcomeBanner ? { outcomeBanner } : {}),
+        ...(applyEligibility ? { applyEligibility } : {}),
+        runFacts: projectRunFacts(detail, expected),
+    };
+}
+/** Read the canonical immutable RunFacts artifact without reconstructing it. */
+export function readRunFactsArtifact(reader, finalDir, expected = {}) {
+    const path = join(finalDir, "run_facts.yaml");
+    const finalDirStat = lstatOrNull(finalDir);
+    if (finalDirStat === null)
+        return null;
+    if (!finalDirStat.isDirectory() || finalDirStat.isSymbolicLink()) {
+        throw new RunFactsInvalidError();
+    }
+    const artifactStat = lstatOrNull(path);
+    if (artifactStat === null)
+        return null;
+    if (!artifactStat.isFile() || artifactStat.isSymbolicLink())
+        throw new RunFactsInvalidError();
+    let raw;
+    try {
+        raw = reader.readYaml(path);
+    }
+    catch {
+        throw new RunFactsInvalidError();
+    }
+    return validateRunFactsReceipt(raw, expected);
+}
+function expectedIdentityFromDetail(detail, expected) {
+    const summary = detail["summary"];
+    if (!summary || typeof summary !== "object")
+        return expected;
+    const record = summary;
+    const summaryRunId = typeof record["runId"] === "string" ? record["runId"] : undefined;
+    const summaryTaskId = typeof record["taskId"] === "string" ? record["taskId"] : undefined;
+    if ((expected.runId !== undefined &&
+        summaryRunId !== undefined &&
+        expected.runId !== summaryRunId) ||
+        (expected.taskId !== undefined &&
+            summaryTaskId !== undefined &&
+            expected.taskId !== summaryTaskId)) {
+        throw new RunFactsInvalidError();
+    }
+    return {
+        runId: expected.runId ?? summaryRunId,
+        taskId: expected.taskId ?? summaryTaskId,
+        ...(expected.lifecycle !== undefined ? { lifecycle: expected.lifecycle } : {}),
+    };
+}
+function lstatOrNull(path) {
+    try {
+        return lstatSync(path);
+    }
+    catch (error) {
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return null;
+        }
+        throw new RunFactsInvalidError();
+    }
+}
+//# sourceMappingURL=run-facts-projection.js.map

package/dist/run-facts-projection.js.map

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

package/dist/runtime-replacement-stop.d.ts

@@ -0,0 +1,25 @@
+import { type AwaitDaemonTerminationOptions, type DaemonTerminationOutcome, type DaemonLeaseOwner, DaemonClient, awaitDaemonTermination } from "@claudexor/daemon";
+interface RuntimeReplacementStopDeps {
+    socketPath(): string;
+    readToken(): string | null;
+    socketAlive(path: string): Promise<boolean>;
+    leaseOwner(path: string): DaemonLeaseOwner | null;
+    client(path: string, token: string): Pick<DaemonClient, "shutdownForRuntimeReplacement">;
+    awaitTermination(path: string, options: AwaitDaemonTerminationOptions): ReturnType<typeof awaitDaemonTermination>;
+    write(line: string): void;
+}
+/** One owner for the admission/termination uncertainty boundary used by both
+ * local and remote runtime replacement. Only a proven
+ * `{ok:true,fenced:true,targetBound:true}` receipt grants
+ * signal authority for the pre-RPC writer-lease owner.
+ * A lost, legacy, or untyped response may passively prove that the pinned
+ * daemon exited, but can never turn into a kill. */
+export declare function admitAndAwaitRuntimeReplacementStop(requestAdmission: () => Promise<unknown>, awaitTermination: (options: AwaitDaemonTerminationOptions) => Promise<DaemonTerminationOutcome>, expectedOwner: DaemonLeaseOwner): Promise<DaemonTerminationOutcome>;
+/** Handle `claudexord --stop`: the identity-proven, admission-safe shutdown the
+ * macOS installer runs before an atomic pointer swap. Unlike explicit operator
+ * shutdown, this asks the daemon to atomically prove idle and fence every ingress
+ * before stopping. The pinned termination proof remains authoritative when the
+ * accepted RPC response is lost as the socket closes. */
+export declare function runStopIfRequested(argv: readonly string[], deps?: RuntimeReplacementStopDeps): Promise<boolean>;
+export {};
+//# sourceMappingURL=runtime-replacement-stop.d.ts.map

package/dist/runtime-replacement-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-replacement-stop.d.ts","sourceRoot":"","sources":["../src/runtime-replacement-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,YAAY,EAGZ,sBAAsB,EAIvB,MAAM,mBAAmB,CAAC;AAE3B,UAAU,0BAA0B;IAClC,UAAU,IAAI,MAAM,CAAC;IACrB,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,+BAA+B,CAAC,CAAC;IACzF,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,GACrC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAoED;;;;;oDAKoD;AACpD,wBAAsB,mCAAmC,CACvD,gBAAgB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACxC,gBAAgB,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,wBAAwB,CAAC,EAC/F,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAgCnC;AAED;;;;yDAIyD;AACzD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,GAAE,0BAA2C,GAChD,OAAO,CAAC,OAAO,CAAC,CAwElB"}

package/dist/runtime-replacement-stop.js

@@ -0,0 +1,145 @@
+import { DaemonClient, daemonLeaseOwner, awaitDaemonTermination, defaultSocketPath, readToken, socketAlive, } from "@claudexor/daemon";
+const productionDeps = {
+    socketPath: defaultSocketPath,
+    readToken,
+    socketAlive,
+    leaseOwner: daemonLeaseOwner,
+    client: (path, token) => new DaemonClient(path, token),
+    awaitTermination: awaitDaemonTermination,
+    write: (line) => process.stdout.write(line),
+};
+function refusalCode(error) {
+    if (!error || typeof error !== "object" || !("code" in error))
+        return null;
+    const code = error.code;
+    return code === "runtime_replacement_busy" || code === "runtime_activity_unknown" ? code : null;
+}
+function activityUnknown(message, cause) {
+    return Object.assign(new Error(message), {
+        code: "runtime_activity_unknown",
+        status: 503,
+        retryable: true,
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function isTargetBoundAdmissionReceipt(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        value.ok === true &&
+        value.fenced === true &&
+        value.targetBound === true);
+}
+function stopIdentity(argv) {
+    const stop = argv.indexOf("--stop");
+    if (stop < 0 || argv.length !== stop + 3)
+        return null;
+    const version = argv[stop + 1];
+    const buildSha = argv[stop + 2];
+    if (typeof version !== "string" ||
+        version.length === 0 ||
+        typeof buildSha !== "string" ||
+        !/^[0-9a-f]{40}$/.test(buildSha)) {
+        return null;
+    }
+    return { version, buildSha };
+}
+function writeRefusal(deps, code, detail) {
+    deps.write(`${JSON.stringify({ stopped: false, code, retryable: true, detail })}\n`);
+    process.exitCode = 1;
+}
+/** One owner for the admission/termination uncertainty boundary used by both
+ * local and remote runtime replacement. Only a proven
+ * `{ok:true,fenced:true,targetBound:true}` receipt grants
+ * signal authority for the pre-RPC writer-lease owner.
+ * A lost, legacy, or untyped response may passively prove that the pinned
+ * daemon exited, but can never turn into a kill. */
+export async function admitAndAwaitRuntimeReplacementStop(requestAdmission, awaitTermination, expectedOwner) {
+    let admitted = false;
+    let admissionFailure;
+    try {
+        const receipt = await requestAdmission();
+        if (isTargetBoundAdmissionReceipt(receipt)) {
+            admitted = true;
+        }
+        else {
+            // A pre-v3.2 daemon can accept the same method while ignoring its new
+            // identity parameters and return the legacy fenced receipt. It may still
+            // exit naturally, but it never grants signal authority to the caller.
+            admissionFailure = activityUnknown("runtime replacement returned no identity-bound admission receipt");
+        }
+    }
+    catch (error) {
+        if (refusalCode(error))
+            throw error;
+        admissionFailure = error;
+    }
+    const termination = await awaitTermination({
+        allowSigkill: admitted,
+        expectedOwner,
+        requireNoSuccessor: true,
+    });
+    if (!admitted && termination.outcome !== "exited") {
+        throw activityUnknown(`runtime replacement admission is uncertain and the daemon remains alive: ${termination.detail}`, admissionFailure);
+    }
+    return termination;
+}
+/** Handle `claudexord --stop`: the identity-proven, admission-safe shutdown the
+ * macOS installer runs before an atomic pointer swap. Unlike explicit operator
+ * shutdown, this asks the daemon to atomically prove idle and fence every ingress
+ * before stopping. The pinned termination proof remains authoritative when the
+ * accepted RPC response is lost as the socket closes. */
+export async function runStopIfRequested(argv, deps = productionDeps) {
+    if (!argv.includes("--stop"))
+        return false;
+    const expectedIdentity = stopIdentity(argv);
+    if (!expectedIdentity) {
+        writeRefusal(deps, "runtime_activity_unknown", "runtime replacement requires an exact expected version and build SHA");
+        return true;
+    }
+    const socketPath = deps.socketPath();
+    const alive = await deps.socketAlive(socketPath);
+    if (!alive) {
+        // A daemon claims the writer lease before it binds the socket. Treating the
+        // boot window as absence would let the installer move the runtime pointer
+        // beneath that live process. Idempotent success therefore requires both
+        // surfaces to prove absence, matching the remote replacement path.
+        if (deps.leaseOwner(socketPath)) {
+            writeRefusal(deps, "runtime_activity_unknown", "runtime replacement found a writer lease but no reachable daemon socket");
+            return true;
+        }
+        deps.write(`${JSON.stringify({ stopped: true, alreadyStopped: true })}\n`);
+        return true;
+    }
+    const token = deps.readToken();
+    if (!token) {
+        writeRefusal(deps, "runtime_activity_unknown", "runtime replacement cannot authenticate to the live daemon");
+        return true;
+    }
+    const expectedOwner = deps.leaseOwner(socketPath);
+    if (!expectedOwner) {
+        writeRefusal(deps, "runtime_activity_unknown", "runtime replacement cannot bind the live daemon to its writer lease");
+        return true;
+    }
+    const expectedTarget = {
+        ...expectedIdentity,
+        leaseOwner: { pid: expectedOwner.pid, token: expectedOwner.token },
+    };
+    let termination;
+    try {
+        termination = await admitAndAwaitRuntimeReplacementStop(() => deps.client(socketPath, token).shutdownForRuntimeReplacement(expectedTarget), (options) => deps.awaitTermination(socketPath, options), expectedOwner);
+    }
+    catch (error) {
+        const code = refusalCode(error);
+        if (code) {
+            writeRefusal(deps, code, error.message);
+            return true;
+        }
+        throw error;
+    }
+    const stopped = termination.outcome !== "still_alive";
+    deps.write(`${JSON.stringify({ stopped, outcome: termination.outcome, detail: termination.detail })}\n`);
+    if (!stopped)
+        process.exitCode = 1;
+    return true;
+}
+//# sourceMappingURL=runtime-replacement-stop.js.map

package/dist/runtime-replacement-stop.js.map

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

package/dist/settings-command.d.ts

@@ -38,4 +38,5 @@ export declare const HARNESS_SETTING_FIELDS: {
 };
 export declare function settingsCommand(args: ParsedArgs, json: boolean): Promise<number>;
 export declare function settingPatch(key: string, value: string): SettingsPatch;
+export declare function formatInteractionTimeoutSetting(value: number | null): string;
 //# sourceMappingURL=settings-command.d.ts.map

package/dist/settings-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-command.d.ts","sourceRoot":"","sources":["../src/settings-command.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAGL,KAAK,4BAA4B,IAAI,aAAa,EACnD,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;CAUxB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAazB,CAAC;AAWX,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBtF;AAsFD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CA2DtE"}
+{"version":3,"file":"settings-command.d.ts","sourceRoot":"","sources":["../src/settings-command.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAGL,KAAK,4BAA4B,IAAI,aAAa,EACnD,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;aAChC,YAAY,EAAE,aAAa;aAC3B,aAAa,EAAE,cAAc;aAC7B,aAAa,EAAE,cAAc;aAC7B,sBAAsB,EAAE,sBAAsB;aAC9C,eAAe,EAAE,gBAAgB;aACjC,kBAAkB,EAAE,mBAAmB;aACvC,eAAe,EAAE,gBAAgB;aACjC,mBAAmB,EAAE,kBAAkB;aACvC,eAAe,EAAE,gBAAgB;CACzB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB;aACjC,OAAO,EAAE,SAAS;aAClB,0BAA0B,EAAE,0BAA0B;aACtD,aAAa,EAAE,cAAc;aAC7B,cAAc,EAAE,eAAe;aAC/B,MAAM,EAAE,QAAQ;aAChB,SAAS,EAAE,UAAU;aACrB,UAAU,EAAE,WAAW;aACvB,WAAW,EAAE,YAAY;aACzB,UAAU,EAAE,WAAW;aACvB,GAAG,EAAE,KAAK;aACV,eAAe,EAAE,gBAAgB;aACjC,oBAAoB,EAAE,oBAAoB;CAClC,CAAC;AAYX,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BtF;AAmFD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CA8DtE;AAkCD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE5E"}

package/dist/settings-command.js

@@ -1,7 +1,7 @@
 /** `claudexor settings` is a thin projection of the daemon-owned /v2/settings surface. */
 import { ControlSettingsSnapshot, ControlSettingsUpdateRequest, } from "@claudexor/schema";
 import { print, printJson, printUsageError } from "./cli-io.js";
-import { renderCliFailure } from "./cli-error.js";
+import { controlProblemError, renderCliFailure, usageError } from "./cli-error.js";
 import { ensureDaemon } from "./daemon-run.js";
 import { controlApiFetch } from "./live.js";
 /**
@@ -42,12 +42,21 @@ export const HARNESS_SETTING_FIELDS = {
 const HARNESS_KEY_RE = new RegExp(`^harness\\.([^.]+)\\.(${Object.keys(HARNESS_SETTING_FIELDS).join("|")})$`);
 const USAGE = "usage: claudexor settings set <key> <value>\n" +
     `  global keys: ${Object.keys(GLOBAL_SETTING_FIELDS).join(", ")}\n` +
+    "  interaction_timeout_ms: positive milliseconds or disabled\n" +
     `  harness keys: harness.<id>.{${Object.keys(HARNESS_SETTING_FIELDS).join(",")}}`;
 export async function settingsCommand(args, json) {
     const sub = args._[1] ?? "show";
     if (sub !== "show" && sub !== "set")
         return printUsageError(json, "usage: claudexor settings show|set");
+    const key = args._[2];
+    const value = args._[3];
+    if (sub === "set" && (!key || value === undefined))
+        return printUsageError(json, USAGE);
     try {
+        // Validate caller-owned input before daemon bootstrap. A bad key/value is a
+        // usage failure even when the engine is offline; starting the daemon cannot
+        // make malformed input valid.
+        const patch = sub === "set" ? settingPatch(key, value) : undefined;
         const { addr } = await ensureDaemon();
         if (sub === "show") {
             const snapshot = await settingsRequest(addr, "GET");
@@ -57,11 +66,7 @@ export async function settingsCommand(args, json) {
                 printSettings(snapshot);
             return 0;
         }
-        const key = args._[2];
-        const value = args._[3];
-        if (!key || value === undefined)
-            return printUsageError(json, USAGE);
-        const snapshot = await settingsRequest(addr, "POST", settingPatch(key, value));
+        const snapshot = await settingsRequest(addr, "POST", patch);
         if (json)
             printJson(snapshot);
         else
@@ -90,12 +95,7 @@ async function settingsRequest(addr, method, body) {
         throw new Error(`settings endpoint returned invalid JSON (HTTP ${response.status})`);
     }
     if (!response.ok) {
-        const detail = value;
-        throw new Error(typeof detail["message"] === "string"
-            ? detail["message"]
-            : typeof detail["error"] === "string"
-                ? detail["error"]
-                : `settings request failed (HTTP ${response.status})`);
+        throw controlProblemError(response.status, value, `settings request failed (HTTP ${response.status})`);
     }
     return ControlSettingsSnapshot.parse(value);
 }
@@ -107,12 +107,12 @@ function harnessFieldPatch(field, value) {
     switch (field) {
         case "enabled": {
             if (value !== "true" && value !== "false")
-                throw new Error("harness enabled must be true or false");
+                throw usageError("harness enabled must be true or false");
             return { enabled: value === "true" };
         }
         case "native_credentials_enabled": {
             if (value !== "true" && value !== "false")
-                throw new Error("harness native_credentials_enabled must be true or false");
+                throw usageError("harness native_credentials_enabled must be true or false");
             return { nativeCredentialsEnabled: value === "true" };
         }
         case "default_model":
@@ -128,7 +128,7 @@ function harnessFieldPatch(field, value) {
                 return { [patchKey]: null };
             const n = Number(value.trim());
             if (!Number.isInteger(n) || n <= 0)
-                throw new Error(`harness ${field} must be a positive integer or none`);
+                throw usageError(`harness ${field} must be a positive integer or none`);
             return { [patchKey]: n };
         }
         case "tools_allow":
@@ -152,7 +152,7 @@ function harnessFieldPatch(field, value) {
 }
 export function settingPatch(key, value) {
     if (key === "default_model") {
-        throw new Error("the global default_model setting was removed (model choice is harness-scoped, INV-103); use `claudexor settings set harness.<id>.default_model <model>`");
+        throw usageError("the global default_model setting was removed (model choice is harness-scoped, INV-103); use `claudexor settings set harness.<id>.default_model <model>`");
     }
     const harness = HARNESS_KEY_RE.exec(key);
     if (harness) {
@@ -163,7 +163,7 @@ export function settingPatch(key, value) {
         });
     }
     if (key === "default_portfolio") {
-        throw new Error("default_portfolio was removed in v2; use routing_goal");
+        throw usageError("default_portfolio was removed in v2; use routing_goal");
     }
     if (key === "routing_goal")
         return ControlSettingsUpdateRequest.parse({ routingGoal: value });
@@ -177,7 +177,7 @@ export function settingPatch(key, value) {
             qualityTiers = JSON.parse(value);
         }
         catch {
-            throw new Error("quality_tiers must be a JSON object of per-intent ordered tiers");
+            throw usageError("quality_tiers must be a JSON object of per-intent ordered tiers");
         }
         return ControlSettingsUpdateRequest.parse({ qualityTiers });
     }
@@ -199,16 +199,19 @@ export function settingPatch(key, value) {
             return ControlSettingsUpdateRequest.parse({ paidBudgetPerRun: { kind: "unlimited" } });
         const maxUsd = Number(value.trim());
         if (!Number.isFinite(maxUsd) || maxUsd < 0 || value.trim() === "")
-            throw new Error(`${key} must be a non-negative number or unlimited`);
+            throw usageError(`${key} must be a non-negative number or unlimited`);
         return ControlSettingsUpdateRequest.parse({
             paidBudgetPerRun: { kind: "finite", maxUsd },
         });
     }
     if (key === "interaction_timeout_ms") {
+        if (value.trim() === "disabled") {
+            return ControlSettingsUpdateRequest.parse({ interactionTimeoutMs: null });
+        }
         const interactionTimeoutMs = Number(value.trim());
         return ControlSettingsUpdateRequest.parse({ interactionTimeoutMs });
     }
-    throw new Error(`unknown setting: ${key}`);
+    throw usageError(`unknown setting: ${key}`);
 }
 function printSettings(settings) {
     print(`sources: ${settings.sources.length ? settings.sources.join(", ") : "(defaults)"}`);
@@ -219,7 +222,7 @@ function printSettings(settings) {
     print(`routing.env_inheritance: ${settings.routing.envInheritance}`);
     print(`routing.auth_preference: ${settings.routing.authPreference}`);
     print(`budget.paid_budget_per_run: ${settings.budget.paidBudgetPerRun.kind === "unlimited" ? "unlimited" : settings.budget.paidBudgetPerRun.maxUsd}`);
-    print(`interaction_timeout_ms: ${settings.interactionTimeoutMs}`);
+    print(`interaction_timeout_ms: ${formatInteractionTimeoutSetting(settings.interactionTimeoutMs)}`);
     print(`runtime.reviewer_timeout_ms: ${settings.runtime.reviewerTimeoutMs}`);
     print(`runtime.transient_retry.max_retries: ${settings.runtime.transientRetry.maxRetries}`);
     print(`runtime.transient_retry.initial_delay_ms: ${settings.runtime.transientRetry.initialDelayMs}`);
@@ -232,4 +235,7 @@ function printSettings(settings) {
         print(`  ${id}: enabled=${harness.enabled} cli_login=${harness.nativeCredentialsEnabled ? "on" : "off"} model=${harness.defaultModel ?? "(native)"} fallback=${harness.fallbackModel ?? "(none)"} effort=${harness.effort ?? "(native)"} web=${harness.web} max_turns=${harness.maxTurns ?? "(none)"} max_rounds=${harness.maxRounds ?? "(default)"} auth=${harness.authPreference} limit_action=${harness.profileLimitAction}`);
     }
 }
+export function formatInteractionTimeoutSetting(value) {
+    return value === null ? "disabled" : String(value);
+}
 //# sourceMappingURL=settings-command.js.map