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

package/dist/terminalPiChildSessionService.cjs

@@ -0,0 +1,267 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_index = require("./src/systems/child/services/childSession/index.cjs");
+const require_historyOwnership = require("./historyOwnership.cjs");
+const require_jsonlSessionRepo = require("./jsonlSessionRepo.cjs");
+const require_directHarnessRuntime = require("./src/server/directHarnessRuntime.cjs");
+const require_nativeChildRuntimes = require("./src/systems/child/adapters/nativeChildRuntimes.cjs");
+const require_nativeChildTranscriptReader = require("./src/server/nativeChildTranscriptReader.cjs");
+const require_headlessChildSessionService = require("./src/systems/child/adapters/headlessChildSessionService.cjs");
+let node_crypto = require("node:crypto");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
+//#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) => require_nativeChildTranscriptReader.readNativeChildTranscript(file, request, signal) } : {},
+		prompt: (task) => require_directHarnessRuntime.promptForAssistantText(runtime, task),
+		steer: (message) => runtime.steer(message),
+		followUp: (message) => runtime.followUp(message),
+		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 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 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 = node_fs.default.readFileSync(filePath);
+	const stat = node_fs.default.statSync(filePath);
+	return {
+		path: filePath,
+		realPath: node_fs.default.realpathSync(filePath),
+		device: stat.dev,
+		inode: stat.ino,
+		size: stat.size,
+		mtimeMs: stat.mtimeMs,
+		sha256: (0, node_crypto.createHash)("sha256").update(content).digest("hex")
+	};
+}
+function rewriteImportedHeader(filePath, request, sourceSessionId) {
+	const lines = node_fs.default.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 = (0, node_crypto.randomUUID)();
+	header.cwd = request.cwd;
+	header.parentSessionId = request.parentSessionId || sourceSessionId;
+	delete header.legacyParentSessionPath;
+	lines[0] = JSON.stringify(header);
+	node_fs.default.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 = node_fs.default.mkdtempSync(node_path.default.join(node_os.default.tmpdir(), "doom-terminal-pi-fork-"));
+	const sourcePath = node_path.default.join(root, "snapshot.jsonl");
+	node_fs.default.writeFileSync(sourcePath, source.snapshotJsonl, { mode: 384 });
+	const sessionsRoot = node_path.default.resolve(options.sessionsRoot ?? node_path.default.join((0, _earendil_works_pi_coding_agent.getAgentDir)(), "sessions"));
+	node_fs.default.mkdirSync(sessionsRoot, {
+		recursive: true,
+		mode: 448
+	});
+	const destinationPath = node_path.default.join(sessionsRoot, `${Date.now()}-${(0, node_crypto.randomUUID)()}.jsonl`);
+	let destinationLease;
+	let primaryFailure;
+	try {
+		destinationLease = await ownership.acquire(destinationPath);
+		await destinationLease.assertQuiescent();
+		node_fs.default.copyFileSync(sourcePath, destinationPath, node_fs.default.constants.COPYFILE_EXCL);
+		await require_jsonlSessionRepo.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]);
+	}
+	node_fs.default.rmSync(root, {
+		recursive: true,
+		force: true
+	});
+	if (primaryFailure !== void 0) {
+		node_fs.default.rmSync(destinationPath, { force: true });
+		throw primaryFailure;
+	}
+	return destinationPath;
+}
+function createTerminalPiChildSessionService(options) {
+	const runtimeFactory = options.runtimeFactory ?? require_directHarnessRuntime.createDirectHarnessRuntime;
+	const ownership = options.historyOwnership ?? require_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 },
+		...options.mcpTool === void 0 ? {} : { mcpTool: options.mcpTool },
+		historyOwnership: ownership,
+		...options.now === void 0 ? {} : { now: options.now },
+		runtimeFactory
+	};
+	const headless = require_headlessChildSessionService.createHeadlessChildSessionService(headlessOptions);
+	const terminal = require_index.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 = require_headlessChildSessionService.composeDirectHarnessRequestOptions(request, options.mcpTool);
+		const requestedModel = require_headlessChildSessionService.parseChildModelReference(request.model);
+		const model = requestedModel?.model ?? options.defaultModel?.();
+		const thinking = request.thinking ?? requestedModel?.thinking;
+		const providers = require_headlessChildSessionService.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,
+			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" ? require_nativeChildRuntimes.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?.();
+				node_fs.default.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
+exports.captureTerminalPiForkSource = captureTerminalPiForkSource;
+exports.createTerminalPiChildSessionService = createTerminalPiChildSessionService;
+exports.createTerminalPiChildSessionServiceProvider = createTerminalPiChildSessionServiceProvider;
+
+//# sourceMappingURL=terminalPiChildSessionService.cjs.map

package/dist/terminalPiChildSessionService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalPiChildSessionService.cjs","names":["readNativeChildTranscript","promptForAssistantText","fs","createHash","randomUUID","path","os","getAgentDir","importV3WithPinnedUpstream","createDirectHarnessRuntime","createHistoryOwnership","createHeadlessChildSessionService","createDoomChildSessionService","composeDirectHarnessRequestOptions","parseChildModelReference","resolveChildProviders","registerNativeChild"],"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 type { DoomChildSessionTool } 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  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  readonly mcpTool?: () => DoomChildSessionTool | 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    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 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 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\n  let destinationLease: HistoryOwnershipLease | undefined;\n  let primaryFailure: unknown;\n  try {\n    // Take ownership before the destination exists. The staged copy still holds\n    // the v3 header until the importer rewrites it, and the v4 owner rejects a\n    // v3 source outright, so copying first makes acquisition impossible.\n    destinationLease = await ownership.acquire(destinationPath);\n    await destinationLease.assertQuiescent();\n    fs.copyFileSync(sourcePath, destinationPath, fs.constants.COPYFILE_EXCL);\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    ...(options.mcpTool === undefined ? {} : { mcpTool: options.mcpTool }),\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 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        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/terminalPiChildSessionService.d.mts

@@ -0,0 +1,42 @@
+import { DoomChildSessionService, DoomChildSessionServiceProvider, DoomChildSessionTerminalPiForkSource, DoomChildSessionTool } from "./src/systems/child/types/childSession.mjs";
+import "./childSession.mjs";
+import { HistoryOwnership } from "./historyImport.mjs";
+import { DirectHarnessModel, DirectHarnessRuntime, DirectHarnessRuntimeOptions } from "./src/types/server/directHarnessRuntime.mjs";
+import "./src/server/directHarnessRuntime.mjs";
+import { Models, MutableModels, Provider } from "@earendil-works/pi-ai";
+//#region src/systems/child/adapters/terminalPiChildSessionService.d.ts
+export interface TerminalPiChildSessionServiceOptions {
+  readonly cwd: string;
+  readonly sessionsRoot?: string;
+  readonly models?: Models | MutableModels;
+  /**
+   * Providers to merge into the model registry for every child spawn. A thunk
+   * is resolved per spawn so providers registered after this service was built,
+   * such as Pi extension providers, are still visible to the child.
+   */
+  readonly providers?: readonly Provider[] | (() => readonly Provider[]);
+  readonly defaultModel?: () => DirectHarnessModel | undefined;
+  readonly mcpTool?: () => DoomChildSessionTool | undefined;
+  readonly historyOwnership?: HistoryOwnership;
+  readonly now?: () => number;
+  readonly runtimeFactory?: (options: DirectHarnessRuntimeOptions) => Promise<DirectHarnessRuntime>;
+}
+export interface TerminalPiForkSourceManager {
+  getSessionId(): string;
+  getLeafId(): string | null;
+  getHeader(): {
+    type: string;
+    version?: number;
+    [key: string]: unknown;
+  } | null;
+  getBranch(fromId?: string): readonly Record<string, unknown>[];
+}
+/** Capture data from Pi memory, not its writable v3 path. The JSONL string is immutable after return. */
+export declare function captureTerminalPiForkSource(manager: TerminalPiForkSourceManager, selectedLeafId?: string | null): DoomChildSessionTerminalPiForkSource | undefined;
+export declare function createTerminalPiChildSessionService(options: TerminalPiChildSessionServiceOptions): DoomChildSessionService;
+export interface TerminalPiChildSessionServiceProvider extends DoomChildSessionServiceProvider {
+  close(): Promise<void>;
+}
+export declare function createTerminalPiChildSessionServiceProvider(options: TerminalPiChildSessionServiceOptions): TerminalPiChildSessionServiceProvider;
+//#endregion
+//# sourceMappingURL=terminalPiChildSessionService.d.mts.map

package/dist/terminalPiChildSessionService.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalPiChildSessionService.d.mts","names":[],"sources":["../src/systems/child/adapters/terminalPiChildSessionService.ts"],"mappings":";;;;;;;iBAsCiB;WACN;WACA;WACA,SAAS,SAAS;;;;;;WAMlB,qBAAqB,6BAA6B;WAClD,qBAAqB;WACrB,gBAAgB;WAChB,mBAAmB;WACnB;WACA,kBAAkB,SAAS,gCAAgC,QAAQ;;iBAG7D;EACf;EACA;EACA;IAAe;IAAc;KAAmB;;EAChD,UAAU,2BAA2B;;;wBA+FvB,4BACd,SAAS,6BACT,iCACC;wBAuGa,oCACd,SAAS,uCACR;iBAyFc,8CAA8C;EAC7D,SAAS;;wBAGK,4CACd,SAAS,uCACR"}

package/dist/terminalPiChildSessionService.mjs

@@ -0,0 +1,260 @@
+import { createDoomChildSessionService } from "./src/systems/child/services/childSession/index.mjs";
+import { createHistoryOwnership } from "./historyOwnership.mjs";
+import { importV3WithPinnedUpstream } from "./jsonlSessionRepo.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 { composeDirectHarnessRequestOptions, createHeadlessChildSessionService, parseChildModelReference, resolveChildProviders } from "./src/systems/child/adapters/headlessChildSessionService.mjs";
+import { createHash, randomUUID } from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+//#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),
+		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 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 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`);
+	let destinationLease;
+	let primaryFailure;
+	try {
+		destinationLease = await ownership.acquire(destinationPath);
+		await destinationLease.assertQuiescent();
+		fs.copyFileSync(sourcePath, destinationPath, fs.constants.COPYFILE_EXCL);
+		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 },
+		...options.mcpTool === void 0 ? {} : { mcpTool: options.mcpTool },
+		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 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,
+			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=terminalPiChildSessionService.mjs.map