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

package/dist/src/services/sqliteSessionHistory/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/sqliteSessionHistory/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { BACKGROUND_CONTEXT } from '@earendil-works/pi-agent-core/harness/context';\nimport { sessionName, value } 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\nexport interface SavedSession {\n  id: string;\n  name?: string;\n  firstMessage: string;\n  createdAt: string;\n  updatedAt: string;\n  messageCount: number;\n}\n\n/** Private execution context, never included in the HTTP history summary. */\nexport interface SavedSessionExecution {\n  cwd: string;\n  repoRoot: string;\n  workspaceId: string;\n  groupingRoot: string;\n  parentSessionId?: string;\n  sessionProvenance?: string;\n  inheritedArtifact?: unknown;\n}\n\nexport interface SavedSessionRecord {\n  summary: SavedSession;\n  execution: SavedSessionExecution;\n}\n\nexport function readSavedExecution(raw: unknown, owner: string): SavedSessionExecution | undefined {\n  if (typeof raw !== 'string') return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Record<string, unknown>;\n  if (\n    typeof record.cwd !== 'string' ||\n    !path.isAbsolute(record.cwd) ||\n    typeof record.repoRoot !== 'string' ||\n    !path.isAbsolute(record.repoRoot) ||\n    record.repoRoot !== owner ||\n    typeof record.workspaceId !== 'string' ||\n    record.workspaceId === '' ||\n    typeof record.groupingRoot !== 'string' ||\n    !path.isAbsolute(record.groupingRoot)\n  )\n    return undefined;\n  if (record.parentSessionId !== undefined && typeof record.parentSessionId !== 'string') return undefined;\n  if (record.sessionProvenance !== undefined && typeof record.sessionProvenance !== 'string') return undefined;\n  return {\n    cwd: record.cwd,\n    repoRoot: record.repoRoot,\n    workspaceId: record.workspaceId,\n    groupingRoot: record.groupingRoot,\n    ...(typeof record.parentSessionId === 'string' ? { parentSessionId: record.parentSessionId } : {}),\n    ...(typeof record.sessionProvenance === 'string' ? { sessionProvenance: record.sessionProvenance } : {}),\n    ...(record.inheritedArtifact === undefined ? {} : { inheritedArtifact: record.inheritedArtifact }),\n  };\n}\n\n/** Lists private execution records for one admitted workspace. */\nexport async function listSavedSessionRecords(\n  sessionsRoot: string,\n  workspaceRoot: string,\n  activeSessionIds: ReadonlySet<string>,\n  workspaceId?: string,\n): Promise<SavedSessionRecord[]> {\n  const factory = createNodeSqliteFactory();\n  const repository = new SqliteSessionRepo({ directory: sessionsRoot, databaseFactory: factory });\n  let sessions: Awaited<ReturnType<typeof repository.list>>;\n  try {\n    sessions = await repository.list(undefined, BACKGROUND_CONTEXT);\n  } finally {\n    await repository.close(BACKGROUND_CONTEXT);\n  }\n  const result: SavedSessionRecord[] = [];\n  for (const metadata of sessions) {\n    if (activeSessionIds.has(metadata.id)) continue;\n    const database = await factory.openReadOnly(metadata.path);\n    const storage = new SqliteStorage(database, { sessionId: metadata.id });\n    try {\n      const owner = await storage.getValue(value('doompi.session', 'workspaceRoot'), BACKGROUND_CONTEXT);\n      if (typeof owner?.value !== 'string') continue;\n      const context = await storage.getValue(value('doompi.session', 'execution'), BACKGROUND_CONTEXT);\n      const execution = readSavedExecution(context?.value, owner.value);\n      if (context?.value !== undefined && !execution) continue;\n      if (execution) {\n        if (execution.groupingRoot !== workspaceRoot || (workspaceId && execution.workspaceId !== workspaceId))\n          continue;\n      } else {\n        // Legacy journals have only an execution root. Never infer worktree grouping\n        // or a subdirectory pwd from their parent workspace.\n        if (owner.value !== workspaceRoot) continue;\n      }\n      const [name, entries, stats, file] = await Promise.all([\n        storage.getValue(sessionName, BACKGROUND_CONTEXT),\n        storage.scanEntries({ type: 'message', order: 'asc', limit: 100 }, BACKGROUND_CONTEXT),\n        storage.getStats(BACKGROUND_CONTEXT),\n        fs.stat(metadata.path),\n      ]);\n      const firstUser = entries.find((entry) => entry.type === 'message' && entry.message.role === 'user');\n      const content =\n        firstUser?.type === 'message' && 'content' in firstUser.message ? firstUser.message.content : undefined;\n      const firstMessage =\n        typeof content === 'string'\n          ? content\n          : Array.isArray(content)\n            ? content\n                .filter((part) => part.type === 'text')\n                .map((part) => part.text)\n                .join('\\n')\n            : '';\n      result.push({\n        summary: {\n          id: metadata.id,\n          ...(typeof name?.value === 'string' ? { name: name.value } : {}),\n          firstMessage,\n          createdAt: new Date(metadata.createdAt).toISOString(),\n          updatedAt: file.mtime.toISOString(),\n          messageCount: stats.messageCount,\n        },\n        execution: execution ?? {\n          cwd: workspaceRoot,\n          repoRoot: workspaceRoot,\n          groupingRoot: workspaceRoot,\n          workspaceId: workspaceId ?? '',\n        },\n      });\n    } finally {\n      await storage.close(BACKGROUND_CONTEXT);\n      database.close();\n    }\n  }\n  return result.sort((left, right) => right.summary.updatedAt.localeCompare(left.summary.updatedAt));\n}\n\n/** Public history summaries contain no execution paths or pinned artifacts. */\nexport async function listSavedSessions(\n  sessionsRoot: string,\n  workspaceRoot: string,\n  activeSessionIds: ReadonlySet<string>,\n  workspaceId?: string,\n): Promise<SavedSession[]> {\n  return (await listSavedSessionRecords(sessionsRoot, workspaceRoot, activeSessionIds, workspaceId)).map(\n    (record) => record.summary,\n  );\n}\n"],"mappings":"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"}

package/dist/src/services/sqliteTranscriptReader/index.cjs

@@ -0,0 +1,70 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../sqliteSessionHistory/index.cjs");
+const require_index$1 = require("../transcriptPages/index.cjs");
+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 node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_runtime.__toESM(node_fs_promises, 1);
+let _earendil_works_pi_session_backend_sqlite_node = require("@earendil-works/pi-session-backend-sqlite-node");
+//#region src/services/sqliteTranscriptReader/index.ts
+/** A completed child is read through a separate read-only WAL connection, never a second writer. */
+async function readSqliteTranscript(file, request, context, ownership) {
+	try {
+		if (!(await node_fs_promises.default.stat(file)).isFile()) throw new Error("Child SQLite session not found");
+	} catch {
+		throw new Error("Child SQLite session not found");
+	}
+	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(file),
+		databasePath: file,
+		databaseFactory: factory
+	});
+	let sessions;
+	try {
+		sessions = await repository.list(void 0, context);
+	} finally {
+		await repository.close(context);
+	}
+	if (sessions.length !== 1) throw new Error("Child SQLite session not found");
+	if (ownership !== void 0 && sessions[0].id !== ownership.sessionId) throw new Error("Saved transcript does not belong to this session");
+	const database = await factory.openReadOnly(file);
+	const storage = new _earendil_works_pi_session_backend_sqlite_node.SqliteStorage(database, { sessionId: sessions[0].id });
+	try {
+		if (ownership !== void 0) {
+			if ((await storage.getValue((0, _earendil_works_pi_agent_core_harness_session.value)("doompi.session", "workspaceRoot"), context))?.value !== ownership.workspaceRoot) throw new Error("Saved transcript does not belong to this workspace");
+			const contextValue = await storage.getValue((0, _earendil_works_pi_agent_core_harness_session.value)("doompi.session", "execution"), context);
+			if (contextValue?.value !== void 0) {
+				const execution = require_index.readSavedExecution(contextValue.value, ownership.workspaceRoot);
+				if (!execution || ownership.workspaceId !== void 0 && execution.workspaceId !== ownership.workspaceId || ownership.groupingRoot !== void 0 && execution.groupingRoot !== ownership.groupingRoot) throw new Error("Saved transcript does not belong to this workspace");
+			}
+		}
+		const branches = await storage.scanValues((0, _earendil_works_pi_agent_core_harness_session.branchTip)(""), context);
+		const branch = branches.find((item) => item.address.key === "main") ?? (branches.length === 1 ? branches[0] : void 0);
+		if (!branch && branches.length > 1) throw new Error("Child transcript has no unambiguous active lane");
+		const tip = branch?.value ?? null;
+		return {
+			...await require_index$1.readTranscriptPage({
+				sessionId: sessions[0].id,
+				laneName: branch?.address.key ?? "main",
+				lane: {
+					getTipId: async () => tip,
+					findEntries: (query, readContext) => tip ? storage.scanBranch({
+						...query,
+						start: query?.start ?? tip
+					}, readContext) : Promise.resolve([])
+				}
+			}, request, 0, context),
+			revision: 0,
+			drafts: []
+		};
+	} finally {
+		await storage.close(context);
+		database.close();
+	}
+}
+//#endregion
+exports.readSqliteTranscript = readSqliteTranscript;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/sqliteTranscriptReader/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["fs","createNodeSqliteFactory","SqliteSessionRepo","path","SqliteStorage","value","readSavedExecution","branchTip","readTranscriptPage"],"sources":["../../../../src/services/sqliteTranscriptReader/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { branchTip, value } 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 { TranscriptPageRequest, TranscriptPage } from '../../exports/sessionProtocol';\nimport { readSavedExecution } from '../sqliteSessionHistory';\nimport { readTranscriptPage } from '../transcriptPages';\n\nexport interface SqliteTranscriptOwnership {\n  sessionId: string;\n  workspaceRoot: string;\n  workspaceId?: string;\n  groupingRoot?: string;\n}\n\n/** A completed child is read through a separate read-only WAL connection, never a second writer. */\nexport async function readSqliteTranscript(\n  file: string,\n  request: TranscriptPageRequest,\n  context: Context,\n  ownership?: SqliteTranscriptOwnership,\n): Promise<TranscriptPage> {\n  try {\n    const stat = await fs.stat(file);\n    if (!stat.isFile()) throw new Error('Child SQLite session not found');\n  } catch {\n    throw new Error('Child SQLite session not found');\n  }\n  const factory = createNodeSqliteFactory();\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(file),\n    databasePath: file,\n    databaseFactory: factory,\n  });\n  let sessions: Awaited<ReturnType<typeof repository.list>>;\n  try {\n    sessions = await repository.list(undefined, context);\n  } finally {\n    await repository.close(context);\n  }\n  if (sessions.length !== 1) throw new Error('Child SQLite session not found');\n  if (ownership !== undefined && sessions[0]!.id !== ownership.sessionId)\n    throw new Error('Saved transcript does not belong to this session');\n  const database = await factory.openReadOnly(file);\n  const storage = new SqliteStorage(database, { sessionId: sessions[0]!.id });\n  try {\n    if (ownership !== undefined) {\n      const owner = await storage.getValue(value('doompi.session', 'workspaceRoot'), context);\n      if (owner?.value !== ownership.workspaceRoot)\n        throw new Error('Saved transcript does not belong to this workspace');\n      const contextValue = await storage.getValue(value('doompi.session', 'execution'), context);\n      if (contextValue?.value !== undefined) {\n        const execution = readSavedExecution(contextValue.value, ownership.workspaceRoot);\n        if (\n          !execution ||\n          (ownership.workspaceId !== undefined && execution.workspaceId !== ownership.workspaceId) ||\n          (ownership.groupingRoot !== undefined && execution.groupingRoot !== ownership.groupingRoot)\n        )\n          throw new Error('Saved transcript does not belong to this workspace');\n      }\n    }\n    const branches = await storage.scanValues(branchTip(''), context);\n    const branch =\n      branches.find((item) => item.address.key === 'main') ?? (branches.length === 1 ? branches[0] : undefined);\n    if (!branch && branches.length > 1) throw new Error('Child transcript has no unambiguous active lane');\n    const tip = branch?.value ?? null;\n    const page = await readTranscriptPage(\n      {\n        sessionId: sessions[0]!.id,\n        laneName: branch?.address.key ?? 'main',\n        lane: {\n          getTipId: async () => tip,\n          findEntries: (query, readContext) =>\n            tip ? storage.scanBranch({ ...query, start: query?.start ?? tip }, readContext) : Promise.resolve([]),\n        },\n      },\n      request,\n      0,\n      context,\n    );\n    return { ...page, revision: 0, drafts: [] };\n  } finally {\n    await storage.close(context);\n    database.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;AAuBA,eAAsB,qBACpB,MACA,SACA,SACA,WACyB;CACzB,IAAI;EAEF,IAAI,EAAC,MADcA,iBAAAA,QAAG,KAAK,IAAI,EAAA,CACrB,OAAO,GAAG,MAAM,IAAI,MAAM,gCAAgC;CACtE,QAAQ;EACN,MAAM,IAAI,MAAM,gCAAgC;CAClD;CACA,MAAM,WAAA,GAAUC,+CAAAA,wBAAAA,CAAwB;CACxC,MAAM,aAAa,IAAIC,+CAAAA,kBAAkB;EACvC,WAAWC,UAAAA,QAAK,QAAQ,IAAI;EAC5B,cAAc;EACd,iBAAiB;CACnB,CAAC;CACD,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,WAAW,KAAK,KAAA,GAAW,OAAO;CACrD,UAAU;EACR,MAAM,WAAW,MAAM,OAAO;CAChC;CACA,IAAI,SAAS,WAAW,GAAG,MAAM,IAAI,MAAM,gCAAgC;CAC3E,IAAI,cAAc,KAAA,KAAa,SAAS,EAAE,CAAE,OAAO,UAAU,WAC3D,MAAM,IAAI,MAAM,kDAAkD;CACpE,MAAM,WAAW,MAAM,QAAQ,aAAa,IAAI;CAChD,MAAM,UAAU,IAAIC,+CAAAA,cAAc,UAAU,EAAE,WAAW,SAAS,EAAE,CAAE,GAAG,CAAC;CAC1E,IAAI;EACF,IAAI,cAAc,KAAA,GAAW;GAE3B,KAAI,MADgB,QAAQ,UAAA,GAASC,8CAAAA,MAAAA,CAAM,kBAAkB,eAAe,GAAG,OAAO,EAAA,EAC3E,UAAU,UAAU,eAC7B,MAAM,IAAI,MAAM,oDAAoD;GACtE,MAAM,eAAe,MAAM,QAAQ,UAAA,GAASA,8CAAAA,MAAAA,CAAM,kBAAkB,WAAW,GAAG,OAAO;GACzF,IAAI,cAAc,UAAU,KAAA,GAAW;IACrC,MAAM,YAAYC,cAAAA,mBAAmB,aAAa,OAAO,UAAU,aAAa;IAChF,IACE,CAAC,aACA,UAAU,gBAAgB,KAAA,KAAa,UAAU,gBAAgB,UAAU,eAC3E,UAAU,iBAAiB,KAAA,KAAa,UAAU,iBAAiB,UAAU,cAE9E,MAAM,IAAI,MAAM,oDAAoD;GACxE;EACF;EACA,MAAM,WAAW,MAAM,QAAQ,YAAA,GAAWC,8CAAAA,UAAAA,CAAU,EAAE,GAAG,OAAO;EAChE,MAAM,SACJ,SAAS,MAAM,SAAS,KAAK,QAAQ,QAAQ,MAAM,MAAM,SAAS,WAAW,IAAI,SAAS,KAAK,KAAA;EACjG,IAAI,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,IAAI,MAAM,iDAAiD;EACrG,MAAM,MAAM,QAAQ,SAAS;EAe7B,OAAO;GAAE,GAAG,MAdOC,gBAAAA,mBACjB;IACE,WAAW,SAAS,EAAE,CAAE;IACxB,UAAU,QAAQ,QAAQ,OAAO;IACjC,MAAM;KACJ,UAAU,YAAY;KACtB,cAAc,OAAO,gBACnB,MAAM,QAAQ,WAAW;MAAE,GAAG;MAAO,OAAO,OAAO,SAAS;KAAI,GAAG,WAAW,IAAI,QAAQ,QAAQ,CAAC,CAAC;IACxG;GACF,GACA,SACA,GACA,OACF;GACkB,UAAU;GAAG,QAAQ,CAAC;EAAE;CAC5C,UAAU;EACR,MAAM,QAAQ,MAAM,OAAO;EAC3B,SAAS,MAAM;CACjB;AACF"}

package/dist/src/services/sqliteTranscriptReader/index.d.mts

@@ -0,0 +1,14 @@
+import { TranscriptPage, TranscriptPageRequest } from "../../schemas/sessionProtocol.mjs";
+import "../../../sessionProtocol.mjs";
+import { Context } from "@earendil-works/chord";
+//#region src/services/sqliteTranscriptReader/index.d.ts
+export interface SqliteTranscriptOwnership {
+  sessionId: string;
+  workspaceRoot: string;
+  workspaceId?: string;
+  groupingRoot?: string;
+}
+/** A completed child is read through a separate read-only WAL connection, never a second writer. */
+export declare function readSqliteTranscript(file: string, request: TranscriptPageRequest, context: Context, ownership?: SqliteTranscriptOwnership): Promise<TranscriptPage>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/sqliteTranscriptReader/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/sqliteTranscriptReader/index.ts"],"mappings":";;;;iBAeiB;EACf;EACA;EACA;EACA;;;wBAIoB,qBACpB,cACA,SAAS,uBACT,SAAS,SACT,YAAY,4BACX,QAAQ"}

package/dist/src/services/sqliteTranscriptReader/index.mjs

@@ -0,0 +1,67 @@
+import { readSavedExecution } from "../sqliteSessionHistory/index.mjs";
+import { readTranscriptPage } from "../transcriptPages/index.mjs";
+import path from "node:path";
+import { branchTip, value } from "@earendil-works/pi-agent-core/harness/session";
+import fs from "node:fs/promises";
+import { SqliteSessionRepo, SqliteStorage, createNodeSqliteFactory } from "@earendil-works/pi-session-backend-sqlite-node";
+//#region src/services/sqliteTranscriptReader/index.ts
+/** A completed child is read through a separate read-only WAL connection, never a second writer. */
+async function readSqliteTranscript(file, request, context, ownership) {
+	try {
+		if (!(await fs.stat(file)).isFile()) throw new Error("Child SQLite session not found");
+	} catch {
+		throw new Error("Child SQLite session not found");
+	}
+	const factory = createNodeSqliteFactory();
+	const repository = new SqliteSessionRepo({
+		directory: path.dirname(file),
+		databasePath: file,
+		databaseFactory: factory
+	});
+	let sessions;
+	try {
+		sessions = await repository.list(void 0, context);
+	} finally {
+		await repository.close(context);
+	}
+	if (sessions.length !== 1) throw new Error("Child SQLite session not found");
+	if (ownership !== void 0 && sessions[0].id !== ownership.sessionId) throw new Error("Saved transcript does not belong to this session");
+	const database = await factory.openReadOnly(file);
+	const storage = new SqliteStorage(database, { sessionId: sessions[0].id });
+	try {
+		if (ownership !== void 0) {
+			if ((await storage.getValue(value("doompi.session", "workspaceRoot"), context))?.value !== ownership.workspaceRoot) throw new Error("Saved transcript does not belong to this workspace");
+			const contextValue = await storage.getValue(value("doompi.session", "execution"), context);
+			if (contextValue?.value !== void 0) {
+				const execution = readSavedExecution(contextValue.value, ownership.workspaceRoot);
+				if (!execution || ownership.workspaceId !== void 0 && execution.workspaceId !== ownership.workspaceId || ownership.groupingRoot !== void 0 && execution.groupingRoot !== ownership.groupingRoot) throw new Error("Saved transcript does not belong to this workspace");
+			}
+		}
+		const branches = await storage.scanValues(branchTip(""), context);
+		const branch = branches.find((item) => item.address.key === "main") ?? (branches.length === 1 ? branches[0] : void 0);
+		if (!branch && branches.length > 1) throw new Error("Child transcript has no unambiguous active lane");
+		const tip = branch?.value ?? null;
+		return {
+			...await readTranscriptPage({
+				sessionId: sessions[0].id,
+				laneName: branch?.address.key ?? "main",
+				lane: {
+					getTipId: async () => tip,
+					findEntries: (query, readContext) => tip ? storage.scanBranch({
+						...query,
+						start: query?.start ?? tip
+					}, readContext) : Promise.resolve([])
+				}
+			}, request, 0, context),
+			revision: 0,
+			drafts: []
+		};
+	} finally {
+		await storage.close(context);
+		database.close();
+	}
+}
+//#endregion
+export { readSqliteTranscript };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/sqliteTranscriptReader/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/sqliteTranscriptReader/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { branchTip, value } 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 { TranscriptPageRequest, TranscriptPage } from '../../exports/sessionProtocol';\nimport { readSavedExecution } from '../sqliteSessionHistory';\nimport { readTranscriptPage } from '../transcriptPages';\n\nexport interface SqliteTranscriptOwnership {\n  sessionId: string;\n  workspaceRoot: string;\n  workspaceId?: string;\n  groupingRoot?: string;\n}\n\n/** A completed child is read through a separate read-only WAL connection, never a second writer. */\nexport async function readSqliteTranscript(\n  file: string,\n  request: TranscriptPageRequest,\n  context: Context,\n  ownership?: SqliteTranscriptOwnership,\n): Promise<TranscriptPage> {\n  try {\n    const stat = await fs.stat(file);\n    if (!stat.isFile()) throw new Error('Child SQLite session not found');\n  } catch {\n    throw new Error('Child SQLite session not found');\n  }\n  const factory = createNodeSqliteFactory();\n  const repository = new SqliteSessionRepo({\n    directory: path.dirname(file),\n    databasePath: file,\n    databaseFactory: factory,\n  });\n  let sessions: Awaited<ReturnType<typeof repository.list>>;\n  try {\n    sessions = await repository.list(undefined, context);\n  } finally {\n    await repository.close(context);\n  }\n  if (sessions.length !== 1) throw new Error('Child SQLite session not found');\n  if (ownership !== undefined && sessions[0]!.id !== ownership.sessionId)\n    throw new Error('Saved transcript does not belong to this session');\n  const database = await factory.openReadOnly(file);\n  const storage = new SqliteStorage(database, { sessionId: sessions[0]!.id });\n  try {\n    if (ownership !== undefined) {\n      const owner = await storage.getValue(value('doompi.session', 'workspaceRoot'), context);\n      if (owner?.value !== ownership.workspaceRoot)\n        throw new Error('Saved transcript does not belong to this workspace');\n      const contextValue = await storage.getValue(value('doompi.session', 'execution'), context);\n      if (contextValue?.value !== undefined) {\n        const execution = readSavedExecution(contextValue.value, ownership.workspaceRoot);\n        if (\n          !execution ||\n          (ownership.workspaceId !== undefined && execution.workspaceId !== ownership.workspaceId) ||\n          (ownership.groupingRoot !== undefined && execution.groupingRoot !== ownership.groupingRoot)\n        )\n          throw new Error('Saved transcript does not belong to this workspace');\n      }\n    }\n    const branches = await storage.scanValues(branchTip(''), context);\n    const branch =\n      branches.find((item) => item.address.key === 'main') ?? (branches.length === 1 ? branches[0] : undefined);\n    if (!branch && branches.length > 1) throw new Error('Child transcript has no unambiguous active lane');\n    const tip = branch?.value ?? null;\n    const page = await readTranscriptPage(\n      {\n        sessionId: sessions[0]!.id,\n        laneName: branch?.address.key ?? 'main',\n        lane: {\n          getTipId: async () => tip,\n          findEntries: (query, readContext) =>\n            tip ? storage.scanBranch({ ...query, start: query?.start ?? tip }, readContext) : Promise.resolve([]),\n        },\n      },\n      request,\n      0,\n      context,\n    );\n    return { ...page, revision: 0, drafts: [] };\n  } finally {\n    await storage.close(context);\n    database.close();\n  }\n}\n"],"mappings":";;;;;;;;AAuBA,eAAsB,qBACpB,MACA,SACA,SACA,WACyB;CACzB,IAAI;EAEF,IAAI,EAAC,MADc,GAAG,KAAK,IAAI,EAAA,CACrB,OAAO,GAAG,MAAM,IAAI,MAAM,gCAAgC;CACtE,QAAQ;EACN,MAAM,IAAI,MAAM,gCAAgC;CAClD;CACA,MAAM,UAAU,wBAAwB;CACxC,MAAM,aAAa,IAAI,kBAAkB;EACvC,WAAW,KAAK,QAAQ,IAAI;EAC5B,cAAc;EACd,iBAAiB;CACnB,CAAC;CACD,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,WAAW,KAAK,KAAA,GAAW,OAAO;CACrD,UAAU;EACR,MAAM,WAAW,MAAM,OAAO;CAChC;CACA,IAAI,SAAS,WAAW,GAAG,MAAM,IAAI,MAAM,gCAAgC;CAC3E,IAAI,cAAc,KAAA,KAAa,SAAS,EAAE,CAAE,OAAO,UAAU,WAC3D,MAAM,IAAI,MAAM,kDAAkD;CACpE,MAAM,WAAW,MAAM,QAAQ,aAAa,IAAI;CAChD,MAAM,UAAU,IAAI,cAAc,UAAU,EAAE,WAAW,SAAS,EAAE,CAAE,GAAG,CAAC;CAC1E,IAAI;EACF,IAAI,cAAc,KAAA,GAAW;GAE3B,KAAI,MADgB,QAAQ,SAAS,MAAM,kBAAkB,eAAe,GAAG,OAAO,EAAA,EAC3E,UAAU,UAAU,eAC7B,MAAM,IAAI,MAAM,oDAAoD;GACtE,MAAM,eAAe,MAAM,QAAQ,SAAS,MAAM,kBAAkB,WAAW,GAAG,OAAO;GACzF,IAAI,cAAc,UAAU,KAAA,GAAW;IACrC,MAAM,YAAY,mBAAmB,aAAa,OAAO,UAAU,aAAa;IAChF,IACE,CAAC,aACA,UAAU,gBAAgB,KAAA,KAAa,UAAU,gBAAgB,UAAU,eAC3E,UAAU,iBAAiB,KAAA,KAAa,UAAU,iBAAiB,UAAU,cAE9E,MAAM,IAAI,MAAM,oDAAoD;GACxE;EACF;EACA,MAAM,WAAW,MAAM,QAAQ,WAAW,UAAU,EAAE,GAAG,OAAO;EAChE,MAAM,SACJ,SAAS,MAAM,SAAS,KAAK,QAAQ,QAAQ,MAAM,MAAM,SAAS,WAAW,IAAI,SAAS,KAAK,KAAA;EACjG,IAAI,CAAC,UAAU,SAAS,SAAS,GAAG,MAAM,IAAI,MAAM,iDAAiD;EACrG,MAAM,MAAM,QAAQ,SAAS;EAe7B,OAAO;GAAE,GAAG,MAdO,mBACjB;IACE,WAAW,SAAS,EAAE,CAAE;IACxB,UAAU,QAAQ,QAAQ,OAAO;IACjC,MAAM;KACJ,UAAU,YAAY;KACtB,cAAc,OAAO,gBACnB,MAAM,QAAQ,WAAW;MAAE,GAAG;MAAO,OAAO,OAAO,SAAS;KAAI,GAAG,WAAW,IAAI,QAAQ,QAAQ,CAAC,CAAC;IACxG;GACF,GACA,SACA,GACA,OACF;GACkB,UAAU;GAAG,QAAQ,CAAC;EAAE;CAC5C,UAAU;EACR,MAAM,QAAQ,MAAM,OAAO;EAC3B,SAAS,MAAM;CACjB;AACF"}

package/dist/src/services/toolCost/index.cjs

@@ -0,0 +1,47 @@
+//#region src/services/toolCost/index.ts
+/** Mirrors the wire shape MCP advertises, so both estimates stay comparable. */
+function schemaPayload(entry) {
+	return JSON.stringify({
+		name: entry.name,
+		...entry.description === void 0 ? {} : { description: entry.description },
+		...entry.parameters === void 0 ? {} : { parameters: entry.parameters }
+	});
+}
+function promptPayload(entry) {
+	return [entry.promptSnippet ?? "", ...entry.promptGuidelines ?? []].filter(Boolean).join("\n");
+}
+function tokensForTool(entry, countTokens) {
+	const schemaTokens = countTokens(schemaPayload(entry));
+	const prompt = promptPayload(entry);
+	const promptTokens = prompt.length === 0 ? 0 : countTokens(prompt);
+	return {
+		schemaTokens,
+		promptTokens,
+		totalTokens: schemaTokens + promptTokens
+	};
+}
+/**
+* Every tool in a source, and what the source costs in total.
+*
+* An inactive tool is still priced: it is in the composition, and the point of
+* the figure is to show what the composition costs. Whether the model may call
+* it is a separate question from whether it is being paid for.
+*/
+function tokensForSource(source, countTokens) {
+	const tools = /* @__PURE__ */ new Map();
+	let totalTokens = 0;
+	for (const entry of source.tools) {
+		const cost = tokensForTool(entry, countTokens);
+		tools.set(entry.name, cost);
+		totalTokens += cost.totalTokens;
+	}
+	return {
+		tools,
+		totalTokens
+	};
+}
+//#endregion
+exports.tokensForSource = tokensForSource;
+exports.tokensForTool = tokensForTool;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/toolCost/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/toolCost/index.ts"],"sourcesContent":["import type { ToolEntry, ToolSource } from '../toolInventory';\n\n/**\n * What one tool costs before anything is asked of it.\n *\n * A tool is sent to the model twice over. Its schema travels in the tool list,\n * and its prose travels in the system prompt: Pi's `BuildSystemPromptOptions`\n * takes `toolSnippets` keyed by tool name and `promptGuidelines` appended to the\n * default guidelines, separately from the tools themselves. Pricing only the\n * schema would undercount every tool that carries either, so the two are counted\n * apart and reported together.\n *\n * The tokenizer is injected rather than imported, matching how MCP schema\n * pricing already takes a `countTokens`. This module stays free of any opinion\n * about which vocabulary the caller's model actually uses.\n */\nexport interface ToolCost {\n  /** The tool-list payload: name, description, and parameter schema. */\n  schemaTokens: number;\n  /** The system-prompt payload: snippet and guideline bullets. */\n  promptTokens: number;\n  totalTokens: number;\n}\n\nexport type CountTokens = (text: string) => number;\n\n/** Mirrors the wire shape MCP advertises, so both estimates stay comparable. */\nfunction schemaPayload(entry: ToolEntry): string {\n  return JSON.stringify({\n    name: entry.name,\n    ...(entry.description === undefined ? {} : { description: entry.description }),\n    ...(entry.parameters === undefined ? {} : { parameters: entry.parameters }),\n  });\n}\n\nfunction promptPayload(entry: ToolEntry): string {\n  return [entry.promptSnippet ?? '', ...(entry.promptGuidelines ?? [])].filter(Boolean).join('\\n');\n}\n\nexport function tokensForTool(entry: ToolEntry, countTokens: CountTokens): ToolCost {\n  const schemaTokens = countTokens(schemaPayload(entry));\n  const prompt = promptPayload(entry);\n  const promptTokens = prompt.length === 0 ? 0 : countTokens(prompt);\n  return { schemaTokens, promptTokens, totalTokens: schemaTokens + promptTokens };\n}\n\n/**\n * Every tool in a source, and what the source costs in total.\n *\n * An inactive tool is still priced: it is in the composition, and the point of\n * the figure is to show what the composition costs. Whether the model may call\n * it is a separate question from whether it is being paid for.\n */\nexport function tokensForSource(\n  source: ToolSource,\n  countTokens: CountTokens,\n): { tools: ReadonlyMap<string, ToolCost>; totalTokens: number } {\n  const tools = new Map<string, ToolCost>();\n  let totalTokens = 0;\n  for (const entry of source.tools) {\n    const cost = tokensForTool(entry, countTokens);\n    tools.set(entry.name, cost);\n    totalTokens += cost.totalTokens;\n  }\n  return { tools, totalTokens };\n}\n"],"mappings":";;AA2BA,SAAS,cAAc,OAA0B;CAC/C,OAAO,KAAK,UAAU;EACpB,MAAM,MAAM;EACZ,GAAI,MAAM,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;EAC5E,GAAI,MAAM,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,MAAM,WAAW;CAC3E,CAAC;AACH;AAEA,SAAS,cAAc,OAA0B;CAC/C,OAAO,CAAC,MAAM,iBAAiB,IAAI,GAAI,MAAM,oBAAoB,CAAC,CAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;AACjG;AAEA,SAAgB,cAAc,OAAkB,aAAoC;CAClF,MAAM,eAAe,YAAY,cAAc,KAAK,CAAC;CACrD,MAAM,SAAS,cAAc,KAAK;CAClC,MAAM,eAAe,OAAO,WAAW,IAAI,IAAI,YAAY,MAAM;CACjE,OAAO;EAAE;EAAc;EAAc,aAAa,eAAe;CAAa;AAChF;;;;;;;;AASA,SAAgB,gBACd,QACA,aAC+D;CAC/D,MAAM,wBAAQ,IAAI,IAAsB;CACxC,IAAI,cAAc;CAClB,KAAK,MAAM,SAAS,OAAO,OAAO;EAChC,MAAM,OAAO,cAAc,OAAO,WAAW;EAC7C,MAAM,IAAI,MAAM,MAAM,IAAI;EAC1B,eAAe,KAAK;CACtB;CACA,OAAO;EAAE;EAAO;CAAY;AAC9B"}

package/dist/src/services/toolCost/index.d.mts

@@ -0,0 +1,38 @@
+import { ToolEntry, ToolSource } from "../../../toolInventory.mjs";
+//#region src/services/toolCost/index.d.ts
+/**
+ * What one tool costs before anything is asked of it.
+ *
+ * A tool is sent to the model twice over. Its schema travels in the tool list,
+ * and its prose travels in the system prompt: Pi's `BuildSystemPromptOptions`
+ * takes `toolSnippets` keyed by tool name and `promptGuidelines` appended to the
+ * default guidelines, separately from the tools themselves. Pricing only the
+ * schema would undercount every tool that carries either, so the two are counted
+ * apart and reported together.
+ *
+ * The tokenizer is injected rather than imported, matching how MCP schema
+ * pricing already takes a `countTokens`. This module stays free of any opinion
+ * about which vocabulary the caller's model actually uses.
+ */
+export interface ToolCost {
+  /** The tool-list payload: name, description, and parameter schema. */
+  schemaTokens: number;
+  /** The system-prompt payload: snippet and guideline bullets. */
+  promptTokens: number;
+  totalTokens: number;
+}
+export type CountTokens = (text: string) => number;
+export declare function tokensForTool(entry: ToolEntry, countTokens: CountTokens): ToolCost;
+/**
+ * Every tool in a source, and what the source costs in total.
+ *
+ * An inactive tool is still priced: it is in the composition, and the point of
+ * the figure is to show what the composition costs. Whether the model may call
+ * it is a separate question from whether it is being paid for.
+ */
+export declare function tokensForSource(source: ToolSource, countTokens: CountTokens): {
+  tools: ReadonlyMap<string, ToolCost>;
+  totalTokens: number;
+};
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/toolCost/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/toolCost/index.ts"],"mappings":";;;;;;;;;;;;;;;;iBAgBiB;;EAEf;;EAEA;EACA;;YAGU,eAAe;wBAeX,cAAc,OAAO,WAAW,aAAa,cAAc;;;;;;;;wBAc3D,gBACd,QAAQ,YACR,aAAa;EACV,OAAO,oBAAoB;EAAW"}

package/dist/src/services/toolCost/index.mjs

@@ -0,0 +1,46 @@
+//#region src/services/toolCost/index.ts
+/** Mirrors the wire shape MCP advertises, so both estimates stay comparable. */
+function schemaPayload(entry) {
+	return JSON.stringify({
+		name: entry.name,
+		...entry.description === void 0 ? {} : { description: entry.description },
+		...entry.parameters === void 0 ? {} : { parameters: entry.parameters }
+	});
+}
+function promptPayload(entry) {
+	return [entry.promptSnippet ?? "", ...entry.promptGuidelines ?? []].filter(Boolean).join("\n");
+}
+function tokensForTool(entry, countTokens) {
+	const schemaTokens = countTokens(schemaPayload(entry));
+	const prompt = promptPayload(entry);
+	const promptTokens = prompt.length === 0 ? 0 : countTokens(prompt);
+	return {
+		schemaTokens,
+		promptTokens,
+		totalTokens: schemaTokens + promptTokens
+	};
+}
+/**
+* Every tool in a source, and what the source costs in total.
+*
+* An inactive tool is still priced: it is in the composition, and the point of
+* the figure is to show what the composition costs. Whether the model may call
+* it is a separate question from whether it is being paid for.
+*/
+function tokensForSource(source, countTokens) {
+	const tools = /* @__PURE__ */ new Map();
+	let totalTokens = 0;
+	for (const entry of source.tools) {
+		const cost = tokensForTool(entry, countTokens);
+		tools.set(entry.name, cost);
+		totalTokens += cost.totalTokens;
+	}
+	return {
+		tools,
+		totalTokens
+	};
+}
+//#endregion
+export { tokensForSource, tokensForTool };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/toolCost/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/toolCost/index.ts"],"sourcesContent":["import type { ToolEntry, ToolSource } from '../toolInventory';\n\n/**\n * What one tool costs before anything is asked of it.\n *\n * A tool is sent to the model twice over. Its schema travels in the tool list,\n * and its prose travels in the system prompt: Pi's `BuildSystemPromptOptions`\n * takes `toolSnippets` keyed by tool name and `promptGuidelines` appended to the\n * default guidelines, separately from the tools themselves. Pricing only the\n * schema would undercount every tool that carries either, so the two are counted\n * apart and reported together.\n *\n * The tokenizer is injected rather than imported, matching how MCP schema\n * pricing already takes a `countTokens`. This module stays free of any opinion\n * about which vocabulary the caller's model actually uses.\n */\nexport interface ToolCost {\n  /** The tool-list payload: name, description, and parameter schema. */\n  schemaTokens: number;\n  /** The system-prompt payload: snippet and guideline bullets. */\n  promptTokens: number;\n  totalTokens: number;\n}\n\nexport type CountTokens = (text: string) => number;\n\n/** Mirrors the wire shape MCP advertises, so both estimates stay comparable. */\nfunction schemaPayload(entry: ToolEntry): string {\n  return JSON.stringify({\n    name: entry.name,\n    ...(entry.description === undefined ? {} : { description: entry.description }),\n    ...(entry.parameters === undefined ? {} : { parameters: entry.parameters }),\n  });\n}\n\nfunction promptPayload(entry: ToolEntry): string {\n  return [entry.promptSnippet ?? '', ...(entry.promptGuidelines ?? [])].filter(Boolean).join('\\n');\n}\n\nexport function tokensForTool(entry: ToolEntry, countTokens: CountTokens): ToolCost {\n  const schemaTokens = countTokens(schemaPayload(entry));\n  const prompt = promptPayload(entry);\n  const promptTokens = prompt.length === 0 ? 0 : countTokens(prompt);\n  return { schemaTokens, promptTokens, totalTokens: schemaTokens + promptTokens };\n}\n\n/**\n * Every tool in a source, and what the source costs in total.\n *\n * An inactive tool is still priced: it is in the composition, and the point of\n * the figure is to show what the composition costs. Whether the model may call\n * it is a separate question from whether it is being paid for.\n */\nexport function tokensForSource(\n  source: ToolSource,\n  countTokens: CountTokens,\n): { tools: ReadonlyMap<string, ToolCost>; totalTokens: number } {\n  const tools = new Map<string, ToolCost>();\n  let totalTokens = 0;\n  for (const entry of source.tools) {\n    const cost = tokensForTool(entry, countTokens);\n    tools.set(entry.name, cost);\n    totalTokens += cost.totalTokens;\n  }\n  return { tools, totalTokens };\n}\n"],"mappings":";;AA2BA,SAAS,cAAc,OAA0B;CAC/C,OAAO,KAAK,UAAU;EACpB,MAAM,MAAM;EACZ,GAAI,MAAM,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;EAC5E,GAAI,MAAM,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,MAAM,WAAW;CAC3E,CAAC;AACH;AAEA,SAAS,cAAc,OAA0B;CAC/C,OAAO,CAAC,MAAM,iBAAiB,IAAI,GAAI,MAAM,oBAAoB,CAAC,CAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;AACjG;AAEA,SAAgB,cAAc,OAAkB,aAAoC;CAClF,MAAM,eAAe,YAAY,cAAc,KAAK,CAAC;CACrD,MAAM,SAAS,cAAc,KAAK;CAClC,MAAM,eAAe,OAAO,WAAW,IAAI,IAAI,YAAY,MAAM;CACjE,OAAO;EAAE;EAAc;EAAc,aAAa,eAAe;CAAa;AAChF;;;;;;;;AASA,SAAgB,gBACd,QACA,aAC+D;CAC/D,MAAM,wBAAQ,IAAI,IAAsB;CACxC,IAAI,cAAc;CAClB,KAAK,MAAM,SAAS,OAAO,OAAO;EAChC,MAAM,OAAO,cAAc,OAAO,WAAW;EAC7C,MAAM,IAAI,MAAM,MAAM,IAAI;EAC1B,eAAe,KAAK;CACtB;CACA,OAAO;EAAE;EAAO;CAAY;AAC9B"}

package/dist/src/services/toolOverrides/index.cjs

@@ -0,0 +1,45 @@
+//#region src/services/toolOverrides/index.ts
+function assertNonEmpty(value, field) {
+	if (value.trim().length === 0) throw new Error(`Doom tool override ${field} must not be empty.`);
+}
+/** Creates the host-owned tool replacement registry for one Doom runtime. */
+function createDoomToolOverridesService(generation) {
+	if (!generation) throw new Error("Doom tool overrides require a runtime generation.");
+	const owners = /* @__PURE__ */ new Map();
+	return Object.freeze({
+		generation,
+		claim(claim) {
+			assertNonEmpty(claim.source, "source");
+			if (claim.tools.length === 0) throw new Error("Doom tool override tools must not be empty.");
+			for (const tool of claim.tools) assertNonEmpty(tool, "tool");
+			const tools = Object.freeze([...new Set(claim.tools)]);
+			if (tools.some((tool) => owners.has(tool))) return Object.freeze({
+				granted: false,
+				tools,
+				dispose: () => void 0
+			});
+			const stored = Object.freeze({
+				source: claim.source,
+				tools
+			});
+			for (const tool of tools) owners.set(tool, stored);
+			let disposed = false;
+			return Object.freeze({
+				granted: true,
+				tools,
+				dispose() {
+					if (disposed) return;
+					disposed = true;
+					for (const tool of tools) if (owners.get(tool) === stored) owners.delete(tool);
+				}
+			});
+		},
+		owner(tool) {
+			return owners.get(tool)?.source;
+		}
+	});
+}
+//#endregion
+exports.createDoomToolOverridesService = createDoomToolOverridesService;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/toolOverrides/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/toolOverrides/index.ts"],"sourcesContent":["import type {\n  DoomToolOverrideClaim,\n  DoomToolOverrideRegistration,\n  DoomToolOverridesService,\n} from '../../schemas/toolOverrides';\n\ninterface StoredClaim {\n  readonly source: string;\n  readonly tools: readonly string[];\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Doom tool override ${field} must not be empty.`);\n}\n\n/** Creates the host-owned tool replacement registry for one Doom runtime. */\nexport function createDoomToolOverridesService(generation: string): DoomToolOverridesService {\n  if (!generation) throw new Error('Doom tool overrides require a runtime generation.');\n\n  const owners = new Map<string, StoredClaim>();\n  return Object.freeze({\n    generation,\n    claim(claim: DoomToolOverrideClaim): DoomToolOverrideRegistration {\n      assertNonEmpty(claim.source, 'source');\n      if (claim.tools.length === 0) throw new Error('Doom tool override tools must not be empty.');\n      for (const tool of claim.tools) assertNonEmpty(tool, 'tool');\n\n      const tools = Object.freeze([...new Set(claim.tools)]);\n      if (tools.some((tool) => owners.has(tool))) {\n        return Object.freeze({ granted: false, tools, dispose: (): void => undefined });\n      }\n\n      const stored: StoredClaim = Object.freeze({ source: claim.source, tools });\n      for (const tool of tools) owners.set(tool, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        granted: true,\n        tools,\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          for (const tool of tools) {\n            if (owners.get(tool) === stored) owners.delete(tool);\n          }\n        },\n      });\n    },\n    owner(tool: string): string | undefined {\n      return owners.get(tool)?.source;\n    },\n  });\n}\n"],"mappings":";AAWA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,sBAAsB,MAAM,oBAAoB;AACjG;;AAGA,SAAgB,+BAA+B,YAA8C;CAC3F,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,mDAAmD;CAEpF,MAAM,yBAAS,IAAI,IAAyB;CAC5C,OAAO,OAAO,OAAO;EACnB;EACA,MAAM,OAA4D;GAChE,eAAe,MAAM,QAAQ,QAAQ;GACrC,IAAI,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,MAAM,6CAA6C;GAC3F,KAAK,MAAM,QAAQ,MAAM,OAAO,eAAe,MAAM,MAAM;GAE3D,MAAM,QAAQ,OAAO,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,CAAC,CAAC;GACrD,IAAI,MAAM,MAAM,SAAS,OAAO,IAAI,IAAI,CAAC,GACvC,OAAO,OAAO,OAAO;IAAE,SAAS;IAAO;IAAO,eAAqB,KAAA;GAAU,CAAC;GAGhF,MAAM,SAAsB,OAAO,OAAO;IAAE,QAAQ,MAAM;IAAQ;GAAM,CAAC;GACzE,KAAK,MAAM,QAAQ,OAAO,OAAO,IAAI,MAAM,MAAM;GAEjD,IAAI,WAAW;GACf,OAAO,OAAO,OAAO;IACnB,SAAS;IACT;IACA,UAAgB;KACd,IAAI,UAAU;KACd,WAAW;KACX,KAAK,MAAM,QAAQ,OACjB,IAAI,OAAO,IAAI,IAAI,MAAM,QAAQ,OAAO,OAAO,IAAI;IAEvD;GACF,CAAC;EACH;EACA,MAAM,MAAkC;GACtC,OAAO,OAAO,IAAI,IAAI,CAAC,EAAE;EAC3B;CACF,CAAC;AACH"}

package/dist/src/services/toolOverrides/index.d.mts

@@ -0,0 +1,6 @@
+import { DoomToolOverridesService } from "../../schemas/toolOverrides.mjs";
+//#region src/services/toolOverrides/index.d.ts
+/** Creates the host-owned tool replacement registry for one Doom runtime. */
+export declare function createDoomToolOverridesService(generation: string): DoomToolOverridesService;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/toolOverrides/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/toolOverrides/index.ts"],"mappings":";;;wBAgBgB,+BAA+B,qBAAqB"}

package/dist/src/services/toolOverrides/index.mjs

@@ -0,0 +1,45 @@
+//#region src/services/toolOverrides/index.ts
+function assertNonEmpty(value, field) {
+	if (value.trim().length === 0) throw new Error(`Doom tool override ${field} must not be empty.`);
+}
+/** Creates the host-owned tool replacement registry for one Doom runtime. */
+function createDoomToolOverridesService(generation) {
+	if (!generation) throw new Error("Doom tool overrides require a runtime generation.");
+	const owners = /* @__PURE__ */ new Map();
+	return Object.freeze({
+		generation,
+		claim(claim) {
+			assertNonEmpty(claim.source, "source");
+			if (claim.tools.length === 0) throw new Error("Doom tool override tools must not be empty.");
+			for (const tool of claim.tools) assertNonEmpty(tool, "tool");
+			const tools = Object.freeze([...new Set(claim.tools)]);
+			if (tools.some((tool) => owners.has(tool))) return Object.freeze({
+				granted: false,
+				tools,
+				dispose: () => void 0
+			});
+			const stored = Object.freeze({
+				source: claim.source,
+				tools
+			});
+			for (const tool of tools) owners.set(tool, stored);
+			let disposed = false;
+			return Object.freeze({
+				granted: true,
+				tools,
+				dispose() {
+					if (disposed) return;
+					disposed = true;
+					for (const tool of tools) if (owners.get(tool) === stored) owners.delete(tool);
+				}
+			});
+		},
+		owner(tool) {
+			return owners.get(tool)?.source;
+		}
+	});
+}
+//#endregion
+export { createDoomToolOverridesService };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/toolOverrides/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/toolOverrides/index.ts"],"sourcesContent":["import type {\n  DoomToolOverrideClaim,\n  DoomToolOverrideRegistration,\n  DoomToolOverridesService,\n} from '../../schemas/toolOverrides';\n\ninterface StoredClaim {\n  readonly source: string;\n  readonly tools: readonly string[];\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (value.trim().length === 0) throw new Error(`Doom tool override ${field} must not be empty.`);\n}\n\n/** Creates the host-owned tool replacement registry for one Doom runtime. */\nexport function createDoomToolOverridesService(generation: string): DoomToolOverridesService {\n  if (!generation) throw new Error('Doom tool overrides require a runtime generation.');\n\n  const owners = new Map<string, StoredClaim>();\n  return Object.freeze({\n    generation,\n    claim(claim: DoomToolOverrideClaim): DoomToolOverrideRegistration {\n      assertNonEmpty(claim.source, 'source');\n      if (claim.tools.length === 0) throw new Error('Doom tool override tools must not be empty.');\n      for (const tool of claim.tools) assertNonEmpty(tool, 'tool');\n\n      const tools = Object.freeze([...new Set(claim.tools)]);\n      if (tools.some((tool) => owners.has(tool))) {\n        return Object.freeze({ granted: false, tools, dispose: (): void => undefined });\n      }\n\n      const stored: StoredClaim = Object.freeze({ source: claim.source, tools });\n      for (const tool of tools) owners.set(tool, stored);\n\n      let disposed = false;\n      return Object.freeze({\n        granted: true,\n        tools,\n        dispose(): void {\n          if (disposed) return;\n          disposed = true;\n          for (const tool of tools) {\n            if (owners.get(tool) === stored) owners.delete(tool);\n          }\n        },\n      });\n    },\n    owner(tool: string): string | undefined {\n      return owners.get(tool)?.source;\n    },\n  });\n}\n"],"mappings":";AAWA,SAAS,eAAe,OAAe,OAAqB;CAC1D,IAAI,MAAM,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,IAAI,MAAM,sBAAsB,MAAM,oBAAoB;AACjG;;AAGA,SAAgB,+BAA+B,YAA8C;CAC3F,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,mDAAmD;CAEpF,MAAM,yBAAS,IAAI,IAAyB;CAC5C,OAAO,OAAO,OAAO;EACnB;EACA,MAAM,OAA4D;GAChE,eAAe,MAAM,QAAQ,QAAQ;GACrC,IAAI,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,MAAM,6CAA6C;GAC3F,KAAK,MAAM,QAAQ,MAAM,OAAO,eAAe,MAAM,MAAM;GAE3D,MAAM,QAAQ,OAAO,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,CAAC,CAAC;GACrD,IAAI,MAAM,MAAM,SAAS,OAAO,IAAI,IAAI,CAAC,GACvC,OAAO,OAAO,OAAO;IAAE,SAAS;IAAO;IAAO,eAAqB,KAAA;GAAU,CAAC;GAGhF,MAAM,SAAsB,OAAO,OAAO;IAAE,QAAQ,MAAM;IAAQ;GAAM,CAAC;GACzE,KAAK,MAAM,QAAQ,OAAO,OAAO,IAAI,MAAM,MAAM;GAEjD,IAAI,WAAW;GACf,OAAO,OAAO,OAAO;IACnB,SAAS;IACT;IACA,UAAgB;KACd,IAAI,UAAU;KACd,WAAW;KACX,KAAK,MAAM,QAAQ,OACjB,IAAI,OAAO,IAAI,IAAI,MAAM,QAAQ,OAAO,OAAO,IAAI;IAEvD;GACF,CAAC;EACH;EACA,MAAM,MAAkC;GACtC,OAAO,OAAO,IAAI,IAAI,CAAC,EAAE;EAC3B;CACF,CAAC;AACH"}

package/dist/src/services/toolPrompt/index.cjs

@@ -0,0 +1,13 @@
+//#region src/services/toolPrompt/index.ts
+function formatToolPrompt(entries) {
+	const listed = entries.filter((entry) => (entry.promptSnippet ?? "").trim().length > 0);
+	const guidelines = [...new Set(entries.flatMap((entry) => entry.promptGuidelines ?? []).filter((line) => line.trim().length > 0))];
+	const sections = [];
+	if (listed.length > 0) sections.push(`Available tools:\n${listed.map((entry) => `- ${entry.name}: ${entry.promptSnippet}`).join("\n")}`);
+	if (guidelines.length > 0) sections.push(`Guidelines:\n${guidelines.map((line) => `- ${line}`).join("\n")}`);
+	return sections.join("\n\n");
+}
+//#endregion
+exports.formatToolPrompt = formatToolPrompt;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/toolPrompt/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/toolPrompt/index.ts"],"sourcesContent":["/**\n * The system-prompt block describing the tools a session currently exposes.\n *\n * Pi's CLI builds this from each tool's `promptSnippet` and `promptGuidelines`.\n * The headless host does not run that builder, so a tool's guidance reached the\n * cost estimate in `toolCost` but never the model. This renders the same two\n * sections, in Pi's shape, from whatever the host has just applied.\n */\n\nexport interface ToolPromptEntry {\n  readonly name: string;\n  /** One line describing the tool. Pi omits a tool without one, and so does this. */\n  readonly promptSnippet?: string;\n  readonly promptGuidelines?: readonly string[];\n}\n\nexport function formatToolPrompt(entries: readonly ToolPromptEntry[]): string {\n  const listed = entries.filter((entry) => (entry.promptSnippet ?? '').trim().length > 0);\n  // Two tools may repeat one guideline, and the reader should see it once.\n  const guidelines = [\n    ...new Set(entries.flatMap((entry) => entry.promptGuidelines ?? []).filter((line) => line.trim().length > 0)),\n  ];\n  const sections: string[] = [];\n  if (listed.length > 0) {\n    sections.push(`Available tools:\\n${listed.map((entry) => `- ${entry.name}: ${entry.promptSnippet!}`).join('\\n')}`);\n  }\n  if (guidelines.length > 0) {\n    sections.push(`Guidelines:\\n${guidelines.map((line) => `- ${line}`).join('\\n')}`);\n  }\n  return sections.join('\\n\\n');\n}\n"],"mappings":";AAgBA,SAAgB,iBAAiB,SAA6C;CAC5E,MAAM,SAAS,QAAQ,QAAQ,WAAW,MAAM,iBAAiB,GAAA,CAAI,KAAK,CAAC,CAAC,SAAS,CAAC;CAEtF,MAAM,aAAa,CACjB,GAAG,IAAI,IAAI,QAAQ,SAAS,UAAU,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,SAAS,KAAK,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAC9G;CACA,MAAM,WAAqB,CAAC;CAC5B,IAAI,OAAO,SAAS,GAClB,SAAS,KAAK,qBAAqB,OAAO,KAAK,UAAU,KAAK,MAAM,KAAK,IAAI,MAAM,eAAgB,CAAC,CAAC,KAAK,IAAI,GAAG;CAEnH,IAAI,WAAW,SAAS,GACtB,SAAS,KAAK,gBAAgB,WAAW,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG;CAElF,OAAO,SAAS,KAAK,MAAM;AAC7B"}

package/dist/src/services/toolPrompt/index.mjs

@@ -0,0 +1,13 @@
+//#region src/services/toolPrompt/index.ts
+function formatToolPrompt(entries) {
+	const listed = entries.filter((entry) => (entry.promptSnippet ?? "").trim().length > 0);
+	const guidelines = [...new Set(entries.flatMap((entry) => entry.promptGuidelines ?? []).filter((line) => line.trim().length > 0))];
+	const sections = [];
+	if (listed.length > 0) sections.push(`Available tools:\n${listed.map((entry) => `- ${entry.name}: ${entry.promptSnippet}`).join("\n")}`);
+	if (guidelines.length > 0) sections.push(`Guidelines:\n${guidelines.map((line) => `- ${line}`).join("\n")}`);
+	return sections.join("\n\n");
+}
+//#endregion
+export { formatToolPrompt };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/toolPrompt/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/toolPrompt/index.ts"],"sourcesContent":["/**\n * The system-prompt block describing the tools a session currently exposes.\n *\n * Pi's CLI builds this from each tool's `promptSnippet` and `promptGuidelines`.\n * The headless host does not run that builder, so a tool's guidance reached the\n * cost estimate in `toolCost` but never the model. This renders the same two\n * sections, in Pi's shape, from whatever the host has just applied.\n */\n\nexport interface ToolPromptEntry {\n  readonly name: string;\n  /** One line describing the tool. Pi omits a tool without one, and so does this. */\n  readonly promptSnippet?: string;\n  readonly promptGuidelines?: readonly string[];\n}\n\nexport function formatToolPrompt(entries: readonly ToolPromptEntry[]): string {\n  const listed = entries.filter((entry) => (entry.promptSnippet ?? '').trim().length > 0);\n  // Two tools may repeat one guideline, and the reader should see it once.\n  const guidelines = [\n    ...new Set(entries.flatMap((entry) => entry.promptGuidelines ?? []).filter((line) => line.trim().length > 0)),\n  ];\n  const sections: string[] = [];\n  if (listed.length > 0) {\n    sections.push(`Available tools:\\n${listed.map((entry) => `- ${entry.name}: ${entry.promptSnippet!}`).join('\\n')}`);\n  }\n  if (guidelines.length > 0) {\n    sections.push(`Guidelines:\\n${guidelines.map((line) => `- ${line}`).join('\\n')}`);\n  }\n  return sections.join('\\n\\n');\n}\n"],"mappings":";AAgBA,SAAgB,iBAAiB,SAA6C;CAC5E,MAAM,SAAS,QAAQ,QAAQ,WAAW,MAAM,iBAAiB,GAAA,CAAI,KAAK,CAAC,CAAC,SAAS,CAAC;CAEtF,MAAM,aAAa,CACjB,GAAG,IAAI,IAAI,QAAQ,SAAS,UAAU,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,SAAS,KAAK,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAC9G;CACA,MAAM,WAAqB,CAAC;CAC5B,IAAI,OAAO,SAAS,GAClB,SAAS,KAAK,qBAAqB,OAAO,KAAK,UAAU,KAAK,MAAM,KAAK,IAAI,MAAM,eAAgB,CAAC,CAAC,KAAK,IAAI,GAAG;CAEnH,IAAI,WAAW,SAAS,GACtB,SAAS,KAAK,gBAAgB,WAAW,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,KAAK,IAAI,GAAG;CAElF,OAAO,SAAS,KAAK,MAAM;AAC7B"}