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

package/dist/terminalPiChildSessionService.mjs

@@ -0,0 +1,318 @@
+import { createDoomChildSessionService } from "./src/systems/child/services/childSession/index.mjs";
+import { createHistoryOwnership } from "./historyOwnership.mjs";
+import { openSqliteSessionStorage } from "./sqliteSessionStorage.mjs";
+import { DurableNavigationDoc } from "./src/services/durableNavigation/index.mjs";
+import { fromPiSessionEntry } from "./src/services/piSessionEntries/index.mjs";
+import { createDirectHarnessRuntime, promptForAssistantText } from "./src/server/directHarnessRuntime.mjs";
+import { registerNativeChild } from "./src/systems/child/adapters/nativeChildRuntimes.mjs";
+import { readNativeChildTranscript } from "./src/server/nativeChildTranscriptReader.mjs";
+import { bindChildHooks, bindChildMcpCatalog, composeDirectHarnessRequestOptions, createHeadlessChildSessionService, parseChildModelReference, resolveChildProviders } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { AgentDoc } from "@earendil-works/pi-durable";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+import { convertToLlm, getAgentDir, parseSessionEntries, sessionEntryToContextMessages } from "@earendil-works/pi-coding-agent";
+//#region src/systems/child/adapters/terminalPiChildSessionService.ts
+function childRuntime(runtime, intercom, release) {
+	const file = runtime.sessionFile;
+	return {
+		sessionId: runtime.sessionId,
+		...typeof file === "string" ? { sessionFile: file } : {},
+		...typeof file === "string" ? { readTranscriptPage: (request, signal) => readNativeChildTranscript(file, request, signal) } : {},
+		prompt: (task) => promptForAssistantText(runtime, task),
+		async steer(message) {
+			await runtime.submitInternalMessage(message, "steer");
+		},
+		async followUp(message) {
+			await runtime.submitInternalMessage(message, "followUp");
+		},
+		onUsage(listener) {
+			return runtime.onEvent((event) => {
+				if (event.type !== "usage") return;
+				listener({
+					rowId: event.row.id,
+					cost: event.row.usage.cost.total
+				});
+			});
+		},
+		abort: () => runtime.abort(),
+		dispose: async () => {
+			try {
+				await release?.();
+			} finally {
+				try {
+					await runtime.dispose();
+				} finally {
+					intercom?.dispose?.();
+				}
+			}
+		}
+	};
+}
+async function installIntercom(runtime, intercom, tools) {
+	if (!intercom) return;
+	const tool = intercom.bindRuntime(childRuntime(runtime));
+	const adapted = {
+		...tool,
+		parameters: tool.parameters,
+		execute: async (operationId, params, onUpdate, _toolContext, _invocation, context) => tool.execute(operationId, params, context.abortSignal ?? new AbortController().signal, onUpdate)
+	};
+	tools.push(adapted);
+	await runtime.replaceTools(tools);
+}
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function requireString(value, field) {
+	if (typeof value !== "string" || value.length === 0) throw new Error(`Invalid terminal Pi snapshot ${field}`);
+	return value;
+}
+function parseSnapshot(snapshotJsonl) {
+	if (!snapshotJsonl.endsWith("\n")) throw new Error("Terminal Pi snapshot is truncated.");
+	const lines = snapshotJsonl.slice(0, -1).split("\n");
+	let headerValue;
+	try {
+		headerValue = JSON.parse(lines[0] ?? "");
+	} catch (error) {
+		throw new Error("Malformed terminal Pi snapshot header.", { cause: error });
+	}
+	const header = asRecord(headerValue);
+	if (header?.type !== "session" || header.version !== 3) throw new Error("Terminal Pi child source must be a v3 JSONL snapshot.");
+	return {
+		header,
+		records: lines.slice(1).map((line, index) => {
+			let value;
+			try {
+				value = JSON.parse(line);
+			} catch (error) {
+				throw new Error(`Malformed terminal Pi snapshot record at line ${index + 2}.`, { cause: error });
+			}
+			const record = asRecord(value);
+			if (record === void 0) throw new Error(`Invalid terminal Pi snapshot record at line ${index + 2}`);
+			requireString(record.id, `record ${index + 2} id`);
+			if (record.parentId !== null && typeof record.parentId !== "string") throw new Error(`Invalid terminal Pi snapshot record ${index + 2} parentId`);
+			return record;
+		})
+	};
+}
+/** Capture data from Pi memory, not its writable v3 path. The JSONL string is immutable after return. */
+function captureTerminalPiForkSource(manager, selectedLeafId = manager.getLeafId()) {
+	const sourceSessionId = manager.getSessionId();
+	const sourceLeafId = selectedLeafId;
+	const header = manager.getHeader();
+	if (!sourceSessionId.trim() || !sourceLeafId || header?.type !== "session" || header.version !== 3) return void 0;
+	const branch = manager.getBranch(sourceLeafId);
+	if (branch.at(-1)?.id !== sourceLeafId) return void 0;
+	const snapshotJsonl = `${[header, ...branch].map((record) => JSON.stringify(record)).join("\n")}\n`;
+	return Object.freeze({
+		kind: "terminal-pi-fork",
+		sourceSessionId,
+		sourceLeafId,
+		snapshotJsonl
+	});
+}
+async function createChildJournal(request, source, options, ownership) {
+	const parsed = parseSnapshot(source.snapshotJsonl);
+	if (requireString(parsed.header.id, "header id") !== source.sourceSessionId) throw new Error("Terminal Pi snapshot session identity does not match its sourceSessionId.");
+	if (parsed.records.at(-1)?.id !== source.sourceLeafId) throw new Error("Terminal Pi snapshot leaf does not match its sourceLeafId.");
+	const records = parseSessionEntries(source.snapshotJsonl).filter((entry) => entry.type !== "session");
+	if (records.length !== parsed.records.length) throw new Error("Terminal Pi snapshot contains invalid entries");
+	const ids = /* @__PURE__ */ new Set();
+	let parent = null;
+	for (const record of records) {
+		if (record.parentId !== parent || ids.has(record.id)) throw new Error("Terminal Pi snapshot is not a selected branch");
+		ids.add(record.id);
+		parent = record.id;
+	}
+	const destination = await openSqliteSessionStorage({
+		sessionsRoot: path.resolve(options.sessionsRoot ?? path.join(getAgentDir(), "server", "sessions")),
+		sessionId: randomUUID(),
+		parentSessionId: request.parentSessionId || source.sourceSessionId,
+		historyOwnership: ownership
+	}, BACKGROUND_CONTEXT);
+	try {
+		await destination.session.commit(async (tx) => {
+			const conversation = await tx.createConversation({ ownership: { kind: "ownerless" } });
+			const mapped = /* @__PURE__ */ new Map();
+			for (const [index, record] of records.entries()) {
+				const tail = record.type === "compaction" ? records.slice(records.findIndex((entry) => entry.id === record.firstKeptEntryId), index).flatMap((entry) => sessionEntryToContextMessages(entry)) : [];
+				const model = convertToLlm([...sessionEntryToContextMessages(record), ...tail]);
+				const head = record.type === "compaction" ? mapped.get(record.firstKeptEntryId) : void 0;
+				if (record.type === "compaction" && head === void 0) throw new Error("Terminal Pi snapshot compaction boundary is absent");
+				const projected = record.type === "message" ? {
+					type: "message",
+					message: record.message,
+					timestamp: Date.parse(record.timestamp)
+				} : record.type === "compaction" ? {
+					type: "compaction",
+					summary: record.summary,
+					tokensBefore: record.tokensBefore,
+					retainedTail: tail,
+					fromHook: record.fromHook ?? false
+				} : record.type === "branch_summary" ? {
+					type: "branch_summary",
+					summary: record.summary,
+					fromId: record.fromId,
+					fromHook: record.fromHook ?? false
+				} : {
+					type: "custom",
+					...fromPiSessionEntry(record)
+				};
+				const draft = {
+					kind: "po.entry",
+					data: JSON.parse(JSON.stringify(projected)),
+					...model.length ? { model } : {},
+					...record.type === "compaction" ? { head: "self" } : {}
+				};
+				const entry = await tx.appendEntry(conversation.id, draft);
+				mapped.set(record.id, entry.id);
+				if (record.type === "model_change") (await tx.doc(AgentDoc, conversation.id)).model = {
+					provider: record.provider,
+					modelId: record.modelId
+				};
+				if (record.type === "thinking_level_change") {
+					if (![
+						"off",
+						"minimal",
+						"low",
+						"medium",
+						"high",
+						"xhigh",
+						"max"
+					].includes(record.thinkingLevel)) throw new Error("Invalid terminal Pi thinking level");
+					(await tx.doc(AgentDoc, conversation.id)).thinkingLevel = record.thinkingLevel;
+				}
+			}
+			(await tx.doc(DurableNavigationDoc)).activeConversationId = conversation.id;
+		}, BACKGROUND_CONTEXT);
+		return destination.sessionFile;
+	} catch (error) {
+		fs.rmSync(destination.sessionFile, { force: true });
+		throw error;
+	} finally {
+		await destination.session.close(BACKGROUND_CONTEXT);
+		await destination.repository.close(BACKGROUND_CONTEXT);
+		await destination.historyLease.release();
+	}
+}
+function createTerminalPiChildSessionService(options) {
+	const runtimeFactory = options.runtimeFactory ?? createDirectHarnessRuntime;
+	const ownership = options.historyOwnership ?? createHistoryOwnership({ sourceFormat: "sqlite" });
+	const headlessOptions = {
+		parentSessionId: "",
+		cwd: options.cwd,
+		...options.sessionsRoot === void 0 ? {} : { sessionsRoot: options.sessionsRoot },
+		...options.models === void 0 ? {} : { models: options.models },
+		...options.providers === void 0 ? {} : { providers: options.providers },
+		...options.defaultModel === void 0 ? {} : { defaultModel: options.defaultModel },
+		...options.parentFastMode === void 0 ? {} : { parentFastMode: options.parentFastMode },
+		...options.mcpTool === void 0 ? {} : { mcpTool: options.mcpTool },
+		...options.subscribeMcpTool === void 0 ? {} : { subscribeMcpTool: options.subscribeMcpTool },
+		...options.hooks === void 0 ? {} : { hooks: options.hooks },
+		historyOwnership: ownership,
+		...options.now === void 0 ? {} : { now: options.now },
+		runtimeFactory
+	};
+	const headless = createHeadlessChildSessionService(headlessOptions);
+	const terminal = createDoomChildSessionService(async (request, signal) => {
+		signal?.throwIfAborted();
+		if (request.source.kind !== "terminal-pi-fork") throw new Error("Terminal Pi child sessions require terminal Pi fork sources.");
+		const directRequestOptions = composeDirectHarnessRequestOptions(request, options.mcpTool);
+		const fastMode = await options.parentFastMode?.();
+		if (fastMode !== void 0 && typeof fastMode !== "boolean") throw new Error("Parent Fast mode must be a boolean.");
+		const requestedModel = parseChildModelReference(request.model);
+		const model = requestedModel?.model ?? options.defaultModel?.();
+		const thinking = request.thinking ?? requestedModel?.thinking;
+		const providers = resolveChildProviders(options.providers);
+		const sessionPath = await createChildJournal(request, request.source, options, ownership);
+		const runtimeOptions = {
+			cwd: request.cwd || options.cwd,
+			parentSessionId: request.parentSessionId,
+			sessionPath,
+			...options.sessionsRoot === void 0 ? {} : { sessionsRoot: options.sessionsRoot },
+			...options.models === void 0 ? {} : { models: options.models },
+			...providers === void 0 ? {} : { providers },
+			...model === void 0 ? {} : { model },
+			...thinking === void 0 ? {} : { thinkingLevel: thinking },
+			...directRequestOptions,
+			...fastMode === void 0 ? {} : { initialFastMode: fastMode },
+			historyOwnership: ownership
+		};
+		let runtime;
+		let hooks;
+		try {
+			hooks = bindChildHooks(request, options.hooks?.(), () => runtime, signal);
+			if (hooks.binding) {
+				runtimeOptions.beforeTool = hooks.binding.beforeTool;
+				runtimeOptions.afterTool = hooks.binding.afterTool;
+			}
+			runtime = await runtimeFactory(runtimeOptions);
+			if (requestedModel && model) await runtime.setModel(model);
+			if (thinking !== void 0) await runtime.setThinkingLevel(thinking);
+			await installIntercom(runtime, request.intercom, runtimeOptions.tools ?? []);
+			const releaseMcp = bindChildMcpCatalog(runtime, request, options, runtimeOptions.tools ?? []);
+			const file = runtime.sessionFile;
+			const releaseNative = typeof file === "string" ? registerNativeChild(file, runtime) : void 0;
+			return childRuntime(runtime, request.intercom, async () => {
+				try {
+					releaseMcp();
+				} finally {
+					try {
+						releaseNative?.();
+					} finally {
+						await hooks?.dispose();
+					}
+				}
+			});
+		} catch (error) {
+			let failure = error;
+			try {
+				await hooks?.dispose();
+			} catch (cleanupError) {
+				failure = new AggregateError([failure, cleanupError], "Terminal Pi child hook cleanup failed");
+			}
+			try {
+				await runtime?.dispose();
+			} catch (cleanupError) {
+				failure = new AggregateError([failure, cleanupError], "Terminal Pi child startup cleanup failed");
+			} finally {
+				request.intercom?.dispose?.();
+				fs.rmSync(sessionPath, { force: true });
+			}
+			throw failure;
+		}
+	}, { now: options.now ?? Date.now });
+	const owners = /* @__PURE__ */ new Map();
+	return {
+		async start(request, signal) {
+			const owner = request.source.kind === "terminal-pi-fork" ? terminal : headless;
+			const handle = await owner.start(request, signal);
+			owners.set(request.runId, owner);
+			return handle;
+		},
+		get: (runId) => owners.get(runId)?.get(runId) ?? terminal.get(runId) ?? headless.get(runId),
+		readTranscriptPage(runId, request, signal) {
+			const owner = owners.get(runId);
+			if (!owner?.readTranscriptPage) return Promise.reject(/* @__PURE__ */ new Error(`Child run '${runId}' has no readable transcript.`));
+			return owner.readTranscriptPage(runId, request, signal);
+		},
+		close: async () => {
+			const failures = await Promise.allSettled([terminal.close(), headless.close()]);
+			owners.clear();
+			const rejected = failures.flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+			if (rejected.length) throw new AggregateError(rejected, "Terminal Pi child-session shutdown failed.");
+		}
+	};
+}
+function createTerminalPiChildSessionServiceProvider(options) {
+	const service = createTerminalPiChildSessionService(options);
+	return {
+		get: () => service,
+		close: () => service.close()
+	};
+}
+//#endregion
+export { captureTerminalPiForkSource, createTerminalPiChildSessionService, createTerminalPiChildSessionServiceProvider };
+
+//# sourceMappingURL=terminalPiChildSessionService.mjs.map

package/dist/terminalPiChildSessionService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalPiChildSessionService.mjs","names":[],"sources":["../src/systems/child/adapters/terminalPiChildSessionService.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { JsonValue } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Models, MutableModels, Provider } from '@earendil-works/pi-ai';\nimport {\n  getAgentDir,\n  parseSessionEntries,\n  sessionEntryToContextMessages,\n  convertToLlm,\n} from '@earendil-works/pi-coding-agent';\nimport { AgentDoc, type EntryId } from '@earendil-works/pi-durable';\n\nimport {\n  createDoomChildSessionService,\n  type DoomChildSessionIntercom,\n  type DoomChildSessionHooks,\n  type DoomChildSessionRuntime,\n  type DoomChildSessionService,\n  type DoomChildSessionServiceProvider,\n  type DoomChildSessionTerminalPiForkSource,\n  type DoomChildSessionRequest,\n} from '../../../exports/childSession';\nimport type { DoomChildSessionMcpTool } from '../../../exports/childSession';\nimport {\n  createDirectHarnessRuntime,\n  promptForAssistantText,\n  type DirectHarnessRuntime,\n  type DirectHarnessRuntimeOptions,\n} from '../../../server/directHarnessRuntime';\nimport { readNativeChildTranscript } from '../../../server/nativeChildTranscriptReader';\nimport { DurableNavigationDoc } from '../../../services/durableNavigation';\nimport type { HistoryOwnership } from '../../../services/historyImport';\nimport { createHistoryOwnership } from '../../../services/historyOwnership';\nimport { fromPiSessionEntry } from '../../../services/piSessionEntries';\nimport { openSqliteSessionStorage } from '../../../services/sqliteSessionStorage';\nimport type { DirectHarnessModel } from '../../../types/server/directHarnessRuntime';\nimport {\n  composeDirectHarnessRequestOptions,\n  bindChildHooks,\n  bindChildMcpCatalog,\n  createHeadlessChildSessionService,\n  parseChildModelReference,\n  resolveChildProviders,\n  type HeadlessChildSessionServiceOptions,\n} from './headlessChildSessionService';\nimport { registerNativeChild } from './nativeChildRuntimes';\n\nexport interface TerminalPiChildSessionServiceOptions {\n  readonly cwd: string;\n  readonly sessionsRoot?: string;\n  readonly models?: Models | MutableModels;\n  /**\n   * Providers to merge into the model registry for every child spawn. A thunk\n   * is resolved per spawn so providers registered after this service was built,\n   * such as Pi extension providers, are still visible to the child.\n   */\n  readonly providers?: readonly Provider[] | (() => readonly Provider[]);\n  readonly defaultModel?: () => DirectHarnessModel | undefined;\n  /** Snapshot the parent preference once per creation, never live-sync child toggles. */\n  readonly parentFastMode?: () => boolean | Promise<boolean>;\n  readonly hooks?: () => DoomChildSessionHooks | undefined;\n  readonly mcpTool?: () => DoomChildSessionMcpTool | undefined;\n  readonly subscribeMcpTool?: (listener: () => void) => () => void;\n  readonly historyOwnership?: HistoryOwnership;\n  readonly now?: () => number;\n  readonly runtimeFactory?: (options: DirectHarnessRuntimeOptions) => Promise<DirectHarnessRuntime>;\n}\n\nexport interface TerminalPiForkSourceManager {\n  getSessionId(): string;\n  getLeafId(): string | null;\n  getHeader(): { type: string; version?: number; [key: string]: unknown } | null;\n  getBranch(fromId?: string): readonly Record<string, unknown>[];\n}\n\nfunction childRuntime(\n  runtime: DirectHarnessRuntime,\n  intercom?: DoomChildSessionIntercom,\n  release?: () => void | Promise<void>,\n): DoomChildSessionRuntime {\n  const file = runtime.sessionFile;\n  return {\n    sessionId: runtime.sessionId,\n    ...(typeof file === 'string' ? { sessionFile: file } : {}),\n    ...(typeof file === 'string'\n      ? { readTranscriptPage: (request, signal) => readNativeChildTranscript(file, request, signal) }\n      : {}),\n    prompt: (task) => promptForAssistantText(runtime, task),\n    async steer(message) {\n      await runtime.submitInternalMessage(message, 'steer');\n    },\n    async followUp(message) {\n      await runtime.submitInternalMessage(message, 'followUp');\n    },\n    onUsage(listener) {\n      return runtime.onEvent((event) => {\n        if (event.type !== 'usage') return;\n        listener({ rowId: event.row.id, cost: event.row.usage.cost.total });\n      });\n    },\n    abort: () => runtime.abort(),\n    dispose: async () => {\n      try {\n        await release?.();\n      } finally {\n        try {\n          await runtime.dispose();\n        } finally {\n          intercom?.dispose?.();\n        }\n      }\n    },\n  };\n}\n\ntype DirectHarnessTool = Parameters<DirectHarnessRuntime['replaceTools']>[0][number];\n\nasync function installIntercom(\n  runtime: DirectHarnessRuntime,\n  intercom: DoomChildSessionIntercom | undefined,\n  tools: DirectHarnessTool[],\n): Promise<void> {\n  if (!intercom) return;\n  const tool = intercom.bindRuntime(childRuntime(runtime));\n  const adapted = {\n    ...tool,\n    parameters: tool.parameters as never,\n    execute: async (\n      operationId: string,\n      params: unknown,\n      onUpdate: (result: { content: unknown; details?: unknown }) => void,\n      _toolContext: unknown,\n      _invocation: unknown,\n      context: { abortSignal: AbortSignal | undefined },\n    ) => tool.execute(operationId, params, context.abortSignal ?? new AbortController().signal, onUpdate as never),\n  } as unknown as DirectHarnessTool;\n  tools.push(adapted);\n  await runtime.replaceTools(tools);\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction requireString(value: unknown, field: string): string {\n  if (typeof value !== 'string' || value.length === 0) throw new Error(`Invalid terminal Pi snapshot ${field}`);\n  return value;\n}\n\nfunction parseSnapshot(snapshotJsonl: string): { header: Record<string, unknown>; records: Record<string, unknown>[] } {\n  if (!snapshotJsonl.endsWith('\\n')) throw new Error('Terminal Pi snapshot is truncated.');\n  const lines = snapshotJsonl.slice(0, -1).split('\\n');\n  let headerValue: unknown;\n  try {\n    headerValue = JSON.parse(lines[0] ?? '');\n  } catch (error) {\n    throw new Error('Malformed terminal Pi snapshot header.', { cause: error });\n  }\n  const header = asRecord(headerValue);\n  if (header?.type !== 'session' || header.version !== 3)\n    throw new Error('Terminal Pi child source must be a v3 JSONL snapshot.');\n  const records = lines.slice(1).map((line, index) => {\n    let value: unknown;\n    try {\n      value = JSON.parse(line);\n    } catch (error) {\n      throw new Error(`Malformed terminal Pi snapshot record at line ${index + 2}.`, { cause: error });\n    }\n    const record = asRecord(value);\n    if (record === undefined) throw new Error(`Invalid terminal Pi snapshot record at line ${index + 2}`);\n    requireString(record.id, `record ${index + 2} id`);\n    if (record.parentId !== null && typeof record.parentId !== 'string')\n      throw new Error(`Invalid terminal Pi snapshot record ${index + 2} parentId`);\n    return record;\n  });\n  return { header, records };\n}\n\n/** Capture data from Pi memory, not its writable v3 path. The JSONL string is immutable after return. */\nexport function captureTerminalPiForkSource(\n  manager: TerminalPiForkSourceManager,\n  selectedLeafId = manager.getLeafId(),\n): DoomChildSessionTerminalPiForkSource | undefined {\n  const sourceSessionId = manager.getSessionId();\n  const sourceLeafId = selectedLeafId;\n  const header = manager.getHeader();\n  if (!sourceSessionId.trim() || !sourceLeafId || header?.type !== 'session' || header.version !== 3) return undefined;\n  const branch = manager.getBranch(sourceLeafId);\n  const lastEntry = branch.at(-1);\n  if (lastEntry?.id !== sourceLeafId) return undefined;\n  const snapshotJsonl = `${[header, ...branch].map((record) => JSON.stringify(record)).join('\\n')}\\n`;\n  return Object.freeze({\n    kind: 'terminal-pi-fork',\n    sourceSessionId,\n    sourceLeafId,\n    snapshotJsonl,\n  });\n}\n\nasync function createChildJournal(\n  request: DoomChildSessionRequest,\n  source: DoomChildSessionTerminalPiForkSource,\n  options: TerminalPiChildSessionServiceOptions,\n  ownership: HistoryOwnership,\n): Promise<string> {\n  const parsed = parseSnapshot(source.snapshotJsonl);\n  if (requireString(parsed.header.id, 'header id') !== source.sourceSessionId)\n    throw new Error('Terminal Pi snapshot session identity does not match its sourceSessionId.');\n  if (parsed.records.at(-1)?.id !== source.sourceLeafId)\n    throw new Error('Terminal Pi snapshot leaf does not match its sourceLeafId.');\n\n  const records = parseSessionEntries(source.snapshotJsonl).filter((entry) => entry.type !== 'session');\n  if (records.length !== parsed.records.length) throw new Error('Terminal Pi snapshot contains invalid entries');\n  const ids = new Set<string>();\n  let parent: string | null = null;\n  for (const record of records) {\n    if (record.parentId !== parent || ids.has(record.id))\n      throw new Error('Terminal Pi snapshot is not a selected branch');\n    ids.add(record.id);\n    parent = record.id;\n  }\n  const destination = await openSqliteSessionStorage(\n    {\n      sessionsRoot: path.resolve(options.sessionsRoot ?? path.join(getAgentDir(), 'server', 'sessions')),\n      sessionId: randomUUID(),\n      parentSessionId: request.parentSessionId || source.sourceSessionId,\n      historyOwnership: ownership,\n    },\n    BACKGROUND_CONTEXT,\n  );\n  try {\n    await destination.session.commit(async (tx) => {\n      const conversation = await tx.createConversation({ ownership: { kind: 'ownerless' } });\n      const mapped = new Map<string, EntryId>();\n      for (const [index, record] of records.entries()) {\n        const tail =\n          record.type === 'compaction'\n            ? records\n                .slice(\n                  records.findIndex((entry) => entry.id === record.firstKeptEntryId),\n                  index,\n                )\n                .flatMap((entry) => sessionEntryToContextMessages(entry))\n            : [];\n        const model = convertToLlm([...sessionEntryToContextMessages(record), ...tail]);\n        const head = record.type === 'compaction' ? mapped.get(record.firstKeptEntryId) : undefined;\n        if (record.type === 'compaction' && head === undefined)\n          throw new Error('Terminal Pi snapshot compaction boundary is absent');\n        const projected =\n          record.type === 'message'\n            ? { type: 'message', message: record.message, timestamp: Date.parse(record.timestamp) }\n            : record.type === 'compaction'\n              ? {\n                  type: 'compaction',\n                  summary: record.summary,\n                  tokensBefore: record.tokensBefore,\n                  retainedTail: tail,\n                  fromHook: record.fromHook ?? false,\n                }\n              : record.type === 'branch_summary'\n                ? {\n                    type: 'branch_summary',\n                    summary: record.summary,\n                    fromId: record.fromId,\n                    fromHook: record.fromHook ?? false,\n                  }\n                : { type: 'custom', ...fromPiSessionEntry(record) };\n        const draft = {\n          kind: 'po.entry',\n          data: JSON.parse(JSON.stringify(projected)) as JsonValue,\n          ...(model.length ? { model } : {}),\n          ...(record.type === 'compaction' ? { head: 'self' as const } : {}),\n        };\n        const entry = await tx.appendEntry(conversation.id, draft);\n        mapped.set(record.id, entry.id);\n        if (record.type === 'model_change')\n          (await tx.doc(AgentDoc, conversation.id)).model = { provider: record.provider, modelId: record.modelId };\n        if (record.type === 'thinking_level_change') {\n          if (!['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'].includes(record.thinkingLevel))\n            throw new Error('Invalid terminal Pi thinking level');\n          (await tx.doc(AgentDoc, conversation.id)).thinkingLevel = record.thinkingLevel as NonNullable<\n            Awaited<ReturnType<DirectHarnessRuntime['lane']['agent']>>['thinkingLevel']\n          >;\n        }\n      }\n      (await tx.doc(DurableNavigationDoc)).activeConversationId = conversation.id;\n    }, BACKGROUND_CONTEXT);\n    return destination.sessionFile;\n  } catch (error) {\n    fs.rmSync(destination.sessionFile, { force: true });\n    throw error;\n  } finally {\n    await destination.session.close(BACKGROUND_CONTEXT);\n    await destination.repository.close(BACKGROUND_CONTEXT);\n    await destination.historyLease.release();\n  }\n}\n\nexport function createTerminalPiChildSessionService(\n  options: TerminalPiChildSessionServiceOptions,\n): DoomChildSessionService {\n  const runtimeFactory = options.runtimeFactory ?? createDirectHarnessRuntime;\n  const ownership = options.historyOwnership ?? createHistoryOwnership({ sourceFormat: 'sqlite' });\n  const headlessOptions: HeadlessChildSessionServiceOptions = {\n    parentSessionId: '',\n    cwd: options.cwd,\n    ...(options.sessionsRoot === undefined ? {} : { sessionsRoot: options.sessionsRoot }),\n    ...(options.models === undefined ? {} : { models: options.models }),\n    ...(options.providers === undefined ? {} : { providers: options.providers }),\n    ...(options.defaultModel === undefined ? {} : { defaultModel: options.defaultModel }),\n    ...(options.parentFastMode === undefined ? {} : { parentFastMode: options.parentFastMode }),\n    ...(options.mcpTool === undefined ? {} : { mcpTool: options.mcpTool }),\n    ...(options.subscribeMcpTool === undefined ? {} : { subscribeMcpTool: options.subscribeMcpTool }),\n    ...(options.hooks === undefined ? {} : { hooks: options.hooks }),\n    historyOwnership: ownership,\n    ...(options.now === undefined ? {} : { now: options.now }),\n    runtimeFactory,\n  };\n  const headless = createHeadlessChildSessionService(headlessOptions);\n  const terminal = createDoomChildSessionService(\n    async (request: DoomChildSessionRequest, signal): Promise<DoomChildSessionRuntime> => {\n      signal?.throwIfAborted();\n      if (request.source.kind !== 'terminal-pi-fork')\n        throw new Error('Terminal Pi child sessions require terminal Pi fork sources.');\n      const directRequestOptions = composeDirectHarnessRequestOptions(request, options.mcpTool);\n      const fastMode = await options.parentFastMode?.();\n      if (fastMode !== undefined && typeof fastMode !== 'boolean')\n        throw new Error('Parent Fast mode must be a boolean.');\n      const requestedModel = parseChildModelReference(request.model);\n      const model = requestedModel?.model ?? options.defaultModel?.();\n      const thinking = request.thinking ?? requestedModel?.thinking;\n      const providers = resolveChildProviders(options.providers);\n      const sessionPath = await createChildJournal(request, request.source, options, ownership);\n      const runtimeOptions: DirectHarnessRuntimeOptions = {\n        cwd: request.cwd || options.cwd,\n        parentSessionId: request.parentSessionId,\n        sessionPath,\n        ...(options.sessionsRoot === undefined ? {} : { sessionsRoot: options.sessionsRoot }),\n        ...(options.models === undefined ? {} : { models: options.models }),\n        ...(providers === undefined ? {} : { providers }),\n        ...(model === undefined ? {} : { model }),\n        ...(thinking === undefined ? {} : { thinkingLevel: thinking as never }),\n        ...directRequestOptions,\n        ...(fastMode === undefined ? {} : { initialFastMode: fastMode }),\n        historyOwnership: ownership,\n      };\n      let runtime: DirectHarnessRuntime | undefined;\n      let hooks: ReturnType<typeof bindChildHooks> | undefined;\n      try {\n        hooks = bindChildHooks(request, options.hooks?.(), () => runtime, signal);\n        if (hooks.binding) {\n          runtimeOptions.beforeTool = hooks.binding.beforeTool;\n          runtimeOptions.afterTool = hooks.binding.afterTool;\n        }\n        runtime = await runtimeFactory(runtimeOptions);\n        if (requestedModel && model) await runtime.setModel(model);\n        if (thinking !== undefined) await runtime.setThinkingLevel(thinking as never);\n        await installIntercom(runtime, request.intercom, (runtimeOptions.tools ?? []) as DirectHarnessTool[]);\n        const releaseMcp = bindChildMcpCatalog(runtime, request, options, runtimeOptions.tools ?? []);\n        const file = runtime.sessionFile;\n        const releaseNative = typeof file === 'string' ? registerNativeChild(file, runtime) : undefined;\n        return childRuntime(runtime, request.intercom, async () => {\n          try {\n            releaseMcp();\n          } finally {\n            try {\n              releaseNative?.();\n            } finally {\n              await hooks?.dispose();\n            }\n          }\n        });\n      } catch (error) {\n        let failure: unknown = error;\n        try {\n          await hooks?.dispose();\n        } catch (cleanupError) {\n          failure = new AggregateError([failure, cleanupError], 'Terminal Pi child hook cleanup failed');\n        }\n        try {\n          await runtime?.dispose();\n        } catch (cleanupError) {\n          failure = new AggregateError([failure, cleanupError], 'Terminal Pi child startup cleanup failed');\n        } finally {\n          request.intercom?.dispose?.();\n          fs.rmSync(sessionPath, { force: true });\n        }\n        throw failure;\n      }\n    },\n    { now: options.now ?? Date.now },\n  );\n  const owners = new Map<string, DoomChildSessionService>();\n  const service: DoomChildSessionService = {\n    async start(request, signal) {\n      const owner = request.source.kind === 'terminal-pi-fork' ? terminal : headless;\n      const handle = await owner.start(request, signal);\n      owners.set(request.runId, owner);\n      return handle;\n    },\n    get: (runId) => owners.get(runId)?.get(runId) ?? terminal.get(runId) ?? headless.get(runId),\n    readTranscriptPage(runId, request, signal) {\n      const owner = owners.get(runId);\n      if (!owner?.readTranscriptPage)\n        return Promise.reject(new Error(`Child run '${runId}' has no readable transcript.`));\n      return owner.readTranscriptPage(runId, request, signal);\n    },\n    close: async () => {\n      const failures = await Promise.allSettled([terminal.close(), headless.close()]);\n      owners.clear();\n      const rejected = failures.flatMap((result) => (result.status === 'rejected' ? [result.reason] : []));\n      if (rejected.length) throw new AggregateError(rejected, 'Terminal Pi child-session shutdown failed.');\n    },\n  };\n  return service;\n}\n\nexport interface TerminalPiChildSessionServiceProvider extends DoomChildSessionServiceProvider {\n  close(): Promise<void>;\n}\n\nexport function createTerminalPiChildSessionServiceProvider(\n  options: TerminalPiChildSessionServiceOptions,\n): TerminalPiChildSessionServiceProvider {\n  const service = createTerminalPiChildSessionService(options);\n  return { get: () => service, close: () => service.close() };\n}\n"],"mappings":"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"}

package/dist/testing.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_testHost = require("./src/testing/pi/testHost.cjs");
+const require_extensionScenarios = require("./src/testing/pi/extensionScenarios.cjs");
+const require_index = require("./src/services/hubChannelHarness/index.cjs");
+const require_index$1 = require("./src/services/packageApiHarness/index.cjs");
+const require_index$2 = require("./src/services/apiSurfaceAssert/index.cjs");
+exports.assertContractSurface = require_index$2.assertContractSurface;
+exports.createPiTestHost = require_testHost.createPiTestHost;
+exports.doomHubChannelHarness = require_index.doomHubChannelHarness;
+exports.mountPackageApi = require_index$1.mountPackageApi;
+exports.standardExtensionScenarios = require_extensionScenarios.standardExtensionScenarios;

package/dist/testing.d.mts

@@ -0,0 +1,6 @@
+import { PiTestContextOptions, PiTestDialogAnswers, PiTestHost, PiTestHostOptions, RecordedCommand, RecordedEntry, RecordedExec, RecordedMessage, RecordedNotification, RecordedProvider, RecordedRenderer, RecordedShortcut, RecordedStatus, RecordedUserMessage, RecordedWidget, createPiTestHost } from "./src/testing/pi/testHost.mjs";
+import { ExtensionContractScenario, StandardExtensionContractOptions, standardExtensionScenarios } from "./src/testing/pi/extensionScenarios.mjs";
+import { DoomHubChannelHarness, DoomHubChannelHarnessOptions, doomHubChannelHarness } from "./src/services/hubChannelHarness/index.mjs";
+import { MountPackageApiOptions, MountedPackageApi, mountPackageApi } from "./src/services/packageApiHarness/index.mjs";
+import { ApiSurfaceOptions, assertContractSurface } from "./src/services/apiSurfaceAssert/index.mjs";
+export { type ApiSurfaceOptions, type DoomHubChannelHarness, type DoomHubChannelHarnessOptions, type ExtensionContractScenario, type MountPackageApiOptions, type MountedPackageApi, type PiTestContextOptions, type PiTestDialogAnswers, type PiTestHost, type PiTestHostOptions, type RecordedCommand, type RecordedEntry, type RecordedExec, type RecordedMessage, type RecordedNotification, type RecordedProvider, type RecordedRenderer, type RecordedShortcut, type RecordedStatus, type RecordedUserMessage, type RecordedWidget, type StandardExtensionContractOptions, assertContractSurface, createPiTestHost, doomHubChannelHarness, mountPackageApi, standardExtensionScenarios };

package/dist/testing.mjs

@@ -0,0 +1,6 @@
+import { createPiTestHost } from "./src/testing/pi/testHost.mjs";
+import { standardExtensionScenarios } from "./src/testing/pi/extensionScenarios.mjs";
+import { doomHubChannelHarness } from "./src/services/hubChannelHarness/index.mjs";
+import { mountPackageApi } from "./src/services/packageApiHarness/index.mjs";
+import { assertContractSurface } from "./src/services/apiSurfaceAssert/index.mjs";
+export { assertContractSurface, createPiTestHost, doomHubChannelHarness, mountPackageApi, standardExtensionScenarios };

package/dist/toolInventory.cjs

@@ -0,0 +1,136 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_index = require("./src/services/toolCost/index.cjs");
+//#region src/services/toolInventory/index.ts
+/** Pi tags its own tools with this source; everything else came from an extension. */
+const BUILTIN_SOURCE = "builtin";
+/** Pi's structural tags for an extension path, neither of which is a package name. */
+const CLI_SOURCE = "cli";
+const LOCAL_SOURCE = "local";
+const CORE_KEY = "core";
+const CORE_NAME = "pi";
+const MCP_KEY_PREFIX = "mcp:";
+/** Labels read name first, then kind, because the name is what the eye scans for. */
+const KIND_SUFFIX = {
+	core: "core",
+	mcp: "mcp",
+	extension: "extension"
+};
+const CONNECTED_STATUS = "connected";
+const KIND_ORDER = {
+	core: 0,
+	mcp: 1,
+	extension: 2
+};
+/**
+* Server state worth reporting, which takes the place of the tool count.
+*
+* A connected server is the unremarkable case, so it keeps its count rather
+* than spending the column on a word that says nothing went wrong.
+*/
+function displayStatus(server) {
+	return server.state === CONNECTED_STATUS ? void 0 : server.state.replace(/-/g, " ");
+}
+function toEntry(tool, activeTools) {
+	return {
+		name: tool.name,
+		...tool.description ? { description: tool.description } : {},
+		...tool.parameters === void 0 ? {} : { parameters: tool.parameters },
+		...tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {},
+		...tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {},
+		active: activeTools.has(tool.name)
+	};
+}
+function byName(left, right) {
+	return left.name.localeCompare(right.name);
+}
+function sourceLabel(name, kind) {
+	return `${name} · ${KIND_SUFFIX[kind]}`;
+}
+/**
+* Indexes each server's declared tool names.
+*
+* The snapshot names its tools outright, so attribution is a lookup rather than a
+* guess at the naming scheme. A tool the snapshot does not claim falls through to
+* the extension that registered it.
+*/
+function serverByTool(servers) {
+	const index = /* @__PURE__ */ new Map();
+	for (const server of servers) for (const toolName of server.tools) index.set(toolName, server);
+	return index;
+}
+/**
+* Groups the session's tools by where they came from: Pi itself, one group per
+* MCP server, then one per extension that registered a tool.
+*
+* Every MCP tool is registered by one extension, so `sourceInfo` cannot separate
+* servers; the status snapshot supplies the tool-to-server mapping instead.
+*/
+function buildToolSources(input) {
+	const activeTools = new Set(input.activeTools);
+	const servers = input.mcpServers ?? [];
+	const owningServer = serverByTool(servers);
+	const core = [];
+	const mcpTools = /* @__PURE__ */ new Map();
+	const extensions = /* @__PURE__ */ new Map();
+	for (const tool of input.tools) {
+		const entry = toEntry(tool, activeTools);
+		const server = owningServer.get(tool.name);
+		if (server) {
+			const bucket = mcpTools.get(server.name);
+			if (bucket) bucket.push(entry);
+			else mcpTools.set(server.name, [entry]);
+			continue;
+		}
+		if (tool.sourceInfo.source === BUILTIN_SOURCE) {
+			core.push(entry);
+			continue;
+		}
+		const recordedPath = input.resolveExtensionToolSource?.(tool.name);
+		const key = recordedPath ?? tool.sourceInfo.path;
+		const group = extensions.get(key);
+		if (group) group.tools.push(entry);
+		else {
+			const name = recordedPath !== void 0 || tool.sourceInfo.source === CLI_SOURCE || tool.sourceInfo.source === LOCAL_SOURCE || !tool.sourceInfo.source ? input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key : tool.sourceInfo.source ?? key;
+			const scoped = input.resolveExtensionPackageName?.(key);
+			extensions.set(key, {
+				label: sourceLabel(name, "extension"),
+				detail: key,
+				...scoped ? { packageName: scoped } : {},
+				tools: [entry]
+			});
+		}
+	}
+	const sources = [];
+	if (core.length > 0) sources.push({
+		key: CORE_KEY,
+		label: sourceLabel(CORE_NAME, CORE_KEY),
+		kind: CORE_KEY,
+		tools: core.sort(byName)
+	});
+	for (const server of servers) {
+		const tools = mcpTools.get(server.name) ?? [];
+		const status = displayStatus(server);
+		sources.push({
+			key: `${MCP_KEY_PREFIX}${server.name}`,
+			label: sourceLabel(server.name, "mcp"),
+			kind: "mcp",
+			...status ? { status } : {},
+			tools: tools.sort(byName)
+		});
+	}
+	for (const [key, group] of extensions) sources.push({
+		key,
+		label: group.label,
+		kind: "extension",
+		detail: group.detail,
+		...group.packageName ? { packageName: group.packageName } : {},
+		tools: group.tools.sort(byName)
+	});
+	return sources.sort((left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label));
+}
+//#endregion
+exports.buildToolSources = buildToolSources;
+exports.tokensForSource = require_index.tokensForSource;
+exports.tokensForTool = require_index.tokensForTool;
+
+//# sourceMappingURL=toolInventory.cjs.map

package/dist/toolInventory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolInventory.cjs","names":[],"sources":["../src/services/toolInventory/index.ts"],"sourcesContent":["import type { McpServerSnapshot } from '../../exports/mcpStatus';\n\nexport type ToolSourceKind = 'core' | 'mcp' | 'extension';\n\nexport interface ToolEntry {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  /** One-line snippet Pi keys by tool name in the system prompt. */\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  active: boolean;\n}\n\nexport interface ToolSource {\n  key: string;\n  label: string;\n  kind: ToolSourceKind;\n  /** Server state for MCP sources, e.g. `disabled`; absent for core and extensions. */\n  status?: string;\n  /** The registering file for extension sources. */\n  detail?: string;\n  /**\n   * Package name as its manifest spells it, scope included.\n   *\n   * `label` is shortened for reading. Attribution joins against `.po`\n   * configuration, which names packages in full, so the unshortened name is\n   * carried separately rather than recovered from the label.\n   */\n  packageName?: string;\n  tools: readonly ToolEntry[];\n}\n\n/** One server row of the MCP status snapshot. */\nexport type McpServerStatus = McpServerSnapshot;\n\nexport interface ToolInfo {\n  name: string;\n  description?: string;\n  parameters?: unknown;\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  sourceInfo: { path: string; source?: string };\n}\n\nexport interface ToolInventoryInput {\n  tools: readonly ToolInfo[];\n  activeTools: readonly string[];\n  /** Absent when the MCP adapter is not loaded or has not published yet. */\n  mcpServers?: readonly McpServerStatus[];\n  resolveExtensionName?: (entryPath: string) => string;\n  /** Unshortened package name for the same entry path, for attribution. */\n  resolveExtensionPackageName?: (entryPath: string) => string | undefined;\n  resolveExtensionToolSource?: (toolName: string) => string | undefined;\n}\n\n/** Pi tags its own tools with this source; everything else came from an extension. */\nconst BUILTIN_SOURCE = 'builtin';\n/** Pi's structural tags for an extension path, neither of which is a package name. */\nconst CLI_SOURCE = 'cli';\nconst LOCAL_SOURCE = 'local';\nconst CORE_KEY = 'core';\nconst CORE_NAME = 'pi';\nconst MCP_KEY_PREFIX = 'mcp:';\n/** Labels read name first, then kind, because the name is what the eye scans for. */\nconst KIND_SUFFIX: Record<ToolSourceKind, string> = { core: 'core', mcp: 'mcp', extension: 'extension' };\nconst CONNECTED_STATUS = 'connected';\nconst KIND_ORDER: Record<ToolSourceKind, number> = { core: 0, mcp: 1, extension: 2 };\n\n/**\n * Server state worth reporting, which takes the place of the tool count.\n *\n * A connected server is the unremarkable case, so it keeps its count rather\n * than spending the column on a word that says nothing went wrong.\n */\nfunction displayStatus(server: McpServerStatus): string | undefined {\n  return server.state === CONNECTED_STATUS ? undefined : server.state.replace(/-/g, ' ');\n}\n\nfunction toEntry(tool: ToolInfo, activeTools: ReadonlySet<string>): ToolEntry {\n  return {\n    name: tool.name,\n    ...(tool.description ? { description: tool.description } : {}),\n    ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),\n    ...(tool.promptSnippet ? { promptSnippet: tool.promptSnippet } : {}),\n    ...(tool.promptGuidelines?.length ? { promptGuidelines: tool.promptGuidelines } : {}),\n    active: activeTools.has(tool.name),\n  };\n}\n\nfunction byName(left: ToolEntry, right: ToolEntry): number {\n  return left.name.localeCompare(right.name);\n}\n\nfunction sourceLabel(name: string, kind: ToolSourceKind): string {\n  return `${name} · ${KIND_SUFFIX[kind]}`;\n}\n\n/**\n * Indexes each server's declared tool names.\n *\n * The snapshot names its tools outright, so attribution is a lookup rather than a\n * guess at the naming scheme. A tool the snapshot does not claim falls through to\n * the extension that registered it.\n */\nfunction serverByTool(servers: readonly McpServerStatus[]): Map<string, McpServerStatus> {\n  const index = new Map<string, McpServerStatus>();\n  for (const server of servers) {\n    for (const toolName of server.tools) index.set(toolName, server);\n  }\n  return index;\n}\n\n/**\n * Groups the session's tools by where they came from: Pi itself, one group per\n * MCP server, then one per extension that registered a tool.\n *\n * Every MCP tool is registered by one extension, so `sourceInfo` cannot separate\n * servers; the status snapshot supplies the tool-to-server mapping instead.\n */\nexport function buildToolSources(input: ToolInventoryInput): readonly ToolSource[] {\n  const activeTools = new Set(input.activeTools);\n  const servers = input.mcpServers ?? [];\n  const owningServer = serverByTool(servers);\n  const core: ToolEntry[] = [];\n  const mcpTools = new Map<string, ToolEntry[]>();\n  const extensions = new Map<string, { label: string; detail: string; packageName?: string; tools: ToolEntry[] }>();\n\n  for (const tool of input.tools) {\n    const entry = toEntry(tool, activeTools);\n    const server = owningServer.get(tool.name);\n    if (server) {\n      const bucket = mcpTools.get(server.name);\n      if (bucket) bucket.push(entry);\n      else mcpTools.set(server.name, [entry]);\n      continue;\n    }\n    if (tool.sourceInfo.source === BUILTIN_SOURCE) {\n      core.push(entry);\n      continue;\n    }\n    // A composed bundle has one Pi source path for every factory inside it. Doom's\n    // compiler records the original entry at registration time so those extensions\n    // remain separate here even though Pi can only see the outer bundle.\n    const recordedPath = input.resolveExtensionToolSource?.(tool.name);\n    const key = recordedPath ?? tool.sourceInfo.path;\n    const group = extensions.get(key);\n    if (group) group.tools.push(entry);\n    else {\n      const structuralSource =\n        recordedPath !== undefined ||\n        tool.sourceInfo.source === CLI_SOURCE ||\n        tool.sourceInfo.source === LOCAL_SOURCE ||\n        !tool.sourceInfo.source;\n      const name = structuralSource\n        ? (input.resolveExtensionName?.(key) ?? tool.sourceInfo.source ?? key)\n        : (tool.sourceInfo.source ?? key);\n      const scoped = input.resolveExtensionPackageName?.(key);\n      extensions.set(key, {\n        label: sourceLabel(name, 'extension'),\n        detail: key,\n        ...(scoped ? { packageName: scoped } : {}),\n        tools: [entry],\n      });\n    }\n  }\n\n  const sources: ToolSource[] = [];\n  if (core.length > 0) {\n    sources.push({ key: CORE_KEY, label: sourceLabel(CORE_NAME, CORE_KEY), kind: CORE_KEY, tools: core.sort(byName) });\n  }\n  for (const server of servers) {\n    const tools = mcpTools.get(server.name) ?? [];\n    const status = displayStatus(server);\n    // Every configured server is listed, including one with no tools: attribution\n    // is exact now, so an empty list is a fact about the server rather than a\n    // failure to recognise its tool names.\n    sources.push({\n      key: `${MCP_KEY_PREFIX}${server.name}`,\n      label: sourceLabel(server.name, 'mcp'),\n      kind: 'mcp',\n      ...(status ? { status } : {}),\n      tools: tools.sort(byName),\n    });\n  }\n  for (const [key, group] of extensions) {\n    sources.push({\n      key,\n      label: group.label,\n      kind: 'extension',\n      detail: group.detail,\n      ...(group.packageName ? { packageName: group.packageName } : {}),\n      tools: group.tools.sort(byName),\n    });\n  }\n\n  return sources.sort(\n    (left, right) => KIND_ORDER[left.kind] - KIND_ORDER[right.kind] || left.label.localeCompare(right.label),\n  );\n}\n\nexport { type CountTokens, type ToolCost, tokensForSource, tokensForTool } from '../toolCost';\n"],"mappings":";;;;AAyDA,MAAM,iBAAiB;;AAEvB,MAAM,aAAa;AACnB,MAAM,eAAe;AACrB,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,iBAAiB;;AAEvB,MAAM,cAA8C;CAAE,MAAM;CAAQ,KAAK;CAAO,WAAW;AAAY;AACvG,MAAM,mBAAmB;AACzB,MAAM,aAA6C;CAAE,MAAM;CAAG,KAAK;CAAG,WAAW;AAAE;;;;;;;AAQnF,SAAS,cAAc,QAA6C;CAClE,OAAO,OAAO,UAAU,mBAAmB,KAAA,IAAY,OAAO,MAAM,QAAQ,MAAM,GAAG;AACvF;AAEA,SAAS,QAAQ,MAAgB,aAA6C;CAC5E,OAAO;EACL,MAAM,KAAK;EACX,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;EAC5D,GAAI,KAAK,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,KAAK,WAAW;EACvE,GAAI,KAAK,gBAAgB,EAAE,eAAe,KAAK,cAAc,IAAI,CAAC;EAClE,GAAI,KAAK,kBAAkB,SAAS,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;EACnF,QAAQ,YAAY,IAAI,KAAK,IAAI;CACnC;AACF;AAEA,SAAS,OAAO,MAAiB,OAA0B;CACzD,OAAO,KAAK,KAAK,cAAc,MAAM,IAAI;AAC3C;AAEA,SAAS,YAAY,MAAc,MAA8B;CAC/D,OAAO,GAAG,KAAK,KAAK,YAAY;AAClC;;;;;;;;AASA,SAAS,aAAa,SAAmE;CACvF,MAAM,wBAAQ,IAAI,IAA6B;CAC/C,KAAK,MAAM,UAAU,SACnB,KAAK,MAAM,YAAY,OAAO,OAAO,MAAM,IAAI,UAAU,MAAM;CAEjE,OAAO;AACT;;;;;;;;AASA,SAAgB,iBAAiB,OAAkD;CACjF,MAAM,cAAc,IAAI,IAAI,MAAM,WAAW;CAC7C,MAAM,UAAU,MAAM,cAAc,CAAC;CACrC,MAAM,eAAe,aAAa,OAAO;CACzC,MAAM,OAAoB,CAAC;CAC3B,MAAM,2BAAW,IAAI,IAAyB;CAC9C,MAAM,6BAAa,IAAI,IAAyF;CAEhH,KAAK,MAAM,QAAQ,MAAM,OAAO;EAC9B,MAAM,QAAQ,QAAQ,MAAM,WAAW;EACvC,MAAM,SAAS,aAAa,IAAI,KAAK,IAAI;EACzC,IAAI,QAAQ;GACV,MAAM,SAAS,SAAS,IAAI,OAAO,IAAI;GACvC,IAAI,QAAQ,OAAO,KAAK,KAAK;QACxB,SAAS,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC;GACtC;EACF;EACA,IAAI,KAAK,WAAW,WAAW,gBAAgB;GAC7C,KAAK,KAAK,KAAK;GACf;EACF;EAIA,MAAM,eAAe,MAAM,6BAA6B,KAAK,IAAI;EACjE,MAAM,MAAM,gBAAgB,KAAK,WAAW;EAC5C,MAAM,QAAQ,WAAW,IAAI,GAAG;EAChC,IAAI,OAAO,MAAM,MAAM,KAAK,KAAK;OAC5B;GAMH,MAAM,OAJJ,iBAAiB,KAAA,KACjB,KAAK,WAAW,WAAW,cAC3B,KAAK,WAAW,WAAW,gBAC3B,CAAC,KAAK,WAAW,SAEd,MAAM,uBAAuB,GAAG,KAAK,KAAK,WAAW,UAAU,MAC/D,KAAK,WAAW,UAAU;GAC/B,MAAM,SAAS,MAAM,8BAA8B,GAAG;GACtD,WAAW,IAAI,KAAK;IAClB,OAAO,YAAY,MAAM,WAAW;IACpC,QAAQ;IACR,GAAI,SAAS,EAAE,aAAa,OAAO,IAAI,CAAC;IACxC,OAAO,CAAC,KAAK;GACf,CAAC;EACH;CACF;CAEA,MAAM,UAAwB,CAAC;CAC/B,IAAI,KAAK,SAAS,GAChB,QAAQ,KAAK;EAAE,KAAK;EAAU,OAAO,YAAY,WAAW,QAAQ;EAAG,MAAM;EAAU,OAAO,KAAK,KAAK,MAAM;CAAE,CAAC;CAEnH,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,QAAQ,SAAS,IAAI,OAAO,IAAI,KAAK,CAAC;EAC5C,MAAM,SAAS,cAAc,MAAM;EAInC,QAAQ,KAAK;GACX,KAAK,GAAG,iBAAiB,OAAO;GAChC,OAAO,YAAY,OAAO,MAAM,KAAK;GACrC,MAAM;GACN,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;GAC3B,OAAO,MAAM,KAAK,MAAM;EAC1B,CAAC;CACH;CACA,KAAK,MAAM,CAAC,KAAK,UAAU,YACzB,QAAQ,KAAK;EACX;EACA,OAAO,MAAM;EACb,MAAM;EACN,QAAQ,MAAM;EACd,GAAI,MAAM,cAAc,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;EAC9D,OAAO,MAAM,MAAM,KAAK,MAAM;CAChC,CAAC;CAGH,OAAO,QAAQ,MACZ,MAAM,UAAU,WAAW,KAAK,QAAQ,WAAW,MAAM,SAAS,KAAK,MAAM,cAAc,MAAM,KAAK,CACzG;AACF"}

package/dist/toolInventory.d.mts

@@ -0,0 +1,66 @@
+import { McpServerSnapshot } from "./src/schemas/mcpStatus.mjs";
+import "./mcpStatus.mjs";
+import { CountTokens, ToolCost, tokensForSource, tokensForTool } from "./src/services/toolCost/index.mjs";
+//#region src/services/toolInventory/index.d.ts
+export type ToolSourceKind = 'core' | 'mcp' | 'extension';
+export interface ToolEntry {
+  name: string;
+  description?: string;
+  parameters?: unknown;
+  /** One-line snippet Pi keys by tool name in the system prompt. */
+  promptSnippet?: string;
+  promptGuidelines?: readonly string[];
+  active: boolean;
+}
+export interface ToolSource {
+  key: string;
+  label: string;
+  kind: ToolSourceKind;
+  /** Server state for MCP sources, e.g. `disabled`; absent for core and extensions. */
+  status?: string;
+  /** The registering file for extension sources. */
+  detail?: string;
+  /**
+   * Package name as its manifest spells it, scope included.
+   *
+   * `label` is shortened for reading. Attribution joins against `.po`
+   * configuration, which names packages in full, so the unshortened name is
+   * carried separately rather than recovered from the label.
+   */
+  packageName?: string;
+  tools: readonly ToolEntry[];
+}
+/** One server row of the MCP status snapshot. */
+export type McpServerStatus = McpServerSnapshot;
+export interface ToolInfo {
+  name: string;
+  description?: string;
+  parameters?: unknown;
+  promptSnippet?: string;
+  promptGuidelines?: readonly string[];
+  sourceInfo: {
+    path: string;
+    source?: string;
+  };
+}
+export interface ToolInventoryInput {
+  tools: readonly ToolInfo[];
+  activeTools: readonly string[];
+  /** Absent when the MCP adapter is not loaded or has not published yet. */
+  mcpServers?: readonly McpServerStatus[];
+  resolveExtensionName?: (entryPath: string) => string;
+  /** Unshortened package name for the same entry path, for attribution. */
+  resolveExtensionPackageName?: (entryPath: string) => string | undefined;
+  resolveExtensionToolSource?: (toolName: string) => string | undefined;
+}
+/**
+ * Groups the session's tools by where they came from: Pi itself, one group per
+ * MCP server, then one per extension that registered a tool.
+ *
+ * Every MCP tool is registered by one extension, so `sourceInfo` cannot separate
+ * servers; the status snapshot supplies the tool-to-server mapping instead.
+ */
+export declare function buildToolSources(input: ToolInventoryInput): readonly ToolSource[];
+//#endregion
+export { type CountTokens, type ToolCost, tokensForSource, tokensForTool };
+//# sourceMappingURL=toolInventory.d.mts.map

package/dist/toolInventory.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolInventory.d.mts","names":[],"sources":["../src/services/toolInventory/index.ts"],"mappings":";;;;YAEY;iBAEK;EACf;EACA;EACA;;EAEA;EACA;EACA;;iBAGe;EACf;EACA;EACA,MAAM;;EAEN;;EAEA;;;;;;;;EAQA;EACA,gBAAgB;;;YAIN,kBAAkB;iBAEb;EACf;EACA;EACA;EACA;EACA;EACA;IAAc;IAAc;;;iBAGb;EACf,gBAAgB;EAChB;;EAEA,sBAAsB;EACtB,wBAAwB;;EAExB,+BAA+B;EAC/B,8BAA8B;;;;;;;;;wBAmEhB,iBAAiB,OAAO,8BAA8B"}