@claudexor/control-api 1.0.1

package/dist/run-timeline.js

@@ -0,0 +1,155 @@
+/**
+ * Timeline projection over a run's canonical events.jsonl: severity
+ * classification (typed event kinds + typed tool status — no prose parsing),
+ * bounded output with an EXPLICIT truncation marker, and the shared
+ * event-reading helpers the budget snapshot reuses.
+ */
+import { lstatSync, readFileSync } from "node:fs";
+import { ControlTimelineEvent, FallbackReason } from "@claudexor/schema";
+import { redactSecrets } from "@claudexor/util";
+import { safeArtifactPath } from "./artifact-paths.js";
+const TIMELINE_EVENTS_MAX = 500;
+export function readRunEvents(rec) {
+    if (!rec.runDir)
+        return [];
+    const path = safeArtifactPath(rec.runDir, "events.jsonl");
+    if (!path)
+        return [];
+    let raw;
+    try {
+        const st = lstatSync(path);
+        if (st.isSymbolicLink() || st.isDirectory())
+            return [];
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of raw.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            const obj = JSON.parse(line);
+            if (obj && typeof obj === "object" && !Array.isArray(obj))
+                out.push(obj);
+        }
+        catch {
+            /* malformed line remains in events.jsonl; omit from projections */
+        }
+    }
+    return out;
+}
+export function eventPayload(ev) {
+    return ev["payload"] && typeof ev["payload"] === "object" && !Array.isArray(ev["payload"])
+        ? ev["payload"]
+        : {};
+}
+export function stringOrNull(value) {
+    return typeof value === "string" && value.length > 0 ? redactSecrets(value) : null;
+}
+function prettyEventType(type) {
+    return type.replace(/\./g, " · ").replace(/_/g, " ");
+}
+const WARNING_EVENT_TYPES = new Set([
+    "route.fallback.started",
+    "route.fallback.auth_switched",
+    "route.fallback.exhausted",
+    "policy.web.upgraded",
+    "run.blocked",
+]);
+const ERROR_EVENT_TYPES = new Set(["run.failed", "reviewer.failed", "reviewer.timed_out"]);
+function timelineSeverity(type, payload, tool) {
+    if (payload["error"] || tool["status"] === "error" || ERROR_EVENT_TYPES.has(type))
+        return "error";
+    const reason = FallbackReason.safeParse(payload["reason"]);
+    if (type === "route.fallback.auth_switched" && reason.success && reason.data === "readiness_preferred")
+        return "info";
+    if (WARNING_EVENT_TYPES.has(type))
+        return "warning";
+    return "info";
+}
+export function timelineEvents(rec) {
+    const out = [];
+    for (const ev of readRunEvents(rec)) {
+        const payload = eventPayload(ev);
+        const type = String(ev["type"] ?? "event");
+        // Typed tool info travels on the normalized HarnessEvent `tool` field.
+        const tool = payload["tool"] && typeof payload["tool"] === "object" && !Array.isArray(payload["tool"])
+            ? payload["tool"]
+            : {};
+        const harnessId = stringOrNull(payload["harness_id"] ?? payload["harness"]);
+        const attemptId = stringOrNull(payload["attempt_id"] ?? payload["attemptId"]);
+        const title = stringOrNull(payload["title"] ?? payload["message"] ?? payload["summary"] ?? payload["text"] ?? payload["error"]) ?? prettyEventType(type);
+        const errorSummary = stringOrNull(tool["error_summary"] ?? payload["error"]);
+        const detail = stringOrNull(payload["detail"] ?? payload["text"] ?? payload["error"]) ?? stringOrNull(tool["content_summary"]) ?? errorSummary;
+        const toolName = stringOrNull(tool["name"]);
+        const target = stringOrNull(tool["target"]);
+        const severity = timelineSeverity(type, payload, tool);
+        out.push(ControlTimelineEvent.parse({
+            type,
+            ts: typeof ev["ts"] === "string" ? ev["ts"] : undefined,
+            harnessId,
+            attemptId,
+            title,
+            detail,
+            severity,
+            toolName,
+            target,
+            errorSummary,
+            rawRef: "events.jsonl",
+        }));
+    }
+    // Bounded projection with an EXPLICIT truncation marker — no silent truncation.
+    if (out.length > TIMELINE_EVENTS_MAX) {
+        const omitted = out.length - TIMELINE_EVENTS_MAX;
+        const tail = out.slice(-TIMELINE_EVENTS_MAX);
+        tail.unshift(ControlTimelineEvent.parse({
+            type: "timeline.truncated",
+            title: `${omitted} earlier event(s) omitted from this projection`,
+            detail: "Full history remains in events.jsonl.",
+            severity: "info",
+            rawRef: "events.jsonl",
+        }));
+        return tail;
+    }
+    return out;
+}
+/** The LAST plan.progress event's typed items (the live plan checklist), or
+ * null when the run never emitted one. Last-wins by construction: plan tools
+ * re-emit the whole list on every revision. On RACES the candidates' lists
+ * interleave — prefer the WINNER's attempt (decision.yaml) so the Plan tab
+ * shows the shipped candidate's checklist, not whichever emitted last. */
+export function latestPlanProgress(rec, winnerAttemptId) {
+    const events = readRunEvents(rec);
+    const pick = (matchWinner) => {
+        for (let i = events.length - 1; i >= 0; i--) {
+            const ev = events[i];
+            if (ev?.["type"] !== "plan.progress")
+                continue;
+            if (matchWinner && eventPayload(ev)["attempt_id"] !== winnerAttemptId)
+                continue;
+            return ev;
+        }
+        return null;
+    };
+    const chosen = (winnerAttemptId ? pick(true) : null) ?? pick(false);
+    {
+        const ev = chosen;
+        if (!ev)
+            return null;
+        const payload = eventPayload(ev);
+        const rawItems = Array.isArray(payload["items"]) ? payload["items"] : [];
+        const items = rawItems
+            .map((raw) => {
+            const r = raw;
+            if (typeof r.id !== "string" || typeof r.title !== "string")
+                return null;
+            const status = r.status === "completed" ? "completed" : r.status === "in_progress" ? "in_progress" : "pending";
+            return { id: r.id, title: r.title, status: status };
+        })
+            .filter((x) => x !== null);
+        return { items };
+    }
+}
+//# sourceMappingURL=run-timeline.js.map

package/dist/run-timeline.js.map

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

package/dist/sse-shared.d.ts

@@ -0,0 +1,11 @@
+/** Daemon job states that end a stream/wait (shared by both SSE surfaces). */
+export declare const TERMINAL_STATES: Set<string>;
+/** One SSE data line: secrets redacted, JSON re-minified when parseable. */
+export declare function redactedSseLine(raw: string): string;
+/** Incremental line reader for events.jsonl tails (rotation-tolerant). */
+export declare function readNewLines(path: string, offset: number, carry: string): {
+    lines: string[];
+    nextOffset: number;
+    rest: string;
+};
+//# sourceMappingURL=sse-shared.d.ts.map

package/dist/sse-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-shared.d.ts","sourceRoot":"","sources":["../src/sse-shared.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,eAAO,MAAM,eAAe,aAY1B,CAAC;AAEH,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgB/H"}

package/dist/sse-shared.js

@@ -0,0 +1,47 @@
+import { closeSync, openSync, readSync, statSync } from "node:fs";
+import { redactSecrets } from "@claudexor/util";
+/** Daemon job states that end a stream/wait (shared by both SSE surfaces). */
+export const TERMINAL_STATES = new Set([
+    "succeeded",
+    "no_op",
+    "ungated",
+    "review_not_run",
+    "blocked",
+    "failed",
+    "cancelled",
+    "interrupted",
+    "exhausted",
+    "not_converged",
+    "stuck_no_progress",
+]);
+/** One SSE data line: secrets redacted, JSON re-minified when parseable. */
+export function redactedSseLine(raw) {
+    const redacted = redactSecrets(raw);
+    try {
+        return JSON.stringify(JSON.parse(redacted));
+    }
+    catch {
+        return redacted;
+    }
+}
+/** Incremental line reader for events.jsonl tails (rotation-tolerant). */
+export function readNewLines(path, offset, carry) {
+    const size = statSync(path).size;
+    const start = size < offset ? 0 : offset; // file rotated/truncated; start over
+    const len = size - start;
+    if (len <= 0)
+        return { lines: [], nextOffset: start, rest: carry };
+    const fd = openSync(path, "r");
+    try {
+        const buf = Buffer.allocUnsafe(len);
+        readSync(fd, buf, 0, len, start);
+        const text = carry + buf.toString("utf8");
+        const parts = text.split("\n");
+        const rest = parts.pop() ?? "";
+        return { lines: parts.filter(Boolean), nextOffset: size, rest };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=sse-shared.js.map

package/dist/sse-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-shared.js","sourceRoot":"","sources":["../src/sse-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IACrC,WAAW;IACX,OAAO;IACP,SAAS;IACT,gBAAgB;IAChB,SAAS;IACT,QAAQ;IACR,WAAW;IACX,aAAa;IACb,WAAW;IACX,eAAe;IACf,mBAAmB;CACpB,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,KAAa;IACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,qCAAqC;IAC/E,MAAM,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;IACzB,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnE,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/thread-projection.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Thread-store projections: raw persisted thread/session/turn records ->
+ * typed Control DTOs. Pure and schema-parsed — the store shape is validated
+ * at the boundary, never trusted.
+ */
+import { ControlSession, ControlThread, ControlThreadTurn, ControlTurnRunCard, type ControlRunSummary } from "@claudexor/schema";
+export declare function projectThread(raw: unknown, needsHuman: boolean): ControlThread;
+export declare function projectSession(raw: unknown): ControlSession;
+/** Project a run summary down to the compact card embedded on a thread turn. */
+export declare function turnRunCard(summary: ControlRunSummary): ControlTurnRunCard;
+export declare function projectTurn(raw: unknown, cards: Map<string, ControlTurnRunCard>): ControlThreadTurn;
+//# sourceMappingURL=thread-projection.d.ts.map

package/dist/thread-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-projection.d.ts","sourceRoot":"","sources":["../src/thread-projection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEjI,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,aAAa,CAoB9E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAU3D;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB,CAY1E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,iBAAiB,CA8BnG"}

package/dist/thread-projection.js

@@ -0,0 +1,83 @@
+/**
+ * Thread-store projections: raw persisted thread/session/turn records ->
+ * typed Control DTOs. Pure and schema-parsed — the store shape is validated
+ * at the boundary, never trusted.
+ */
+import { ControlSession, ControlThread, ControlThreadTurn, ControlTurnRunCard } from "@claudexor/schema";
+export function projectThread(raw, needsHuman) {
+    const t = raw;
+    const repo = t["repo"];
+    const workspace = t["workspace"];
+    return ControlThread.parse({
+        id: t["id"],
+        title: t["title"] ?? null,
+        repoRoot: repo?.root ?? null,
+        mode: t["mode"],
+        workspaceMode: workspace?.mode ?? "in_place",
+        authPreference: t["auth_preference"] ?? "auto",
+        primaryHarness: t["primary_harness"] ?? null,
+        eligibleHarnesses: t["eligible_harnesses"] ?? [],
+        state: t["state"] ?? "active",
+        runIds: t["run_ids"] ?? [],
+        headRunId: t["head_run_id"] ?? null,
+        needsHuman,
+        createdAt: t["created_at"],
+        updatedAt: t["updated_at"],
+    });
+}
+export function projectSession(raw) {
+    const s = raw;
+    return ControlSession.parse({
+        id: s["id"],
+        threadId: s["thread_id"],
+        harnessId: s["harness_id"],
+        nativeSessionId: s["native_session_id"] ?? null,
+        observedModel: s["last_observed_model"] ?? null,
+        state: s["state"] ?? "live",
+    });
+}
+/** Project a run summary down to the compact card embedded on a thread turn. */
+export function turnRunCard(summary) {
+    return ControlTurnRunCard.parse({
+        state: summary.state,
+        mode: summary.mode,
+        strategy: summary.strategy ?? null,
+        n: summary.n,
+        result: summary.result,
+        spendUsd: summary.spendUsd ?? null,
+        outputReadyState: summary.outputReadyState,
+        waitingOnUser: summary.waitingOnUser,
+        finishedAt: summary.finishedAt ?? null,
+    });
+}
+export function projectTurn(raw, cards) {
+    const t = raw;
+    const runId = t["run_id"] ?? null;
+    const enqueueError = t["enqueue_error"];
+    return ControlThreadTurn.parse({
+        id: t["id"],
+        threadId: t["thread_id"],
+        runId,
+        parentRunId: t["parent_run_id"] ?? null,
+        planRunId: t["plan_run_id"] ?? null,
+        kind: t["kind"] ?? "followup",
+        prompt: t["prompt"] ?? "",
+        // Embedded run card so the chat renders the whole conversation (state +
+        // honest outcome) from this one response — no N+1 run-detail fetch per turn.
+        run: runId ? cards.get(runId) ?? null : null,
+        // A runless turn's refusal (trust gate / preflight) rides the projection so
+        // the chat shows WHY there is no run instead of an eternally-empty bubble.
+        enqueueError: !runId && enqueueError && typeof enqueueError === "object"
+            ? {
+                message: String(enqueueError.message ?? ""),
+                code: typeof enqueueError.code === "string" ? enqueueError.code : null,
+                // Legacy records (pre-retryable) default to true — they came from
+                // the runner-hook path, where a job exists to replay.
+                retryable: enqueueError.retryable !== false,
+                failedAt: String(enqueueError.failed_at ?? ""),
+            }
+            : null,
+        createdAt: t["created_at"],
+    });
+}
+//# sourceMappingURL=thread-projection.js.map

package/dist/thread-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-projection.js","sourceRoot":"","sources":["../src/thread-projection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAC;AAEjI,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,UAAmB;IAC7D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAA6B,CAAC;IACnD,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAkC,CAAC;IAClE,OAAO,aAAa,CAAC,KAAK,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI;QACzB,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,SAAS,EAAE,IAAI,IAAI,UAAU;QAC5C,cAAc,EAAE,CAAC,CAAC,iBAAiB,CAAC,IAAI,MAAM;QAC9C,cAAc,EAAE,CAAC,CAAC,iBAAiB,CAAC,IAAI,IAAI;QAC5C,iBAAiB,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAChD,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,QAAQ;QAC7B,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE;QAC1B,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI;QACnC,UAAU;QACV,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC;QAC1B,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,cAAc,CAAC,KAAK,CAAC;QAC1B,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC;QACxB,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC;QAC1B,eAAe,EAAE,CAAC,CAAC,mBAAmB,CAAC,IAAI,IAAI;QAC/C,aAAa,EAAE,CAAC,CAAC,qBAAqB,CAAC,IAAI,IAAI;QAC/C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,MAAM;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,OAA0B;IACpD,OAAO,kBAAkB,CAAC,KAAK,CAAC;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;KACvC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,KAAsC;IAC9E,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,KAAK,GAAI,CAAC,CAAC,QAAQ,CAAmB,IAAI,IAAI,CAAC;IACrD,MAAM,YAAY,GAAG,CAAC,CAAC,eAAe,CAAuG,CAAC;IAC9I,OAAO,iBAAiB,CAAC,KAAK,CAAC;QAC7B,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC;QACxB,KAAK;QACL,WAAW,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,IAAI;QACvC,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI;QACnC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,UAAU;QAC7B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;QACzB,wEAAwE;QACxE,6EAA6E;QAC7E,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;QAC5C,4EAA4E;QAC5E,2EAA2E;QAC3E,YAAY,EACV,CAAC,KAAK,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ;YACxD,CAAC,CAAC;gBACE,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC3C,IAAI,EAAE,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBACtE,kEAAkE;gBAClE,sDAAsD;gBACtD,SAAS,EAAE,YAAY,CAAC,SAAS,KAAK,KAAK;gBAC3C,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC;aAC/C;YACH,CAAC,CAAC,IAAI;QACV,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/thread-turn-routes.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Thread-turn write routes: POST /threads/:id/turns (create + enqueue) and
+ * POST /threads/:id/turns/:turnId/retry (re-enqueue a REFUSED turn).
+ *
+ * Extracted from daemon-server.ts (INV-124 ratchet). The server passes a thin
+ * ctx of bound helpers; these functions own the per-thread serialization and
+ * the refused-turn honesty rules (persist the refusal ON the turn, INV-093).
+ */
+import type { ServerResponse } from "node:http";
+import { ControlRunStartRequest } from "@claudexor/schema";
+import type { AttachmentInput } from "@claudexor/schema";
+import type { DaemonFacadeClient, DaemonRunRecord } from "./daemon-server.js";
+export interface ThreadTurnRouteCtx {
+    json(res: ServerResponse, status: number, body: unknown): void;
+    waitForRunStart(jobId: string): Promise<DaemonRunRecord>;
+    readRunArtifactText(runId: string, relPath: string): Promise<string | null>;
+    /** The server's single run-start normalizer (scope/prompt/policy validation). */
+    normalizeStart(parsed: ControlRunStartRequest): ControlRunStartRequest;
+    /** True for terminal job states (the server's TERMINAL_STATES set). */
+    isTerminalState(state: string): boolean;
+    daemon: DaemonFacadeClient;
+    threadDetail(id: string): Promise<{
+        thread: unknown;
+        sessions: unknown[];
+        turns: unknown[];
+    }>;
+    createThreadTurn(id: string, prompt: string, opts: {
+        parentRunId?: string | null;
+        planRunId?: string | null;
+        attachments?: AttachmentInput[];
+    }): Promise<unknown>;
+    setTurnEnqueueError?: (turnId: string, message: string, code: string | null, retryable?: boolean) => void;
+    /** Per-thread promise chain (owned by the server; shared with turn creation). */
+    threadTurnChains: Map<string, Promise<void>>;
+}
+/** A typed throw's machine code (e.g. the trust gate's), null when absent or
+ * non-string (a numeric errno-style `code` must not leak into the typed
+ * refusal contract). ONE owner — daemon-server's refusal recorder reuses it. */
+export declare function errCode(err: unknown): string | null;
+/**
+ * Persist an enqueue failure on a pre-created turn (refused-turn honesty,
+ * INV-093). Shared by every pre-create-then-enqueue path OUTSIDE these
+ * routes (direct POST /runs with threadId, rerun_with_feedback). Marked
+ * retryable=false: these are enqueue-throw paths — no job was recorded, so
+ * the retry endpoint has nothing to replay. Best-effort by
+ * contract: recording must never mask the original error (callers always
+ * return it), and errCode yields null for absent/non-string codes.
+ */
+export declare function recordTurnEnqueueFailure(setTurnEnqueueError: ((turnId: string, message: string, code: string | null, retryable?: boolean) => void) | undefined, turnId: string | undefined, err: unknown): void;
+/**
+ * POST /threads/:id/turns — create the turn record FIRST (single-writer), then
+ * enqueue its run. Per-thread serialization: concurrent turns on one thread
+ * would race the head_run_id lineage (check-then-act across awaits).
+ */
+export declare function handleThreadTurnCreate(ctx: ThreadTurnRouteCtx, res: ServerResponse, threadId: string, body: Record<string, unknown>): Promise<void>;
+/**
+ * POST /threads/:id/turns/:turnId/retry — re-enqueue a REFUSED turn (same
+ * prompt/options/attachment refs: the job registry is the SSOT of enqueue
+ * params, replayed verbatim). No duplicate bubble: the run binds to the SAME
+ * turn, which also clears enqueue_error.
+ */
+export declare function handleThreadTurnRetry(ctx: ThreadTurnRouteCtx, res: ServerResponse, threadId: string, turnId: string): Promise<void>;
+//# sourceMappingURL=thread-turn-routes.d.ts.map

package/dist/thread-turn-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-turn-routes.d.ts","sourceRoot":"","sources":["../src/thread-turn-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAuB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/D,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACzD,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5E,iFAAiF;IACjF,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAAC;IACvE,uEAAuE;IACvE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAC9F,gBAAgB,CACd,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,GAChG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1G,iFAAiF;IACjF,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAC9C;AAoBD;;gFAEgF;AAChF,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,EACtH,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,OAAO,GACX,IAAI,CAON;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAuJf;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAwGf"}