@agimon-ai/po-core 0.0.0-alpha.0

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

@@ -0,0 +1,92 @@
+import { DURABLE_BACKGROUND_CONTEXT, DURABLE_DIRECTORY, SessionIdentityDoc, SessionMetadataDoc, openReadOnlyDurableStorage } from "../../../sqliteSessionStorage.mjs";
+import path from "node:path";
+import fs from "node:fs/promises";
+import { createSession } from "@earendil-works/pi-durable";
+//#region src/services/sqliteSessionHistory/index.ts
+function readSavedExecution(raw, owner) {
+	if (typeof raw !== "string") return void 0;
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	if (typeof record.cwd !== "string" || !path.isAbsolute(record.cwd) || typeof record.repoRoot !== "string" || !path.isAbsolute(record.repoRoot) || record.repoRoot !== owner || typeof record.workspaceId !== "string" || record.workspaceId === "" || typeof record.groupingRoot !== "string" || !path.isAbsolute(record.groupingRoot)) return void 0;
+	if (record.parentSessionId !== void 0 && typeof record.parentSessionId !== "string") return void 0;
+	if (record.sessionProvenance !== void 0 && typeof record.sessionProvenance !== "string") return void 0;
+	return {
+		cwd: record.cwd,
+		repoRoot: record.repoRoot,
+		workspaceId: record.workspaceId,
+		groupingRoot: record.groupingRoot,
+		...typeof record.parentSessionId === "string" ? { parentSessionId: record.parentSessionId } : {},
+		...typeof record.sessionProvenance === "string" ? { sessionProvenance: record.sessionProvenance } : {}
+	};
+}
+/** Lists only fresh durable containers, never legacy journals. */
+async function listSavedSessionRecords(sessionsRoot, workspaceRoot, activeSessionIds, workspaceId) {
+	const directory = path.join(sessionsRoot, DURABLE_DIRECTORY);
+	const files = await fs.readdir(directory).catch((error) => {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	});
+	const result = [];
+	for (const file of files) {
+		if (!/^[a-zA-Z0-9_-]+\.sqlite$/u.test(file)) continue;
+		const id = path.basename(file, ".sqlite");
+		if (activeSessionIds.has(id)) continue;
+		const filePath = path.join(directory, file);
+		const storage = await openReadOnlyDurableStorage(filePath);
+		const session = createSession(storage);
+		try {
+			const identity = await session.snapshot(SessionIdentityDoc, DURABLE_BACKGROUND_CONTEXT);
+			if (!identity || identity.id !== id) throw new Error("Durable session identity mismatch");
+			const metadata = await session.snapshot(SessionMetadataDoc, DURABLE_BACKGROUND_CONTEXT);
+			if (!metadata?.workspaceRoot) continue;
+			const execution = readSavedExecution(metadata.execution, metadata.workspaceRoot);
+			if (!execution || execution.groupingRoot !== workspaceRoot || workspaceId && execution.workspaceId !== workspaceId) continue;
+			const entries = /* @__PURE__ */ new Map();
+			let conversationCursor;
+			do {
+				const conversations = await storage.scanConversations({}, 100, conversationCursor, DURABLE_BACKGROUND_CONTEXT);
+				for (const conversation of conversations.items) {
+					let cursor;
+					do {
+						const page = await storage.scanEntries({ conversationId: conversation.id }, 100, cursor, DURABLE_BACKGROUND_CONTEXT);
+						for (const entry of page.items) entries.set(entry.id, entry);
+						cursor = page.next;
+					} while (cursor);
+				}
+				conversationCursor = conversations.next;
+			} while (conversationCursor);
+			const messages = [...entries.values()].sort((a, b) => a.id - b.id).flatMap((entry) => entry.model ?? []);
+			const content = messages.find((message) => message.role === "user")?.content;
+			const firstMessage = typeof content === "string" ? content : Array.isArray(content) ? content.filter((part) => part.type === "text").map((part) => part.text).join("\n") : "";
+			const stat = await fs.stat(filePath);
+			result.push({
+				summary: {
+					id,
+					...metadata.name ? { name: metadata.name } : {},
+					firstMessage,
+					createdAt: new Date(identity.createdAt).toISOString(),
+					updatedAt: stat.mtime.toISOString(),
+					messageCount: messages.length
+				},
+				execution
+			});
+		} finally {
+			await session.close(DURABLE_BACKGROUND_CONTEXT);
+		}
+	}
+	return result.sort((a, b) => b.summary.updatedAt.localeCompare(a.summary.updatedAt));
+}
+/** Public summaries do not expose private execution metadata. */
+async function listSavedSessions(sessionsRoot, workspaceRoot, activeSessionIds, workspaceId) {
+	return (await listSavedSessionRecords(sessionsRoot, workspaceRoot, activeSessionIds, workspaceId)).map((record) => record.summary);
+}
+//#endregion
+export { listSavedSessionRecords, listSavedSessions, readSavedExecution };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["context"],"sources":["../../../../src/services/sqliteSessionHistory/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createSession, type Cursor, type EntryRecord } from '@earendil-works/pi-durable';\n\nimport {\n  DURABLE_DIRECTORY,\n  DURABLE_BACKGROUND_CONTEXT as context,\n  SessionIdentityDoc,\n  SessionMetadataDoc,\n  openReadOnlyDurableStorage,\n} from '../sqliteSessionStorage';\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}\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  };\n}\n\n/** Lists only fresh durable containers, never legacy journals. */\nexport async function listSavedSessionRecords(\n  sessionsRoot: string,\n  workspaceRoot: string,\n  activeSessionIds: ReadonlySet<string>,\n  workspaceId?: string,\n): Promise<SavedSessionRecord[]> {\n  const directory = path.join(sessionsRoot, DURABLE_DIRECTORY);\n  const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n    if (error.code === 'ENOENT') return [];\n    throw error;\n  });\n  const result: SavedSessionRecord[] = [];\n  for (const file of files) {\n    if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n    const id = path.basename(file, '.sqlite');\n    if (activeSessionIds.has(id)) continue;\n    const filePath = path.join(directory, file);\n    const storage = await openReadOnlyDurableStorage(filePath);\n    const session = createSession(storage);\n    try {\n      const identity = await session.snapshot(SessionIdentityDoc, context);\n      if (!identity || identity.id !== id) throw new Error('Durable session identity mismatch');\n      const metadata = await session.snapshot(SessionMetadataDoc, context);\n      if (!metadata?.workspaceRoot) continue;\n      const execution = readSavedExecution(metadata.execution, metadata.workspaceRoot);\n      if (\n        !execution ||\n        execution.groupingRoot !== workspaceRoot ||\n        (workspaceId && execution.workspaceId !== workspaceId)\n      )\n        continue;\n      const entries = new Map<number, EntryRecord>();\n      let conversationCursor: Cursor | undefined;\n      do {\n        const conversations = await storage.scanConversations({}, 100, conversationCursor, context);\n        for (const conversation of conversations.items) {\n          let cursor: Cursor | undefined;\n          do {\n            const page = await storage.scanEntries({ conversationId: conversation.id }, 100, cursor, context);\n            for (const entry of page.items) entries.set(entry.id, entry);\n            cursor = page.next;\n          } while (cursor);\n        }\n        conversationCursor = conversations.next;\n      } while (conversationCursor);\n      const ordered = [...entries.values()].sort((a, b) => a.id - b.id);\n      const messages = ordered.flatMap((entry) => entry.model ?? []);\n      const content = messages.find((message) => message.role === 'user')?.content;\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      const stat = await fs.stat(filePath);\n      result.push({\n        summary: {\n          id,\n          ...(metadata.name ? { name: metadata.name } : {}),\n          firstMessage,\n          createdAt: new Date(identity.createdAt).toISOString(),\n          updatedAt: stat.mtime.toISOString(),\n          messageCount: messages.length,\n        },\n        execution,\n      });\n    } finally {\n      await session.close(context);\n    }\n  }\n  return result.sort((a, b) => b.summary.updatedAt.localeCompare(a.summary.updatedAt));\n}\n\n/** Public summaries do not expose private execution metadata. */\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,67 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_sqliteSessionStorage = require("../../../sqliteSessionStorage.cjs");
+const require_index = require("../sqliteSessionHistory/index.cjs");
+const require_index$1 = require("../durableNavigation/index.cjs");
+const require_index$2 = require("../transcriptPages/index.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _earendil_works_pi_durable = require("@earendil-works/pi-durable");
+//#region src/services/sqliteTranscriptReader/index.ts
+/** A completed child is read without admitting a writer or updating the schema. */
+async function readSqliteTranscript(file, request, context, ownership) {
+	if (node_path.default.basename(node_path.default.dirname(file)) !== "durable-v1") throw new Error("Legacy SQLite transcripts are unsupported");
+	const storage = await require_sqliteSessionStorage.openReadOnlyDurableStorage(file);
+	const session = (0, _earendil_works_pi_durable.createSession)(storage);
+	try {
+		const identity = await session.snapshot(require_sqliteSessionStorage.SessionIdentityDoc, context);
+		if (!identity || identity.id !== node_path.default.basename(file, ".sqlite") || ownership && identity.id !== ownership.sessionId) throw new Error("Saved transcript does not belong to this session");
+		if (ownership) {
+			const metadata = await session.snapshot(require_sqliteSessionStorage.SessionMetadataDoc, context);
+			const execution = require_index.readSavedExecution(metadata?.execution, ownership.workspaceRoot);
+			if (metadata?.workspaceRoot !== ownership.workspaceRoot || !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 conversationId = (await session.snapshot(require_index$1.DurableNavigationDoc, context))?.activeConversationId;
+		const raw = [];
+		if (conversationId !== null && conversationId !== void 0) {
+			let cursor;
+			do {
+				const page = await storage.scanEntries({ conversationId }, 100, cursor, context);
+				raw.push(...page.items);
+				cursor = page.next;
+			} while (cursor);
+		}
+		const entries = require_index$2.projectDurableEntries(raw.reverse());
+		const tip = entries.at(-1)?.id ?? null;
+		const laneName = (await session.snapshot(require_sqliteSessionStorage.SessionMetadataDoc, context))?.laneName ?? "main";
+		return {
+			...await require_index$2.readTranscriptPage({
+				sessionId: identity.id,
+				laneName,
+				lane: {
+					getTipId: async () => tip,
+					findEntries: async (query) => {
+						let rows = entries;
+						if (query.start) {
+							const index = rows.findIndex((entry) => entry.id === query.start);
+							if (index < 0) throw new Error("Transcript references missing entry");
+							rows = rows.slice(0, index + 1);
+						}
+						if (query.cursor) rows = rows.filter((entry) => query.order === "oldestFirst" ? entry.seq > query.cursor.seq : entry.seq < query.cursor.seq);
+						if (query.type) rows = rows.filter((entry) => entry.type === query.type);
+						if (query.customType) rows = rows.filter((entry) => entry.type === "custom" && entry.customType === query.customType);
+						if (query.order !== "oldestFirst") rows = [...rows].reverse();
+						return rows.slice(0, query.limit);
+					}
+				}
+			}, request, 0, context),
+			revision: 0,
+			drafts: []
+		};
+	} finally {
+		await session.close(context);
+	}
+}
+//#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":["path","openReadOnlyDurableStorage","createSession","SessionIdentityDoc","SessionMetadataDoc","readSavedExecution","DurableNavigationDoc","projectDurableEntries","readTranscriptPage"],"sources":["../../../../src/services/sqliteTranscriptReader/index.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { createSession, type Cursor, type EntryRecord } from '@earendil-works/pi-durable';\n\nimport type { TranscriptPageRequest, TranscriptPage } from '../../exports/sessionProtocol';\nimport { DurableNavigationDoc } from '../durableNavigation';\nimport { readSavedExecution } from '../sqliteSessionHistory';\nimport {\n  DURABLE_DIRECTORY,\n  SessionIdentityDoc,\n  SessionMetadataDoc,\n  openReadOnlyDurableStorage,\n} from '../sqliteSessionStorage';\nimport { projectDurableEntries, 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 without admitting a writer or updating the schema. */\nexport async function readSqliteTranscript(\n  file: string,\n  request: TranscriptPageRequest,\n  context: Context,\n  ownership?: SqliteTranscriptOwnership,\n): Promise<TranscriptPage> {\n  if (path.basename(path.dirname(file)) !== DURABLE_DIRECTORY)\n    throw new Error('Legacy SQLite transcripts are unsupported');\n  const storage = await openReadOnlyDurableStorage(file);\n  const session = createSession(storage);\n  try {\n    const identity = await session.snapshot(SessionIdentityDoc, context);\n    if (\n      !identity ||\n      identity.id !== path.basename(file, '.sqlite') ||\n      (ownership && identity.id !== ownership.sessionId)\n    )\n      throw new Error('Saved transcript does not belong to this session');\n    if (ownership) {\n      const metadata = await session.snapshot(SessionMetadataDoc, context);\n      const execution = readSavedExecution(metadata?.execution, ownership.workspaceRoot);\n      if (\n        metadata?.workspaceRoot !== ownership.workspaceRoot ||\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    const navigation = await session.snapshot(DurableNavigationDoc, context);\n    const conversationId = navigation?.activeConversationId;\n    const raw: EntryRecord[] = [];\n    if (conversationId !== null && conversationId !== undefined) {\n      let cursor: Cursor | undefined;\n      do {\n        const page = await storage.scanEntries({ conversationId }, 100, cursor, context);\n        raw.push(...page.items);\n        cursor = page.next;\n      } while (cursor);\n    }\n    const entries = projectDurableEntries(raw.reverse());\n    const tip = entries.at(-1)?.id ?? null;\n    const metadata = await session.snapshot(SessionMetadataDoc, context);\n    const laneName = metadata?.laneName ?? 'main';\n    const page = await readTranscriptPage(\n      {\n        sessionId: identity.id,\n        laneName,\n        lane: {\n          getTipId: async () => tip,\n          findEntries: async (query) => {\n            let rows = entries;\n            if (query.start) {\n              const index = rows.findIndex((entry) => entry.id === query.start);\n              if (index < 0) throw new Error('Transcript references missing entry');\n              rows = rows.slice(0, index + 1);\n            }\n            if (query.cursor)\n              rows = rows.filter((entry) =>\n                query.order === 'oldestFirst' ? entry.seq > query.cursor!.seq : entry.seq < query.cursor!.seq,\n              );\n            if (query.type) rows = rows.filter((entry) => entry.type === query.type);\n            if (query.customType)\n              rows = rows.filter((entry) => entry.type === 'custom' && entry.customType === query.customType);\n            if (query.order !== 'oldestFirst') rows = [...rows].reverse();\n            return rows.slice(0, query.limit);\n          },\n        },\n      },\n      request,\n      0,\n      context,\n    );\n    return { ...page, revision: 0, drafts: [] };\n  } finally {\n    await session.close(context);\n  }\n}\n"],"mappings":";;;;;;;;;;AAwBA,eAAsB,qBACpB,MACA,SACA,SACA,WACyB;CACzB,IAAIA,UAAAA,QAAK,SAASA,UAAAA,QAAK,QAAQ,IAAI,CAAC,MAAA,cAClC,MAAM,IAAI,MAAM,2CAA2C;CAC7D,MAAM,UAAU,MAAMC,6BAAAA,2BAA2B,IAAI;CACrD,MAAM,WAAA,GAAUC,2BAAAA,cAAAA,CAAc,OAAO;CACrC,IAAI;EACF,MAAM,WAAW,MAAM,QAAQ,SAASC,6BAAAA,oBAAoB,OAAO;EACnE,IACE,CAAC,YACD,SAAS,OAAOH,UAAAA,QAAK,SAAS,MAAM,SAAS,KAC5C,aAAa,SAAS,OAAO,UAAU,WAExC,MAAM,IAAI,MAAM,kDAAkD;EACpE,IAAI,WAAW;GACb,MAAM,WAAW,MAAM,QAAQ,SAASI,6BAAAA,oBAAoB,OAAO;GACnE,MAAM,YAAYC,cAAAA,mBAAmB,UAAU,WAAW,UAAU,aAAa;GACjF,IACE,UAAU,kBAAkB,UAAU,iBACtC,CAAC,aACA,UAAU,gBAAgB,KAAA,KAAa,UAAU,gBAAgB,UAAU,eAC3E,UAAU,iBAAiB,KAAA,KAAa,UAAU,iBAAiB,UAAU,cAE9E,MAAM,IAAI,MAAM,oDAAoD;EACxE;EAEA,MAAM,kBAAiB,MADE,QAAQ,SAASC,gBAAAA,sBAAsB,OAAO,EAAA,EACpC;EACnC,MAAM,MAAqB,CAAC;EAC5B,IAAI,mBAAmB,QAAQ,mBAAmB,KAAA,GAAW;GAC3D,IAAI;GACJ,GAAG;IACD,MAAM,OAAO,MAAM,QAAQ,YAAY,EAAE,eAAe,GAAG,KAAK,QAAQ,OAAO;IAC/E,IAAI,KAAK,GAAG,KAAK,KAAK;IACtB,SAAS,KAAK;GAChB,SAAS;EACX;EACA,MAAM,UAAUC,gBAAAA,sBAAsB,IAAI,QAAQ,CAAC;EACnD,MAAM,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,MAAM;EAElC,MAAM,YAAW,MADM,QAAQ,SAASH,6BAAAA,oBAAoB,OAAO,EAAA,EACxC,YAAY;EA8BvC,OAAO;GAAE,GAAG,MA7BOI,gBAAAA,mBACjB;IACE,WAAW,SAAS;IACpB;IACA,MAAM;KACJ,UAAU,YAAY;KACtB,aAAa,OAAO,UAAU;MAC5B,IAAI,OAAO;MACX,IAAI,MAAM,OAAO;OACf,MAAM,QAAQ,KAAK,WAAW,UAAU,MAAM,OAAO,MAAM,KAAK;OAChE,IAAI,QAAQ,GAAG,MAAM,IAAI,MAAM,qCAAqC;OACpE,OAAO,KAAK,MAAM,GAAG,QAAQ,CAAC;MAChC;MACA,IAAI,MAAM,QACR,OAAO,KAAK,QAAQ,UAClB,MAAM,UAAU,gBAAgB,MAAM,MAAM,MAAM,OAAQ,MAAM,MAAM,MAAM,MAAM,OAAQ,GAC5F;MACF,IAAI,MAAM,MAAM,OAAO,KAAK,QAAQ,UAAU,MAAM,SAAS,MAAM,IAAI;MACvE,IAAI,MAAM,YACR,OAAO,KAAK,QAAQ,UAAU,MAAM,SAAS,YAAY,MAAM,eAAe,MAAM,UAAU;MAChG,IAAI,MAAM,UAAU,eAAe,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ;MAC5D,OAAO,KAAK,MAAM,GAAG,MAAM,KAAK;KAClC;IACF;GACF,GACA,SACA,GACA,OACF;GACkB,UAAU;GAAG,QAAQ,CAAC;EAAE;CAC5C,UAAU;EACR,MAAM,QAAQ,MAAM,OAAO;CAC7B;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 without admitting a writer or updating the schema. */
+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":";;;;iBAgBiB;EACf;EACA;EACA;EACA;;;wBAIoB,qBACpB,cACA,SAAS,uBACT,SAAS,SACT,YAAY,4BACX,QAAQ"}

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

@@ -0,0 +1,65 @@
+import { SessionIdentityDoc, SessionMetadataDoc, openReadOnlyDurableStorage } from "../../../sqliteSessionStorage.mjs";
+import { readSavedExecution } from "../sqliteSessionHistory/index.mjs";
+import { DurableNavigationDoc } from "../durableNavigation/index.mjs";
+import { projectDurableEntries, readTranscriptPage } from "../transcriptPages/index.mjs";
+import path from "node:path";
+import { createSession } from "@earendil-works/pi-durable";
+//#region src/services/sqliteTranscriptReader/index.ts
+/** A completed child is read without admitting a writer or updating the schema. */
+async function readSqliteTranscript(file, request, context, ownership) {
+	if (path.basename(path.dirname(file)) !== "durable-v1") throw new Error("Legacy SQLite transcripts are unsupported");
+	const storage = await openReadOnlyDurableStorage(file);
+	const session = createSession(storage);
+	try {
+		const identity = await session.snapshot(SessionIdentityDoc, context);
+		if (!identity || identity.id !== path.basename(file, ".sqlite") || ownership && identity.id !== ownership.sessionId) throw new Error("Saved transcript does not belong to this session");
+		if (ownership) {
+			const metadata = await session.snapshot(SessionMetadataDoc, context);
+			const execution = readSavedExecution(metadata?.execution, ownership.workspaceRoot);
+			if (metadata?.workspaceRoot !== ownership.workspaceRoot || !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 conversationId = (await session.snapshot(DurableNavigationDoc, context))?.activeConversationId;
+		const raw = [];
+		if (conversationId !== null && conversationId !== void 0) {
+			let cursor;
+			do {
+				const page = await storage.scanEntries({ conversationId }, 100, cursor, context);
+				raw.push(...page.items);
+				cursor = page.next;
+			} while (cursor);
+		}
+		const entries = projectDurableEntries(raw.reverse());
+		const tip = entries.at(-1)?.id ?? null;
+		const laneName = (await session.snapshot(SessionMetadataDoc, context))?.laneName ?? "main";
+		return {
+			...await readTranscriptPage({
+				sessionId: identity.id,
+				laneName,
+				lane: {
+					getTipId: async () => tip,
+					findEntries: async (query) => {
+						let rows = entries;
+						if (query.start) {
+							const index = rows.findIndex((entry) => entry.id === query.start);
+							if (index < 0) throw new Error("Transcript references missing entry");
+							rows = rows.slice(0, index + 1);
+						}
+						if (query.cursor) rows = rows.filter((entry) => query.order === "oldestFirst" ? entry.seq > query.cursor.seq : entry.seq < query.cursor.seq);
+						if (query.type) rows = rows.filter((entry) => entry.type === query.type);
+						if (query.customType) rows = rows.filter((entry) => entry.type === "custom" && entry.customType === query.customType);
+						if (query.order !== "oldestFirst") rows = [...rows].reverse();
+						return rows.slice(0, query.limit);
+					}
+				}
+			}, request, 0, context),
+			revision: 0,
+			drafts: []
+		};
+	} finally {
+		await session.close(context);
+	}
+}
+//#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 path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { createSession, type Cursor, type EntryRecord } from '@earendil-works/pi-durable';\n\nimport type { TranscriptPageRequest, TranscriptPage } from '../../exports/sessionProtocol';\nimport { DurableNavigationDoc } from '../durableNavigation';\nimport { readSavedExecution } from '../sqliteSessionHistory';\nimport {\n  DURABLE_DIRECTORY,\n  SessionIdentityDoc,\n  SessionMetadataDoc,\n  openReadOnlyDurableStorage,\n} from '../sqliteSessionStorage';\nimport { projectDurableEntries, 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 without admitting a writer or updating the schema. */\nexport async function readSqliteTranscript(\n  file: string,\n  request: TranscriptPageRequest,\n  context: Context,\n  ownership?: SqliteTranscriptOwnership,\n): Promise<TranscriptPage> {\n  if (path.basename(path.dirname(file)) !== DURABLE_DIRECTORY)\n    throw new Error('Legacy SQLite transcripts are unsupported');\n  const storage = await openReadOnlyDurableStorage(file);\n  const session = createSession(storage);\n  try {\n    const identity = await session.snapshot(SessionIdentityDoc, context);\n    if (\n      !identity ||\n      identity.id !== path.basename(file, '.sqlite') ||\n      (ownership && identity.id !== ownership.sessionId)\n    )\n      throw new Error('Saved transcript does not belong to this session');\n    if (ownership) {\n      const metadata = await session.snapshot(SessionMetadataDoc, context);\n      const execution = readSavedExecution(metadata?.execution, ownership.workspaceRoot);\n      if (\n        metadata?.workspaceRoot !== ownership.workspaceRoot ||\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    const navigation = await session.snapshot(DurableNavigationDoc, context);\n    const conversationId = navigation?.activeConversationId;\n    const raw: EntryRecord[] = [];\n    if (conversationId !== null && conversationId !== undefined) {\n      let cursor: Cursor | undefined;\n      do {\n        const page = await storage.scanEntries({ conversationId }, 100, cursor, context);\n        raw.push(...page.items);\n        cursor = page.next;\n      } while (cursor);\n    }\n    const entries = projectDurableEntries(raw.reverse());\n    const tip = entries.at(-1)?.id ?? null;\n    const metadata = await session.snapshot(SessionMetadataDoc, context);\n    const laneName = metadata?.laneName ?? 'main';\n    const page = await readTranscriptPage(\n      {\n        sessionId: identity.id,\n        laneName,\n        lane: {\n          getTipId: async () => tip,\n          findEntries: async (query) => {\n            let rows = entries;\n            if (query.start) {\n              const index = rows.findIndex((entry) => entry.id === query.start);\n              if (index < 0) throw new Error('Transcript references missing entry');\n              rows = rows.slice(0, index + 1);\n            }\n            if (query.cursor)\n              rows = rows.filter((entry) =>\n                query.order === 'oldestFirst' ? entry.seq > query.cursor!.seq : entry.seq < query.cursor!.seq,\n              );\n            if (query.type) rows = rows.filter((entry) => entry.type === query.type);\n            if (query.customType)\n              rows = rows.filter((entry) => entry.type === 'custom' && entry.customType === query.customType);\n            if (query.order !== 'oldestFirst') rows = [...rows].reverse();\n            return rows.slice(0, query.limit);\n          },\n        },\n      },\n      request,\n      0,\n      context,\n    );\n    return { ...page, revision: 0, drafts: [] };\n  } finally {\n    await session.close(context);\n  }\n}\n"],"mappings":";;;;;;;;AAwBA,eAAsB,qBACpB,MACA,SACA,SACA,WACyB;CACzB,IAAI,KAAK,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAA,cAClC,MAAM,IAAI,MAAM,2CAA2C;CAC7D,MAAM,UAAU,MAAM,2BAA2B,IAAI;CACrD,MAAM,UAAU,cAAc,OAAO;CACrC,IAAI;EACF,MAAM,WAAW,MAAM,QAAQ,SAAS,oBAAoB,OAAO;EACnE,IACE,CAAC,YACD,SAAS,OAAO,KAAK,SAAS,MAAM,SAAS,KAC5C,aAAa,SAAS,OAAO,UAAU,WAExC,MAAM,IAAI,MAAM,kDAAkD;EACpE,IAAI,WAAW;GACb,MAAM,WAAW,MAAM,QAAQ,SAAS,oBAAoB,OAAO;GACnE,MAAM,YAAY,mBAAmB,UAAU,WAAW,UAAU,aAAa;GACjF,IACE,UAAU,kBAAkB,UAAU,iBACtC,CAAC,aACA,UAAU,gBAAgB,KAAA,KAAa,UAAU,gBAAgB,UAAU,eAC3E,UAAU,iBAAiB,KAAA,KAAa,UAAU,iBAAiB,UAAU,cAE9E,MAAM,IAAI,MAAM,oDAAoD;EACxE;EAEA,MAAM,kBAAiB,MADE,QAAQ,SAAS,sBAAsB,OAAO,EAAA,EACpC;EACnC,MAAM,MAAqB,CAAC;EAC5B,IAAI,mBAAmB,QAAQ,mBAAmB,KAAA,GAAW;GAC3D,IAAI;GACJ,GAAG;IACD,MAAM,OAAO,MAAM,QAAQ,YAAY,EAAE,eAAe,GAAG,KAAK,QAAQ,OAAO;IAC/E,IAAI,KAAK,GAAG,KAAK,KAAK;IACtB,SAAS,KAAK;GAChB,SAAS;EACX;EACA,MAAM,UAAU,sBAAsB,IAAI,QAAQ,CAAC;EACnD,MAAM,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,MAAM;EAElC,MAAM,YAAW,MADM,QAAQ,SAAS,oBAAoB,OAAO,EAAA,EACxC,YAAY;EA8BvC,OAAO;GAAE,GAAG,MA7BO,mBACjB;IACE,WAAW,SAAS;IACpB;IACA,MAAM;KACJ,UAAU,YAAY;KACtB,aAAa,OAAO,UAAU;MAC5B,IAAI,OAAO;MACX,IAAI,MAAM,OAAO;OACf,MAAM,QAAQ,KAAK,WAAW,UAAU,MAAM,OAAO,MAAM,KAAK;OAChE,IAAI,QAAQ,GAAG,MAAM,IAAI,MAAM,qCAAqC;OACpE,OAAO,KAAK,MAAM,GAAG,QAAQ,CAAC;MAChC;MACA,IAAI,MAAM,QACR,OAAO,KAAK,QAAQ,UAClB,MAAM,UAAU,gBAAgB,MAAM,MAAM,MAAM,OAAQ,MAAM,MAAM,MAAM,MAAM,OAAQ,GAC5F;MACF,IAAI,MAAM,MAAM,OAAO,KAAK,QAAQ,UAAU,MAAM,SAAS,MAAM,IAAI;MACvE,IAAI,MAAM,YACR,OAAO,KAAK,QAAQ,UAAU,MAAM,SAAS,YAAY,MAAM,eAAe,MAAM,UAAU;MAChG,IAAI,MAAM,UAAU,eAAe,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ;MAC5D,OAAO,KAAK,MAAM,GAAG,MAAM,KAAK;KAClC;IACF;GACF,GACA,SACA,GACA,OACF;GACkB,UAAU;GAAG,QAAQ,CAAC;EAAE;CAC5C,UAAU;EACR,MAAM,QAAQ,MAAM,OAAO;CAC7B;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"}