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

package/dist/terminal-pi-child-session-service.mjs

@@ -0,0 +1,256 @@
+import { createDoomChildSessionService } from "./systems/child/services/childSession/index.mjs";
+import { registerNativeChild } from "./systems/child/adapters/nativeChildRuntimes.mjs";
+import { importV3WithPinnedUpstream } from "./jsonl-session-repo.mjs";
+import { createDirectHarnessRuntime, promptForAssistantText } from "./server/directHarnessRuntime.mjs";
+import { readNativeChildTranscript } from "./server/nativeChildTranscriptReader.mjs";
+import { createHistoryOwnership } from "./history-ownership.mjs";
+import { composeDirectHarnessRequestOptions, createHeadlessChildSessionService } from "./systems/child/adapters/headlessChildSessionService.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import os from "node:os";
+//#region src/systems/child/adapters/terminalPiChildSessionService.ts
+function childRuntime(runtime, intercom, release) {
+	const file = runtime.session.metadata.path;
+	return {
+		sessionId: runtime.sessionId,
+		...typeof file === "string" ? { sessionFile: file } : {},
+		...typeof file === "string" ? { readTranscriptPage: (request, signal) => readNativeChildTranscript(file, request, signal) } : {},
+		prompt: (task) => promptForAssistantText(runtime, task),
+		steer: (message) => runtime.steer(message),
+		followUp: (message) => runtime.followUp(message),
+		abort: () => runtime.abort(),
+		dispose: async () => {
+			try {
+				await runtime.dispose();
+			} finally {
+				release?.();
+				intercom?.dispose?.();
+			}
+		}
+	};
+}
+async function installIntercom(runtime, intercom, tools) {
+	if (!intercom) return;
+	const tool = intercom.bindRuntime(childRuntime(runtime));
+	const adapted = {
+		...tool,
+		parameters: tool.parameters,
+		execute: (operationId, params, signal, onUpdate) => tool.execute(operationId, params, signal, onUpdate)
+	};
+	await runtime.replaceTools([...tools, adapted]);
+}
+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 modelReference(value) {
+	if (value === void 0) return void 0;
+	const separator = value.indexOf("/");
+	if (separator <= 0 || separator === value.length - 1) throw new Error(`Child model must use the provider/model form: ${value}`);
+	return {
+		provider: value.slice(0, separator),
+		id: value.slice(separator + 1)
+	};
+}
+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
+	});
+}
+function sourceIdentity(filePath) {
+	const content = fs.readFileSync(filePath);
+	const stat = fs.statSync(filePath);
+	return {
+		path: filePath,
+		realPath: fs.realpathSync(filePath),
+		device: stat.dev,
+		inode: stat.ino,
+		size: stat.size,
+		mtimeMs: stat.mtimeMs,
+		sha256: createHash("sha256").update(content).digest("hex")
+	};
+}
+function rewriteImportedHeader(filePath, request, sourceSessionId) {
+	const lines = fs.readFileSync(filePath, "utf8").split("\n");
+	const header = asRecord(JSON.parse(lines[0] ?? ""));
+	if (header?.kind !== "header" || header.v !== 4) throw new Error("Terminal Pi child journal import did not produce a v4 JSONL file.");
+	header.id = randomUUID();
+	header.cwd = request.cwd;
+	header.parentSessionId = request.parentSessionId || sourceSessionId;
+	delete header.legacyParentSessionPath;
+	lines[0] = JSON.stringify(header);
+	fs.writeFileSync(filePath, lines.join("\n"));
+}
+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 root = fs.mkdtempSync(path.join(os.tmpdir(), "doom-terminal-pi-fork-"));
+	const sourcePath = path.join(root, "snapshot.jsonl");
+	fs.writeFileSync(sourcePath, source.snapshotJsonl, { mode: 384 });
+	const sessionsRoot = path.resolve(options.sessionsRoot ?? path.join(getAgentDir(), "sessions"));
+	fs.mkdirSync(sessionsRoot, {
+		recursive: true,
+		mode: 448
+	});
+	const destinationPath = path.join(sessionsRoot, `${Date.now()}-${randomUUID()}.jsonl`);
+	fs.copyFileSync(sourcePath, destinationPath, fs.constants.COPYFILE_EXCL);
+	let destinationLease;
+	let primaryFailure;
+	try {
+		destinationLease = await ownership.acquire(destinationPath);
+		await destinationLease.assertQuiescent();
+		await importV3WithPinnedUpstream({
+			sourcePath,
+			stagingPath: destinationPath,
+			originalPath: sourcePath,
+			sourceIdentity: sourceIdentity(sourcePath)
+		});
+		rewriteImportedHeader(destinationPath, request, source.sourceSessionId);
+	} catch (error) {
+		primaryFailure = error;
+	}
+	try {
+		await destinationLease?.release();
+	} catch (error) {
+		primaryFailure = primaryFailure === void 0 ? error : new AggregateError([primaryFailure, error]);
+	}
+	fs.rmSync(root, {
+		recursive: true,
+		force: true
+	});
+	if (primaryFailure !== void 0) {
+		fs.rmSync(destinationPath, { force: true });
+		throw primaryFailure;
+	}
+	return destinationPath;
+}
+function createTerminalPiChildSessionService(options) {
+	const runtimeFactory = options.runtimeFactory ?? createDirectHarnessRuntime;
+	const ownership = options.historyOwnership ?? createHistoryOwnership();
+	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 },
+		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);
+		const model = modelReference(request.model) ?? options.defaultModel?.();
+		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 },
+			...options.providers === void 0 ? {} : { providers: options.providers },
+			...model === void 0 ? {} : { model },
+			...request.thinking === void 0 ? {} : { thinkingLevel: request.thinking },
+			...directRequestOptions,
+			historyOwnership: ownership
+		};
+		let runtime;
+		try {
+			runtime = await runtimeFactory(runtimeOptions);
+			await installIntercom(runtime, request.intercom, runtimeOptions.tools ?? []);
+			const file = runtime.session.metadata.path;
+			return childRuntime(runtime, request.intercom, typeof file === "string" ? registerNativeChild(file, runtime) : void 0);
+		} catch (error) {
+			let failure = error;
+			try {
+				await runtime?.dispose();
+			} catch (cleanupError) {
+				failure = new AggregateError([error, 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=terminal-pi-child-session-service.mjs.map

package/dist/terminal-pi-child-session-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-pi-child-session-service.mjs","names":[],"sources":["../src/systems/child/adapters/terminalPiChildSessionService.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport type { Models, MutableModels, Provider } from '@earendil-works/pi-ai';\nimport { getAgentDir } from '@earendil-works/pi-coding-agent';\n\nimport {\n  createDoomChildSessionService,\n  type DoomChildSessionIntercom,\n  type DoomChildSessionRuntime,\n  type DoomChildSessionService,\n  type DoomChildSessionServiceProvider,\n  type DoomChildSessionTerminalPiForkSource,\n  type DoomChildSessionRequest,\n} from '../../../exports/childSession';\nimport {\n  createDirectHarnessRuntime,\n  promptForAssistantText,\n  type DirectHarnessRuntime,\n  type DirectHarnessRuntimeOptions,\n} from '../../../server/directHarnessRuntime';\nimport { readNativeChildTranscript } from '../../../server/nativeChildTranscriptReader';\nimport type { HistoryOwnership, HistoryOwnershipLease } from '../../../services/historyImport';\nimport { createHistoryOwnership } from '../../../services/historyOwnership';\nimport { importV3WithPinnedUpstream } from '../../../services/jsonlSessionRepo';\nimport type { DirectHarnessModel } from '../../../types/server/directHarnessRuntime';\nimport {\n  composeDirectHarnessRequestOptions,\n  createHeadlessChildSessionService,\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  readonly providers?: readonly Provider[];\n  readonly defaultModel?: () => DirectHarnessModel | undefined;\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,\n): DoomChildSessionRuntime {\n  const file = (runtime.session.metadata as unknown as { path?: unknown }).path;\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    steer: (message) => runtime.steer(message),\n    followUp: (message) => runtime.followUp(message),\n    abort: () => runtime.abort(),\n    dispose: async () => {\n      try {\n        await runtime.dispose();\n      } finally {\n        release?.();\n        intercom?.dispose?.();\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: (operationId: string, params: unknown, signal: AbortSignal, onUpdate: unknown) =>\n      tool.execute(operationId, params, signal, onUpdate as never),\n  } as unknown as DirectHarnessTool;\n  await runtime.replaceTools([...tools, adapted]);\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 modelReference(value: string | undefined): DirectHarnessModel | undefined {\n  if (value === undefined) return undefined;\n  const separator = value.indexOf('/');\n  if (separator <= 0 || separator === value.length - 1)\n    throw new Error(`Child model must use the provider/model form: ${value}`);\n  return { provider: value.slice(0, separator), id: value.slice(separator + 1) };\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\nfunction sourceIdentity(filePath: string): {\n  path: string;\n  realPath: string;\n  device: number;\n  inode: number;\n  size: number;\n  mtimeMs: number;\n  sha256: string;\n} {\n  const content = fs.readFileSync(filePath);\n  const stat = fs.statSync(filePath);\n  return {\n    path: filePath,\n    realPath: fs.realpathSync(filePath),\n    device: stat.dev,\n    inode: stat.ino,\n    size: stat.size,\n    mtimeMs: stat.mtimeMs,\n    sha256: createHash('sha256').update(content).digest('hex'),\n  };\n}\n\nfunction rewriteImportedHeader(filePath: string, request: DoomChildSessionRequest, sourceSessionId: string): void {\n  const lines = fs.readFileSync(filePath, 'utf8').split('\\n');\n  const header = asRecord(JSON.parse(lines[0] ?? ''));\n  if (header?.kind !== 'header' || header.v !== 4)\n    throw new Error('Terminal Pi child journal import did not produce a v4 JSONL file.');\n  header.id = randomUUID();\n  header.cwd = request.cwd;\n  header.parentSessionId = request.parentSessionId || sourceSessionId;\n  delete header.legacyParentSessionPath;\n  lines[0] = JSON.stringify(header);\n  fs.writeFileSync(filePath, lines.join('\\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 root = fs.mkdtempSync(path.join(os.tmpdir(), 'doom-terminal-pi-fork-'));\n  const sourcePath = path.join(root, 'snapshot.jsonl');\n  fs.writeFileSync(sourcePath, source.snapshotJsonl, { mode: 0o600 });\n  const sessionsRoot = path.resolve(options.sessionsRoot ?? path.join(getAgentDir(), 'sessions'));\n  fs.mkdirSync(sessionsRoot, { recursive: true, mode: 0o700 });\n  const destinationPath = path.join(sessionsRoot, `${Date.now()}-${randomUUID()}.jsonl`);\n  fs.copyFileSync(sourcePath, destinationPath, fs.constants.COPYFILE_EXCL);\n\n  let destinationLease: HistoryOwnershipLease | undefined;\n  let primaryFailure: unknown;\n  try {\n    destinationLease = await ownership.acquire(destinationPath);\n    await destinationLease.assertQuiescent();\n    await importV3WithPinnedUpstream({\n      sourcePath,\n      stagingPath: destinationPath,\n      originalPath: sourcePath,\n      sourceIdentity: sourceIdentity(sourcePath),\n    });\n    rewriteImportedHeader(destinationPath, request, source.sourceSessionId);\n  } catch (error) {\n    primaryFailure = error;\n  }\n  try {\n    await destinationLease?.release();\n  } catch (error) {\n    primaryFailure = primaryFailure === undefined ? error : new AggregateError([primaryFailure, error]);\n  }\n  fs.rmSync(root, { recursive: true, force: true });\n  if (primaryFailure !== undefined) {\n    fs.rmSync(destinationPath, { force: true });\n    throw primaryFailure;\n  }\n  return destinationPath;\n}\n\nexport function createTerminalPiChildSessionService(\n  options: TerminalPiChildSessionServiceOptions,\n): DoomChildSessionService {\n  const runtimeFactory = options.runtimeFactory ?? createDirectHarnessRuntime;\n  const ownership = options.historyOwnership ?? createHistoryOwnership();\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    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);\n      const model = modelReference(request.model) ?? options.defaultModel?.();\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        ...(options.providers === undefined ? {} : { providers: options.providers }),\n        ...(model === undefined ? {} : { model }),\n        ...(request.thinking === undefined ? {} : { thinkingLevel: request.thinking as never }),\n        ...directRequestOptions,\n        historyOwnership: ownership,\n      };\n      let runtime: DirectHarnessRuntime | undefined;\n      try {\n        runtime = await runtimeFactory(runtimeOptions);\n        await installIntercom(runtime, request.intercom, (runtimeOptions.tools ?? []) as DirectHarnessTool[]);\n        const file = (runtime.session.metadata as unknown as { path?: unknown }).path;\n        return childRuntime(\n          runtime,\n          request.intercom,\n          typeof file === 'string' ? registerNativeChild(file, runtime) : undefined,\n        );\n      } catch (error) {\n        let failure: unknown = error;\n        try {\n          await runtime?.dispose();\n        } catch (cleanupError) {\n          failure = new AggregateError([error, 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/pi/extensionScenarios.cjs

@@ -0,0 +1,73 @@
+const require_testHost = require("./testHost.cjs");
+//#region src/testing/pi/extensionScenarios.ts
+const SHUTDOWN_EVENT = "session_shutdown";
+const START_EVENT = "session_start";
+function fail(message) {
+	throw new Error(message);
+}
+function assertContains(actual, expected, subject) {
+	const missing = expected.filter((name) => !actual.includes(name));
+	if (missing.length > 0) fail(`Expected ${subject} ${missing.join(", ")}; the entry registered ${actual.join(", ") || "nothing"}.`);
+}
+function standardExtensionScenarios(options) {
+	const expectedTools = options.tools ?? [];
+	const expectedCommands = options.commands ?? [];
+	const build = options.createHost ?? require_testHost.createPiTestHost;
+	/** Runs one scenario against its own host, and disposes it either way. */
+	const scenario = (name, hostOptions, body) => ({
+		name,
+		async run() {
+			const host = build(hostOptions);
+			try {
+				await host.cordis("standard-extension-contract");
+				await body(host);
+			} finally {
+				await host.dispose();
+			}
+		}
+	});
+	return [
+		scenario("registers its declared tools and commands when the host loads it", {}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			assertContains(host.tools.map(({ name }) => name), expectedTools, "the entry to register tools");
+			assertContains(host.commands.map(({ name }) => name), expectedCommands, "the entry to claim commands");
+		}),
+		scenario("handles session_shutdown, so the host can reclaim what it registered", {}, async (host) => {
+			const before = host.handlers(SHUTDOWN_EVENT).length;
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			if (host.handlers(SHUTDOWN_EVENT).length === before) fail("The entry registered no session_shutdown handler, so nothing it holds is ever released.");
+		}),
+		scenario("takes a repeated shutdown without failing the second one", {}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			await host.emit(SHUTDOWN_EVENT, { reason: "quit" });
+			await host.emit(SHUTDOWN_EVENT, { reason: "quit" });
+		}),
+		scenario("loads again on the same host after a shutdown, the way /reload does", {}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			await host.emit(SHUTDOWN_EVENT, { reason: "reload" });
+			const before = host.tools.length;
+			await host.cordis("standard-extension-contract");
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			if (expectedTools.length > 0 && host.tools.length === before) fail("Loading the entry again registered nothing: a module-level latch is surviving the reload.");
+			assertContains(host.tools.slice(before).map(({ name }) => name), expectedTools, "the reloaded entry to register tools");
+		}),
+		scenario("installs and shuts down on a headless host", {
+			hasUI: false,
+			mode: "rpc"
+		}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			await host.emit(START_EVENT, { reason: "startup" });
+			await host.emit(SHUTDOWN_EVENT, { reason: "quit" });
+		})
+	];
+}
+//#endregion
+exports.standardExtensionScenarios = standardExtensionScenarios;
+
+//# sourceMappingURL=extensionScenarios.cjs.map

package/dist/testing/pi/extensionScenarios.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionScenarios.cjs","names":["createPiTestHost"],"sources":["../../../src/testing/pi/extensionScenarios.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\n\nimport { createPiTestHost, type PiTestHost, type PiTestHostOptions } from './testHost';\n\n/**\n * The lifecycle every standard Pi entry owes its host, as runnable scenarios.\n *\n * Eight packages carry their own partial copy of this, and the copies disagree\n * about which parts matter. What they share is what a host actually depends on:\n * that loading the entry registers something, that shutdown can be delivered\n * twice, and that a `/reload` can install the entry again on the same runner.\n *\n * Scenarios are plain data, not `describe`/`it` calls, so this adds no test\n * framework to a package every extension already installs. A caller loops:\n *\n * ```ts\n * for (const scenario of standardExtensionScenarios({ factory, tools: ['x'] })) {\n *   it(scenario.name, () => scenario.run());\n * }\n * ```\n *\n * Deeper fencing is deliberately not here. A package that makes a shut-down\n * tool answer instead of run owns that message and that decision, so it keeps\n * the test too; this covers only what is true of every extension.\n */\n\nexport interface StandardExtensionContractOptions {\n  /** The package's standard Pi entry: the default export Pi invokes. */\n  factory(pi: ExtensionAPI): Promise<void> | void;\n  /** Tool names loading the entry must register. */\n  tools?: readonly string[];\n  /** Slash commands loading the entry must claim. */\n  commands?: readonly string[];\n  /** A fresh host per scenario, for a factory that needs one stubbed a certain way. */\n  createHost?: (options: PiTestHostOptions) => PiTestHost;\n}\n\nexport interface ExtensionContractScenario {\n  name: string;\n  run(): Promise<void>;\n}\n\nconst SHUTDOWN_EVENT = 'session_shutdown';\nconst START_EVENT = 'session_start';\n\nfunction fail(message: string): never {\n  throw new Error(message);\n}\n\nfunction assertContains(actual: readonly string[], expected: readonly string[], subject: string): void {\n  const missing = expected.filter((name) => !actual.includes(name));\n  if (missing.length > 0) {\n    fail(`Expected ${subject} ${missing.join(', ')}; the entry registered ${actual.join(', ') || 'nothing'}.`);\n  }\n}\n\nexport function standardExtensionScenarios(\n  options: StandardExtensionContractOptions,\n): readonly ExtensionContractScenario[] {\n  const expectedTools = options.tools ?? [];\n  const expectedCommands = options.commands ?? [];\n  const build = options.createHost ?? createPiTestHost;\n\n  /** Runs one scenario against its own host, and disposes it either way. */\n  const scenario = (\n    name: string,\n    hostOptions: PiTestHostOptions,\n    body: (host: PiTestHost) => Promise<void>,\n  ): ExtensionContractScenario => ({\n    name,\n    async run() {\n      const host = build(hostOptions);\n      try {\n        await host.cordis('standard-extension-contract');\n        await body(host);\n      } finally {\n        await host.dispose();\n      }\n    },\n  });\n\n  return [\n    scenario('registers its declared tools and commands when the host loads it', {}, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      assertContains(\n        host.tools.map(({ name }) => name),\n        expectedTools,\n        'the entry to register tools',\n      );\n      assertContains(\n        host.commands.map(({ name }) => name),\n        expectedCommands,\n        'the entry to claim commands',\n      );\n    }),\n\n    scenario('handles session_shutdown, so the host can reclaim what it registered', {}, async (host) => {\n      const before = host.handlers(SHUTDOWN_EVENT).length;\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      if (host.handlers(SHUTDOWN_EVENT).length === before) {\n        fail('The entry registered no session_shutdown handler, so nothing it holds is ever released.');\n      }\n    }),\n\n    scenario('takes a repeated shutdown without failing the second one', {}, async (host) => {\n      // Pi delivers shutdown per registered extension, and a package that\n      // installed twice on one runner receives it twice.\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n    }),\n\n    scenario('loads again on the same host after a shutdown, the way /reload does', {}, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n      await host.emit(SHUTDOWN_EVENT, { reason: 'reload' });\n      const before = host.tools.length;\n\n      await host.cordis('standard-extension-contract');\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      if (expectedTools.length > 0 && host.tools.length === before) {\n        fail('Loading the entry again registered nothing: a module-level latch is surviving the reload.');\n      }\n      assertContains(\n        host.tools.slice(before).map(({ name }) => name),\n        expectedTools,\n        'the reloaded entry to register tools',\n      );\n    }),\n\n    // The cockpit and the RPC runtime both load extensions with no TUI. An\n    // entry that reaches for one there takes the whole session down.\n    scenario('installs and shuts down on a headless host', { hasUI: false, mode: 'rpc' }, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n      await host.emit(START_EVENT, { reason: 'startup' });\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n    }),\n  ];\n}\n"],"mappings":";;AA0CA,MAAM,iBAAiB;AACvB,MAAM,cAAc;AAEpB,SAAS,KAAK,SAAwB;CACpC,MAAM,IAAI,MAAM,OAAO;AACzB;AAEA,SAAS,eAAe,QAA2B,UAA6B,SAAuB;CACrG,MAAM,UAAU,SAAS,QAAQ,SAAS,CAAC,OAAO,SAAS,IAAI,CAAC;CAChE,IAAI,QAAQ,SAAS,GACnB,KAAK,YAAY,QAAQ,GAAG,QAAQ,KAAK,IAAI,EAAE,yBAAyB,OAAO,KAAK,IAAI,KAAK,UAAU,EAAE;AAE7G;AAEA,SAAgB,2BACd,SACsC;CACtC,MAAM,gBAAgB,QAAQ,SAAS,CAAC;CACxC,MAAM,mBAAmB,QAAQ,YAAY,CAAC;CAC9C,MAAM,QAAQ,QAAQ,cAAcA,iBAAAA;;CAGpC,MAAM,YACJ,MACA,aACA,UAC+B;EAC/B;EACA,MAAM,MAAM;GACV,MAAM,OAAO,MAAM,WAAW;GAC9B,IAAI;IACF,MAAM,KAAK,OAAO,6BAA6B;IAC/C,MAAM,KAAK,IAAI;GACjB,UAAU;IACR,MAAM,KAAK,QAAQ;GACrB;EACF;CACF;CAEA,OAAO;EACL,SAAS,oEAAoE,CAAC,GAAG,OAAO,SAAS;GAC/F,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,eACE,KAAK,MAAM,KAAK,EAAE,WAAW,IAAI,GACjC,eACA,6BACF;GACA,eACE,KAAK,SAAS,KAAK,EAAE,WAAW,IAAI,GACpC,kBACA,6BACF;EACF,CAAC;EAED,SAAS,wEAAwE,CAAC,GAAG,OAAO,SAAS;GACnG,MAAM,SAAS,KAAK,SAAS,cAAc,CAAC,CAAC;GAC7C,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,IAAI,KAAK,SAAS,cAAc,CAAC,CAAC,WAAW,QAC3C,KAAK,yFAAyF;EAElG,CAAC;EAED,SAAS,4DAA4D,CAAC,GAAG,OAAO,SAAS;GAGvF,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;GAClD,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;EACpD,CAAC;EAED,SAAS,uEAAuE,CAAC,GAAG,OAAO,SAAS;GAClG,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAC7B,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,SAAS,CAAC;GACpD,MAAM,SAAS,KAAK,MAAM;GAE1B,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,IAAI,cAAc,SAAS,KAAK,KAAK,MAAM,WAAW,QACpD,KAAK,2FAA2F;GAElG,eACE,KAAK,MAAM,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,GAC/C,eACA,sCACF;EACF,CAAC;EAID,SAAS,8CAA8C;GAAE,OAAO;GAAO,MAAM;EAAM,GAAG,OAAO,SAAS;GACpG,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAC7B,MAAM,KAAK,KAAK,aAAa,EAAE,QAAQ,UAAU,CAAC;GAClD,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;EACpD,CAAC;CACH;AACF"}

package/dist/testing/pi/extensionScenarios.d.cts

@@ -0,0 +1,41 @@
+import { PiTestHost, PiTestHostOptions } from "./testHost.cjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/testing/pi/extensionScenarios.d.ts
+/**
+ * The lifecycle every standard Pi entry owes its host, as runnable scenarios.
+ *
+ * Eight packages carry their own partial copy of this, and the copies disagree
+ * about which parts matter. What they share is what a host actually depends on:
+ * that loading the entry registers something, that shutdown can be delivered
+ * twice, and that a `/reload` can install the entry again on the same runner.
+ *
+ * Scenarios are plain data, not `describe`/`it` calls, so this adds no test
+ * framework to a package every extension already installs. A caller loops:
+ *
+ * ```ts
+ * for (const scenario of standardExtensionScenarios({ factory, tools: ['x'] })) {
+ *   it(scenario.name, () => scenario.run());
+ * }
+ * ```
+ *
+ * Deeper fencing is deliberately not here. A package that makes a shut-down
+ * tool answer instead of run owns that message and that decision, so it keeps
+ * the test too; this covers only what is true of every extension.
+ */
+export interface StandardExtensionContractOptions {
+  /** The package's standard Pi entry: the default export Pi invokes. */
+  factory(pi: ExtensionAPI): Promise<void> | void;
+  /** Tool names loading the entry must register. */
+  tools?: readonly string[];
+  /** Slash commands loading the entry must claim. */
+  commands?: readonly string[];
+  /** A fresh host per scenario, for a factory that needs one stubbed a certain way. */
+  createHost?: (options: PiTestHostOptions) => PiTestHost;
+}
+export interface ExtensionContractScenario {
+  name: string;
+  run(): Promise<void>;
+}
+export declare function standardExtensionScenarios(options: StandardExtensionContractOptions): readonly ExtensionContractScenario[];
+//#endregion
+//# sourceMappingURL=extensionScenarios.d.cts.map

package/dist/testing/pi/extensionScenarios.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionScenarios.d.cts","names":[],"sources":["../../../src/testing/pi/extensionScenarios.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;iBA0BiB;;EAEf,QAAQ,IAAI,eAAe;;EAE3B;;EAEA;;EAEA,cAAc,SAAS,sBAAsB;;iBAG9B;EACf;EACA,OAAO;;wBAiBO,2BACd,SAAS,4CACC"}

package/dist/testing/pi/extensionScenarios.d.mts

@@ -0,0 +1,41 @@
+import { PiTestHost, PiTestHostOptions } from "./testHost.mjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/testing/pi/extensionScenarios.d.ts
+/**
+ * The lifecycle every standard Pi entry owes its host, as runnable scenarios.
+ *
+ * Eight packages carry their own partial copy of this, and the copies disagree
+ * about which parts matter. What they share is what a host actually depends on:
+ * that loading the entry registers something, that shutdown can be delivered
+ * twice, and that a `/reload` can install the entry again on the same runner.
+ *
+ * Scenarios are plain data, not `describe`/`it` calls, so this adds no test
+ * framework to a package every extension already installs. A caller loops:
+ *
+ * ```ts
+ * for (const scenario of standardExtensionScenarios({ factory, tools: ['x'] })) {
+ *   it(scenario.name, () => scenario.run());
+ * }
+ * ```
+ *
+ * Deeper fencing is deliberately not here. A package that makes a shut-down
+ * tool answer instead of run owns that message and that decision, so it keeps
+ * the test too; this covers only what is true of every extension.
+ */
+export interface StandardExtensionContractOptions {
+  /** The package's standard Pi entry: the default export Pi invokes. */
+  factory(pi: ExtensionAPI): Promise<void> | void;
+  /** Tool names loading the entry must register. */
+  tools?: readonly string[];
+  /** Slash commands loading the entry must claim. */
+  commands?: readonly string[];
+  /** A fresh host per scenario, for a factory that needs one stubbed a certain way. */
+  createHost?: (options: PiTestHostOptions) => PiTestHost;
+}
+export interface ExtensionContractScenario {
+  name: string;
+  run(): Promise<void>;
+}
+export declare function standardExtensionScenarios(options: StandardExtensionContractOptions): readonly ExtensionContractScenario[];
+//#endregion
+//# sourceMappingURL=extensionScenarios.d.mts.map

package/dist/testing/pi/extensionScenarios.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionScenarios.d.mts","names":[],"sources":["../../../src/testing/pi/extensionScenarios.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;iBA0BiB;;EAEf,QAAQ,IAAI,eAAe;;EAE3B;;EAEA;;EAEA,cAAc,SAAS,sBAAsB;;iBAG9B;EACf;EACA,OAAO;;wBAiBO,2BACd,SAAS,4CACC"}

package/dist/testing/pi/extensionScenarios.mjs

@@ -0,0 +1,73 @@
+import { createPiTestHost } from "./testHost.mjs";
+//#region src/testing/pi/extensionScenarios.ts
+const SHUTDOWN_EVENT = "session_shutdown";
+const START_EVENT = "session_start";
+function fail(message) {
+	throw new Error(message);
+}
+function assertContains(actual, expected, subject) {
+	const missing = expected.filter((name) => !actual.includes(name));
+	if (missing.length > 0) fail(`Expected ${subject} ${missing.join(", ")}; the entry registered ${actual.join(", ") || "nothing"}.`);
+}
+function standardExtensionScenarios(options) {
+	const expectedTools = options.tools ?? [];
+	const expectedCommands = options.commands ?? [];
+	const build = options.createHost ?? createPiTestHost;
+	/** Runs one scenario against its own host, and disposes it either way. */
+	const scenario = (name, hostOptions, body) => ({
+		name,
+		async run() {
+			const host = build(hostOptions);
+			try {
+				await host.cordis("standard-extension-contract");
+				await body(host);
+			} finally {
+				await host.dispose();
+			}
+		}
+	});
+	return [
+		scenario("registers its declared tools and commands when the host loads it", {}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			assertContains(host.tools.map(({ name }) => name), expectedTools, "the entry to register tools");
+			assertContains(host.commands.map(({ name }) => name), expectedCommands, "the entry to claim commands");
+		}),
+		scenario("handles session_shutdown, so the host can reclaim what it registered", {}, async (host) => {
+			const before = host.handlers(SHUTDOWN_EVENT).length;
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			if (host.handlers(SHUTDOWN_EVENT).length === before) fail("The entry registered no session_shutdown handler, so nothing it holds is ever released.");
+		}),
+		scenario("takes a repeated shutdown without failing the second one", {}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			await host.emit(SHUTDOWN_EVENT, { reason: "quit" });
+			await host.emit(SHUTDOWN_EVENT, { reason: "quit" });
+		}),
+		scenario("loads again on the same host after a shutdown, the way /reload does", {}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			await host.emit(SHUTDOWN_EVENT, { reason: "reload" });
+			const before = host.tools.length;
+			await host.cordis("standard-extension-contract");
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			if (expectedTools.length > 0 && host.tools.length === before) fail("Loading the entry again registered nothing: a module-level latch is surviving the reload.");
+			assertContains(host.tools.slice(before).map(({ name }) => name), expectedTools, "the reloaded entry to register tools");
+		}),
+		scenario("installs and shuts down on a headless host", {
+			hasUI: false,
+			mode: "rpc"
+		}, async (host) => {
+			await host.cordis("standard-extension-contract");
+			await options.factory(host.pi);
+			await host.emit(START_EVENT, { reason: "startup" });
+			await host.emit(SHUTDOWN_EVENT, { reason: "quit" });
+		})
+	];
+}
+//#endregion
+export { standardExtensionScenarios };
+
+//# sourceMappingURL=extensionScenarios.mjs.map

package/dist/testing/pi/extensionScenarios.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionScenarios.mjs","names":[],"sources":["../../../src/testing/pi/extensionScenarios.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\n\nimport { createPiTestHost, type PiTestHost, type PiTestHostOptions } from './testHost';\n\n/**\n * The lifecycle every standard Pi entry owes its host, as runnable scenarios.\n *\n * Eight packages carry their own partial copy of this, and the copies disagree\n * about which parts matter. What they share is what a host actually depends on:\n * that loading the entry registers something, that shutdown can be delivered\n * twice, and that a `/reload` can install the entry again on the same runner.\n *\n * Scenarios are plain data, not `describe`/`it` calls, so this adds no test\n * framework to a package every extension already installs. A caller loops:\n *\n * ```ts\n * for (const scenario of standardExtensionScenarios({ factory, tools: ['x'] })) {\n *   it(scenario.name, () => scenario.run());\n * }\n * ```\n *\n * Deeper fencing is deliberately not here. A package that makes a shut-down\n * tool answer instead of run owns that message and that decision, so it keeps\n * the test too; this covers only what is true of every extension.\n */\n\nexport interface StandardExtensionContractOptions {\n  /** The package's standard Pi entry: the default export Pi invokes. */\n  factory(pi: ExtensionAPI): Promise<void> | void;\n  /** Tool names loading the entry must register. */\n  tools?: readonly string[];\n  /** Slash commands loading the entry must claim. */\n  commands?: readonly string[];\n  /** A fresh host per scenario, for a factory that needs one stubbed a certain way. */\n  createHost?: (options: PiTestHostOptions) => PiTestHost;\n}\n\nexport interface ExtensionContractScenario {\n  name: string;\n  run(): Promise<void>;\n}\n\nconst SHUTDOWN_EVENT = 'session_shutdown';\nconst START_EVENT = 'session_start';\n\nfunction fail(message: string): never {\n  throw new Error(message);\n}\n\nfunction assertContains(actual: readonly string[], expected: readonly string[], subject: string): void {\n  const missing = expected.filter((name) => !actual.includes(name));\n  if (missing.length > 0) {\n    fail(`Expected ${subject} ${missing.join(', ')}; the entry registered ${actual.join(', ') || 'nothing'}.`);\n  }\n}\n\nexport function standardExtensionScenarios(\n  options: StandardExtensionContractOptions,\n): readonly ExtensionContractScenario[] {\n  const expectedTools = options.tools ?? [];\n  const expectedCommands = options.commands ?? [];\n  const build = options.createHost ?? createPiTestHost;\n\n  /** Runs one scenario against its own host, and disposes it either way. */\n  const scenario = (\n    name: string,\n    hostOptions: PiTestHostOptions,\n    body: (host: PiTestHost) => Promise<void>,\n  ): ExtensionContractScenario => ({\n    name,\n    async run() {\n      const host = build(hostOptions);\n      try {\n        await host.cordis('standard-extension-contract');\n        await body(host);\n      } finally {\n        await host.dispose();\n      }\n    },\n  });\n\n  return [\n    scenario('registers its declared tools and commands when the host loads it', {}, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      assertContains(\n        host.tools.map(({ name }) => name),\n        expectedTools,\n        'the entry to register tools',\n      );\n      assertContains(\n        host.commands.map(({ name }) => name),\n        expectedCommands,\n        'the entry to claim commands',\n      );\n    }),\n\n    scenario('handles session_shutdown, so the host can reclaim what it registered', {}, async (host) => {\n      const before = host.handlers(SHUTDOWN_EVENT).length;\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      if (host.handlers(SHUTDOWN_EVENT).length === before) {\n        fail('The entry registered no session_shutdown handler, so nothing it holds is ever released.');\n      }\n    }),\n\n    scenario('takes a repeated shutdown without failing the second one', {}, async (host) => {\n      // Pi delivers shutdown per registered extension, and a package that\n      // installed twice on one runner receives it twice.\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n    }),\n\n    scenario('loads again on the same host after a shutdown, the way /reload does', {}, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n      await host.emit(SHUTDOWN_EVENT, { reason: 'reload' });\n      const before = host.tools.length;\n\n      await host.cordis('standard-extension-contract');\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      if (expectedTools.length > 0 && host.tools.length === before) {\n        fail('Loading the entry again registered nothing: a module-level latch is surviving the reload.');\n      }\n      assertContains(\n        host.tools.slice(before).map(({ name }) => name),\n        expectedTools,\n        'the reloaded entry to register tools',\n      );\n    }),\n\n    // The cockpit and the RPC runtime both load extensions with no TUI. An\n    // entry that reaches for one there takes the whole session down.\n    scenario('installs and shuts down on a headless host', { hasUI: false, mode: 'rpc' }, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n      await host.emit(START_EVENT, { reason: 'startup' });\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n    }),\n  ];\n}\n"],"mappings":";;AA0CA,MAAM,iBAAiB;AACvB,MAAM,cAAc;AAEpB,SAAS,KAAK,SAAwB;CACpC,MAAM,IAAI,MAAM,OAAO;AACzB;AAEA,SAAS,eAAe,QAA2B,UAA6B,SAAuB;CACrG,MAAM,UAAU,SAAS,QAAQ,SAAS,CAAC,OAAO,SAAS,IAAI,CAAC;CAChE,IAAI,QAAQ,SAAS,GACnB,KAAK,YAAY,QAAQ,GAAG,QAAQ,KAAK,IAAI,EAAE,yBAAyB,OAAO,KAAK,IAAI,KAAK,UAAU,EAAE;AAE7G;AAEA,SAAgB,2BACd,SACsC;CACtC,MAAM,gBAAgB,QAAQ,SAAS,CAAC;CACxC,MAAM,mBAAmB,QAAQ,YAAY,CAAC;CAC9C,MAAM,QAAQ,QAAQ,cAAc;;CAGpC,MAAM,YACJ,MACA,aACA,UAC+B;EAC/B;EACA,MAAM,MAAM;GACV,MAAM,OAAO,MAAM,WAAW;GAC9B,IAAI;IACF,MAAM,KAAK,OAAO,6BAA6B;IAC/C,MAAM,KAAK,IAAI;GACjB,UAAU;IACR,MAAM,KAAK,QAAQ;GACrB;EACF;CACF;CAEA,OAAO;EACL,SAAS,oEAAoE,CAAC,GAAG,OAAO,SAAS;GAC/F,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,eACE,KAAK,MAAM,KAAK,EAAE,WAAW,IAAI,GACjC,eACA,6BACF;GACA,eACE,KAAK,SAAS,KAAK,EAAE,WAAW,IAAI,GACpC,kBACA,6BACF;EACF,CAAC;EAED,SAAS,wEAAwE,CAAC,GAAG,OAAO,SAAS;GACnG,MAAM,SAAS,KAAK,SAAS,cAAc,CAAC,CAAC;GAC7C,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,IAAI,KAAK,SAAS,cAAc,CAAC,CAAC,WAAW,QAC3C,KAAK,yFAAyF;EAElG,CAAC;EAED,SAAS,4DAA4D,CAAC,GAAG,OAAO,SAAS;GAGvF,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;GAClD,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;EACpD,CAAC;EAED,SAAS,uEAAuE,CAAC,GAAG,OAAO,SAAS;GAClG,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAC7B,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,SAAS,CAAC;GACpD,MAAM,SAAS,KAAK,MAAM;GAE1B,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,IAAI,cAAc,SAAS,KAAK,KAAK,MAAM,WAAW,QACpD,KAAK,2FAA2F;GAElG,eACE,KAAK,MAAM,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,GAC/C,eACA,sCACF;EACF,CAAC;EAID,SAAS,8CAA8C;GAAE,OAAO;GAAO,MAAM;EAAM,GAAG,OAAO,SAAS;GACpG,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAC7B,MAAM,KAAK,KAAK,aAAa,EAAE,QAAQ,UAAU,CAAC;GAClD,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;EACpD,CAAC;CACH;AACF"}