@claudexor/control-api 3.1.2 → 3.2.0

package/dist/remote-operation-descriptors.js

@@ -0,0 +1,35 @@
+import { queryParam } from "./operation-parameters.js";
+export const REMOTE_OPERATION_DRAFTS = [
+    {
+        method: "GET",
+        path: "/v2/filesystem/directories",
+        mutability: "read_only",
+        requestSchema: null,
+        responseSchema: "ControlDirectoryListing",
+        responseKind: "json",
+        summary: "List the visible subdirectories of a directory contained by the server user's home; served only by the remote runtime (a local daemon answers 501).",
+        parameters: [
+            queryParam({
+                name: "path",
+                description: "Absolute visible (non-hidden) directory under the server user's home; omit to start at HOME.",
+            }),
+        ],
+    },
+    {
+        method: "GET",
+        path: "/v2/projects/:id/file",
+        mutability: "read_only",
+        requestSchema: null,
+        responseSchema: null,
+        responseKind: "binary",
+        summary: "Fetch one bounded raster image contained by a registered project; served only by the remote runtime (a local daemon answers 501).",
+        parameters: [
+            queryParam({
+                name: "path",
+                required: true,
+                description: "Relative path contained by the registered project; the content must be a raster image (magic-byte validated).",
+            }),
+        ],
+    },
+];
+//# sourceMappingURL=remote-operation-descriptors.js.map

package/dist/remote-operation-descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-operation-descriptors.js","sourceRoot":"","sources":["../src/remote-operation-descriptors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,4BAA4B;QAClC,UAAU,EAAE,WAAW;QACvB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,yBAAyB;QACzC,YAAY,EAAE,MAAM;QACpB,OAAO,EACL,qJAAqJ;QACvJ,UAAU,EAAE;YACV,UAAU,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,WAAW,EACT,8FAA8F;aACjG,CAAC;SACH;KACF;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uBAAuB;QAC7B,UAAU,EAAE,WAAW;QACvB,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,QAAQ;QACtB,OAAO,EACL,mIAAmI;QACrI,UAAU,EAAE;YACV,UAAU,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,IAAI;gBACd,WAAW,EACT,+GAA+G;aAClH,CAAC;SACH;KACF;CAC2C,CAAC"}

package/dist/resource-routes.d.ts

@@ -1,17 +1,18 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
+import { ControlUploadCreateRequest, type ResourceAttachmentRef } from "@claudexor/schema";
 export interface ResourceRouteServices {
-    createUpload(input: unknown, idempotencyKey: string): Promise<unknown>;
+    createUpload(input: ControlUploadCreateRequest, idempotencyKey: string): Promise<unknown>;
     writeUpload(uploadId: string, chunks: AsyncIterable<Uint8Array>): Promise<unknown>;
     uploadStatus(uploadId: string): Promise<unknown>;
     cancelUpload(uploadId: string): Promise<unknown>;
     finalizeUpload(uploadId: string, expectedSha256: string | undefined, idempotencyKey: string): Promise<unknown>;
-    validateResources(refs: import("@claudexor/schema").ResourceAttachmentRef[]): Promise<void>;
+    validateResources(refs: ResourceAttachmentRef[]): Promise<void>;
 }
 export interface ResourceRouteContext {
     services?: Partial<ResourceRouteServices>;
     readBody(req: IncomingMessage): Promise<unknown>;
     json(res: ServerResponse, status: number, body: unknown): void;
-    requestError(res: ServerResponse, error: unknown): void;
+    requestError(res: ServerResponse, error: unknown, fallbackStatus?: 400 | 500): void;
 }
 export declare function handleResourceRoute(ctx: ResourceRouteContext, method: string, path: string, req: IncomingMessage, res: ServerResponse): Promise<boolean>;
 //# sourceMappingURL=resource-routes.d.ts.map

package/dist/resource-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-routes.d.ts","sourceRoot":"","sources":["../src/resource-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,iBAAiB,CAAC,IAAI,EAAE,OAAO,mBAAmB,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/D,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACzD;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,CAiDlB"}
+{"version":3,"file":"resource-routes.d.ts","sourceRoot":"","sources":["../src/resource-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAEL,0BAA0B,EAG1B,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/D,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;CACrF;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,CAmFlB"}

package/dist/resource-routes.js

@@ -1,58 +1,82 @@
-import { ControlUploadFinalizeRequest } from "@claudexor/schema";
+import { ControlResource, ControlUploadCreateRequest, ControlUploadFinalizeRequest, ControlUploadStatus, } from "@claudexor/schema";
+import { requiredIdempotencyKey } from "./run-start.js";
+import { routeValue, serviceResponse } from "./route-stages.js";
 export async function handleResourceRoute(ctx, method, path, req, res) {
     const services = ctx.services;
     if (method === "POST" && path === "/uploads") {
-        if (!services?.createUpload)
+        const service = services?.createUpload;
+        if (!service)
             return false;
-        try {
-            ctx.json(res, 201, await services.createUpload(await ctx.readBody(req), requiredIdempotencyKey(req)));
-        }
-        catch (error) {
-            ctx.requestError(res, error);
-        }
-        return true;
+        const input = await routeValue(ctx, res, 400, async () => ({
+            idempotencyKey: requiredIdempotencyKey(req),
+            request: ControlUploadCreateRequest.parse(await ctx.readBody(req)),
+        }));
+        if (!input.ok)
+            return true;
+        const result = await routeValue(ctx, res, 500, () => service(input.value.request, input.value.idempotencyKey));
+        if (!result.ok)
+            return true;
+        return serviceResponse(ctx, res, "createUpload", () => ctx.json(res, 201, ControlUploadStatus.parse(result.value)));
     }
     const uploadBytesMatch = /^\/uploads\/([^/]+)\/bytes$/.exec(path);
     const uploadFinalizeMatch = /^\/uploads\/([^/]+)\/finalize$/.exec(path);
     const uploadMatch = /^\/uploads\/([^/]+)$/.exec(path);
-    try {
-        if (method === "PUT" && uploadBytesMatch && services?.writeUpload) {
-            const uploadId = decodeURIComponent(uploadBytesMatch[1]);
-            ctx.json(res, 200, await services.writeUpload(uploadId, req));
+    if (method === "PUT" && uploadBytesMatch) {
+        const service = services?.writeUpload;
+        if (!service)
+            return false;
+        const uploadId = await routeValue(ctx, res, 400, () => decodeURIComponent(uploadBytesMatch[1]));
+        if (!uploadId.ok)
+            return true;
+        const result = await routeValue(ctx, res, 500, () => service(uploadId.value, req));
+        if (!result.ok)
             return true;
-        }
-        if (method === "POST" && uploadFinalizeMatch && services?.finalizeUpload) {
+        return serviceResponse(ctx, res, "writeUpload", () => ctx.json(res, 200, ControlUploadStatus.parse(result.value)));
+    }
+    if (method === "POST" && uploadFinalizeMatch) {
+        const service = services?.finalizeUpload;
+        if (!service)
+            return false;
+        const input = await routeValue(ctx, res, 400, async () => {
             const uploadId = decodeURIComponent(uploadFinalizeMatch[1]);
             const body = ControlUploadFinalizeRequest.parse(await ctx.readBody(req));
-            ctx.json(res, 201, await services.finalizeUpload(uploadId, body.expectedSha256, requiredIdempotencyKey(req)));
+            return {
+                uploadId,
+                expectedSha256: body.expectedSha256,
+                idempotencyKey: requiredIdempotencyKey(req),
+            };
+        });
+        if (!input.ok)
+            return true;
+        const result = await routeValue(ctx, res, 500, () => service(input.value.uploadId, input.value.expectedSha256, input.value.idempotencyKey));
+        if (!result.ok)
             return true;
-        }
-        if (method === "GET" && uploadMatch && services?.uploadStatus) {
-            const uploadId = decodeURIComponent(uploadMatch[1]);
-            ctx.json(res, 200, await services.uploadStatus(uploadId));
+        return serviceResponse(ctx, res, "finalizeUpload", () => ctx.json(res, 201, ControlResource.parse(result.value)));
+    }
+    if (method === "GET" && uploadMatch) {
+        const service = services?.uploadStatus;
+        if (!service)
+            return false;
+        const uploadId = await routeValue(ctx, res, 400, () => decodeURIComponent(uploadMatch[1]));
+        if (!uploadId.ok)
             return true;
-        }
-        if (method === "DELETE" && uploadMatch && services?.cancelUpload) {
-            const uploadId = decodeURIComponent(uploadMatch[1]);
-            ctx.json(res, 200, await services.cancelUpload(uploadId));
+        const result = await routeValue(ctx, res, 500, () => service(uploadId.value));
+        if (!result.ok)
             return true;
-        }
+        return serviceResponse(ctx, res, "uploadStatus", () => ctx.json(res, 200, ControlUploadStatus.parse(result.value)));
     }
-    catch (error) {
-        ctx.requestError(res, error);
-        return true;
+    if (method === "DELETE" && uploadMatch) {
+        const service = services?.cancelUpload;
+        if (!service)
+            return false;
+        const uploadId = await routeValue(ctx, res, 400, () => decodeURIComponent(uploadMatch[1]));
+        if (!uploadId.ok)
+            return true;
+        const result = await routeValue(ctx, res, 500, () => service(uploadId.value));
+        if (!result.ok)
+            return true;
+        return serviceResponse(ctx, res, "cancelUpload", () => ctx.json(res, 200, ControlUploadStatus.parse(result.value)));
     }
     return false;
 }
-function requiredIdempotencyKey(req) {
-    const raw = req.headers["idempotency-key"];
-    const value = Array.isArray(raw) ? raw[0] : raw;
-    if (!value || value.length > 256) {
-        throw Object.assign(new Error("Idempotency-Key is required for this create operation"), {
-            status: 400,
-            code: value ? "invalid_idempotency_key" : "idempotency_key_required",
-        });
-    }
-    return value;
-}
 //# sourceMappingURL=resource-routes.js.map

package/dist/resource-routes.js.map

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

package/dist/route-stages.d.ts

@@ -0,0 +1,15 @@
+import type { ServerResponse } from "node:http";
+export interface RouteStageContext {
+    requestError(res: ServerResponse, error: unknown, fallbackStatus?: 400 | 500): void;
+}
+export type RouteValue<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+};
+/** Keep request/service failures distinct before a response is written. */
+export declare function routeValue<T>(ctx: RouteStageContext, res: ServerResponse, fallbackStatus: 400 | 500, load: () => T | Promise<T>): Promise<RouteValue<T>>;
+/** Fail closed when a service returns a value outside its public contract. */
+export declare function serviceResponse(ctx: RouteStageContext, res: ServerResponse, service: string, send: () => void): true;
+//# sourceMappingURL=route-stages.d.ts.map

package/dist/route-stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-stages.d.ts","sourceRoot":"","sources":["../src/route-stages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;CACrF;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnE,2EAA2E;AAC3E,wBAAsB,UAAU,CAAC,CAAC,EAChC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,GAAG,GAAG,GAAG,EACzB,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAOxB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,IAAI,GACf,IAAI,CAcN"}

package/dist/route-stages.js

@@ -0,0 +1,24 @@
+/** Keep request/service failures distinct before a response is written. */
+export async function routeValue(ctx, res, fallbackStatus, load) {
+    try {
+        return { ok: true, value: await load() };
+    }
+    catch (error) {
+        ctx.requestError(res, error, fallbackStatus);
+        return { ok: false };
+    }
+}
+/** Fail closed when a service returns a value outside its public contract. */
+export function serviceResponse(ctx, res, service, send) {
+    try {
+        send();
+    }
+    catch {
+        ctx.requestError(res, Object.assign(new Error(`${service} returned a response that violates its schema`), {
+            status: 500,
+            code: "invalid_service_response",
+        }), 500);
+    }
+    return true;
+}
+//# sourceMappingURL=route-stages.js.map

package/dist/route-stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-stages.js","sourceRoot":"","sources":["../src/route-stages.ts"],"names":[],"mappings":"AAQA,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAsB,EACtB,GAAmB,EACnB,cAAyB,EACzB,IAA0B;IAE1B,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAC7B,GAAsB,EACtB,GAAmB,EACnB,OAAe,EACf,IAAgB;IAEhB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,YAAY,CACd,GAAG,EACH,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,+CAA+C,CAAC,EAAE;YAClF,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,0BAA0B;SACjC,CAAC,EACF,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,35 @@
+import { type ApplyEligibility, type DecisionRecord, type ExpectedRunFactsIdentity, type RequiredAction, type RunFacts, type RunOutcomeFacts } from "@claudexor/schema";
+export interface RunFactsDetailProjection {
+    runFacts: RunFacts | null;
+    outcomeFacts: RunOutcomeFacts | null;
+    applyEligibility: ApplyEligibility | null;
+    requiredActions: RequiredAction[];
+}
+export interface EffectiveTerminalFacts {
+    runFacts: RunFacts | null;
+    outcomeFacts: RunOutcomeFacts | null;
+    decision: DecisionRecord | null;
+}
+/** The shared pure identity contract lives in @claudexor/schema (S2: one
+ * validation owner); this alias keeps the control-api surface name stable. */
+export type ExpectedRunFacts = ExpectedRunFactsIdentity;
+/** Bind a canonical receipt to its daemon record without asserting a racy active lifecycle. */
+export declare function expectedRunFacts(record: {
+    id: string;
+    state: string;
+    runId?: string;
+    taskId?: string;
+}): ExpectedRunFacts;
+/**
+ * Single terminal-facts accessor: a cross-field-valid RunFacts receipt wins;
+ * old/in-flight runs with no receipt retain legacy projections. A receipt that
+ * is present but invalid fails loudly and can never reopen legacy apply truth.
+ */
+export declare function effectiveTerminalFacts(runDir: string | undefined, legacyOutcomeFacts: RunOutcomeFacts | null, legacyDecision?: DecisionRecord | null, expected?: ExpectedRunFacts): EffectiveTerminalFacts;
+/**
+ * Project terminal compatibility fields from one canonical receipt read.
+ * Missing receipts use legacy derivations for in-flight and pre-RunFacts runs.
+ * Present-but-invalid receipts fail loudly.
+ */
+export declare function projectRunFactsForDetail(runDir: string | undefined, legacyOutcomeFacts: RunOutcomeFacts | null, hasValidOperatorDecision: boolean, legacyApplyEligibility: () => ApplyEligibility | null, expected?: ExpectedRunFacts): RunFactsDetailProjection;
+//# 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,EAKL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED;8EAC8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAExD,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,gBAAgB,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,kBAAkB,EAAE,eAAe,GAAG,IAAI,EAC1C,cAAc,GAAE,cAAc,GAAG,IAAW,EAC5C,QAAQ,GAAE,gBAAqB,GAC9B,sBAAsB,CASxB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,kBAAkB,EAAE,eAAe,GAAG,IAAI,EAC1C,wBAAwB,EAAE,OAAO,EACjC,sBAAsB,EAAE,MAAM,gBAAgB,GAAG,IAAI,EACrD,QAAQ,GAAE,gBAAqB,GAC9B,wBAAwB,CA4B1B"}

package/dist/run-facts-projection.js

@@ -0,0 +1,133 @@
+import { lstatSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { isTerminalLifecycle, RunFactsInvalidError, validateRunFactsReceipt, requiredActionsFor, } from "@claudexor/schema";
+import { parse as parseYaml } from "yaml";
+import { safeArtifactPath, safeArtifactRoot } from "./artifact-paths.js";
+/** Bind a canonical receipt to its daemon record without asserting a racy active lifecycle. */
+export function expectedRunFacts(record) {
+    return {
+        runId: record.runId ?? record.id,
+        ...(record.taskId ? { taskId: record.taskId } : {}),
+        ...(isTerminalLifecycle(record.state)
+            ? { lifecycle: record.state }
+            : {}),
+    };
+}
+/**
+ * Single terminal-facts accessor: a cross-field-valid RunFacts receipt wins;
+ * old/in-flight runs with no receipt retain legacy projections. A receipt that
+ * is present but invalid fails loudly and can never reopen legacy apply truth.
+ */
+export function effectiveTerminalFacts(runDir, legacyOutcomeFacts, legacyDecision = null, expected = {}) {
+    const runFacts = readRunFacts(runDir, expected);
+    const outcomeFacts = runFacts?.outcome ?? legacyOutcomeFacts;
+    return {
+        runFacts,
+        outcomeFacts,
+        decision: legacyDecision && outcomeFacts ? { ...legacyDecision, facts: outcomeFacts } : legacyDecision,
+    };
+}
+/**
+ * Project terminal compatibility fields from one canonical receipt read.
+ * Missing receipts use legacy derivations for in-flight and pre-RunFacts runs.
+ * Present-but-invalid receipts fail loudly.
+ */
+export function projectRunFactsForDetail(runDir, legacyOutcomeFacts, hasValidOperatorDecision, legacyApplyEligibility, expected = {}) {
+    const { runFacts, outcomeFacts } = effectiveTerminalFacts(runDir, legacyOutcomeFacts, null, expected);
+    if (runFacts) {
+        // Delivery state and operator decisions are the two legitimate
+        // post-terminal overlays. Re-derive only their mutable compatibility
+        // fields while keeping the receipt's terminal outcome authoritative.
+        const hasMutableOverlay = hasValidOperatorDecision || artifactExists(runDir, "final/delivery_state.yaml");
+        return {
+            runFacts,
+            outcomeFacts,
+            applyEligibility: hasMutableOverlay ? legacyApplyEligibility() : runFacts.apply.eligibility,
+            requiredActions: hasMutableOverlay
+                ? requiredActionsFor(runFacts.outcome, hasValidOperatorDecision)
+                : runFacts.required_actions,
+        };
+    }
+    return {
+        runFacts: null,
+        outcomeFacts: legacyOutcomeFacts,
+        applyEligibility: legacyApplyEligibility(),
+        requiredActions: requiredActionsFor(legacyOutcomeFacts, hasValidOperatorDecision),
+    };
+}
+/** RunFacts is already redacted; avoid a second presentation-redaction pass. */
+function readRunFacts(runDir, expected) {
+    if (!runDir)
+        return null;
+    const root = safeArtifactRoot(runDir);
+    if (!root) {
+        try {
+            lstatSync(runDir);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return null;
+        }
+        throw invalidRunFacts();
+    }
+    const finalDir = join(root, "final");
+    let finalStat;
+    try {
+        finalStat = lstatSync(finalDir);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw invalidRunFacts();
+    }
+    if (finalStat.isSymbolicLink() || !finalStat.isDirectory()) {
+        throw invalidRunFacts();
+    }
+    const path = join(finalDir, "run_facts.yaml");
+    let stat;
+    try {
+        stat = lstatSync(path);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw invalidRunFacts();
+    }
+    if (stat.isSymbolicLink() || stat.isDirectory() || !stat.isFile()) {
+        throw invalidRunFacts();
+    }
+    try {
+        // Shape + cross-axis invariants + identity binding live in the ONE shared
+        // pure owner (@claudexor/schema); only YAML/file reading and the HTTP
+        // problem mapping below are control-api's own.
+        return validateRunFactsReceipt(parseYaml(readFileSync(path, "utf8")), expected);
+    }
+    catch {
+        throw invalidRunFacts();
+    }
+}
+/** Transport mapping of the shared refusal: the HTTP status and typed unblock
+ * action are control-api's own; message/code/retryable/evidenceRefs come from
+ * the ONE shared class in @claudexor/schema — never duplicated here. */
+class RunFactsInvalidHttpError extends RunFactsInvalidError {
+    status = 500;
+    requiredActions = ["inspect_run_artifacts"];
+}
+function invalidRunFacts() {
+    return new RunFactsInvalidHttpError();
+}
+function artifactExists(runDir, relativePath) {
+    try {
+        if (!runDir)
+            return false;
+        const path = safeArtifactPath(runDir, relativePath);
+        if (!path)
+            return false;
+        const stat = lstatSync(path);
+        return !stat.isSymbolicLink() && !stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# 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/run-list-fingerprint.d.ts

@@ -0,0 +1,7 @@
+import type { DaemonRunRecord } from "./run-record.js";
+export declare function runListFingerprintProbeCountForTests(): number;
+export declare function resetRunListFingerprintProbeCountForTests(): void;
+/** Fingerprint only the mutable delivery overlay for settled runs; all other
+ * terminal artifacts are immutable. Active runs retain the complete set. */
+export declare function summaryFingerprint(rec: DaemonRunRecord): string;
+//# sourceMappingURL=run-list-fingerprint.d.ts.map

package/dist/run-list-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-list-fingerprint.d.ts","sourceRoot":"","sources":["../src/run-list-fingerprint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD,wBAAgB,oCAAoC,IAAI,MAAM,CAE7D;AAED,wBAAgB,yCAAyC,IAAI,IAAI,CAEhE;AAED;4EAC4E;AAC5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAyC/D"}

package/dist/run-list-fingerprint.js

@@ -0,0 +1,68 @@
+import { statSync } from "node:fs";
+import { sha256 } from "@claudexor/util";
+import { safeArtifactPath } from "./artifact-paths.js";
+import { TERMINAL_STATES } from "./sse-shared.js";
+/** Number of artifact-path probes performed by the run-list fingerprinter. */
+let fingerprintProbeCount = 0;
+export function runListFingerprintProbeCountForTests() {
+    return fingerprintProbeCount;
+}
+export function resetRunListFingerprintProbeCountForTests() {
+    fingerprintProbeCount = 0;
+}
+/** Fingerprint only the mutable delivery overlay for settled runs; all other
+ * terminal artifacts are immutable. Active runs retain the complete set. */
+export function summaryFingerprint(rec) {
+    const fileIdentity = (rel) => {
+        fingerprintProbeCount++;
+        if (!rec.runDir)
+            return "0";
+        const path = safeArtifactPath(rec.runDir, rel);
+        if (!path)
+            return "0";
+        try {
+            const stat = statSync(path, { bigint: true });
+            return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
+        }
+        catch {
+            return "0";
+        }
+    };
+    const identity = [rec.state, paramsFingerprint(rec), rec.finishedAt ?? "", rec.error ?? ""];
+    if (TERMINAL_STATES.has(rec.state)) {
+        // Delivery is the only ordinary mutable terminal overlay. Retention is the
+        // other sanctioned transition: it atomically replaces the whole run tree
+        // with tombstone.yaml, so that marker must invalidate a previously cached
+        // ready summary without re-statting every immutable terminal artifact.
+        return [
+            ...identity,
+            fileIdentity("final/delivery_state.yaml"),
+            fileIdentity("tombstone.yaml"),
+        ].join("|");
+    }
+    return [
+        ...identity,
+        fileIdentity("events.jsonl"),
+        fileIdentity("arbitration/decision.yaml"),
+        fileIdentity("final/telemetry.yaml"),
+        fileIdentity("final/run_facts.yaml"),
+        fileIdentity("final/failure.yaml"),
+        fileIdentity("final/summary.md"),
+        fileIdentity("final/answer.md"),
+        fileIdentity("final/plan.md"),
+        fileIdentity("final/explore.md"),
+        fileIdentity("final/report.md"),
+        fileIdentity("final/patch.diff"),
+        fileIdentity("final/work_product.yaml"),
+        fileIdentity("final/delivery_state.yaml"),
+    ].join("|");
+}
+function paramsFingerprint(rec) {
+    try {
+        return sha256(JSON.stringify(rec.params ?? null));
+    }
+    catch {
+        return "unserializable-params";
+    }
+}
+//# sourceMappingURL=run-list-fingerprint.js.map

package/dist/run-list-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-list-fingerprint.js","sourceRoot":"","sources":["../src/run-list-fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,8EAA8E;AAC9E,IAAI,qBAAqB,GAAG,CAAC,CAAC;AAE9B,MAAM,UAAU,oCAAoC;IAClD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,yCAAyC;IACvD,qBAAqB,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,GAAoB;IACrD,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;QAC3C,qBAAqB,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,GAAG,CAAC;QAC5B,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5F,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,2EAA2E;QAC3E,yEAAyE;QACzE,0EAA0E;QAC1E,uEAAuE;QACvE,OAAO;YACL,GAAG,QAAQ;YACX,YAAY,CAAC,2BAA2B,CAAC;YACzC,YAAY,CAAC,gBAAgB,CAAC;SAC/B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO;QACL,GAAG,QAAQ;QACX,YAAY,CAAC,cAAc,CAAC;QAC5B,YAAY,CAAC,2BAA2B,CAAC;QACzC,YAAY,CAAC,sBAAsB,CAAC;QACpC,YAAY,CAAC,sBAAsB,CAAC;QACpC,YAAY,CAAC,oBAAoB,CAAC;QAClC,YAAY,CAAC,kBAAkB,CAAC;QAChC,YAAY,CAAC,iBAAiB,CAAC;QAC/B,YAAY,CAAC,eAAe,CAAC;QAC7B,YAAY,CAAC,kBAAkB,CAAC;QAChC,YAAY,CAAC,iBAAiB,CAAC;QAC/B,YAAY,CAAC,kBAAkB,CAAC;QAChC,YAAY,CAAC,yBAAyB,CAAC;QACvC,YAAY,CAAC,2BAA2B,CAAC;KAC1C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAoB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/run-record.d.ts

@@ -8,6 +8,8 @@ export interface DaemonRunRecord {
     errorCode?: string;
     errorStatus?: number;
     errorRetryable?: boolean;
+    errorRequiredActions?: string[];
+    errorContext?: Record<string, unknown>;
     params?: unknown;
     createdAt?: string;
     startedAt?: string;
@@ -22,11 +24,13 @@ export interface DaemonFacadeClient {
     }): Promise<{
         id: string;
         state: string;
+        reused?: boolean;
     }>;
     findAccepted?(params: unknown, options: {
         idempotencyKey: string;
         clientId?: string;
         operation?: string;
+        idempotencyRequest?: unknown;
     }): Promise<DaemonRunRecord | null>;
     status(id: string): Promise<DaemonRunRecord>;
     list(): Promise<DaemonRunRecord[]>;

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

@@ -1 +1 @@
-{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../src/run-record.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CACL,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1C,YAAY,CAAC,CACX,MAAM,EAAE,OAAO,EACf,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACzE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,qBAAqB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,aAAa,GAAG,sBAAsB,CAAC;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI7E;AAED;kEACkE;AAClE,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,KAAK,SAAyB,GAC7B,eAAe,EAAE,CAwBnB;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,SAAS,eAAe,EAAE,GAC/B,eAAe,EAAE,CAuBnB"}
+{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../src/run-record.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CACL,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5D,YAAY,CAAC,CACX,MAAM,EAAE,OAAO,EACf,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,GACA,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,qBAAqB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,aAAa,GAAG,sBAAsB,CAAC;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI7E;AAED;kEACkE;AAClE,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,KAAK,SAAyB,GAC7B,eAAe,EAAE,CAwBnB;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,SAAS,eAAe,EAAE,GAC/B,eAAe,EAAE,CAuBnB"}

package/dist/run-record.js.map

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

package/dist/run-retry-routes.d.ts

@@ -1,13 +1,14 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { DaemonControlApiOptions, DaemonFacadeClient, DaemonRunRecord } from "./daemon-server.js";
-type RetryServices = Pick<NonNullable<DaemonControlApiOptions["services"]>, "createThreadTurn" | "setTurnEnqueueError" | "threadDetail" | "validateResources" | "preflightRunRequirements">;
+type RetryServices = Pick<NonNullable<DaemonControlApiOptions["services"]>, "createThreadTurn" | "findThreadTurnByIdempotency" | "setTurnEnqueueError" | "threadDetail" | "validateResources" | "preflightRunRequirements">;
 export interface RunRetryRouteContext {
     daemon: DaemonFacadeClient;
     services?: RetryServices;
     findRun(id: string): Promise<DaemonRunRecord | null>;
     waitForRunStart(jobId: string): Promise<DaemonRunRecord>;
+    serializeThreadMutation<T>(threadId: string, work: () => Promise<T>): Promise<T>;
     json(response: ServerResponse, status: number, body: unknown): void;
-    requestError(response: ServerResponse, error: unknown): void;
+    requestError(response: ServerResponse, error: unknown, fallbackStatus?: 400 | 500): void;
 }
 export declare function handleRunRetryRoute(ctx: RunRetryRouteContext, method: string, path: string, req: IncomingMessage, res: ServerResponse): Promise<boolean>;
 export {};

package/dist/run-retry-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-retry-routes.d.ts","sourceRoot":"","sources":["../src/run-retry-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAWjE,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAK5B,KAAK,aAAa,GAAG,IAAI,CACvB,WAAW,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,EAC9C,kBAAkB,GAClB,qBAAqB,GACrB,cAAc,GACd,mBAAmB,GACnB,0BAA0B,CAC7B,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACpE,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9D;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,CAYlB"}
+{"version":3,"file":"run-retry-routes.d.ts","sourceRoot":"","sources":["../src/run-retry-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAWjE,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAM5B,KAAK,aAAa,GAAG,IAAI,CACvB,WAAW,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,EAC9C,kBAAkB,GAClB,6BAA6B,GAC7B,qBAAqB,GACrB,cAAc,GACd,mBAAmB,GACnB,0BAA0B,CAC7B,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACzD,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjF,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACpE,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;CAC1F;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,CAYlB"}