apex-code 0.0.1-alpha.1 → 0.0.1-alpha.2

package/dist/core/durable-state/daemon.js

@@ -0,0 +1,62 @@
+import { readGitProvenance } from "./provenance.js";
+import { openDurableStateStore, } from "./sqlite.js";
+/**
+ * Local daemon state coordinator. All session mutations are admitted through a
+ * durable lease and journaled before the caller receives its operation callback.
+ */
+export class DurableStateDaemon {
+    recoveryDiagnostics;
+    provenance;
+    #store;
+    #attachments = new Map();
+    constructor(options) {
+        this.#store = openDurableStateStore(options.databasePath);
+        this.provenance = readGitProvenance(options.cwd ?? process.cwd());
+        this.recoveryDiagnostics = this.#store.recoverUnfinishedCommandsWithDiagnostics(`daemon ${options.daemonId} started before command completion`);
+    }
+    attach(input) {
+        const lease = this.#store.acquireLease({
+            sessionId: input.sessionId,
+            ownerId: input.clientId,
+            mode: input.mode,
+            ttlMs: input.ttlMs,
+        });
+        const clients = this.#attachments.get(input.sessionId) ?? new Map();
+        clients.set(input.clientId, lease);
+        this.#attachments.set(input.sessionId, clients);
+        return lease;
+    }
+    detach(sessionId, clientId) {
+        this.#store.releaseLease(sessionId, clientId);
+        const clients = this.#attachments.get(sessionId);
+        if (!clients)
+            return;
+        clients.delete(clientId);
+        if (clients.size === 0)
+            this.#attachments.delete(sessionId);
+    }
+    beginMutation(input) {
+        this.#requireExclusiveAttachment(input.sessionId, input.clientId);
+        return this.#store.beginCommand({ id: input.id, sessionId: input.sessionId, command: input.command });
+    }
+    async runMutation(input, operation) {
+        this.#requireExclusiveAttachment(input.sessionId, input.clientId);
+        return this.#store.runCommand({ id: input.id, sessionId: input.sessionId, command: input.command }, operation);
+    }
+    getCommand(id) {
+        return this.#store.getCommand(id);
+    }
+    getCommandCount() {
+        return this.#store.commandCount();
+    }
+    dispose() {
+        this.#store.close();
+    }
+    #requireExclusiveAttachment(sessionId, clientId) {
+        const attachment = this.#attachments.get(sessionId)?.get(clientId);
+        if (!attachment || attachment.mode !== "exclusive" || Date.parse(attachment.expiresAt) <= Date.now()) {
+            throw new Error(`Client does not hold an active exclusive lease for ${sessionId}`);
+        }
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/core/durable-state/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../../src/core/durable-state/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAGN,qBAAqB,GAIrB,MAAM,aAAa,CAAC;AAoBrB;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,mBAAmB,CAAgC;IACnD,UAAU,CAAgB;IAC1B,MAAM,CAAoB;IAC1B,YAAY,GAAG,IAAI,GAAG,EAA2C,CAAC;IAE3E,YAAY,OAAkC,EAAE;QAC/C,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC,wCAAwC,CAC9E,UAAU,OAAO,CAAC,QAAQ,oCAAoC,CAC9D,CAAC;IAAA,CACF;IAED,MAAM,CAAC,KAAwB,EAAsB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YACtC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,QAAQ;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAA8B,CAAC;QAChG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IAAA,CACb;IAED,MAAM,CAAC,SAAiB,EAAE,QAAgB,EAAQ;QACjD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAAA,CAC5D;IAED,aAAa,CAAC,KAAoB,EAAwB;QACzD,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAAA,CACtG;IAED,KAAK,CAAC,WAAW,CAAI,KAAoB,EAAE,SAA2B,EAAc;QACnF,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAAA,CAC/G;IAED,UAAU,CAAC,EAAU,EAAoC;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAAA,CAClC;IACD,eAAe,GAAW;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IAAA,CAClC;IACD,OAAO,GAAS;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAAA,CACpB;IAED,2BAA2B,CAAC,SAAiB,EAAE,QAAgB,EAAQ;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACtG,MAAM,IAAI,KAAK,CAAC,sDAAsD,SAAS,EAAE,CAAC,CAAC;QACpF,CAAC;IAAA,CACD;CACD","sourcesContent":["import { type GitProvenance, readGitProvenance } from \"./provenance.ts\";\nimport {\n\ttype CommandJournalRecord,\n\ttype DurableStateStore,\n\topenDurableStateStore,\n\ttype RecoveryDiagnostic,\n\ttype SessionLeaseMode,\n\ttype SessionLeaseRecord,\n} from \"./sqlite.ts\";\n\nexport interface DurableStateDaemonOptions {\n\tdatabasePath: string;\n\tdaemonId: string;\n\tcwd?: string;\n}\nexport interface AttachClientInput {\n\tsessionId: string;\n\tclientId: string;\n\tmode: SessionLeaseMode;\n\tttlMs: number;\n}\nexport interface MutationInput {\n\tid?: string;\n\tsessionId: string;\n\tclientId: string;\n\tcommand: string;\n}\n\n/**\n * Local daemon state coordinator. All session mutations are admitted through a\n * durable lease and journaled before the caller receives its operation callback.\n */\nexport class DurableStateDaemon {\n\treadonly recoveryDiagnostics: readonly RecoveryDiagnostic[];\n\treadonly provenance: GitProvenance;\n\treadonly #store: DurableStateStore;\n\treadonly #attachments = new Map<string, Map<string, SessionLeaseRecord>>();\n\n\tconstructor(options: DurableStateDaemonOptions) {\n\t\tthis.#store = openDurableStateStore(options.databasePath);\n\t\tthis.provenance = readGitProvenance(options.cwd ?? process.cwd());\n\t\tthis.recoveryDiagnostics = this.#store.recoverUnfinishedCommandsWithDiagnostics(\n\t\t\t`daemon ${options.daemonId} started before command completion`,\n\t\t);\n\t}\n\n\tattach(input: AttachClientInput): SessionLeaseRecord {\n\t\tconst lease = this.#store.acquireLease({\n\t\t\tsessionId: input.sessionId,\n\t\t\townerId: input.clientId,\n\t\t\tmode: input.mode,\n\t\t\tttlMs: input.ttlMs,\n\t\t});\n\t\tconst clients = this.#attachments.get(input.sessionId) ?? new Map<string, SessionLeaseRecord>();\n\t\tclients.set(input.clientId, lease);\n\t\tthis.#attachments.set(input.sessionId, clients);\n\t\treturn lease;\n\t}\n\n\tdetach(sessionId: string, clientId: string): void {\n\t\tthis.#store.releaseLease(sessionId, clientId);\n\t\tconst clients = this.#attachments.get(sessionId);\n\t\tif (!clients) return;\n\t\tclients.delete(clientId);\n\t\tif (clients.size === 0) this.#attachments.delete(sessionId);\n\t}\n\n\tbeginMutation(input: MutationInput): CommandJournalRecord {\n\t\tthis.#requireExclusiveAttachment(input.sessionId, input.clientId);\n\t\treturn this.#store.beginCommand({ id: input.id, sessionId: input.sessionId, command: input.command });\n\t}\n\n\tasync runMutation<T>(input: MutationInput, operation: () => Promise<T>): Promise<T> {\n\t\tthis.#requireExclusiveAttachment(input.sessionId, input.clientId);\n\t\treturn this.#store.runCommand({ id: input.id, sessionId: input.sessionId, command: input.command }, operation);\n\t}\n\n\tgetCommand(id: string): CommandJournalRecord | undefined {\n\t\treturn this.#store.getCommand(id);\n\t}\n\tgetCommandCount(): number {\n\t\treturn this.#store.commandCount();\n\t}\n\tdispose(): void {\n\t\tthis.#store.close();\n\t}\n\n\t#requireExclusiveAttachment(sessionId: string, clientId: string): void {\n\t\tconst attachment = this.#attachments.get(sessionId)?.get(clientId);\n\t\tif (!attachment || attachment.mode !== \"exclusive\" || Date.parse(attachment.expiresAt) <= Date.now()) {\n\t\t\tthrow new Error(`Client does not hold an active exclusive lease for ${sessionId}`);\n\t\t}\n\t}\n}\n"]}

package/dist/core/durable-state/provenance.d.ts

@@ -0,0 +1,7 @@
+export interface GitProvenance {
+    repositoryRoot?: string;
+    revision?: string;
+    dirty?: boolean;
+}
+export declare function readGitProvenance(cwd: string): GitProvenance;
+//# sourceMappingURL=provenance.d.ts.map

package/dist/core/durable-state/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../../src/core/durable-state/provenance.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAoB5D","sourcesContent":["import { spawnProcessSync } from \"../../utils/child-process.ts\";\n\nexport interface GitProvenance {\n\trepositoryRoot?: string;\n\trevision?: string;\n\tdirty?: boolean;\n}\n\nexport function readGitProvenance(cwd: string): GitProvenance {\n\tconst root = spawnProcessSync(\"git\", [\"-C\", cwd, \"rev-parse\", \"--show-toplevel\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\tif (root.status !== 0 || !root.stdout.trim()) return {};\n\tconst repositoryRoot = root.stdout.trim();\n\tconst revision = spawnProcessSync(\"git\", [\"-C\", repositoryRoot, \"rev-parse\", \"HEAD\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\tconst dirty = spawnProcessSync(\"git\", [\"-C\", repositoryRoot, \"status\", \"--porcelain\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\treturn {\n\t\trepositoryRoot,\n\t\t...(revision.status === 0 && revision.stdout.trim() ? { revision: revision.stdout.trim() } : {}),\n\t\t...(dirty.status === 0 ? { dirty: Boolean(dirty.stdout.trim()) } : {}),\n\t};\n}\n"]}

package/dist/core/durable-state/provenance.js

@@ -0,0 +1,24 @@
+import { spawnProcessSync } from "../../utils/child-process.js";
+export function readGitProvenance(cwd) {
+    const root = spawnProcessSync("git", ["-C", cwd, "rev-parse", "--show-toplevel"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    if (root.status !== 0 || !root.stdout.trim())
+        return {};
+    const repositoryRoot = root.stdout.trim();
+    const revision = spawnProcessSync("git", ["-C", repositoryRoot, "rev-parse", "HEAD"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    const dirty = spawnProcessSync("git", ["-C", repositoryRoot, "status", "--porcelain"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+    });
+    return {
+        repositoryRoot,
+        ...(revision.status === 0 && revision.stdout.trim() ? { revision: revision.stdout.trim() } : {}),
+        ...(dirty.status === 0 ? { dirty: Boolean(dirty.stdout.trim()) } : {}),
+    };
+}
+//# sourceMappingURL=provenance.js.map

package/dist/core/durable-state/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../../src/core/durable-state/provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAQhE,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAiB;IAC7D,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE;QACjF,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;KACnC,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;QACrF,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;KACnC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE;QACtF,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;KACnC,CAAC,CAAC;IACH,OAAO;QACN,cAAc;QACd,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;AAAA,CACF","sourcesContent":["import { spawnProcessSync } from \"../../utils/child-process.ts\";\n\nexport interface GitProvenance {\n\trepositoryRoot?: string;\n\trevision?: string;\n\tdirty?: boolean;\n}\n\nexport function readGitProvenance(cwd: string): GitProvenance {\n\tconst root = spawnProcessSync(\"git\", [\"-C\", cwd, \"rev-parse\", \"--show-toplevel\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\tif (root.status !== 0 || !root.stdout.trim()) return {};\n\tconst repositoryRoot = root.stdout.trim();\n\tconst revision = spawnProcessSync(\"git\", [\"-C\", repositoryRoot, \"rev-parse\", \"HEAD\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\tconst dirty = spawnProcessSync(\"git\", [\"-C\", repositoryRoot, \"status\", \"--porcelain\"], {\n\t\tencoding: \"utf8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t});\n\treturn {\n\t\trepositoryRoot,\n\t\t...(revision.status === 0 && revision.stdout.trim() ? { revision: revision.stdout.trim() } : {}),\n\t\t...(dirty.status === 0 ? { dirty: Boolean(dirty.stdout.trim()) } : {}),\n\t};\n}\n"]}

package/dist/core/durable-state/sqlite.d.ts

@@ -0,0 +1,84 @@
+/** Current schema for the daemon-owned durable-state sidecar. */
+export declare const CURRENT_DURABLE_STATE_SCHEMA_VERSION = 4;
+export type CommandJournalState = "created" | "running" | "completed" | "failed" | "interrupted";
+export type SessionLeaseMode = "shared" | "exclusive";
+export interface SessionLeaseRecord {
+    sessionId: string;
+    ownerId: string;
+    mode: SessionLeaseMode;
+    expiresAt: string;
+}
+export interface CommandJournalRecord {
+    id: string;
+    sessionId: string;
+    command: string;
+    state: CommandJournalState;
+    createdAt: string;
+    updatedAt: string;
+    recoveryReason?: string;
+}
+/**
+ * Plain, domain-independent row shape for `model_performance`. Deliberately not the
+ * richer `UsagePerformanceSample` (which carries a branded `CredentialIdentity` and a
+ * nested `usage` object) — this module owns SQLite schema and writes only, never
+ * `ModelRuntime`'s domain types, to avoid a circular import between the two.
+ */
+export interface UsagePerformanceRow {
+    provider: string;
+    modelId: string;
+    ttftMs: number | null;
+    generationMs: number | null;
+    sampledAt: string;
+    sessionId: string | null;
+    role: string | null;
+    credentialIdentity: string | null;
+    outcome: string | null;
+    failureKind: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheWriteTokens: number | null;
+    cost: number | null;
+}
+export interface RecoveryDiagnostic {
+    commandId: string;
+    sessionId: string;
+    previousState: "created" | "running";
+    state: "interrupted";
+    reason: string;
+    recoveredAt: string;
+}
+export interface DurableStateStore {
+    schemaVersion(): number;
+    tableNames(): string[];
+    columns(tableName: string): string[];
+    beginCommand(input: {
+        id?: string;
+        sessionId: string;
+        command: string;
+    }): CommandJournalRecord;
+    runCommand<T>(input: {
+        id?: string;
+        sessionId: string;
+        command: string;
+    }, operation: () => Promise<T>): Promise<T>;
+    transitionCommand(id: string, state: Exclude<CommandJournalState, "created">, reason?: string): CommandJournalRecord;
+    getCommand(id: string): CommandJournalRecord | undefined;
+    commandCount(): number;
+    recoverUnfinishedCommands(reason?: string): CommandJournalRecord[];
+    recoverUnfinishedCommandsWithDiagnostics(reason?: string): RecoveryDiagnostic[];
+    acquireLease(input: {
+        sessionId: string;
+        ownerId: string;
+        mode: SessionLeaseMode;
+        ttlMs: number;
+    }): SessionLeaseRecord;
+    releaseLease(sessionId: string, ownerId: string): void;
+    getLease(sessionId: string): SessionLeaseRecord | undefined;
+    recordUsagePerformance(row: UsagePerformanceRow): void;
+    listUsagePerformance(): UsagePerformanceRow[];
+    pruneUsagePerformance(olderThanIso: string): number;
+    close(): void;
+}
+export declare function openDurableStateStore(path: string): DurableStateStore;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/core/durable-state/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/core/durable-state/sqlite.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { DatabaseSync } from \"node:sqlite\";\n\n/** Current schema for the daemon-owned durable-state sidecar. */\nexport const CURRENT_DURABLE_STATE_SCHEMA_VERSION = 4;\n\nexport type CommandJournalState = \"created\" | \"running\" | \"completed\" | \"failed\" | \"interrupted\";\n\nexport type SessionLeaseMode = \"shared\" | \"exclusive\";\nexport interface SessionLeaseRecord {\n\tsessionId: string;\n\townerId: string;\n\tmode: SessionLeaseMode;\n\texpiresAt: string;\n}\n\nexport interface CommandJournalRecord {\n\tid: string;\n\tsessionId: string;\n\tcommand: string;\n\tstate: CommandJournalState;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\trecoveryReason?: string;\n}\n\nconst COMMAND_TRANSITIONS: Record<CommandJournalState, readonly CommandJournalState[]> = {\n\tcreated: [\"running\", \"failed\", \"interrupted\"],\n\trunning: [\"completed\", \"failed\", \"interrupted\"],\n\tcompleted: [],\n\tfailed: [],\n\tinterrupted: [],\n};\n\nconst TABLES = [\n\t\"cache_entries\",\n\t\"command_journal\",\n\t\"daemon_metadata\",\n\t\"model_performance\",\n\t\"schema_migrations\",\n\t\"session_leases\",\n] as const;\n\n/** Columns added to `model_performance` in schema version 4 (roadmap Phase 8). */\nconst MODEL_PERFORMANCE_V4_COLUMNS: ReadonlyArray<readonly [string, string]> = [\n\t[\"session_id\", \"TEXT\"],\n\t[\"role\", \"TEXT\"],\n\t[\"credential_identity\", \"TEXT\"],\n\t[\"outcome\", \"TEXT\"],\n\t[\"failure_kind\", \"TEXT\"],\n\t[\"input_tokens\", \"INTEGER\"],\n\t[\"output_tokens\", \"INTEGER\"],\n\t[\"cache_read_tokens\", \"INTEGER\"],\n\t[\"cache_write_tokens\", \"INTEGER\"],\n\t[\"cost\", \"REAL\"],\n];\n\n/**\n * Plain, domain-independent row shape for `model_performance`. Deliberately not the\n * richer `UsagePerformanceSample` (which carries a branded `CredentialIdentity` and a\n * nested `usage` object) — this module owns SQLite schema and writes only, never\n * `ModelRuntime`'s domain types, to avoid a circular import between the two.\n */\nexport interface UsagePerformanceRow {\n\tprovider: string;\n\tmodelId: string;\n\tttftMs: number | null;\n\tgenerationMs: number | null;\n\tsampledAt: string;\n\tsessionId: string | null;\n\trole: string | null;\n\tcredentialIdentity: string | null;\n\toutcome: string | null;\n\tfailureKind: string | null;\n\tinputTokens: number | null;\n\toutputTokens: number | null;\n\tcacheReadTokens: number | null;\n\tcacheWriteTokens: number | null;\n\tcost: number | null;\n}\n\nexport interface RecoveryDiagnostic {\n\tcommandId: string;\n\tsessionId: string;\n\tpreviousState: \"created\" | \"running\";\n\tstate: \"interrupted\";\n\treason: string;\n\trecoveredAt: string;\n}\n\nexport interface DurableStateStore {\n\tschemaVersion(): number;\n\ttableNames(): string[];\n\tcolumns(tableName: string): string[];\n\tbeginCommand(input: { id?: string; sessionId: string; command: string }): CommandJournalRecord;\n\trunCommand<T>(input: { id?: string; sessionId: string; command: string }, operation: () => Promise<T>): Promise<T>;\n\ttransitionCommand(id: string, state: Exclude<CommandJournalState, \"created\">, reason?: string): CommandJournalRecord;\n\tgetCommand(id: string): CommandJournalRecord | undefined;\n\tcommandCount(): number;\n\trecoverUnfinishedCommands(reason?: string): CommandJournalRecord[];\n\trecoverUnfinishedCommandsWithDiagnostics(reason?: string): RecoveryDiagnostic[];\n\tacquireLease(input: {\n\t\tsessionId: string;\n\t\townerId: string;\n\t\tmode: SessionLeaseMode;\n\t\tttlMs: number;\n\t}): SessionLeaseRecord;\n\treleaseLease(sessionId: string, ownerId: string): void;\n\tgetLease(sessionId: string): SessionLeaseRecord | undefined;\n\trecordUsagePerformance(row: UsagePerformanceRow): void;\n\tlistUsagePerformance(): UsagePerformanceRow[];\n\tpruneUsagePerformance(olderThanIso: string): number;\n\tclose(): void;\n}\n\nfunction readSchemaVersion(database: DatabaseSync): number {\n\tconst row = database.prepare(\"SELECT COALESCE(MAX(version), 0) AS version FROM schema_migrations\").get() as\n\t\t| { version: number }\n\t\t| undefined;\n\treturn row?.version ?? 0;\n}\n\nfunction createSchema(database: DatabaseSync): void {\n\tdatabase.exec(`\n\t\tCREATE TABLE IF NOT EXISTS schema_migrations (\n\t\t\tversion INTEGER PRIMARY KEY,\n\t\t\tapplied_at TEXT NOT NULL\n\t\t);\n\t\tCREATE TABLE IF NOT EXISTS daemon_metadata (\n\t\t\tkey TEXT PRIMARY KEY,\n\t\t\tvalue TEXT NOT NULL\n\t\t);\n\t\tCREATE TABLE IF NOT EXISTS command_journal (\n\t\t\tid TEXT PRIMARY KEY,\n\t\t\tsession_id TEXT NOT NULL,\n\t\t\tcommand TEXT NOT NULL,\n\t\t\tstate TEXT NOT NULL,\n\t\t\trecovery_reason TEXT,\n\t\t\tcreated_at TEXT NOT NULL,\n\t\t\tupdated_at TEXT NOT NULL\n\t\t);\n\t\tCREATE TABLE IF NOT EXISTS session_leases (\n\t\t\tsession_id TEXT NOT NULL,\n\t\t\towner_id TEXT NOT NULL,\n\t\t\tmode TEXT NOT NULL,\n\t\t\texpires_at TEXT NOT NULL,\n\t\t\tPRIMARY KEY (session_id, owner_id)\n\t\t);\n\t\tCREATE TABLE IF NOT EXISTS model_performance (\n\t\t\tid INTEGER PRIMARY KEY,\n\t\t\tprovider TEXT NOT NULL,\n\t\t\tmodel_id TEXT NOT NULL,\n\t\t\tttft_ms REAL,\n\t\t\tgeneration_ms REAL,\n\t\t\tsampled_at TEXT NOT NULL,\n\t\t\tsession_id TEXT,\n\t\t\trole TEXT,\n\t\t\tcredential_identity TEXT,\n\t\t\toutcome TEXT,\n\t\t\tfailure_kind TEXT,\n\t\t\tinput_tokens INTEGER,\n\t\t\toutput_tokens INTEGER,\n\t\t\tcache_read_tokens INTEGER,\n\t\t\tcache_write_tokens INTEGER,\n\t\t\tcost REAL\n\t\t);\n\t\tCREATE TABLE IF NOT EXISTS cache_entries (\n\t\t\tkey TEXT PRIMARY KEY,\n\t\t\tvalue BLOB NOT NULL,\n\t\t\texpires_at TEXT\n\t\t);\n\t`);\n}\n\nfunction readCommand(database: DatabaseSync, id: string): CommandJournalRecord | undefined {\n\tconst row = database\n\t\t.prepare(\n\t\t\t\"SELECT id, session_id, command, state, recovery_reason, created_at, updated_at FROM command_journal WHERE id = ?\",\n\t\t)\n\t\t.get(id) as\n\t\t| {\n\t\t\t\tid: string;\n\t\t\t\tsession_id: string;\n\t\t\t\tcommand: string;\n\t\t\t\tstate: CommandJournalState;\n\t\t\t\trecovery_reason: string | null;\n\t\t\t\tcreated_at: string;\n\t\t\t\tupdated_at: string;\n\t\t  }\n\t\t| undefined;\n\tif (!row) return undefined;\n\treturn {\n\t\tid: row.id,\n\t\tsessionId: row.session_id,\n\t\tcommand: row.command,\n\t\tstate: row.state,\n\t\tcreatedAt: row.created_at,\n\t\tupdatedAt: row.updated_at,\n\t\t...(row.recovery_reason ? { recoveryReason: row.recovery_reason } : {}),\n\t};\n}\n\nfunction readLeases(database: DatabaseSync, sessionId: string): SessionLeaseRecord[] {\n\tconst rows = database\n\t\t.prepare(\n\t\t\t\"SELECT session_id, owner_id, mode, expires_at FROM session_leases WHERE session_id = ? ORDER BY owner_id\",\n\t\t)\n\t\t.all(sessionId) as Array<{ session_id: string; owner_id: string; mode: SessionLeaseMode; expires_at: string }>;\n\treturn rows.map((row) => ({\n\t\tsessionId: row.session_id,\n\t\townerId: row.owner_id,\n\t\tmode: row.mode,\n\t\texpiresAt: row.expires_at,\n\t}));\n}\n\nfunction readLease(database: DatabaseSync, sessionId: string): SessionLeaseRecord | undefined {\n\treturn readLeases(database, sessionId)[0];\n}\n\nfunction transitionCommand(\n\tdatabase: DatabaseSync,\n\tid: string,\n\tstate: Exclude<CommandJournalState, \"created\">,\n\treason?: string,\n): CommandJournalRecord {\n\tconst current = readCommand(database, id);\n\tif (!current) throw new Error(`Unknown command journal entry: ${id}`);\n\tif (!COMMAND_TRANSITIONS[current.state].includes(state))\n\t\tthrow new Error(`Invalid command transition: ${current.state} -> ${state}`);\n\tconst now = new Date().toISOString();\n\tdatabase\n\t\t.prepare(\"UPDATE command_journal SET state = ?, recovery_reason = ?, updated_at = ? WHERE id = ?\")\n\t\t.run(state, reason ?? null, now, id);\n\treturn readCommand(database, id)!;\n}\n\nexport function openDurableStateStore(path: string): DurableStateStore {\n\tconst database = new DatabaseSync(path);\n\ttry {\n\t\tdatabase.exec(\"BEGIN IMMEDIATE\");\n\t\tcreateSchema(database);\n\t\tconst version = readSchemaVersion(database);\n\t\tif (version > CURRENT_DURABLE_STATE_SCHEMA_VERSION) {\n\t\t\tdatabase.exec(\"ROLLBACK\");\n\t\t\tthrow new Error(\n\t\t\t\t`Durable state database schema version ${version} is newer than this version (${CURRENT_DURABLE_STATE_SCHEMA_VERSION})`,\n\t\t\t);\n\t\t}\n\t\tif (version < 2) {\n\t\t\tconst commandColumns = database.prepare('PRAGMA table_info(\"command_journal\")').all() as Array<{\n\t\t\t\tname: string;\n\t\t\t}>;\n\t\t\tif (!commandColumns.some((column) => column.name === \"recovery_reason\"))\n\t\t\t\tdatabase.exec(\"ALTER TABLE command_journal ADD COLUMN recovery_reason TEXT\");\n\t\t}\n\t\tif (version < 3 && version > 0) {\n\t\t\tdatabase.exec(`\n\t\t\t\tALTER TABLE session_leases RENAME TO session_leases_v2;\n\t\t\t\tCREATE TABLE session_leases (\n\t\t\t\t\tsession_id TEXT NOT NULL,\n\t\t\t\t\towner_id TEXT NOT NULL,\n\t\t\t\t\tmode TEXT NOT NULL,\n\t\t\t\t\texpires_at TEXT NOT NULL,\n\t\t\t\t\tPRIMARY KEY (session_id, owner_id)\n\t\t\t\t);\n\t\t\t\tINSERT INTO session_leases (session_id, owner_id, mode, expires_at)\n\t\t\t\tSELECT session_id, owner_id, mode, expires_at FROM session_leases_v2;\n\t\t\t\tDROP TABLE session_leases_v2;\n\t\t\t`);\n\t\t}\n\t\tif (version < 4 && version > 0) {\n\t\t\tconst modelPerformanceColumns = database.prepare('PRAGMA table_info(\"model_performance\")').all() as Array<{\n\t\t\t\tname: string;\n\t\t\t}>;\n\t\t\tconst existingNames = new Set(modelPerformanceColumns.map((column) => column.name));\n\t\t\tfor (const [name, type] of MODEL_PERFORMANCE_V4_COLUMNS) {\n\t\t\t\tif (!existingNames.has(name)) database.exec(`ALTER TABLE model_performance ADD COLUMN ${name} ${type}`);\n\t\t\t}\n\t\t\tdatabase.exec(\"DROP TABLE IF EXISTS usage_totals\");\n\t\t}\n\t\tif (version < CURRENT_DURABLE_STATE_SCHEMA_VERSION) {\n\t\t\tdatabase\n\t\t\t\t.prepare(\"INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)\")\n\t\t\t\t.run(CURRENT_DURABLE_STATE_SCHEMA_VERSION, new Date().toISOString());\n\t\t}\n\t\tdatabase.exec(\"COMMIT\");\n\t} catch (error) {\n\t\ttry {\n\t\t\tdatabase.exec(\"ROLLBACK\");\n\t\t} catch {\n\t\t\t// Preserve the original migration error.\n\t\t}\n\t\tdatabase.close();\n\t\tthrow error;\n\t}\n\n\treturn {\n\t\tschemaVersion: () => readSchemaVersion(database),\n\t\ttableNames: () => {\n\t\t\tconst rows = database\n\t\t\t\t.prepare(\"SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name\")\n\t\t\t\t.all() as Array<{ name: string }>;\n\t\t\treturn rows.map((row) => row.name);\n\t\t},\n\t\tcolumns: (tableName) => {\n\t\t\tif (!TABLES.includes(tableName as (typeof TABLES)[number]))\n\t\t\t\tthrow new Error(`Unknown durable-state table: ${tableName}`);\n\t\t\tconst rows = database.prepare(`PRAGMA table_info(\"${tableName}\")`).all() as Array<{ name: string }>;\n\t\t\treturn rows.map((row) => row.name);\n\t\t},\n\t\tbeginCommand: ({ id = randomUUID(), sessionId, command }) => {\n\t\t\tconst now = new Date().toISOString();\n\t\t\tdatabase\n\t\t\t\t.prepare(\n\t\t\t\t\t\"INSERT INTO command_journal (id, session_id, command, state, created_at, updated_at) VALUES (?, ?, ?, 'created', ?, ?)\",\n\t\t\t\t)\n\t\t\t\t.run(id, sessionId, command, now, now);\n\t\t\treturn readCommand(database, id)!;\n\t\t},\n\t\trunCommand: async (input, operation) => {\n\t\t\tconst entry = (() => {\n\t\t\t\tconst id = input.id ?? randomUUID();\n\t\t\t\tconst now = new Date().toISOString();\n\t\t\t\tdatabase\n\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\"INSERT INTO command_journal (id, session_id, command, state, created_at, updated_at) VALUES (?, ?, ?, 'created', ?, ?)\",\n\t\t\t\t\t)\n\t\t\t\t\t.run(id, input.sessionId, input.command, now, now);\n\t\t\t\treturn readCommand(database, id)!;\n\t\t\t})();\n\t\t\ttransitionCommand(database, entry.id, \"running\");\n\t\t\ttry {\n\t\t\t\tconst result = await operation();\n\t\t\t\ttransitionCommand(database, entry.id, \"completed\");\n\t\t\t\treturn result;\n\t\t\t} catch (error) {\n\t\t\t\ttransitionCommand(database, entry.id, \"failed\");\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\ttransitionCommand: (id, state, reason) => {\n\t\t\tconst current = readCommand(database, id);\n\t\t\tif (!current) throw new Error(`Unknown command journal entry: ${id}`);\n\t\t\tif (!COMMAND_TRANSITIONS[current.state].includes(state))\n\t\t\t\tthrow new Error(`Invalid command transition: ${current.state} -> ${state}`);\n\t\t\tconst now = new Date().toISOString();\n\t\t\tdatabase\n\t\t\t\t.prepare(\"UPDATE command_journal SET state = ?, recovery_reason = ?, updated_at = ? WHERE id = ?\")\n\t\t\t\t.run(state, reason ?? null, now, id);\n\t\t\treturn readCommand(database, id)!;\n\t\t},\n\t\tgetCommand: (id) => readCommand(database, id),\n\t\tcommandCount: () =>\n\t\t\t(database.prepare(\"SELECT COUNT(*) AS count FROM command_journal\").get() as { count: number }).count,\n\t\trecoverUnfinishedCommands: (reason = \"daemon restarted before command completion\") => {\n\t\t\tconst rows = database\n\t\t\t\t.prepare(\"SELECT id FROM command_journal WHERE state IN ('created', 'running')\")\n\t\t\t\t.all() as Array<{ id: string }>;\n\t\t\treturn rows.map(({ id }) => {\n\t\t\t\tconst current = readCommand(database, id)!;\n\t\t\t\treturn current.state === \"interrupted\" ? current : transitionCommand(database, id, \"interrupted\", reason);\n\t\t\t});\n\t\t},\n\t\trecoverUnfinishedCommandsWithDiagnostics: (reason = \"daemon restarted before command completion\") => {\n\t\t\tconst recoveredAt = new Date().toISOString();\n\t\t\tconst rows = database\n\t\t\t\t.prepare(\"SELECT id, session_id, state FROM command_journal WHERE state IN ('created', 'running')\")\n\t\t\t\t.all() as Array<{ id: string; session_id: string; state: \"created\" | \"running\" }>;\n\t\t\treturn rows.map((row) => {\n\t\t\t\ttransitionCommand(database, row.id, \"interrupted\", reason);\n\t\t\t\treturn {\n\t\t\t\t\tcommandId: row.id,\n\t\t\t\t\tsessionId: row.session_id,\n\t\t\t\t\tpreviousState: row.state,\n\t\t\t\t\tstate: \"interrupted\" as const,\n\t\t\t\t\treason,\n\t\t\t\t\trecoveredAt,\n\t\t\t\t};\n\t\t\t});\n\t\t},\n\t\tacquireLease: ({ sessionId, ownerId, mode, ttlMs }) => {\n\t\t\tif (!Number.isFinite(ttlMs) || ttlMs <= 0) throw new Error(\"Lease TTL must be positive\");\n\t\t\tdatabase.exec(\"BEGIN IMMEDIATE\");\n\t\t\ttry {\n\t\t\t\tdatabase.prepare(\"DELETE FROM session_leases WHERE expires_at <= ?\").run(new Date().toISOString());\n\t\t\t\tconst active = readLeases(database, sessionId).filter((lease) => lease.ownerId !== ownerId);\n\t\t\t\tif (active.some((lease) => lease.mode === \"exclusive\") || (mode === \"exclusive\" && active.length > 0)) {\n\t\t\t\t\tthrow new Error(`Session lease is held for ${sessionId}`);\n\t\t\t\t}\n\t\t\t\tconst expiresAt = new Date(Date.now() + ttlMs).toISOString();\n\t\t\t\tdatabase\n\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\"INSERT INTO session_leases (session_id, owner_id, mode, expires_at) VALUES (?, ?, ?, ?) ON CONFLICT(session_id, owner_id) DO UPDATE SET mode=excluded.mode, expires_at=excluded.expires_at\",\n\t\t\t\t\t)\n\t\t\t\t\t.run(sessionId, ownerId, mode, expiresAt);\n\t\t\t\tdatabase.exec(\"COMMIT\");\n\t\t\t\treturn readLeases(database, sessionId).find((lease) => lease.ownerId === ownerId)!;\n\t\t\t} catch (error) {\n\t\t\t\tdatabase.exec(\"ROLLBACK\");\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\treleaseLease: (sessionId, ownerId) => {\n\t\t\tdatabase.prepare(\"DELETE FROM session_leases WHERE session_id = ? AND owner_id = ?\").run(sessionId, ownerId);\n\t\t},\n\t\tgetLease: (sessionId) => readLease(database, sessionId),\n\t\trecordUsagePerformance: (row) => {\n\t\t\tdatabase\n\t\t\t\t.prepare(\n\t\t\t\t\t`INSERT INTO model_performance (\n\t\t\t\t\t\tprovider, model_id, ttft_ms, generation_ms, sampled_at,\n\t\t\t\t\t\tsession_id, role, credential_identity, outcome, failure_kind,\n\t\t\t\t\t\tinput_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cost\n\t\t\t\t\t) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t\t)\n\t\t\t\t.run(\n\t\t\t\t\trow.provider,\n\t\t\t\t\trow.modelId,\n\t\t\t\t\trow.ttftMs,\n\t\t\t\t\trow.generationMs,\n\t\t\t\t\trow.sampledAt,\n\t\t\t\t\trow.sessionId,\n\t\t\t\t\trow.role,\n\t\t\t\t\trow.credentialIdentity,\n\t\t\t\t\trow.outcome,\n\t\t\t\t\trow.failureKind,\n\t\t\t\t\trow.inputTokens,\n\t\t\t\t\trow.outputTokens,\n\t\t\t\t\trow.cacheReadTokens,\n\t\t\t\t\trow.cacheWriteTokens,\n\t\t\t\t\trow.cost,\n\t\t\t\t);\n\t\t},\n\t\tlistUsagePerformance: () =>\n\t\t\t(\n\t\t\t\tdatabase\n\t\t\t\t\t.prepare(\n\t\t\t\t\t\t`SELECT provider, model_id, ttft_ms, generation_ms, sampled_at, session_id, role,\n\t\t\t\t\t\t\tcredential_identity, outcome, failure_kind, input_tokens, output_tokens,\n\t\t\t\t\t\t\tcache_read_tokens, cache_write_tokens, cost\n\t\t\t\t\t\tFROM model_performance ORDER BY id ASC`,\n\t\t\t\t\t)\n\t\t\t\t\t.all() as Array<{\n\t\t\t\t\tprovider: string;\n\t\t\t\t\tmodel_id: string;\n\t\t\t\t\tttft_ms: number | null;\n\t\t\t\t\tgeneration_ms: number | null;\n\t\t\t\t\tsampled_at: string;\n\t\t\t\t\tsession_id: string | null;\n\t\t\t\t\trole: string | null;\n\t\t\t\t\tcredential_identity: string | null;\n\t\t\t\t\toutcome: string | null;\n\t\t\t\t\tfailure_kind: string | null;\n\t\t\t\t\tinput_tokens: number | null;\n\t\t\t\t\toutput_tokens: number | null;\n\t\t\t\t\tcache_read_tokens: number | null;\n\t\t\t\t\tcache_write_tokens: number | null;\n\t\t\t\t\tcost: number | null;\n\t\t\t\t}>\n\t\t\t).map((row) => ({\n\t\t\t\tprovider: row.provider,\n\t\t\t\tmodelId: row.model_id,\n\t\t\t\tttftMs: row.ttft_ms,\n\t\t\t\tgenerationMs: row.generation_ms,\n\t\t\t\tsampledAt: row.sampled_at,\n\t\t\t\tsessionId: row.session_id,\n\t\t\t\trole: row.role,\n\t\t\t\tcredentialIdentity: row.credential_identity,\n\t\t\t\toutcome: row.outcome,\n\t\t\t\tfailureKind: row.failure_kind,\n\t\t\t\tinputTokens: row.input_tokens,\n\t\t\t\toutputTokens: row.output_tokens,\n\t\t\t\tcacheReadTokens: row.cache_read_tokens,\n\t\t\t\tcacheWriteTokens: row.cache_write_tokens,\n\t\t\t\tcost: row.cost,\n\t\t\t})),\n\t\tpruneUsagePerformance: (olderThanIso) => {\n\t\t\tconst result = database.prepare(\"DELETE FROM model_performance WHERE sampled_at < ?\").run(olderThanIso);\n\t\t\treturn Number(result.changes);\n\t\t},\n\t\tclose: () => database.close(),\n\t};\n}\n"]}

package/dist/core/durable-state/sqlite.js

@@ -0,0 +1,331 @@
+import { randomUUID } from "node:crypto";
+import { DatabaseSync } from "node:sqlite";
+/** Current schema for the daemon-owned durable-state sidecar. */
+export const CURRENT_DURABLE_STATE_SCHEMA_VERSION = 4;
+const COMMAND_TRANSITIONS = {
+    created: ["running", "failed", "interrupted"],
+    running: ["completed", "failed", "interrupted"],
+    completed: [],
+    failed: [],
+    interrupted: [],
+};
+const TABLES = [
+    "cache_entries",
+    "command_journal",
+    "daemon_metadata",
+    "model_performance",
+    "schema_migrations",
+    "session_leases",
+];
+/** Columns added to `model_performance` in schema version 4 (roadmap Phase 8). */
+const MODEL_PERFORMANCE_V4_COLUMNS = [
+    ["session_id", "TEXT"],
+    ["role", "TEXT"],
+    ["credential_identity", "TEXT"],
+    ["outcome", "TEXT"],
+    ["failure_kind", "TEXT"],
+    ["input_tokens", "INTEGER"],
+    ["output_tokens", "INTEGER"],
+    ["cache_read_tokens", "INTEGER"],
+    ["cache_write_tokens", "INTEGER"],
+    ["cost", "REAL"],
+];
+function readSchemaVersion(database) {
+    const row = database.prepare("SELECT COALESCE(MAX(version), 0) AS version FROM schema_migrations").get();
+    return row?.version ?? 0;
+}
+function createSchema(database) {
+    database.exec(`
+		CREATE TABLE IF NOT EXISTS schema_migrations (
+			version INTEGER PRIMARY KEY,
+			applied_at TEXT NOT NULL
+		);
+		CREATE TABLE IF NOT EXISTS daemon_metadata (
+			key TEXT PRIMARY KEY,
+			value TEXT NOT NULL
+		);
+		CREATE TABLE IF NOT EXISTS command_journal (
+			id TEXT PRIMARY KEY,
+			session_id TEXT NOT NULL,
+			command TEXT NOT NULL,
+			state TEXT NOT NULL,
+			recovery_reason TEXT,
+			created_at TEXT NOT NULL,
+			updated_at TEXT NOT NULL
+		);
+		CREATE TABLE IF NOT EXISTS session_leases (
+			session_id TEXT NOT NULL,
+			owner_id TEXT NOT NULL,
+			mode TEXT NOT NULL,
+			expires_at TEXT NOT NULL,
+			PRIMARY KEY (session_id, owner_id)
+		);
+		CREATE TABLE IF NOT EXISTS model_performance (
+			id INTEGER PRIMARY KEY,
+			provider TEXT NOT NULL,
+			model_id TEXT NOT NULL,
+			ttft_ms REAL,
+			generation_ms REAL,
+			sampled_at TEXT NOT NULL,
+			session_id TEXT,
+			role TEXT,
+			credential_identity TEXT,
+			outcome TEXT,
+			failure_kind TEXT,
+			input_tokens INTEGER,
+			output_tokens INTEGER,
+			cache_read_tokens INTEGER,
+			cache_write_tokens INTEGER,
+			cost REAL
+		);
+		CREATE TABLE IF NOT EXISTS cache_entries (
+			key TEXT PRIMARY KEY,
+			value BLOB NOT NULL,
+			expires_at TEXT
+		);
+	`);
+}
+function readCommand(database, id) {
+    const row = database
+        .prepare("SELECT id, session_id, command, state, recovery_reason, created_at, updated_at FROM command_journal WHERE id = ?")
+        .get(id);
+    if (!row)
+        return undefined;
+    return {
+        id: row.id,
+        sessionId: row.session_id,
+        command: row.command,
+        state: row.state,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        ...(row.recovery_reason ? { recoveryReason: row.recovery_reason } : {}),
+    };
+}
+function readLeases(database, sessionId) {
+    const rows = database
+        .prepare("SELECT session_id, owner_id, mode, expires_at FROM session_leases WHERE session_id = ? ORDER BY owner_id")
+        .all(sessionId);
+    return rows.map((row) => ({
+        sessionId: row.session_id,
+        ownerId: row.owner_id,
+        mode: row.mode,
+        expiresAt: row.expires_at,
+    }));
+}
+function readLease(database, sessionId) {
+    return readLeases(database, sessionId)[0];
+}
+function transitionCommand(database, id, state, reason) {
+    const current = readCommand(database, id);
+    if (!current)
+        throw new Error(`Unknown command journal entry: ${id}`);
+    if (!COMMAND_TRANSITIONS[current.state].includes(state))
+        throw new Error(`Invalid command transition: ${current.state} -> ${state}`);
+    const now = new Date().toISOString();
+    database
+        .prepare("UPDATE command_journal SET state = ?, recovery_reason = ?, updated_at = ? WHERE id = ?")
+        .run(state, reason ?? null, now, id);
+    return readCommand(database, id);
+}
+export function openDurableStateStore(path) {
+    const database = new DatabaseSync(path);
+    try {
+        database.exec("BEGIN IMMEDIATE");
+        createSchema(database);
+        const version = readSchemaVersion(database);
+        if (version > CURRENT_DURABLE_STATE_SCHEMA_VERSION) {
+            database.exec("ROLLBACK");
+            throw new Error(`Durable state database schema version ${version} is newer than this version (${CURRENT_DURABLE_STATE_SCHEMA_VERSION})`);
+        }
+        if (version < 2) {
+            const commandColumns = database.prepare('PRAGMA table_info("command_journal")').all();
+            if (!commandColumns.some((column) => column.name === "recovery_reason"))
+                database.exec("ALTER TABLE command_journal ADD COLUMN recovery_reason TEXT");
+        }
+        if (version < 3 && version > 0) {
+            database.exec(`
+				ALTER TABLE session_leases RENAME TO session_leases_v2;
+				CREATE TABLE session_leases (
+					session_id TEXT NOT NULL,
+					owner_id TEXT NOT NULL,
+					mode TEXT NOT NULL,
+					expires_at TEXT NOT NULL,
+					PRIMARY KEY (session_id, owner_id)
+				);
+				INSERT INTO session_leases (session_id, owner_id, mode, expires_at)
+				SELECT session_id, owner_id, mode, expires_at FROM session_leases_v2;
+				DROP TABLE session_leases_v2;
+			`);
+        }
+        if (version < 4 && version > 0) {
+            const modelPerformanceColumns = database.prepare('PRAGMA table_info("model_performance")').all();
+            const existingNames = new Set(modelPerformanceColumns.map((column) => column.name));
+            for (const [name, type] of MODEL_PERFORMANCE_V4_COLUMNS) {
+                if (!existingNames.has(name))
+                    database.exec(`ALTER TABLE model_performance ADD COLUMN ${name} ${type}`);
+            }
+            database.exec("DROP TABLE IF EXISTS usage_totals");
+        }
+        if (version < CURRENT_DURABLE_STATE_SCHEMA_VERSION) {
+            database
+                .prepare("INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)")
+                .run(CURRENT_DURABLE_STATE_SCHEMA_VERSION, new Date().toISOString());
+        }
+        database.exec("COMMIT");
+    }
+    catch (error) {
+        try {
+            database.exec("ROLLBACK");
+        }
+        catch {
+            // Preserve the original migration error.
+        }
+        database.close();
+        throw error;
+    }
+    return {
+        schemaVersion: () => readSchemaVersion(database),
+        tableNames: () => {
+            const rows = database
+                .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name")
+                .all();
+            return rows.map((row) => row.name);
+        },
+        columns: (tableName) => {
+            if (!TABLES.includes(tableName))
+                throw new Error(`Unknown durable-state table: ${tableName}`);
+            const rows = database.prepare(`PRAGMA table_info("${tableName}")`).all();
+            return rows.map((row) => row.name);
+        },
+        beginCommand: ({ id = randomUUID(), sessionId, command }) => {
+            const now = new Date().toISOString();
+            database
+                .prepare("INSERT INTO command_journal (id, session_id, command, state, created_at, updated_at) VALUES (?, ?, ?, 'created', ?, ?)")
+                .run(id, sessionId, command, now, now);
+            return readCommand(database, id);
+        },
+        runCommand: async (input, operation) => {
+            const entry = (() => {
+                const id = input.id ?? randomUUID();
+                const now = new Date().toISOString();
+                database
+                    .prepare("INSERT INTO command_journal (id, session_id, command, state, created_at, updated_at) VALUES (?, ?, ?, 'created', ?, ?)")
+                    .run(id, input.sessionId, input.command, now, now);
+                return readCommand(database, id);
+            })();
+            transitionCommand(database, entry.id, "running");
+            try {
+                const result = await operation();
+                transitionCommand(database, entry.id, "completed");
+                return result;
+            }
+            catch (error) {
+                transitionCommand(database, entry.id, "failed");
+                throw error;
+            }
+        },
+        transitionCommand: (id, state, reason) => {
+            const current = readCommand(database, id);
+            if (!current)
+                throw new Error(`Unknown command journal entry: ${id}`);
+            if (!COMMAND_TRANSITIONS[current.state].includes(state))
+                throw new Error(`Invalid command transition: ${current.state} -> ${state}`);
+            const now = new Date().toISOString();
+            database
+                .prepare("UPDATE command_journal SET state = ?, recovery_reason = ?, updated_at = ? WHERE id = ?")
+                .run(state, reason ?? null, now, id);
+            return readCommand(database, id);
+        },
+        getCommand: (id) => readCommand(database, id),
+        commandCount: () => database.prepare("SELECT COUNT(*) AS count FROM command_journal").get().count,
+        recoverUnfinishedCommands: (reason = "daemon restarted before command completion") => {
+            const rows = database
+                .prepare("SELECT id FROM command_journal WHERE state IN ('created', 'running')")
+                .all();
+            return rows.map(({ id }) => {
+                const current = readCommand(database, id);
+                return current.state === "interrupted" ? current : transitionCommand(database, id, "interrupted", reason);
+            });
+        },
+        recoverUnfinishedCommandsWithDiagnostics: (reason = "daemon restarted before command completion") => {
+            const recoveredAt = new Date().toISOString();
+            const rows = database
+                .prepare("SELECT id, session_id, state FROM command_journal WHERE state IN ('created', 'running')")
+                .all();
+            return rows.map((row) => {
+                transitionCommand(database, row.id, "interrupted", reason);
+                return {
+                    commandId: row.id,
+                    sessionId: row.session_id,
+                    previousState: row.state,
+                    state: "interrupted",
+                    reason,
+                    recoveredAt,
+                };
+            });
+        },
+        acquireLease: ({ sessionId, ownerId, mode, ttlMs }) => {
+            if (!Number.isFinite(ttlMs) || ttlMs <= 0)
+                throw new Error("Lease TTL must be positive");
+            database.exec("BEGIN IMMEDIATE");
+            try {
+                database.prepare("DELETE FROM session_leases WHERE expires_at <= ?").run(new Date().toISOString());
+                const active = readLeases(database, sessionId).filter((lease) => lease.ownerId !== ownerId);
+                if (active.some((lease) => lease.mode === "exclusive") || (mode === "exclusive" && active.length > 0)) {
+                    throw new Error(`Session lease is held for ${sessionId}`);
+                }
+                const expiresAt = new Date(Date.now() + ttlMs).toISOString();
+                database
+                    .prepare("INSERT INTO session_leases (session_id, owner_id, mode, expires_at) VALUES (?, ?, ?, ?) ON CONFLICT(session_id, owner_id) DO UPDATE SET mode=excluded.mode, expires_at=excluded.expires_at")
+                    .run(sessionId, ownerId, mode, expiresAt);
+                database.exec("COMMIT");
+                return readLeases(database, sessionId).find((lease) => lease.ownerId === ownerId);
+            }
+            catch (error) {
+                database.exec("ROLLBACK");
+                throw error;
+            }
+        },
+        releaseLease: (sessionId, ownerId) => {
+            database.prepare("DELETE FROM session_leases WHERE session_id = ? AND owner_id = ?").run(sessionId, ownerId);
+        },
+        getLease: (sessionId) => readLease(database, sessionId),
+        recordUsagePerformance: (row) => {
+            database
+                .prepare(`INSERT INTO model_performance (
+						provider, model_id, ttft_ms, generation_ms, sampled_at,
+						session_id, role, credential_identity, outcome, failure_kind,
+						input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cost
+					) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(row.provider, row.modelId, row.ttftMs, row.generationMs, row.sampledAt, row.sessionId, row.role, row.credentialIdentity, row.outcome, row.failureKind, row.inputTokens, row.outputTokens, row.cacheReadTokens, row.cacheWriteTokens, row.cost);
+        },
+        listUsagePerformance: () => database
+            .prepare(`SELECT provider, model_id, ttft_ms, generation_ms, sampled_at, session_id, role,
+							credential_identity, outcome, failure_kind, input_tokens, output_tokens,
+							cache_read_tokens, cache_write_tokens, cost
+						FROM model_performance ORDER BY id ASC`)
+            .all().map((row) => ({
+            provider: row.provider,
+            modelId: row.model_id,
+            ttftMs: row.ttft_ms,
+            generationMs: row.generation_ms,
+            sampledAt: row.sampled_at,
+            sessionId: row.session_id,
+            role: row.role,
+            credentialIdentity: row.credential_identity,
+            outcome: row.outcome,
+            failureKind: row.failure_kind,
+            inputTokens: row.input_tokens,
+            outputTokens: row.output_tokens,
+            cacheReadTokens: row.cache_read_tokens,
+            cacheWriteTokens: row.cache_write_tokens,
+            cost: row.cost,
+        })),
+        pruneUsagePerformance: (olderThanIso) => {
+            const result = database.prepare("DELETE FROM model_performance WHERE sampled_at < ?").run(olderThanIso);
+            return Number(result.changes);
+        },
+        close: () => database.close(),
+    };
+}
+//# sourceMappingURL=sqlite.js.map