@claudexor/daemon 3.25.1 → 4.0.0

package/dist/store/partitions.d.ts

@@ -0,0 +1,37 @@
+import type { EngineStore } from "./store.js";
+import { type SqlWriteContext } from "./mutation.js";
+/** One generation of a partition: the surrogate `pid` is the only key rows carry. */
+export interface PartitionGeneration {
+    pid: number;
+    name: string;
+    epoch: string;
+    status: string;
+    nextSeq: number;
+}
+interface PartitionRow {
+    id: number | bigint;
+    name: string;
+    epoch: string;
+    status: string;
+    next_seq: number | bigint;
+}
+export declare function generationOf(row: PartitionRow): PartitionGeneration;
+/** Create a new generation (inside the caller's transaction). Sequence numbers start at 1, as today. */
+export declare function createPartition(store: EngineStore, name: string, options?: {
+    epoch?: string;
+    projectId?: string | null;
+}): PartitionGeneration;
+/** Importers supply the original identity, time and sparse sequence head. */
+export declare function insertPartitionInTx(sql: SqlWriteContext, input: {
+    name: string;
+    epoch: string;
+    createdAt: string;
+    projectId?: string | null;
+    status?: string;
+    nextSeq?: number;
+}): PartitionGeneration;
+/** The current (`ready`) generation of a partition name, or null. */
+export declare function currentGeneration(store: Pick<SqlWriteContext, "prepare">, name: string): PartitionGeneration | null;
+export declare function partitionById(sql: Pick<SqlWriteContext, "prepare">, pid: number): PartitionGeneration | null;
+export {};
+//# sourceMappingURL=partitions.d.ts.map

package/dist/store/partitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitions.d.ts","sourceRoot":"","sources":["../../src/store/partitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEzE,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,mBAAmB,CAQnE;AAED,wGAAwG;AACxG,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAC1D,mBAAmB,CAQrB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,mBAAmB,CAiBrB;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EACvC,IAAI,EAAE,MAAM,GACX,mBAAmB,GAAG,IAAI,CA4B5B;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EACrC,GAAG,EAAE,MAAM,GACV,mBAAmB,GAAG,IAAI,CAK5B"}

package/dist/store/partitions.js

@@ -0,0 +1,68 @@
+import { randomUUID } from "node:crypto";
+import { requireTransaction } from "./mutation.js";
+export function generationOf(row) {
+    return {
+        pid: Number(row.id),
+        name: row.name,
+        epoch: row.epoch,
+        status: row.status,
+        nextSeq: Number(row.next_seq),
+    };
+}
+/** Create a new generation (inside the caller's transaction). Sequence numbers start at 1, as today. */
+export function createPartition(store, name, options = {}) {
+    const epoch = options.epoch ?? randomUUID().replace(/-/g, "");
+    return insertPartitionInTx(store, {
+        name,
+        epoch,
+        projectId: options.projectId,
+        createdAt: store.now().toISOString(),
+    });
+}
+/** Importers supply the original identity, time and sparse sequence head. */
+export function insertPartitionInTx(sql, input) {
+    requireTransaction(sql);
+    if (!input.name.trim())
+        throw new Error("journal partition must not be empty");
+    const status = input.status ?? "ready";
+    const nextSeq = input.nextSeq ?? 1;
+    const result = sql
+        .prepare("INSERT INTO partition(name, epoch, status, next_seq, project_id, created_at) VALUES(?, ?, ?, ?, ?, ?)")
+        .run(input.name, input.epoch, status, nextSeq, input.projectId ?? null, input.createdAt);
+    return {
+        pid: Number(result.lastInsertRowid),
+        name: input.name,
+        epoch: input.epoch,
+        status,
+        nextSeq,
+    };
+}
+/** The current (`ready`) generation of a partition name, or null. */
+export function currentGeneration(store, name) {
+    const global = store.prepare("SELECT value FROM meta WHERE key = 'global_pid'").get();
+    if (global) {
+        const row = name === "global"
+            ? store
+                .prepare("SELECT id,name,epoch,status,next_seq FROM partition WHERE id=? AND name='global' AND status='ready'")
+                .get(Number(global.value))
+            : store
+                .prepare(`SELECT q.id,q.name,q.epoch,q.status,q.next_seq FROM project p
+          JOIN partition q ON q.id=p.current_pid JOIN partition g ON g.id=p.pid
+          WHERE p.pid=? AND p.status='active' AND g.status='ready' AND q.name=? AND q.status='ready'`)
+                .get(Number(global.value), name);
+        return row ? generationOf(row) : null;
+    }
+    // Core/import fixtures may construct a partition before binding the registry;
+    // admitted composition always has global_pid and uses the branch above.
+    const row = store
+        .prepare("SELECT id, name, epoch, status, next_seq FROM partition WHERE name = ? AND status = 'ready'")
+        .get(name);
+    return row ? generationOf(row) : null;
+}
+export function partitionById(sql, pid) {
+    const row = sql
+        .prepare("SELECT id, name, epoch, status, next_seq FROM partition WHERE id = ?")
+        .get(pid);
+    return row ? generationOf(row) : null;
+}
+//# sourceMappingURL=partitions.js.map

package/dist/store/partitions.js.map

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

package/dist/store/pragmas.d.ts

@@ -0,0 +1,32 @@
+import type { DatabaseSync } from "node:sqlite";
+/**
+ * Connection pragmas of the engine store (SYNTHESIS_R5 §2, topology A2).
+ *
+ * Main connection: WAL + NORMAL (a commit performs no sync), autocheckpoint
+ * TRIGGERED at 4000 pages (about 16 MiB of frames — a threshold, not a WAL
+ * size bound: a pinned reader or a large transaction grows the WAL beyond it
+ * until the reader releases, R5_AMENDMENTS A6)
+ * with `checkpoint_fullfsync=1` so the one checkpoint that may complete a
+ * backfill on this thread syncs WAL -> DB -> reuse with F_FULLFSYNC; plain
+ * `fullfsync` stays off so nothing else on the request thread syncs. The busy
+ * timeout is a fuse, not a design: hitting it is the `busy_waits` fact.
+ *
+ * Flusher connection: never writes rows, never waits for a lock (PASSIVE
+ * checkpoints are lock-free by contract), same checkpoint sync class.
+ */
+export interface PragmaSpec {
+    readonly [name: string]: number | string;
+}
+export declare const MAIN_CONNECTION_PRAGMAS: PragmaSpec;
+export declare const FLUSHER_CONNECTION_PRAGMAS: PragmaSpec;
+export declare class PragmaReadbackError extends Error {
+    readonly pragma: string;
+    readonly expected: number | string;
+    readonly actual: unknown;
+    constructor(pragma: string, expected: number | string, actual: unknown);
+}
+/** Apply every pragma, then prove each one by reading it back. */
+export declare function applyPragmas(db: DatabaseSync, spec: PragmaSpec): Record<string, number | string>;
+/** Read the named pragmas back and compare against the spec. */
+export declare function readPragmas(db: DatabaseSync, spec: PragmaSpec): Record<string, number | string>;
+//# sourceMappingURL=pragmas.d.ts.map

package/dist/store/pragmas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pragmas.d.ts","sourceRoot":"","sources":["../../src/store/pragmas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAC1C;AAED,eAAO,MAAM,uBAAuB,EAAE,UAWpC,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,UAIvC,CAAC;AAaH,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAH1B,YACW,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,MAAM,EAAE,OAAO,EAIzB;CACF;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAMhG;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAgB/F"}

package/dist/store/pragmas.js

@@ -0,0 +1,65 @@
+export const MAIN_CONNECTION_PRAGMAS = Object.freeze({
+    journal_mode: "wal",
+    synchronous: 1,
+    wal_autocheckpoint: 4000,
+    checkpoint_fullfsync: 1,
+    fullfsync: 0,
+    journal_size_limit: 67108864,
+    busy_timeout: 5000,
+    temp_store: 2,
+    page_size: 4096,
+    auto_vacuum: 0,
+});
+export const FLUSHER_CONNECTION_PRAGMAS = Object.freeze({
+    checkpoint_fullfsync: 1,
+    fullfsync: 0,
+    busy_timeout: 0,
+});
+/** Human spellings SQLite accepts on assignment for the symbolic pragmas. */
+const ASSIGNMENT_VALUE = {
+    journal_mode: { wal: "WAL" },
+    synchronous: { "1": "NORMAL" },
+    temp_store: { "2": "MEMORY" },
+    auto_vacuum: { "0": "NONE" },
+};
+/** `PRAGMA busy_timeout` reads back under the column name `timeout`. */
+const READBACK_COLUMN = { busy_timeout: "timeout" };
+export class PragmaReadbackError extends Error {
+    pragma;
+    expected;
+    actual;
+    constructor(pragma, expected, actual) {
+        super(`PRAGMA ${pragma} read back ${JSON.stringify(actual)}, expected ${expected}`);
+        this.pragma = pragma;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = "PragmaReadbackError";
+    }
+}
+/** Apply every pragma, then prove each one by reading it back. */
+export function applyPragmas(db, spec) {
+    for (const [name, value] of Object.entries(spec)) {
+        const spelled = ASSIGNMENT_VALUE[name]?.[String(value)] ?? String(value);
+        db.exec(`PRAGMA ${name}=${spelled}`);
+    }
+    return readPragmas(db, spec);
+}
+/** Read the named pragmas back and compare against the spec. */
+export function readPragmas(db, spec) {
+    const observed = {};
+    for (const [name, expected] of Object.entries(spec)) {
+        const row = db.prepare(`PRAGMA ${name}`).get();
+        const column = READBACK_COLUMN[name] ?? name;
+        const actual = row?.[column];
+        const normalized = typeof actual === "string"
+            ? actual.toLowerCase()
+            : typeof actual === "bigint"
+                ? Number(actual)
+                : actual;
+        if (normalized !== expected)
+            throw new PragmaReadbackError(name, expected, actual);
+        observed[name] = normalized;
+    }
+    return observed;
+}
+//# sourceMappingURL=pragmas.js.map

package/dist/store/pragmas.js.map

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

package/dist/store/project-router.d.ts

@@ -0,0 +1,325 @@
+import { type ControlProjectListingProblem, type Thread, type ThreadTurn } from "@claudexor/schema";
+import type { CreateThreadInput, CreateTurnInput, UpdateThreadInput } from "../threads.js";
+import { type PartitionGeneration } from "./partitions.js";
+import { SqlProjectStore } from "./projects.js";
+import { SqlThreadStore } from "./threads.js";
+/** SQL routing returns one generation, never an array of recovered stores.
+ * Command/interaction/decision owners use these same addressed routes. */
+export declare class SqlProjectRouter {
+    readonly projects: SqlProjectStore;
+    constructor(projects: SqlProjectStore);
+    get store(): import("./store.js").EngineStore;
+    threadStore(generation: Pick<PartitionGeneration, "pid" | "name" | "epoch">): SqlThreadStore;
+    private globalThreads;
+    generationForThread(id: string): PartitionGeneration | null;
+    generationForTurn(id: string): PartitionGeneration | null;
+    generationForCommand(id: string): PartitionGeneration | null;
+    private entityGeneration;
+    generationForRequest(params: unknown): PartitionGeneration;
+    registerProject(input: Parameters<SqlProjectStore["register"]>[0]): import("../projects.js").ProjectRegistration;
+    relinkProject(id: string, root: string): {
+        schema_version: 2;
+        id: string;
+        root: string;
+        created_at: string;
+        updated_at: string;
+    };
+    removeProject(id: string, activeRunRoots: ReadonlySet<string>): {
+        projectId: string;
+        root: string;
+        registryRemoved: true;
+        journalPartitionArchived: boolean;
+        archivedPartitionPath: string | null;
+        artifactsRetained: true;
+        activeRunCheck: "snapshot";
+    };
+    findThreadCreation(input: CreateThreadInput & {
+        ephemeral?: boolean;
+    }): Thread | null;
+    createThread(input: CreateThreadInput & {
+        ephemeral?: boolean;
+    }): Thread;
+    listThreadsResilient(): {
+        threads: Thread[];
+        problems: ControlProjectListingProblem[];
+    };
+    listThreads(): Thread[];
+    listPurgedThreads(): Thread[];
+    getThread(id: string): Thread | undefined;
+    getTurn(id: string): ThreadTurn | undefined;
+    turnsFor(id: string): ThreadTurn[];
+    sessionsForThread(id: string): {
+        id: string;
+        thread_id: string;
+        harness_id: string;
+        native_session_id: string | null;
+        resume_kind: "none" | "resume_by_id";
+        profile_id: string | null;
+        last_observed_model: string | null;
+        state: "live" | "rebound" | "stale";
+        created_at: string;
+        updated_at: string;
+    }[];
+    createTurn(id: string, prompt: string, input?: CreateTurnInput): {
+        id: string;
+        thread_id: string;
+        run_id: string | null;
+        parent_run_id: string | null;
+        answers_plan_run_id: string | null;
+        plan_run_id: string | null;
+        plan_hash: string | null;
+        plan_readiness_overridden: boolean;
+        kind: "decision" | "followup" | "initial";
+        prompt: string;
+        attachments: {
+            resource_id: string;
+            kind: "file" | "image";
+            mime: string;
+            name: string;
+            sha256: string;
+            size_bytes: number;
+            path: string;
+        }[];
+        enqueue_error: {
+            message: string;
+            code: string | null;
+            retryable: boolean;
+            required_actions: string[];
+            context: Record<string, unknown>;
+            failed_at: string;
+        } | null;
+        continuity: {
+            kind: "fresh" | "native_resume" | "packet";
+            packet_turns: number;
+            summarized: boolean;
+            lane_switched_from: {
+                harness_id: string;
+                profile_id: string | null;
+            } | null;
+        } | null;
+        created_at: string;
+    };
+    findTurnByIdempotency(id: string, input: NonNullable<CreateTurnInput["idempotency"]>): {
+        id: string;
+        thread_id: string;
+        run_id: string | null;
+        parent_run_id: string | null;
+        answers_plan_run_id: string | null;
+        plan_run_id: string | null;
+        plan_hash: string | null;
+        plan_readiness_overridden: boolean;
+        kind: "decision" | "followup" | "initial";
+        prompt: string;
+        attachments: {
+            resource_id: string;
+            kind: "file" | "image";
+            mime: string;
+            name: string;
+            sha256: string;
+            size_bytes: number;
+            path: string;
+        }[];
+        enqueue_error: {
+            message: string;
+            code: string | null;
+            retryable: boolean;
+            required_actions: string[];
+            context: Record<string, unknown>;
+            failed_at: string;
+        } | null;
+        continuity: {
+            kind: "fresh" | "native_resume" | "packet";
+            packet_turns: number;
+            summarized: boolean;
+            lane_switched_from: {
+                harness_id: string;
+                profile_id: string | null;
+            } | null;
+        } | null;
+        created_at: string;
+    } | undefined;
+    updateThread(id: string, patch: UpdateThreadInput): {
+        schema_version: 2;
+        id: string;
+        created_at: string;
+        updated_at: string;
+        repo: {
+            root: string;
+            base_ref: string;
+        } | null;
+        title: string | null;
+        folder: string | null;
+        mode: "agent" | "ask" | "plan";
+        auth_preference: "api_key" | "auto" | "subscription";
+        access: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null;
+        credential_profile_id: string | null;
+        primary_harness: string | null;
+        eligible_harnesses: string[];
+        workspace: {
+            mode: "delegated" | "in_place" | "isolated";
+            worktree_path: string | null;
+            base_sha: string | null;
+            delivered_through_run_id: string | null;
+            workspace_root: string | null;
+        };
+        run_ids: string[];
+        head_run_id: string | null;
+        state: "active" | "closed" | "purged" | "trashed";
+        trashed_at: string | null;
+        purge_after: string | null;
+        pre_trash_state: "active" | "closed" | null;
+    };
+    trashThread(id: string): {
+        schema_version: 2;
+        id: string;
+        created_at: string;
+        updated_at: string;
+        repo: {
+            root: string;
+            base_ref: string;
+        } | null;
+        title: string | null;
+        folder: string | null;
+        mode: "agent" | "ask" | "plan";
+        auth_preference: "api_key" | "auto" | "subscription";
+        access: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null;
+        credential_profile_id: string | null;
+        primary_harness: string | null;
+        eligible_harnesses: string[];
+        workspace: {
+            mode: "delegated" | "in_place" | "isolated";
+            worktree_path: string | null;
+            base_sha: string | null;
+            delivered_through_run_id: string | null;
+            workspace_root: string | null;
+        };
+        run_ids: string[];
+        head_run_id: string | null;
+        state: "active" | "closed" | "purged" | "trashed";
+        trashed_at: string | null;
+        purge_after: string | null;
+        pre_trash_state: "active" | "closed" | null;
+    };
+    restoreThread(id: string): {
+        schema_version: 2;
+        id: string;
+        created_at: string;
+        updated_at: string;
+        repo: {
+            root: string;
+            base_ref: string;
+        } | null;
+        title: string | null;
+        folder: string | null;
+        mode: "agent" | "ask" | "plan";
+        auth_preference: "api_key" | "auto" | "subscription";
+        access: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null;
+        credential_profile_id: string | null;
+        primary_harness: string | null;
+        eligible_harnesses: string[];
+        workspace: {
+            mode: "delegated" | "in_place" | "isolated";
+            worktree_path: string | null;
+            base_sha: string | null;
+            delivered_through_run_id: string | null;
+            workspace_root: string | null;
+        };
+        run_ids: string[];
+        head_run_id: string | null;
+        state: "active" | "closed" | "purged" | "trashed";
+        trashed_at: string | null;
+        purge_after: string | null;
+        pre_trash_state: "active" | "closed" | null;
+    };
+    purgeThread(id: string): {
+        schema_version: 2;
+        id: string;
+        created_at: string;
+        updated_at: string;
+        repo: {
+            root: string;
+            base_ref: string;
+        } | null;
+        title: string | null;
+        folder: string | null;
+        mode: "agent" | "ask" | "plan";
+        auth_preference: "api_key" | "auto" | "subscription";
+        access: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null;
+        credential_profile_id: string | null;
+        primary_harness: string | null;
+        eligible_harnesses: string[];
+        workspace: {
+            mode: "delegated" | "in_place" | "isolated";
+            worktree_path: string | null;
+            base_sha: string | null;
+            delivered_through_run_id: string | null;
+            workspace_root: string | null;
+        };
+        run_ids: string[];
+        head_run_id: string | null;
+        state: "active" | "closed" | "purged" | "trashed";
+        trashed_at: string | null;
+        purge_after: string | null;
+        pre_trash_state: "active" | "closed" | null;
+    };
+    setThreadWorktree(id: string, path: string, base: string, through?: string): void;
+    assertKnownIds(threadId: unknown, turnId: unknown): {
+        threadId?: string;
+        turnId?: string;
+    };
+    bindTurnRun(id: string, runId: string): void;
+    setTurnEnqueueError(id: string, problem: Parameters<SqlThreadStore["setTurnEnqueueError"]>[1]): void;
+    resumeMap(id: string, profileId?: string | null): Record<string, {
+        sessionId: string;
+        profileId: string | null;
+    }>;
+    resumeMapAuto(id: string): Record<string, {
+        sessionId: string;
+        profileId: string | null;
+    }>;
+    accountBindings(id: string): Record<string, string>;
+    recordSession(id: string, harnessId: string, nativeId: string, observed?: string | null, profileId?: string | null): void;
+    recordLaneCheckpoint(id: string, harnessId: string, profileId: string | null, turnId: string): void;
+    laneCheckpoint(id: string, harnessId: string, profileId: string | null): string | null;
+    laneCheckpointsForThread(id: string): {
+        id: string;
+        thread_id: string;
+        harness_id: string;
+        profile_id: string | null;
+        turn_id: string;
+        updated_at: string;
+    }[];
+    setTurnContinuity(id: string, disclosure: Parameters<SqlThreadStore["setTurnContinuity"]>[1]): void;
+    pingThreadHead(id: string): void;
+    migrateNullProfileContinuity(harnessId: string, rowId: string): {
+        sessions: number;
+        checkpoints: number;
+        skippedPartitions: string[];
+    };
+    rollbackProfileContinuity(harnessId: string, rowId: string): {
+        sessions: number;
+        checkpoints: number;
+        skippedPartitions: string[];
+    };
+    private continuity;
+    private unreadyProjects;
+    assertCredentialProfileInvalidationReady(): void;
+    invalidateCredentialProfile(harnessId: string, profileId: string): {
+        clearedThreads: number;
+        invalidatedSessions: number;
+    };
+    healthyProjectRoots(): string[];
+    quarantineGhostProjects(): {
+        projectId: string;
+        root: string;
+        reason: string;
+    }[];
+    /** Startup-only query joins the selected turn to its command, without
+     * loading accepted request bodies or every command's retained history. */
+    recoverRunlessTurns(): number;
+    private forThread;
+    private forTurn;
+    private requireThread;
+    private requireTurn;
+}
+//# sourceMappingURL=project-router.d.ts.map

package/dist/store/project-router.d.ts.map

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