@agimon-ai/doompi-core 0.0.1-alpha.70

package/dist/session-files-api.mjs

@@ -0,0 +1,57 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/server/sessionFilesApi.ts
+const EXCLUDED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
+const FILE_QUERY_TIMEOUT_MS = 2e3;
+const MAX_FILE_RESULTS = 50;
+async function listSessionFiles(cwd, query, signal) {
+	const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;
+	const pending = [""];
+	const matches = [];
+	while (pending.length > 0) {
+		if (signal.aborted) throw signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("File completion was aborted.");
+		if (Date.now() > deadline) throw new Error("File completion timed out.");
+		const relativeDirectory = pending.pop();
+		if (relativeDirectory === void 0) break;
+		const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });
+		for (const entry of entries) {
+			const relativePath = path.join(relativeDirectory, entry.name);
+			if (entry.isDirectory() && !EXCLUDED_DIRECTORIES.has(entry.name)) pending.push(relativePath);
+			else if (entry.isFile()) {
+				const file = relativePath.split(path.sep).join("/");
+				if (file.toLowerCase().includes(query)) matches.push(file);
+			}
+		}
+	}
+	return matches.sort().slice(0, MAX_FILE_RESULTS);
+}
+/** Bounded, read-only file completion rooted in the owning session. */
+const sessionFilesApi = {
+	basePath: "files",
+	start(context) {
+		if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
+		const cwd = context.cwd;
+		let closed = false;
+		return {
+			async fetch(request) {
+				if (closed) return new Response(null, { status: 503 });
+				const url = new URL(request.url);
+				if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
+				const query = (url.searchParams.get("q") ?? "").toLowerCase();
+				if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
+				try {
+					return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });
+				} catch {
+					return Response.json({ error: "File completion could not be read." }, { status: 503 });
+				}
+			},
+			close() {
+				closed = true;
+			}
+		};
+	}
+};
+//#endregion
+export { sessionFilesApi };
+
+//# sourceMappingURL=session-files-api.mjs.map

package/dist/session-files-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-files-api.mjs","names":[],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DoomApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\nasync function listSessionFiles(cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  const matches: string[] = [];\n\n  while (pending.length > 0) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    if (Date.now() > deadline) throw new Error('File completion timed out.');\n    const relativeDirectory = pending.pop();\n    if (relativeDirectory === undefined) break;\n    const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });\n    for (const entry of entries) {\n      const relativePath = path.join(relativeDirectory, entry.name);\n      if (entry.isDirectory() && !EXCLUDED_DIRECTORIES.has(entry.name)) {\n        pending.push(relativePath);\n      } else if (entry.isFile()) {\n        const file = relativePath.split(path.sep).join('/');\n        if (file.toLowerCase().includes(query)) matches.push(file);\n      }\n    }\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session. */\nexport const sessionFilesApi: DoomApi = {\n  basePath: 'files',\n  start(context) {\n    if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n    const cwd = context.cwd;\n    let closed = false;\n    return {\n      async fetch(request) {\n        if (closed) return new Response(null, { status: 503 });\n        const url = new URL(request.url);\n        if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n        const query = (url.searchParams.get('q') ?? '').toLowerCase();\n        if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n        try {\n          return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });\n        } catch {\n          return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n        }\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":";;;AAKA,MAAM,uCAAuB,IAAI,IAAI,CAAC,QAAQ,cAAc,CAAC;AAC7D,MAAM,wBAAwB;AAC9B,MAAM,mBAAmB;AAEzB,eAAe,iBAAiB,KAAa,OAAe,QAAwC;CAClG,MAAM,WAAW,KAAK,IAAI,IAAI;CAC9B,MAAM,UAAU,CAAC,EAAE;CACnB,MAAM,UAAoB,CAAC;CAE3B,OAAO,QAAQ,SAAS,GAAG;EACzB,IAAI,OAAO,SACT,MAAM,OAAO,kBAAkB,QAAQ,OAAO,yBAAS,IAAI,MAAM,8BAA8B;EAEjG,IAAI,KAAK,IAAI,IAAI,UAAU,MAAM,IAAI,MAAM,4BAA4B;EACvE,MAAM,oBAAoB,QAAQ,IAAI;EACtC,IAAI,sBAAsB,KAAA,GAAW;EACrC,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ,KAAK,KAAK,KAAK,iBAAiB,GAAG,EAAE,eAAe,KAAK,CAAC;EACpG,KAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,eAAe,KAAK,KAAK,mBAAmB,MAAM,IAAI;GAC5D,IAAI,MAAM,YAAY,KAAK,CAAC,qBAAqB,IAAI,MAAM,IAAI,GAC7D,QAAQ,KAAK,YAAY;QACpB,IAAI,MAAM,OAAO,GAAG;IACzB,MAAM,OAAO,aAAa,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;IAClD,IAAI,KAAK,YAAY,CAAC,CAAC,SAAS,KAAK,GAAG,QAAQ,KAAK,IAAI;GAC3D;EACF;CACF;CAEA,OAAO,QAAQ,KAAK,CAAC,CAAC,MAAM,GAAG,gBAAgB;AACjD;;AAGA,MAAa,kBAA2B;CACtC,UAAU;CACV,MAAM,SAAS;EACb,IAAI,QAAQ,UAAU,aAAa,CAAC,QAAQ,KAAK,MAAM,IAAI,MAAM,qCAAqC;EACtG,MAAM,MAAM,QAAQ;EACpB,IAAI,SAAS;EACb,OAAO;GACL,MAAM,MAAM,SAAS;IACnB,IAAI,QAAQ,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;IACrD,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;IAC/B,IAAI,QAAQ,WAAW,SAAS,IAAI,aAAa,KAAK,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;IAC/F,MAAM,SAAS,IAAI,aAAa,IAAI,GAAG,KAAK,GAAA,CAAI,YAAY;IAC5D,IAAI,MAAM,SAAS,KAAK,OAAO,SAAS,KAAK,EAAE,OAAO,0BAA0B,GAAG,EAAE,QAAQ,IAAI,CAAC;IAClG,IAAI;KACF,OAAO,SAAS,KAAK,EAAE,OAAO,MAAM,iBAAiB,KAAK,OAAO,QAAQ,MAAM,EAAE,CAAC;IACpF,QAAQ;KACN,OAAO,SAAS,KAAK,EAAE,OAAO,qCAAqC,GAAG,EAAE,QAAQ,IAAI,CAAC;IACvF;GACF;GACA,QAAQ;IACN,SAAS;GACX;EACF;CACF;AACF"}

package/dist/session-protocol.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sessionProtocol = require("./schemas/sessionProtocol.cjs");
+exports.DOOM_COCKPIT_SERVER_ID = require_sessionProtocol.DOOM_COCKPIT_SERVER_ID;
+exports.DOOM_SESSION_MANAGEMENT_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_MANAGEMENT_SERVICE_ID;
+exports.DOOM_SESSION_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_SERVICE_ID;
+exports.DoomHubService = require_sessionProtocol.DoomHubService;
+exports.DoomSessionManagementService = require_sessionProtocol.DoomSessionManagementService;
+exports.DoomSessionService = require_sessionProtocol.DoomSessionService;

package/dist/session-protocol.d.cts

@@ -0,0 +1,3 @@
+import { DoomContentBlock, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus } from "./schemas/sessionUpdates.cjs";
+import { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromptArgs, ProtocolEvent, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem } from "./schemas/sessionProtocol.cjs";
+export { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomContentBlock, DoomHubService, DoomSessionManagementService, DoomSessionService, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromptArgs, ProtocolEvent, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem };

package/dist/session-protocol.d.mts

@@ -0,0 +1,3 @@
+import { DoomContentBlock, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus } from "./schemas/sessionUpdates.mjs";
+import { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromptArgs, ProtocolEvent, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem } from "./schemas/sessionProtocol.mjs";
+export { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomContentBlock, DoomHubService, DoomSessionManagementService, DoomSessionService, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromptArgs, ProtocolEvent, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem };

package/dist/session-protocol.mjs

@@ -0,0 +1,2 @@
+import { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService } from "./schemas/sessionProtocol.mjs";
+export { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService };

package/dist/skills.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_skills = require("./schemas/skills.cjs");
+exports.DOOM_RESOURCE_CATALOG_ENTRY_TYPE = require_skills.DOOM_RESOURCE_CATALOG_ENTRY_TYPE;
+exports.DOOM_SKILL_SOURCES_SERVICE = require_skills.DOOM_SKILL_SOURCES_SERVICE;
+exports.SkillSourceContributionSchema = require_skills.SkillSourceContributionSchema;
+exports.SkillSourceNameSchema = require_skills.SkillSourceNameSchema;
+exports.createDoomSkillSourcesService = require_skills.createDoomSkillSourcesService;
+exports.readDoomSkillSourcesService = require_skills.readDoomSkillSourcesService;
+exports.requireDoomSkillSourcesService = require_skills.requireDoomSkillSourcesService;

package/dist/skills.d.cts

@@ -0,0 +1,2 @@
+import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, DoomSkillSourcesService, ResourceCatalogProjection, SkillSourceContribution, SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./schemas/skills.cjs";
+export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, type DoomSkillSourcesService, type ResourceCatalogProjection, type SkillSourceContribution, type SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };

package/dist/skills.d.mts

@@ -0,0 +1,2 @@
+import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, DoomSkillSourcesService, ResourceCatalogProjection, SkillSourceContribution, SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./schemas/skills.mjs";
+export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, type DoomSkillSourcesService, type ResourceCatalogProjection, type SkillSourceContribution, type SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };

package/dist/skills.mjs

@@ -0,0 +1,2 @@
+import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./schemas/skills.mjs";
+export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };

package/dist/sqlite-history-import.cjs

@@ -0,0 +1,151 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_jsonl_session_repo = require("./jsonl-session-repo.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _earendil_works_pi_agent_core_harness_session = require("@earendil-works/pi-agent-core/harness/session");
+let _earendil_works_pi_session_backend_sqlite_node = require("@earendil-works/pi-session-backend-sqlite-node");
+let _earendil_works_pi_agent_core_harness_context = require("@earendil-works/pi-agent-core/harness/context");
+let node_sqlite = require("node:sqlite");
+//#region src/services/sqliteHistoryImport/index.ts
+function record(input) {
+	if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error("Invalid history record");
+	return input;
+}
+/** Replays a protected, offline journal through Pi's public SQLite session writer. */
+async function importSqliteHistory(input) {
+	let content = node_fs.default.readFileSync(input.stagingPath, "utf8");
+	const sourceHeader = record(JSON.parse(content.split("\n", 1)[0]));
+	let verification;
+	if (sourceHeader.type === "session" && sourceHeader.version === 3) {
+		verification = await require_jsonl_session_repo.importV3WithPinnedUpstream(input);
+		content = node_fs.default.readFileSync(input.stagingPath, "utf8");
+	}
+	if (!content.endsWith("\n")) throw new Error("Cannot import truncated history");
+	const lines = content.trimEnd().split("\n");
+	const header = record(JSON.parse(lines.shift()));
+	if (header.kind !== "header" || header.v !== 4 || typeof header.id !== "string") throw new Error("Expected v3 or v4 history");
+	const transactions = lines.map((line) => {
+		const parsed = JSON.parse(line);
+		return (Array.isArray(parsed) ? parsed : [parsed]).map(record);
+	});
+	const entries = transactions.flat().filter((item) => item.kind === "entry");
+	const values = /* @__PURE__ */ new Map();
+	for (const item of transactions.flat()) if (item.kind === "value") {
+		const key = JSON.stringify([item.namespace, item.key]);
+		if (item.op === "delete") values.delete(key);
+		else values.set(key, item);
+	}
+	for (const item of values.values()) if (item.namespace === "pi.lane.state") {
+		const state = record(item.value);
+		if (state.currentOperationId != null || Array.isArray(state.inbox) && state.inbox.length > 0) throw new Error("SQLite import requires settled sessions with empty queues");
+	}
+	verification ??= {
+		entries: entries.map((entry) => ({
+			sourceId: String(entry.id),
+			importedId: String(entry.id),
+			sourceParentId: entry.parentId,
+			importedParentId: entry.parentId,
+			sourceContentHash: require_jsonl_session_repo.contentHash(entry),
+			importedContentHash: require_jsonl_session_repo.contentHash(entry)
+		})),
+		branches: [...values.values()].filter((item) => item.namespace === "pi.branch.tip").map((item) => ({
+			branch: String(item.key),
+			sourceTipId: item.value,
+			importedTipId: item.value
+		}))
+	};
+	node_fs.default.unlinkSync(input.stagingPath);
+	let timestamp = Number(header.createdAt);
+	if (!Number.isFinite(timestamp)) throw new Error("Invalid history creation timestamp");
+	const repository = new _earendil_works_pi_session_backend_sqlite_node.SqliteSessionRepo({
+		directory: node_path.default.dirname(input.stagingPath),
+		databasePath: input.stagingPath,
+		databaseFactory: (0, _earendil_works_pi_session_backend_sqlite_node.createNodeSqliteFactory)(),
+		now: () => timestamp
+	});
+	try {
+		const session = await repository.create({
+			id: header.id,
+			...typeof header.parentSessionId === "string" ? { parentSessionId: header.parentSessionId } : {}
+		}, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		for (const transaction of transactions) {
+			const entryTime = transaction.find((item) => item.kind === "entry")?.timestamp;
+			if (typeof entryTime === "number") timestamp = entryTime;
+			const writes = transaction.map((item) => {
+				const { kind, seq: _seq, timestamp: _timestamp, ...rest } = item;
+				if (kind === "entry") return {
+					kind,
+					entry: rest
+				};
+				if (kind === "usage") return {
+					kind,
+					row: {
+						...rest,
+						timestamp: item.timestamp
+					}
+				};
+				if (kind === "value" || kind === "list") return {
+					kind,
+					...rest
+				};
+				throw new Error(`Unsupported history record kind: ${String(kind)}`);
+			});
+			await session.mutate((mutation, context) => mutation.commit(writes, context).then(() => void 0), _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		}
+		for (const item of values.values()) {
+			const stored = await session.getValue((0, _earendil_works_pi_agent_core_harness_session.value)(String(item.namespace), String(item.key)), _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+			if (JSON.stringify(stored?.value) !== JSON.stringify(item.value)) throw new Error("Imported session state differs from the source");
+		}
+		const copied = await session.findEntries({ order: "asc" }, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		if (copied.length !== entries.length || copied.some((entry, index) => entry.id !== entries[index]?.id || entry.timestamp !== entries[index]?.timestamp)) throw new Error("Imported entry identity or timestamp differs from the source");
+		await session.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+	} finally {
+		await repository.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+	}
+	const database = new node_sqlite.DatabaseSync(input.stagingPath);
+	try {
+		database.exec("PRAGMA wal_checkpoint(TRUNCATE)");
+	} finally {
+		database.close();
+	}
+	node_fs.default.chmodSync(input.stagingPath, 384);
+	return verifySqliteHistory(input.stagingPath, verification);
+}
+/** Reopens the staged database read-only before protected publication. */
+async function verifySqliteHistory(stagingPath, proof) {
+	const factory = (0, _earendil_works_pi_session_backend_sqlite_node.createNodeSqliteFactory)();
+	const repository = new _earendil_works_pi_session_backend_sqlite_node.SqliteSessionRepo({
+		directory: node_path.default.dirname(stagingPath),
+		databasePath: stagingPath,
+		databaseFactory: factory
+	});
+	const sessions = await repository.list(void 0, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+	await repository.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+	if (sessions.length !== 1) throw new Error("Invalid imported SQLite session");
+	const database = await factory.openReadOnly(stagingPath);
+	const storage = new _earendil_works_pi_session_backend_sqlite_node.SqliteStorage(database, { sessionId: sessions[0].id });
+	try {
+		const entries = await storage.scanEntries({}, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		if (entries.length !== proof.entries.length) throw new Error("SQLite import entry count differs");
+		const byId = new Map(entries.map((entry) => [entry.id, entry]));
+		for (const expected of proof.entries) {
+			const entry = byId.get(expected.importedId);
+			if (!entry || entry.parentId !== expected.importedParentId || require_jsonl_session_repo.contentHash(entry) !== expected.importedContentHash) throw new Error(`SQLite import verification failed for ${expected.importedId}`);
+		}
+		for (const branch of proof.branches) if (branch.branch !== void 0) {
+			if ((await storage.getValue((0, _earendil_works_pi_agent_core_harness_session.branchTip)(branch.branch), _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT))?.value !== branch.importedTipId) throw new Error("SQLite import branch differs");
+		}
+		return proof;
+	} finally {
+		await storage.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		database.close();
+	}
+}
+//#endregion
+exports.importSqliteHistory = importSqliteHistory;
+exports.verifySqliteHistory = verifySqliteHistory;
+
+//# sourceMappingURL=sqlite-history-import.cjs.map

package/dist/sqlite-history-import.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-history-import.cjs","names":["fs","importV3WithPinnedUpstream","contentHash","SqliteSessionRepo","path","createNodeSqliteFactory","BACKGROUND_CONTEXT","value","DatabaseSync","SqliteStorage","branchTip"],"sources":["../src/services/sqliteHistoryImport/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { DatabaseSync } from 'node:sqlite';\n\nimport { BACKGROUND_CONTEXT } from '@earendil-works/pi-agent-core/harness/context';\nimport { branchTip, value, type Write } from '@earendil-works/pi-agent-core/harness/session';\nimport {\n  SqliteSessionRepo,\n  SqliteStorage,\n  createNodeSqliteFactory,\n} from '@earendil-works/pi-session-backend-sqlite-node';\n\nimport type { HistoryImportVerification, HistoryStagingImportInput } from '../historyImport';\nimport { contentHash, importV3WithPinnedUpstream } from '../jsonlSessionRepo';\n\ntype RecordValue = Record<string, unknown>;\n\nfunction record(input: unknown): RecordValue {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) throw new Error('Invalid history record');\n  return input as RecordValue;\n}\n\n/** Replays a protected, offline journal through Pi's public SQLite session writer. */\nexport async function importSqliteHistory(input: HistoryStagingImportInput): Promise<HistoryImportVerification> {\n  let content = fs.readFileSync(input.stagingPath, 'utf8');\n  const sourceHeader = record(JSON.parse(content.split('\\n', 1)[0]!));\n  let verification: HistoryImportVerification | undefined;\n  if (sourceHeader.type === 'session' && sourceHeader.version === 3) {\n    verification = await importV3WithPinnedUpstream(input);\n    content = fs.readFileSync(input.stagingPath, 'utf8');\n  }\n  if (!content.endsWith('\\n')) throw new Error('Cannot import truncated history');\n  const lines = content.trimEnd().split('\\n');\n  const header = record(JSON.parse(lines.shift()!));\n  if (header.kind !== 'header' || header.v !== 4 || typeof header.id !== 'string')\n    throw new Error('Expected v3 or v4 history');\n  const transactions = lines.map((line) => {\n    const parsed: unknown = JSON.parse(line);\n    return (Array.isArray(parsed) ? parsed : [parsed]).map(record);\n  });\n  const entries = transactions.flat().filter((item) => item.kind === 'entry');\n  const values = new Map<string, RecordValue>();\n  for (const item of transactions.flat())\n    if (item.kind === 'value') {\n      const key = JSON.stringify([item.namespace, item.key]);\n      if (item.op === 'delete') values.delete(key);\n      else values.set(key, item);\n    }\n  for (const item of values.values())\n    if (item.namespace === 'pi.lane.state') {\n      const state = record(item.value);\n      if (state.currentOperationId != null || (Array.isArray(state.inbox) && state.inbox.length > 0))\n        throw new Error('SQLite import requires settled sessions with empty queues');\n    }\n  verification ??= {\n    entries: entries.map((entry) => ({\n      sourceId: String(entry.id),\n      importedId: String(entry.id),\n      sourceParentId: entry.parentId as string | null,\n      importedParentId: entry.parentId as string | null,\n      sourceContentHash: contentHash(entry),\n      importedContentHash: contentHash(entry),\n    })),\n    branches: [...values.values()]\n      .filter((item) => item.namespace === 'pi.branch.tip')\n      .map((item) => ({\n        branch: String(item.key),\n        sourceTipId: item.value as string | null,\n        importedTipId: item.value as string | null,\n      })),\n  };\n  fs.unlinkSync(input.stagingPath);\n  let timestamp = Number(header.createdAt);\n  if (!Number.isFinite(timestamp)) throw new Error('Invalid history creation timestamp');\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(input.stagingPath),\n    databasePath: input.stagingPath,\n    databaseFactory: createNodeSqliteFactory(),\n    now: () => timestamp,\n  });\n  try {\n    const session = await repository.create(\n      {\n        id: header.id,\n        ...(typeof header.parentSessionId === 'string' ? { parentSessionId: header.parentSessionId } : {}),\n      },\n      BACKGROUND_CONTEXT,\n    );\n    for (const transaction of transactions) {\n      const entryTime = transaction.find((item) => item.kind === 'entry')?.timestamp;\n      if (typeof entryTime === 'number') timestamp = entryTime;\n      const writes = transaction.map((item): Write => {\n        const { kind, seq: _seq, timestamp: _timestamp, ...rest } = item;\n        if (kind === 'entry') return { kind, entry: rest } as unknown as Write;\n        if (kind === 'usage') return { kind, row: { ...rest, timestamp: item.timestamp } } as unknown as Write;\n        if (kind === 'value' || kind === 'list') return { kind, ...rest } as unknown as Write;\n        throw new Error(`Unsupported history record kind: ${String(kind)}`);\n      });\n      await session.mutate(\n        (mutation, context) => mutation.commit(writes, context).then(() => undefined),\n        BACKGROUND_CONTEXT,\n      );\n    }\n    for (const item of values.values()) {\n      const stored = await session.getValue(value(String(item.namespace), String(item.key)), BACKGROUND_CONTEXT);\n      if (JSON.stringify(stored?.value) !== JSON.stringify(item.value))\n        throw new Error('Imported session state differs from the source');\n    }\n    const copied = await session.findEntries({ order: 'asc' }, BACKGROUND_CONTEXT);\n    if (\n      copied.length !== entries.length ||\n      copied.some((entry, index) => entry.id !== entries[index]?.id || entry.timestamp !== entries[index]?.timestamp)\n    )\n      throw new Error('Imported entry identity or timestamp differs from the source');\n    await session.close(BACKGROUND_CONTEXT);\n  } finally {\n    await repository.close(BACKGROUND_CONTEXT);\n  }\n  const database = new DatabaseSync(input.stagingPath);\n  try {\n    database.exec('PRAGMA wal_checkpoint(TRUNCATE)');\n  } finally {\n    database.close();\n  }\n  fs.chmodSync(input.stagingPath, 0o600);\n  return verifySqliteHistory(input.stagingPath, verification);\n}\n\n/** Reopens the staged database read-only before protected publication. */\nexport async function verifySqliteHistory(\n  stagingPath: string,\n  proof: HistoryImportVerification,\n): Promise<HistoryImportVerification> {\n  const factory = createNodeSqliteFactory();\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(stagingPath),\n    databasePath: stagingPath,\n    databaseFactory: factory,\n  });\n  const sessions = await repository.list(undefined, BACKGROUND_CONTEXT);\n  await repository.close(BACKGROUND_CONTEXT);\n  if (sessions.length !== 1) throw new Error('Invalid imported SQLite session');\n  const database = await factory.openReadOnly(stagingPath);\n  const storage = new SqliteStorage(database, { sessionId: sessions[0]!.id });\n  try {\n    const entries = await storage.scanEntries({}, BACKGROUND_CONTEXT);\n    if (entries.length !== proof.entries.length) throw new Error('SQLite import entry count differs');\n    const byId = new Map(entries.map((entry) => [entry.id, entry]));\n    for (const expected of proof.entries) {\n      const entry = byId.get(expected.importedId);\n      if (\n        !entry ||\n        entry.parentId !== expected.importedParentId ||\n        contentHash(entry as unknown as RecordValue) !== expected.importedContentHash\n      )\n        throw new Error(`SQLite import verification failed for ${expected.importedId}`);\n    }\n    for (const branch of proof.branches)\n      if (branch.branch !== undefined) {\n        const tip = await storage.getValue(branchTip(branch.branch), BACKGROUND_CONTEXT);\n        if (tip?.value !== branch.importedTipId) throw new Error('SQLite import branch differs');\n      }\n    return proof;\n  } finally {\n    await storage.close(BACKGROUND_CONTEXT);\n    database.close();\n  }\n}\n"],"mappings":"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"}

package/dist/sqlite-history-import.d.cts

@@ -0,0 +1,8 @@
+import { HistoryImportVerification, HistoryStagingImportInput } from "./history-import.cjs";
+//#region src/services/sqliteHistoryImport/index.d.ts
+/** Replays a protected, offline journal through Pi's public SQLite session writer. */
+export declare function importSqliteHistory(input: HistoryStagingImportInput): Promise<HistoryImportVerification>;
+/** Reopens the staged database read-only before protected publication. */
+export declare function verifySqliteHistory(stagingPath: string, proof: HistoryImportVerification): Promise<HistoryImportVerification>;
+//#endregion
+//# sourceMappingURL=sqlite-history-import.d.cts.map

package/dist/sqlite-history-import.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-history-import.d.cts","names":[],"sources":["../src/services/sqliteHistoryImport/index.ts"],"mappings":";;;wBAuBsB,oBAAoB,OAAO,4BAA4B,QAAQ;;wBA0G/D,oBACpB,qBACA,OAAO,4BACN,QAAQ"}

package/dist/sqlite-history-import.d.mts

@@ -0,0 +1,8 @@
+import { HistoryImportVerification, HistoryStagingImportInput } from "./history-import.mjs";
+//#region src/services/sqliteHistoryImport/index.d.ts
+/** Replays a protected, offline journal through Pi's public SQLite session writer. */
+export declare function importSqliteHistory(input: HistoryStagingImportInput): Promise<HistoryImportVerification>;
+/** Reopens the staged database read-only before protected publication. */
+export declare function verifySqliteHistory(stagingPath: string, proof: HistoryImportVerification): Promise<HistoryImportVerification>;
+//#endregion
+//# sourceMappingURL=sqlite-history-import.d.mts.map

package/dist/sqlite-history-import.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-history-import.d.mts","names":[],"sources":["../src/services/sqliteHistoryImport/index.ts"],"mappings":";;;wBAuBsB,oBAAoB,OAAO,4BAA4B,QAAQ;;wBA0G/D,oBACpB,qBACA,OAAO,4BACN,QAAQ"}

package/dist/sqlite-history-import.mjs

@@ -0,0 +1,146 @@
+import { contentHash, importV3WithPinnedUpstream } from "./jsonl-session-repo.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { branchTip, value } from "@earendil-works/pi-agent-core/harness/session";
+import { SqliteSessionRepo, SqliteStorage, createNodeSqliteFactory } from "@earendil-works/pi-session-backend-sqlite-node";
+import { BACKGROUND_CONTEXT } from "@earendil-works/pi-agent-core/harness/context";
+import { DatabaseSync } from "node:sqlite";
+//#region src/services/sqliteHistoryImport/index.ts
+function record(input) {
+	if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error("Invalid history record");
+	return input;
+}
+/** Replays a protected, offline journal through Pi's public SQLite session writer. */
+async function importSqliteHistory(input) {
+	let content = fs.readFileSync(input.stagingPath, "utf8");
+	const sourceHeader = record(JSON.parse(content.split("\n", 1)[0]));
+	let verification;
+	if (sourceHeader.type === "session" && sourceHeader.version === 3) {
+		verification = await importV3WithPinnedUpstream(input);
+		content = fs.readFileSync(input.stagingPath, "utf8");
+	}
+	if (!content.endsWith("\n")) throw new Error("Cannot import truncated history");
+	const lines = content.trimEnd().split("\n");
+	const header = record(JSON.parse(lines.shift()));
+	if (header.kind !== "header" || header.v !== 4 || typeof header.id !== "string") throw new Error("Expected v3 or v4 history");
+	const transactions = lines.map((line) => {
+		const parsed = JSON.parse(line);
+		return (Array.isArray(parsed) ? parsed : [parsed]).map(record);
+	});
+	const entries = transactions.flat().filter((item) => item.kind === "entry");
+	const values = /* @__PURE__ */ new Map();
+	for (const item of transactions.flat()) if (item.kind === "value") {
+		const key = JSON.stringify([item.namespace, item.key]);
+		if (item.op === "delete") values.delete(key);
+		else values.set(key, item);
+	}
+	for (const item of values.values()) if (item.namespace === "pi.lane.state") {
+		const state = record(item.value);
+		if (state.currentOperationId != null || Array.isArray(state.inbox) && state.inbox.length > 0) throw new Error("SQLite import requires settled sessions with empty queues");
+	}
+	verification ??= {
+		entries: entries.map((entry) => ({
+			sourceId: String(entry.id),
+			importedId: String(entry.id),
+			sourceParentId: entry.parentId,
+			importedParentId: entry.parentId,
+			sourceContentHash: contentHash(entry),
+			importedContentHash: contentHash(entry)
+		})),
+		branches: [...values.values()].filter((item) => item.namespace === "pi.branch.tip").map((item) => ({
+			branch: String(item.key),
+			sourceTipId: item.value,
+			importedTipId: item.value
+		}))
+	};
+	fs.unlinkSync(input.stagingPath);
+	let timestamp = Number(header.createdAt);
+	if (!Number.isFinite(timestamp)) throw new Error("Invalid history creation timestamp");
+	const repository = new SqliteSessionRepo({
+		directory: path.dirname(input.stagingPath),
+		databasePath: input.stagingPath,
+		databaseFactory: createNodeSqliteFactory(),
+		now: () => timestamp
+	});
+	try {
+		const session = await repository.create({
+			id: header.id,
+			...typeof header.parentSessionId === "string" ? { parentSessionId: header.parentSessionId } : {}
+		}, BACKGROUND_CONTEXT);
+		for (const transaction of transactions) {
+			const entryTime = transaction.find((item) => item.kind === "entry")?.timestamp;
+			if (typeof entryTime === "number") timestamp = entryTime;
+			const writes = transaction.map((item) => {
+				const { kind, seq: _seq, timestamp: _timestamp, ...rest } = item;
+				if (kind === "entry") return {
+					kind,
+					entry: rest
+				};
+				if (kind === "usage") return {
+					kind,
+					row: {
+						...rest,
+						timestamp: item.timestamp
+					}
+				};
+				if (kind === "value" || kind === "list") return {
+					kind,
+					...rest
+				};
+				throw new Error(`Unsupported history record kind: ${String(kind)}`);
+			});
+			await session.mutate((mutation, context) => mutation.commit(writes, context).then(() => void 0), BACKGROUND_CONTEXT);
+		}
+		for (const item of values.values()) {
+			const stored = await session.getValue(value(String(item.namespace), String(item.key)), BACKGROUND_CONTEXT);
+			if (JSON.stringify(stored?.value) !== JSON.stringify(item.value)) throw new Error("Imported session state differs from the source");
+		}
+		const copied = await session.findEntries({ order: "asc" }, BACKGROUND_CONTEXT);
+		if (copied.length !== entries.length || copied.some((entry, index) => entry.id !== entries[index]?.id || entry.timestamp !== entries[index]?.timestamp)) throw new Error("Imported entry identity or timestamp differs from the source");
+		await session.close(BACKGROUND_CONTEXT);
+	} finally {
+		await repository.close(BACKGROUND_CONTEXT);
+	}
+	const database = new DatabaseSync(input.stagingPath);
+	try {
+		database.exec("PRAGMA wal_checkpoint(TRUNCATE)");
+	} finally {
+		database.close();
+	}
+	fs.chmodSync(input.stagingPath, 384);
+	return verifySqliteHistory(input.stagingPath, verification);
+}
+/** Reopens the staged database read-only before protected publication. */
+async function verifySqliteHistory(stagingPath, proof) {
+	const factory = createNodeSqliteFactory();
+	const repository = new SqliteSessionRepo({
+		directory: path.dirname(stagingPath),
+		databasePath: stagingPath,
+		databaseFactory: factory
+	});
+	const sessions = await repository.list(void 0, BACKGROUND_CONTEXT);
+	await repository.close(BACKGROUND_CONTEXT);
+	if (sessions.length !== 1) throw new Error("Invalid imported SQLite session");
+	const database = await factory.openReadOnly(stagingPath);
+	const storage = new SqliteStorage(database, { sessionId: sessions[0].id });
+	try {
+		const entries = await storage.scanEntries({}, BACKGROUND_CONTEXT);
+		if (entries.length !== proof.entries.length) throw new Error("SQLite import entry count differs");
+		const byId = new Map(entries.map((entry) => [entry.id, entry]));
+		for (const expected of proof.entries) {
+			const entry = byId.get(expected.importedId);
+			if (!entry || entry.parentId !== expected.importedParentId || contentHash(entry) !== expected.importedContentHash) throw new Error(`SQLite import verification failed for ${expected.importedId}`);
+		}
+		for (const branch of proof.branches) if (branch.branch !== void 0) {
+			if ((await storage.getValue(branchTip(branch.branch), BACKGROUND_CONTEXT))?.value !== branch.importedTipId) throw new Error("SQLite import branch differs");
+		}
+		return proof;
+	} finally {
+		await storage.close(BACKGROUND_CONTEXT);
+		database.close();
+	}
+}
+//#endregion
+export { importSqliteHistory, verifySqliteHistory };
+
+//# sourceMappingURL=sqlite-history-import.mjs.map

package/dist/sqlite-history-import.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-history-import.mjs","names":[],"sources":["../src/services/sqliteHistoryImport/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { DatabaseSync } from 'node:sqlite';\n\nimport { BACKGROUND_CONTEXT } from '@earendil-works/pi-agent-core/harness/context';\nimport { branchTip, value, type Write } from '@earendil-works/pi-agent-core/harness/session';\nimport {\n  SqliteSessionRepo,\n  SqliteStorage,\n  createNodeSqliteFactory,\n} from '@earendil-works/pi-session-backend-sqlite-node';\n\nimport type { HistoryImportVerification, HistoryStagingImportInput } from '../historyImport';\nimport { contentHash, importV3WithPinnedUpstream } from '../jsonlSessionRepo';\n\ntype RecordValue = Record<string, unknown>;\n\nfunction record(input: unknown): RecordValue {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) throw new Error('Invalid history record');\n  return input as RecordValue;\n}\n\n/** Replays a protected, offline journal through Pi's public SQLite session writer. */\nexport async function importSqliteHistory(input: HistoryStagingImportInput): Promise<HistoryImportVerification> {\n  let content = fs.readFileSync(input.stagingPath, 'utf8');\n  const sourceHeader = record(JSON.parse(content.split('\\n', 1)[0]!));\n  let verification: HistoryImportVerification | undefined;\n  if (sourceHeader.type === 'session' && sourceHeader.version === 3) {\n    verification = await importV3WithPinnedUpstream(input);\n    content = fs.readFileSync(input.stagingPath, 'utf8');\n  }\n  if (!content.endsWith('\\n')) throw new Error('Cannot import truncated history');\n  const lines = content.trimEnd().split('\\n');\n  const header = record(JSON.parse(lines.shift()!));\n  if (header.kind !== 'header' || header.v !== 4 || typeof header.id !== 'string')\n    throw new Error('Expected v3 or v4 history');\n  const transactions = lines.map((line) => {\n    const parsed: unknown = JSON.parse(line);\n    return (Array.isArray(parsed) ? parsed : [parsed]).map(record);\n  });\n  const entries = transactions.flat().filter((item) => item.kind === 'entry');\n  const values = new Map<string, RecordValue>();\n  for (const item of transactions.flat())\n    if (item.kind === 'value') {\n      const key = JSON.stringify([item.namespace, item.key]);\n      if (item.op === 'delete') values.delete(key);\n      else values.set(key, item);\n    }\n  for (const item of values.values())\n    if (item.namespace === 'pi.lane.state') {\n      const state = record(item.value);\n      if (state.currentOperationId != null || (Array.isArray(state.inbox) && state.inbox.length > 0))\n        throw new Error('SQLite import requires settled sessions with empty queues');\n    }\n  verification ??= {\n    entries: entries.map((entry) => ({\n      sourceId: String(entry.id),\n      importedId: String(entry.id),\n      sourceParentId: entry.parentId as string | null,\n      importedParentId: entry.parentId as string | null,\n      sourceContentHash: contentHash(entry),\n      importedContentHash: contentHash(entry),\n    })),\n    branches: [...values.values()]\n      .filter((item) => item.namespace === 'pi.branch.tip')\n      .map((item) => ({\n        branch: String(item.key),\n        sourceTipId: item.value as string | null,\n        importedTipId: item.value as string | null,\n      })),\n  };\n  fs.unlinkSync(input.stagingPath);\n  let timestamp = Number(header.createdAt);\n  if (!Number.isFinite(timestamp)) throw new Error('Invalid history creation timestamp');\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(input.stagingPath),\n    databasePath: input.stagingPath,\n    databaseFactory: createNodeSqliteFactory(),\n    now: () => timestamp,\n  });\n  try {\n    const session = await repository.create(\n      {\n        id: header.id,\n        ...(typeof header.parentSessionId === 'string' ? { parentSessionId: header.parentSessionId } : {}),\n      },\n      BACKGROUND_CONTEXT,\n    );\n    for (const transaction of transactions) {\n      const entryTime = transaction.find((item) => item.kind === 'entry')?.timestamp;\n      if (typeof entryTime === 'number') timestamp = entryTime;\n      const writes = transaction.map((item): Write => {\n        const { kind, seq: _seq, timestamp: _timestamp, ...rest } = item;\n        if (kind === 'entry') return { kind, entry: rest } as unknown as Write;\n        if (kind === 'usage') return { kind, row: { ...rest, timestamp: item.timestamp } } as unknown as Write;\n        if (kind === 'value' || kind === 'list') return { kind, ...rest } as unknown as Write;\n        throw new Error(`Unsupported history record kind: ${String(kind)}`);\n      });\n      await session.mutate(\n        (mutation, context) => mutation.commit(writes, context).then(() => undefined),\n        BACKGROUND_CONTEXT,\n      );\n    }\n    for (const item of values.values()) {\n      const stored = await session.getValue(value(String(item.namespace), String(item.key)), BACKGROUND_CONTEXT);\n      if (JSON.stringify(stored?.value) !== JSON.stringify(item.value))\n        throw new Error('Imported session state differs from the source');\n    }\n    const copied = await session.findEntries({ order: 'asc' }, BACKGROUND_CONTEXT);\n    if (\n      copied.length !== entries.length ||\n      copied.some((entry, index) => entry.id !== entries[index]?.id || entry.timestamp !== entries[index]?.timestamp)\n    )\n      throw new Error('Imported entry identity or timestamp differs from the source');\n    await session.close(BACKGROUND_CONTEXT);\n  } finally {\n    await repository.close(BACKGROUND_CONTEXT);\n  }\n  const database = new DatabaseSync(input.stagingPath);\n  try {\n    database.exec('PRAGMA wal_checkpoint(TRUNCATE)');\n  } finally {\n    database.close();\n  }\n  fs.chmodSync(input.stagingPath, 0o600);\n  return verifySqliteHistory(input.stagingPath, verification);\n}\n\n/** Reopens the staged database read-only before protected publication. */\nexport async function verifySqliteHistory(\n  stagingPath: string,\n  proof: HistoryImportVerification,\n): Promise<HistoryImportVerification> {\n  const factory = createNodeSqliteFactory();\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(stagingPath),\n    databasePath: stagingPath,\n    databaseFactory: factory,\n  });\n  const sessions = await repository.list(undefined, BACKGROUND_CONTEXT);\n  await repository.close(BACKGROUND_CONTEXT);\n  if (sessions.length !== 1) throw new Error('Invalid imported SQLite session');\n  const database = await factory.openReadOnly(stagingPath);\n  const storage = new SqliteStorage(database, { sessionId: sessions[0]!.id });\n  try {\n    const entries = await storage.scanEntries({}, BACKGROUND_CONTEXT);\n    if (entries.length !== proof.entries.length) throw new Error('SQLite import entry count differs');\n    const byId = new Map(entries.map((entry) => [entry.id, entry]));\n    for (const expected of proof.entries) {\n      const entry = byId.get(expected.importedId);\n      if (\n        !entry ||\n        entry.parentId !== expected.importedParentId ||\n        contentHash(entry as unknown as RecordValue) !== expected.importedContentHash\n      )\n        throw new Error(`SQLite import verification failed for ${expected.importedId}`);\n    }\n    for (const branch of proof.branches)\n      if (branch.branch !== undefined) {\n        const tip = await storage.getValue(branchTip(branch.branch), BACKGROUND_CONTEXT);\n        if (tip?.value !== branch.importedTipId) throw new Error('SQLite import branch differs');\n      }\n    return proof;\n  } finally {\n    await storage.close(BACKGROUND_CONTEXT);\n    database.close();\n  }\n}\n"],"mappings":";;;;;;;;AAiBA,SAAS,OAAO,OAA6B;CAC3C,IAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG,MAAM,IAAI,MAAM,wBAAwB;CACzG,OAAO;AACT;;AAGA,eAAsB,oBAAoB,OAAsE;CAC9G,IAAI,UAAU,GAAG,aAAa,MAAM,aAAa,MAAM;CACvD,MAAM,eAAe,OAAO,KAAK,MAAM,QAAQ,MAAM,MAAM,CAAC,CAAC,CAAC,EAAG,CAAC;CAClE,IAAI;CACJ,IAAI,aAAa,SAAS,aAAa,aAAa,YAAY,GAAG;EACjE,eAAe,MAAM,2BAA2B,KAAK;EACrD,UAAU,GAAG,aAAa,MAAM,aAAa,MAAM;CACrD;CACA,IAAI,CAAC,QAAQ,SAAS,IAAI,GAAG,MAAM,IAAI,MAAM,iCAAiC;CAC9E,MAAM,QAAQ,QAAQ,QAAQ,CAAC,CAAC,MAAM,IAAI;CAC1C,MAAM,SAAS,OAAO,KAAK,MAAM,MAAM,MAAM,CAAE,CAAC;CAChD,IAAI,OAAO,SAAS,YAAY,OAAO,MAAM,KAAK,OAAO,OAAO,OAAO,UACrE,MAAM,IAAI,MAAM,2BAA2B;CAC7C,MAAM,eAAe,MAAM,KAAK,SAAS;EACvC,MAAM,SAAkB,KAAK,MAAM,IAAI;EACvC,QAAQ,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM,EAAA,CAAG,IAAI,MAAM;CAC/D,CAAC;CACD,MAAM,UAAU,aAAa,KAAK,CAAC,CAAC,QAAQ,SAAS,KAAK,SAAS,OAAO;CAC1E,MAAM,yBAAS,IAAI,IAAyB;CAC5C,KAAK,MAAM,QAAQ,aAAa,KAAK,GACnC,IAAI,KAAK,SAAS,SAAS;EACzB,MAAM,MAAM,KAAK,UAAU,CAAC,KAAK,WAAW,KAAK,GAAG,CAAC;EACrD,IAAI,KAAK,OAAO,UAAU,OAAO,OAAO,GAAG;OACtC,OAAO,IAAI,KAAK,IAAI;CAC3B;CACF,KAAK,MAAM,QAAQ,OAAO,OAAO,GAC/B,IAAI,KAAK,cAAc,iBAAiB;EACtC,MAAM,QAAQ,OAAO,KAAK,KAAK;EAC/B,IAAI,MAAM,sBAAsB,QAAS,MAAM,QAAQ,MAAM,KAAK,KAAK,MAAM,MAAM,SAAS,GAC1F,MAAM,IAAI,MAAM,2DAA2D;CAC/E;CACF,iBAAiB;EACf,SAAS,QAAQ,KAAK,WAAW;GAC/B,UAAU,OAAO,MAAM,EAAE;GACzB,YAAY,OAAO,MAAM,EAAE;GAC3B,gBAAgB,MAAM;GACtB,kBAAkB,MAAM;GACxB,mBAAmB,YAAY,KAAK;GACpC,qBAAqB,YAAY,KAAK;EACxC,EAAE;EACF,UAAU,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CAC3B,QAAQ,SAAS,KAAK,cAAc,eAAe,CAAC,CACpD,KAAK,UAAU;GACd,QAAQ,OAAO,KAAK,GAAG;GACvB,aAAa,KAAK;GAClB,eAAe,KAAK;EACtB,EAAE;CACN;CACA,GAAG,WAAW,MAAM,WAAW;CAC/B,IAAI,YAAY,OAAO,OAAO,SAAS;CACvC,IAAI,CAAC,OAAO,SAAS,SAAS,GAAG,MAAM,IAAI,MAAM,oCAAoC;CACrF,MAAM,aAAa,IAAI,kBAAkB;EACvC,WAAW,KAAK,QAAQ,MAAM,WAAW;EACzC,cAAc,MAAM;EACpB,iBAAiB,wBAAwB;EACzC,WAAW;CACb,CAAC;CACD,IAAI;EACF,MAAM,UAAU,MAAM,WAAW,OAC/B;GACE,IAAI,OAAO;GACX,GAAI,OAAO,OAAO,oBAAoB,WAAW,EAAE,iBAAiB,OAAO,gBAAgB,IAAI,CAAC;EAClG,GACA,kBACF;EACA,KAAK,MAAM,eAAe,cAAc;GACtC,MAAM,YAAY,YAAY,MAAM,SAAS,KAAK,SAAS,OAAO,CAAC,EAAE;GACrE,IAAI,OAAO,cAAc,UAAU,YAAY;GAC/C,MAAM,SAAS,YAAY,KAAK,SAAgB;IAC9C,MAAM,EAAE,MAAM,KAAK,MAAM,WAAW,YAAY,GAAG,SAAS;IAC5D,IAAI,SAAS,SAAS,OAAO;KAAE;KAAM,OAAO;IAAK;IACjD,IAAI,SAAS,SAAS,OAAO;KAAE;KAAM,KAAK;MAAE,GAAG;MAAM,WAAW,KAAK;KAAU;IAAE;IACjF,IAAI,SAAS,WAAW,SAAS,QAAQ,OAAO;KAAE;KAAM,GAAG;IAAK;IAChE,MAAM,IAAI,MAAM,oCAAoC,OAAO,IAAI,GAAG;GACpE,CAAC;GACD,MAAM,QAAQ,QACX,UAAU,YAAY,SAAS,OAAO,QAAQ,OAAO,CAAC,CAAC,WAAW,KAAA,CAAS,GAC5E,kBACF;EACF;EACA,KAAK,MAAM,QAAQ,OAAO,OAAO,GAAG;GAClC,MAAM,SAAS,MAAM,QAAQ,SAAS,MAAM,OAAO,KAAK,SAAS,GAAG,OAAO,KAAK,GAAG,CAAC,GAAG,kBAAkB;GACzG,IAAI,KAAK,UAAU,QAAQ,KAAK,MAAM,KAAK,UAAU,KAAK,KAAK,GAC7D,MAAM,IAAI,MAAM,gDAAgD;EACpE;EACA,MAAM,SAAS,MAAM,QAAQ,YAAY,EAAE,OAAO,MAAM,GAAG,kBAAkB;EAC7E,IACE,OAAO,WAAW,QAAQ,UAC1B,OAAO,MAAM,OAAO,UAAU,MAAM,OAAO,QAAQ,MAAM,EAAE,MAAM,MAAM,cAAc,QAAQ,MAAM,EAAE,SAAS,GAE9G,MAAM,IAAI,MAAM,8DAA8D;EAChF,MAAM,QAAQ,MAAM,kBAAkB;CACxC,UAAU;EACR,MAAM,WAAW,MAAM,kBAAkB;CAC3C;CACA,MAAM,WAAW,IAAI,aAAa,MAAM,WAAW;CACnD,IAAI;EACF,SAAS,KAAK,iCAAiC;CACjD,UAAU;EACR,SAAS,MAAM;CACjB;CACA,GAAG,UAAU,MAAM,aAAa,GAAK;CACrC,OAAO,oBAAoB,MAAM,aAAa,YAAY;AAC5D;;AAGA,eAAsB,oBACpB,aACA,OACoC;CACpC,MAAM,UAAU,wBAAwB;CACxC,MAAM,aAAa,IAAI,kBAAkB;EACvC,WAAW,KAAK,QAAQ,WAAW;EACnC,cAAc;EACd,iBAAiB;CACnB,CAAC;CACD,MAAM,WAAW,MAAM,WAAW,KAAK,KAAA,GAAW,kBAAkB;CACpE,MAAM,WAAW,MAAM,kBAAkB;CACzC,IAAI,SAAS,WAAW,GAAG,MAAM,IAAI,MAAM,iCAAiC;CAC5E,MAAM,WAAW,MAAM,QAAQ,aAAa,WAAW;CACvD,MAAM,UAAU,IAAI,cAAc,UAAU,EAAE,WAAW,SAAS,EAAE,CAAE,GAAG,CAAC;CAC1E,IAAI;EACF,MAAM,UAAU,MAAM,QAAQ,YAAY,CAAC,GAAG,kBAAkB;EAChE,IAAI,QAAQ,WAAW,MAAM,QAAQ,QAAQ,MAAM,IAAI,MAAM,mCAAmC;EAChG,MAAM,OAAO,IAAI,IAAI,QAAQ,KAAK,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;EAC9D,KAAK,MAAM,YAAY,MAAM,SAAS;GACpC,MAAM,QAAQ,KAAK,IAAI,SAAS,UAAU;GAC1C,IACE,CAAC,SACD,MAAM,aAAa,SAAS,oBAC5B,YAAY,KAA+B,MAAM,SAAS,qBAE1D,MAAM,IAAI,MAAM,yCAAyC,SAAS,YAAY;EAClF;EACA,KAAK,MAAM,UAAU,MAAM,UACzB,IAAI,OAAO,WAAW,KAAA,GAEhB;QAAA,MADc,QAAQ,SAAS,UAAU,OAAO,MAAM,GAAG,kBAAkB,EAAA,EACtE,UAAU,OAAO,eAAe,MAAM,IAAI,MAAM,8BAA8B;EAAA;EAE3F,OAAO;CACT,UAAU;EACR,MAAM,QAAQ,MAAM,kBAAkB;EACtC,SAAS,MAAM;CACjB;AACF"}

package/dist/sqlite-session-storage.cjs

@@ -0,0 +1,53 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_crypto = require("node:crypto");
+let _earendil_works_pi_session_backend_sqlite_node = require("@earendil-works/pi-session-backend-sqlite-node");
+//#region src/services/sqliteSessionStorage/index.ts
+/** Opens the one SQLite container owned by a server session. */
+async function openSqliteSessionStorage(options, context) {
+	if (!options.historyOwnership) throw new Error("SQLite sessions require explicit HistoryOwnership");
+	if (!options.sessionsRoot && !options.sessionPath) throw new Error("SQLite sessions require a server data directory");
+	const id = options.sessionId ?? (0, node_crypto.randomUUID)();
+	if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error("Invalid SQLite session id");
+	const sessionFile = node_path.default.resolve(options.sessionPath ?? node_path.default.join(options.sessionsRoot, `${id}.sqlite`));
+	const historyLease = await options.historyOwnership.acquire(sessionFile);
+	const repository = new _earendil_works_pi_session_backend_sqlite_node.SqliteSessionRepo({
+		directory: node_path.default.dirname(sessionFile),
+		databasePath: sessionFile,
+		databaseFactory: (0, _earendil_works_pi_session_backend_sqlite_node.createNodeSqliteFactory)()
+	});
+	try {
+		await historyLease.assertQuiescent();
+		const existing = node_fs.default.existsSync(sessionFile);
+		if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);
+		const metadata = existing ? await repository.list(void 0, context) : [];
+		if (existing && metadata.length !== 1) throw new Error("Expected exactly one session in the SQLite container");
+		if (existing && options.sessionId && metadata[0].id !== options.sessionId) throw new Error("SQLite session id does not match the requested session");
+		const session = existing ? await repository.open(metadata[0], context) : await repository.create({
+			id,
+			...options.parentSessionId ? { parentSessionId: options.parentSessionId } : {}
+		}, context);
+		if (!existing) node_fs.default.chmodSync(sessionFile, 384);
+		return {
+			session,
+			sessionFile,
+			repository,
+			historyLease
+		};
+	} catch (error) {
+		try {
+			await repository.close(context);
+		} finally {
+			await historyLease.release();
+		}
+		throw error;
+	}
+}
+//#endregion
+exports.openSqliteSessionStorage = openSqliteSessionStorage;
+
+//# sourceMappingURL=sqlite-session-storage.cjs.map

package/dist/sqlite-session-storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-session-storage.cjs","names":["randomUUID","path","SqliteSessionRepo","createNodeSqliteFactory","fs"],"sources":["../src/services/sqliteSessionStorage/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/pi-agent-core/harness/context';\nimport { SqliteSessionRepo, createNodeSqliteFactory } from '@earendil-works/pi-session-backend-sqlite-node';\n\nimport type { DirectHarnessRuntimeOptions, SqliteSessionStorage } from '../../types/server/directHarnessRuntime';\n\n/** Opens the one SQLite container owned by a server session. */\nexport async function openSqliteSessionStorage(\n  options: Pick<\n    DirectHarnessRuntimeOptions,\n    'historyOwnership' | 'sessionsRoot' | 'sessionPath' | 'sessionId' | 'parentSessionId'\n  >,\n  context: Context,\n): Promise<SqliteSessionStorage> {\n  if (!options.historyOwnership) throw new Error('SQLite sessions require explicit HistoryOwnership');\n  if (!options.sessionsRoot && !options.sessionPath) throw new Error('SQLite sessions require a server data directory');\n  const id = options.sessionId ?? randomUUID();\n  if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error('Invalid SQLite session id');\n  const sessionFile = path.resolve(options.sessionPath ?? path.join(options.sessionsRoot!, `${id}.sqlite`));\n  const historyLease = await options.historyOwnership.acquire(sessionFile);\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(sessionFile),\n    databasePath: sessionFile,\n    databaseFactory: createNodeSqliteFactory(),\n  });\n  try {\n    await historyLease.assertQuiescent();\n    const existing = fs.existsSync(sessionFile);\n    if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);\n    const metadata = existing ? await repository.list(undefined, context) : [];\n    if (existing && metadata.length !== 1) throw new Error('Expected exactly one session in the SQLite container');\n    if (existing && options.sessionId && metadata[0]!.id !== options.sessionId)\n      throw new Error('SQLite session id does not match the requested session');\n    const session = existing\n      ? await repository.open(metadata[0]!, context)\n      : await repository.create(\n          { id, ...(options.parentSessionId ? { parentSessionId: options.parentSessionId } : {}) },\n          context,\n        );\n    if (!existing) fs.chmodSync(sessionFile, 0o600);\n    return { session, sessionFile, repository, historyLease };\n  } catch (error) {\n    try {\n      await repository.close(context);\n    } finally {\n      await historyLease.release();\n    }\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;AAUA,eAAsB,yBACpB,SAIA,SAC+B;CAC/B,IAAI,CAAC,QAAQ,kBAAkB,MAAM,IAAI,MAAM,mDAAmD;CAClG,IAAI,CAAC,QAAQ,gBAAgB,CAAC,QAAQ,aAAa,MAAM,IAAI,MAAM,iDAAiD;CACpH,MAAM,KAAK,QAAQ,cAAA,GAAaA,YAAAA,WAAAA,CAAW;CAC3C,IAAI,CAAC,oBAAoB,KAAK,EAAE,GAAG,MAAM,IAAI,MAAM,2BAA2B;CAC9E,MAAM,cAAcC,UAAAA,QAAK,QAAQ,QAAQ,eAAeA,UAAAA,QAAK,KAAK,QAAQ,cAAe,GAAG,GAAG,QAAQ,CAAC;CACxG,MAAM,eAAe,MAAM,QAAQ,iBAAiB,QAAQ,WAAW;CACvE,MAAM,aAAa,IAAIC,+CAAAA,kBAAkB;EACvC,WAAWD,UAAAA,QAAK,QAAQ,WAAW;EACnC,cAAc;EACd,kBAAA,GAAiBE,+CAAAA,wBAAAA,CAAwB;CAC3C,CAAC;CACD,IAAI;EACF,MAAM,aAAa,gBAAgB;EACnC,MAAM,WAAWC,QAAAA,QAAG,WAAW,WAAW;EAC1C,IAAI,QAAQ,eAAe,CAAC,UAAU,MAAM,IAAI,MAAM,6BAA6B,aAAa;EAChG,MAAM,WAAW,WAAW,MAAM,WAAW,KAAK,KAAA,GAAW,OAAO,IAAI,CAAC;EACzE,IAAI,YAAY,SAAS,WAAW,GAAG,MAAM,IAAI,MAAM,sDAAsD;EAC7G,IAAI,YAAY,QAAQ,aAAa,SAAS,EAAE,CAAE,OAAO,QAAQ,WAC/D,MAAM,IAAI,MAAM,wDAAwD;EAC1E,MAAM,UAAU,WACZ,MAAM,WAAW,KAAK,SAAS,IAAK,OAAO,IAC3C,MAAM,WAAW,OACf;GAAE;GAAI,GAAI,QAAQ,kBAAkB,EAAE,iBAAiB,QAAQ,gBAAgB,IAAI,CAAC;EAAG,GACvF,OACF;EACJ,IAAI,CAAC,UAAU,QAAA,QAAG,UAAU,aAAa,GAAK;EAC9C,OAAO;GAAE;GAAS;GAAa;GAAY;EAAa;CAC1D,SAAS,OAAO;EACd,IAAI;GACF,MAAM,WAAW,MAAM,OAAO;EAChC,UAAU;GACR,MAAM,aAAa,QAAQ;EAC7B;EACA,MAAM;CACR;AACF"}

package/dist/sqlite-session-storage.d.cts

@@ -0,0 +1,7 @@
+import { DirectHarnessRuntimeOptions, SqliteSessionStorage } from "./types/server/directHarnessRuntime.cjs";
+import { Context } from "@earendil-works/pi-agent-core/harness/context";
+//#region src/services/sqliteSessionStorage/index.d.ts
+/** Opens the one SQLite container owned by a server session. */
+export declare function openSqliteSessionStorage(options: Pick<DirectHarnessRuntimeOptions, 'historyOwnership' | 'sessionsRoot' | 'sessionPath' | 'sessionId' | 'parentSessionId'>, context: Context): Promise<SqliteSessionStorage>;
+//#endregion
+//# sourceMappingURL=sqlite-session-storage.d.cts.map

package/dist/sqlite-session-storage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-session-storage.d.cts","names":[],"sources":["../src/services/sqliteSessionStorage/index.ts"],"mappings":";;;;wBAUsB,yBACpB,SAAS,KACP,qHAGF,SAAS,UACR,QAAQ"}

package/dist/sqlite-session-storage.d.mts

@@ -0,0 +1,7 @@
+import { DirectHarnessRuntimeOptions, SqliteSessionStorage } from "./types/server/directHarnessRuntime.mjs";
+import { Context } from "@earendil-works/pi-agent-core/harness/context";
+//#region src/services/sqliteSessionStorage/index.d.ts
+/** Opens the one SQLite container owned by a server session. */
+export declare function openSqliteSessionStorage(options: Pick<DirectHarnessRuntimeOptions, 'historyOwnership' | 'sessionsRoot' | 'sessionPath' | 'sessionId' | 'parentSessionId'>, context: Context): Promise<SqliteSessionStorage>;
+//#endregion
+//# sourceMappingURL=sqlite-session-storage.d.mts.map

package/dist/sqlite-session-storage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-session-storage.d.mts","names":[],"sources":["../src/services/sqliteSessionStorage/index.ts"],"mappings":";;;;wBAUsB,yBACpB,SAAS,KACP,qHAGF,SAAS,UACR,QAAQ"}