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

package/dist/systems/child/services/childSession/index.cjs

@@ -0,0 +1,206 @@
+//#region src/systems/child/services/childSession/index.ts
+/**
+* Owns lifecycle for runtimes created by a direct host adapter.
+*
+* The factory is the host boundary: it must construct the direct harness, apply
+* history ownership, and return only after child extensions are composed.
+*/
+function createDoomChildSessionService(factory, dependencies) {
+	const handles = /* @__PURE__ */ new Map();
+	const transcriptReaders = /* @__PURE__ */ new Map();
+	const claimedRunIds = /* @__PURE__ */ new Set();
+	const starting = /* @__PURE__ */ new Set();
+	const cleanupFailures = [];
+	let closed = false;
+	let closePromise;
+	const release = (runId) => {
+		handles.delete(runId);
+		if (!transcriptReaders.has(runId)) claimedRunIds.delete(runId);
+	};
+	const recordCleanupFailure = (error) => {
+		cleanupFailures.push(error);
+	};
+	return {
+		start(request, signal) {
+			if (closed) return Promise.reject(/* @__PURE__ */ new Error("The Doom child-session service is closed."));
+			if (claimedRunIds.has(request.runId)) return Promise.reject(/* @__PURE__ */ new Error(`Child run '${request.runId}' already exists.`));
+			claimedRunIds.add(request.runId);
+			const pending = (async () => {
+				try {
+					signal?.throwIfAborted();
+					const handle = await createHandle(async (ownedRequest, ownedSignal) => {
+						const runtime = await factory(ownedRequest, ownedSignal);
+						if (runtime.readTranscriptPage) transcriptReaders.set(request.runId, (pageRequest, pageSignal) => runtime.readTranscriptPage(pageRequest, pageSignal));
+						return runtime;
+					}, dependencies, request, signal, () => release(request.runId), recordCleanupFailure);
+					if (closed || signal?.aborted) {
+						await handle.dispose();
+						throw signal?.reason ?? /* @__PURE__ */ new Error("Child session startup was cancelled.");
+					}
+					if (!isTerminal(handle.state())) handles.set(request.runId, handle);
+					return handle;
+				} catch (error) {
+					transcriptReaders.delete(request.runId);
+					release(request.runId);
+					throw error;
+				}
+			})();
+			starting.add(pending);
+			pending.then(() => starting.delete(pending), () => starting.delete(pending));
+			return pending;
+		},
+		get: (runId) => handles.get(runId),
+		async readTranscriptPage(runId, request, signal) {
+			if (closed) throw new Error("The Doom child-session service is closed.");
+			signal?.throwIfAborted();
+			const reader = transcriptReaders.get(runId);
+			if (!reader) throw new Error(`Child run '${runId}' has no readable transcript.`);
+			const page = await reader(request, signal);
+			signal?.throwIfAborted();
+			return page;
+		},
+		close() {
+			closePromise ??= (async () => {
+				if (closed) return;
+				closed = true;
+				await Promise.allSettled(starting);
+				const active = [...handles.values()];
+				await Promise.allSettled(active.map((handle) => handle.dispose()));
+				const failures = [...cleanupFailures];
+				handles.clear();
+				transcriptReaders.clear();
+				claimedRunIds.clear();
+				if (failures.length) throw new AggregateError(failures, "Doom child-session shutdown failed.");
+			})();
+			return closePromise;
+		}
+	};
+}
+function isTerminal(state) {
+	return state === "completed" || state === "failed" || state === "stopped";
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : typeof error === "string" ? error : "Unknown cleanup failure";
+}
+async function createHandle(factory, dependencies, request, signal, onTerminal, onCleanupFailure) {
+	const runtime = await factory(request, signal);
+	if (signal?.aborted) {
+		await runtime.dispose();
+		throw signal.reason ?? /* @__PURE__ */ new Error("Child session startup was cancelled.");
+	}
+	let state = "starting";
+	let disposed = false;
+	let lastEvent;
+	let finishPromise;
+	let stopPromise;
+	let cleanupPromise;
+	let abortCleanup;
+	const listeners = /* @__PURE__ */ new Set();
+	const sessionFile = runtime.sessionFile;
+	const emit = (next, message) => {
+		state = next;
+		const event = {
+			runId: request.runId,
+			state: next,
+			timestamp: dependencies.now(),
+			...message ? { message } : {},
+			...sessionFile ? { sessionFile } : {}
+		};
+		lastEvent = event;
+		for (const listener of Array.from(listeners)) try {
+			listener(event);
+		} catch {}
+	};
+	const cleanup = () => {
+		cleanupPromise ??= (async () => {
+			try {
+				await runtime.dispose();
+			} finally {
+				abortCleanup?.();
+				abortCleanup = void 0;
+			}
+		})();
+		return cleanupPromise;
+	};
+	const finish = (next, message) => {
+		finishPromise ??= (async () => {
+			let cleanupFailure;
+			try {
+				await cleanup();
+			} catch (error) {
+				cleanupFailure = error;
+				onCleanupFailure(error);
+			}
+			if (cleanupFailure === void 0) emit(next, message);
+			else {
+				const detail = errorMessage(cleanupFailure);
+				emit("failed", `Child session cleanup failed: ${detail}`);
+			}
+			disposed = true;
+			onTerminal();
+			listeners.clear();
+			if (cleanupFailure !== void 0) throw cleanupFailure;
+		})();
+		return finishPromise;
+	};
+	const handle = {
+		runId: request.runId,
+		...sessionFile ? { sessionFile } : {},
+		state: () => state,
+		subscribe(listener) {
+			if (disposed || isTerminal(state)) {
+				if (lastEvent) try {
+					listener(lastEvent);
+				} catch {}
+				return () => false;
+			}
+			listeners.add(listener);
+			if (lastEvent) try {
+				listener(lastEvent);
+			} catch {}
+			return () => listeners.delete(listener);
+		},
+		async steer(message, steerSignal) {
+			if (disposed || finishPromise) throw new Error(`Child run '${request.runId}' is no longer active.`);
+			steerSignal?.throwIfAborted();
+			await runtime.steer(message);
+			steerSignal?.throwIfAborted();
+		},
+		stop(reason) {
+			stopPromise ??= (async () => {
+				if (finishPromise) return finishPromise;
+				let abortFailure;
+				try {
+					await runtime.abort();
+				} catch (error) {
+					abortFailure = error;
+				}
+				let finishFailure;
+				try {
+					await finish("stopped", reason ?? "Child session stopped.");
+				} catch (error) {
+					finishFailure = error;
+				}
+				if (abortFailure !== void 0 && finishFailure !== void 0) throw new AggregateError([abortFailure, finishFailure], "Stopping the child session failed.");
+				if (abortFailure !== void 0) throw abortFailure;
+				if (finishFailure !== void 0) throw finishFailure;
+			})();
+			return stopPromise;
+		},
+		dispose: () => finish("stopped", "Child session disposed.")
+	};
+	if (signal) {
+		const onAbort = () => {
+			handle.stop("Child session startup was cancelled.").catch(() => void 0);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		abortCleanup = () => signal.removeEventListener("abort", onAbort);
+	}
+	emit("running");
+	Promise.resolve().then(() => runtime.prompt(request.task)).then((message) => finish("completed", typeof message === "string" ? message : void 0).catch(() => void 0), (error) => finish("failed", error instanceof Error ? error.message : String(error)).catch(() => void 0));
+	return handle;
+}
+//#endregion
+exports.createDoomChildSessionService = createDoomChildSessionService;
+
+//# sourceMappingURL=index.cjs.map

package/dist/systems/child/services/childSession/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../../src/systems/child/services/childSession/index.ts"],"sourcesContent":["import type { TranscriptPage, TranscriptPageRequest } from '../../../../schemas/sessionProtocol';\nimport type {\n  DoomChildSessionEvent,\n  DoomChildSessionHandle,\n  DoomChildSessionRequest,\n  DoomChildSessionRuntimeFactory,\n  DoomChildSessionService,\n  DoomChildSessionState,\n} from '../../types/childSession';\n\nexport interface DoomChildSessionServiceDependencies {\n  readonly now: () => number;\n}\n\n/**\n * Owns lifecycle for runtimes created by a direct host adapter.\n *\n * The factory is the host boundary: it must construct the direct harness, apply\n * history ownership, and return only after child extensions are composed.\n */\nexport function createDoomChildSessionService(\n  factory: DoomChildSessionRuntimeFactory,\n  dependencies: DoomChildSessionServiceDependencies,\n): DoomChildSessionService {\n  const handles = new Map<string, DoomChildSessionHandle>();\n  const transcriptReaders = new Map<\n    string,\n    (request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal) => Promise<TranscriptPage>\n  >();\n  const claimedRunIds = new Set<string>();\n  const starting = new Set<Promise<DoomChildSessionHandle>>();\n  const cleanupFailures: unknown[] = [];\n  let closed = false;\n  let closePromise: Promise<void> | undefined;\n\n  const release = (runId: string): void => {\n    handles.delete(runId);\n    if (!transcriptReaders.has(runId)) claimedRunIds.delete(runId);\n  };\n  const recordCleanupFailure = (error: unknown): void => {\n    cleanupFailures.push(error);\n  };\n\n  const service: DoomChildSessionService = {\n    start(request, signal) {\n      if (closed) return Promise.reject(new Error('The Doom child-session service is closed.'));\n      if (claimedRunIds.has(request.runId))\n        return Promise.reject(new Error(`Child run '${request.runId}' already exists.`));\n      claimedRunIds.add(request.runId);\n\n      const pending = (async (): Promise<DoomChildSessionHandle> => {\n        try {\n          signal?.throwIfAborted();\n          const handle = await createHandle(\n            async (ownedRequest, ownedSignal) => {\n              const runtime = await factory(ownedRequest, ownedSignal);\n              if (runtime.readTranscriptPage)\n                transcriptReaders.set(request.runId, (pageRequest, pageSignal) =>\n                  runtime.readTranscriptPage!(pageRequest, pageSignal),\n                );\n              return runtime;\n            },\n            dependencies,\n            request,\n            signal,\n            () => release(request.runId),\n            recordCleanupFailure,\n          );\n          if (closed || signal?.aborted) {\n            await handle.dispose();\n            throw signal?.reason ?? new Error('Child session startup was cancelled.');\n          }\n          if (!isTerminal(handle.state())) handles.set(request.runId, handle);\n          return handle;\n        } catch (error) {\n          transcriptReaders.delete(request.runId);\n          release(request.runId);\n          throw error;\n        }\n      })();\n      starting.add(pending);\n      void pending.then(\n        () => starting.delete(pending),\n        () => starting.delete(pending),\n      );\n      return pending;\n    },\n    get: (runId) => handles.get(runId),\n    async readTranscriptPage(runId, request, signal) {\n      if (closed) throw new Error('The Doom child-session service is closed.');\n      signal?.throwIfAborted();\n      const reader = transcriptReaders.get(runId);\n      if (!reader) throw new Error(`Child run '${runId}' has no readable transcript.`);\n      const page = await reader(request, signal);\n      signal?.throwIfAborted();\n      return page;\n    },\n    close() {\n      closePromise ??= (async () => {\n        if (closed) return;\n        closed = true;\n        await Promise.allSettled(starting);\n        const active = [...handles.values()];\n        await Promise.allSettled(active.map((handle) => handle.dispose()));\n        const failures = [...cleanupFailures];\n        handles.clear();\n        transcriptReaders.clear();\n        claimedRunIds.clear();\n        if (failures.length) throw new AggregateError(failures, 'Doom child-session shutdown failed.');\n      })();\n      return closePromise;\n    },\n  };\n  return service;\n}\n\nfunction isTerminal(state: DoomChildSessionState): boolean {\n  return state === 'completed' || state === 'failed' || state === 'stopped';\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : typeof error === 'string' ? error : 'Unknown cleanup failure';\n}\n\nasync function createHandle(\n  factory: DoomChildSessionRuntimeFactory,\n  dependencies: DoomChildSessionServiceDependencies,\n  request: DoomChildSessionRequest,\n  signal: AbortSignal | undefined,\n  onTerminal: () => void,\n  onCleanupFailure: (error: unknown) => void,\n): Promise<DoomChildSessionHandle> {\n  const runtime = await factory(request, signal);\n  if (signal?.aborted) {\n    await runtime.dispose();\n    throw signal.reason ?? new Error('Child session startup was cancelled.');\n  }\n\n  let state: DoomChildSessionState = 'starting';\n  let disposed = false;\n  let lastEvent: DoomChildSessionEvent | undefined;\n  let finishPromise: Promise<void> | undefined;\n  let stopPromise: Promise<void> | undefined;\n  let cleanupPromise: Promise<void> | undefined;\n  let abortCleanup: (() => void) | undefined;\n  const listeners = new Set<(event: DoomChildSessionEvent) => void>();\n  const sessionFile = runtime.sessionFile;\n\n  const emit = (next: DoomChildSessionState, message?: string): void => {\n    state = next;\n    const event: DoomChildSessionEvent = {\n      runId: request.runId,\n      state: next,\n      timestamp: dependencies.now(),\n      ...(message ? { message } : {}),\n      ...(sessionFile ? { sessionFile } : {}),\n    };\n    lastEvent = event;\n    for (const listener of Array.from(listeners)) {\n      try {\n        listener(event);\n      } catch {\n        // Observers must not fault child ownership.\n      }\n    }\n  };\n\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      try {\n        await runtime.dispose();\n      } finally {\n        abortCleanup?.();\n        abortCleanup = undefined;\n      }\n    })();\n    return cleanupPromise;\n  };\n\n  const finish = (\n    next: Extract<DoomChildSessionState, 'completed' | 'failed' | 'stopped'>,\n    message?: string,\n  ): Promise<void> => {\n    finishPromise ??= (async () => {\n      let cleanupFailure: unknown;\n      try {\n        await cleanup();\n      } catch (error) {\n        cleanupFailure = error;\n        onCleanupFailure(error);\n      }\n      if (cleanupFailure === undefined) {\n        emit(next, message);\n      } else {\n        const detail = errorMessage(cleanupFailure);\n        emit('failed', `Child session cleanup failed: ${detail}`);\n      }\n      disposed = true;\n      onTerminal();\n      listeners.clear();\n      if (cleanupFailure !== undefined) throw cleanupFailure;\n    })();\n    return finishPromise;\n  };\n\n  const handle: DoomChildSessionHandle = {\n    runId: request.runId,\n    ...(sessionFile ? { sessionFile } : {}),\n    state: () => state,\n    subscribe(listener) {\n      if (disposed || isTerminal(state)) {\n        if (lastEvent) {\n          try {\n            listener(lastEvent);\n          } catch {\n            // Observers must not fault child ownership.\n          }\n        }\n        return () => false;\n      }\n      listeners.add(listener);\n      if (lastEvent) {\n        try {\n          listener(lastEvent);\n        } catch {\n          // Observers must not fault child ownership.\n        }\n      }\n      return () => listeners.delete(listener);\n    },\n    async steer(message, steerSignal) {\n      if (disposed || finishPromise) throw new Error(`Child run '${request.runId}' is no longer active.`);\n      steerSignal?.throwIfAborted();\n      await runtime.steer(message);\n      steerSignal?.throwIfAborted();\n    },\n    stop(reason) {\n      stopPromise ??= (async () => {\n        if (finishPromise) return finishPromise;\n        let abortFailure: unknown;\n        try {\n          await runtime.abort();\n        } catch (error) {\n          abortFailure = error;\n        }\n        let finishFailure: unknown;\n        try {\n          await finish('stopped', reason ?? 'Child session stopped.');\n        } catch (error) {\n          finishFailure = error;\n        }\n        if (abortFailure !== undefined && finishFailure !== undefined)\n          throw new AggregateError([abortFailure, finishFailure], 'Stopping the child session failed.');\n        if (abortFailure !== undefined) throw abortFailure;\n        if (finishFailure !== undefined) throw finishFailure;\n      })();\n      return stopPromise;\n    },\n    dispose: () => finish('stopped', 'Child session disposed.'),\n  };\n\n  if (signal) {\n    const onAbort = (): void => {\n      void handle.stop('Child session startup was cancelled.').catch(() => undefined);\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    abortCleanup = () => signal.removeEventListener('abort', onAbort);\n  }\n  emit('running');\n  void Promise.resolve()\n    .then(() => runtime.prompt(request.task))\n    .then(\n      (message) => finish('completed', typeof message === 'string' ? message : undefined).catch(() => undefined),\n      (error: unknown) =>\n        finish('failed', error instanceof Error ? error.message : String(error)).catch(() => undefined),\n    );\n  return handle;\n}\n\nexport type { DoomChildSessionRuntime } from '../../types/childSession';\n"],"mappings":"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"}

package/dist/systems/child/services/childSession/index.d.cts

@@ -0,0 +1,14 @@
+import { DoomChildSessionRuntime, DoomChildSessionRuntimeFactory, DoomChildSessionService } from "../../types/childSession.cjs";
+//#region src/systems/child/services/childSession/index.d.ts
+export interface DoomChildSessionServiceDependencies {
+  readonly now: () => number;
+}
+/**
+ * Owns lifecycle for runtimes created by a direct host adapter.
+ *
+ * The factory is the host boundary: it must construct the direct harness, apply
+ * history ownership, and return only after child extensions are composed.
+ */
+export declare function createDoomChildSessionService(factory: DoomChildSessionRuntimeFactory, dependencies: DoomChildSessionServiceDependencies): DoomChildSessionService;
+//#endregion
+//# sourceMappingURL=index.d.cts.map

package/dist/systems/child/services/childSession/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../../src/systems/child/services/childSession/index.ts"],"mappings":";;iBAUiB;WACN;;;;;;;;wBASK,8BACd,SAAS,gCACT,cAAc,sCACb"}

package/dist/systems/child/services/childSession/index.d.mts

@@ -0,0 +1,14 @@
+import { DoomChildSessionRuntime, DoomChildSessionRuntimeFactory, DoomChildSessionService } from "../../types/childSession.mjs";
+//#region src/systems/child/services/childSession/index.d.ts
+export interface DoomChildSessionServiceDependencies {
+  readonly now: () => number;
+}
+/**
+ * Owns lifecycle for runtimes created by a direct host adapter.
+ *
+ * The factory is the host boundary: it must construct the direct harness, apply
+ * history ownership, and return only after child extensions are composed.
+ */
+export declare function createDoomChildSessionService(factory: DoomChildSessionRuntimeFactory, dependencies: DoomChildSessionServiceDependencies): DoomChildSessionService;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/systems/child/services/childSession/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/systems/child/services/childSession/index.ts"],"mappings":";;iBAUiB;WACN;;;;;;;;wBASK,8BACd,SAAS,gCACT,cAAc,sCACb"}

package/dist/systems/child/services/childSession/index.mjs

@@ -0,0 +1,206 @@
+//#region src/systems/child/services/childSession/index.ts
+/**
+* Owns lifecycle for runtimes created by a direct host adapter.
+*
+* The factory is the host boundary: it must construct the direct harness, apply
+* history ownership, and return only after child extensions are composed.
+*/
+function createDoomChildSessionService(factory, dependencies) {
+	const handles = /* @__PURE__ */ new Map();
+	const transcriptReaders = /* @__PURE__ */ new Map();
+	const claimedRunIds = /* @__PURE__ */ new Set();
+	const starting = /* @__PURE__ */ new Set();
+	const cleanupFailures = [];
+	let closed = false;
+	let closePromise;
+	const release = (runId) => {
+		handles.delete(runId);
+		if (!transcriptReaders.has(runId)) claimedRunIds.delete(runId);
+	};
+	const recordCleanupFailure = (error) => {
+		cleanupFailures.push(error);
+	};
+	return {
+		start(request, signal) {
+			if (closed) return Promise.reject(/* @__PURE__ */ new Error("The Doom child-session service is closed."));
+			if (claimedRunIds.has(request.runId)) return Promise.reject(/* @__PURE__ */ new Error(`Child run '${request.runId}' already exists.`));
+			claimedRunIds.add(request.runId);
+			const pending = (async () => {
+				try {
+					signal?.throwIfAborted();
+					const handle = await createHandle(async (ownedRequest, ownedSignal) => {
+						const runtime = await factory(ownedRequest, ownedSignal);
+						if (runtime.readTranscriptPage) transcriptReaders.set(request.runId, (pageRequest, pageSignal) => runtime.readTranscriptPage(pageRequest, pageSignal));
+						return runtime;
+					}, dependencies, request, signal, () => release(request.runId), recordCleanupFailure);
+					if (closed || signal?.aborted) {
+						await handle.dispose();
+						throw signal?.reason ?? /* @__PURE__ */ new Error("Child session startup was cancelled.");
+					}
+					if (!isTerminal(handle.state())) handles.set(request.runId, handle);
+					return handle;
+				} catch (error) {
+					transcriptReaders.delete(request.runId);
+					release(request.runId);
+					throw error;
+				}
+			})();
+			starting.add(pending);
+			pending.then(() => starting.delete(pending), () => starting.delete(pending));
+			return pending;
+		},
+		get: (runId) => handles.get(runId),
+		async readTranscriptPage(runId, request, signal) {
+			if (closed) throw new Error("The Doom child-session service is closed.");
+			signal?.throwIfAborted();
+			const reader = transcriptReaders.get(runId);
+			if (!reader) throw new Error(`Child run '${runId}' has no readable transcript.`);
+			const page = await reader(request, signal);
+			signal?.throwIfAborted();
+			return page;
+		},
+		close() {
+			closePromise ??= (async () => {
+				if (closed) return;
+				closed = true;
+				await Promise.allSettled(starting);
+				const active = [...handles.values()];
+				await Promise.allSettled(active.map((handle) => handle.dispose()));
+				const failures = [...cleanupFailures];
+				handles.clear();
+				transcriptReaders.clear();
+				claimedRunIds.clear();
+				if (failures.length) throw new AggregateError(failures, "Doom child-session shutdown failed.");
+			})();
+			return closePromise;
+		}
+	};
+}
+function isTerminal(state) {
+	return state === "completed" || state === "failed" || state === "stopped";
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : typeof error === "string" ? error : "Unknown cleanup failure";
+}
+async function createHandle(factory, dependencies, request, signal, onTerminal, onCleanupFailure) {
+	const runtime = await factory(request, signal);
+	if (signal?.aborted) {
+		await runtime.dispose();
+		throw signal.reason ?? /* @__PURE__ */ new Error("Child session startup was cancelled.");
+	}
+	let state = "starting";
+	let disposed = false;
+	let lastEvent;
+	let finishPromise;
+	let stopPromise;
+	let cleanupPromise;
+	let abortCleanup;
+	const listeners = /* @__PURE__ */ new Set();
+	const sessionFile = runtime.sessionFile;
+	const emit = (next, message) => {
+		state = next;
+		const event = {
+			runId: request.runId,
+			state: next,
+			timestamp: dependencies.now(),
+			...message ? { message } : {},
+			...sessionFile ? { sessionFile } : {}
+		};
+		lastEvent = event;
+		for (const listener of Array.from(listeners)) try {
+			listener(event);
+		} catch {}
+	};
+	const cleanup = () => {
+		cleanupPromise ??= (async () => {
+			try {
+				await runtime.dispose();
+			} finally {
+				abortCleanup?.();
+				abortCleanup = void 0;
+			}
+		})();
+		return cleanupPromise;
+	};
+	const finish = (next, message) => {
+		finishPromise ??= (async () => {
+			let cleanupFailure;
+			try {
+				await cleanup();
+			} catch (error) {
+				cleanupFailure = error;
+				onCleanupFailure(error);
+			}
+			if (cleanupFailure === void 0) emit(next, message);
+			else {
+				const detail = errorMessage(cleanupFailure);
+				emit("failed", `Child session cleanup failed: ${detail}`);
+			}
+			disposed = true;
+			onTerminal();
+			listeners.clear();
+			if (cleanupFailure !== void 0) throw cleanupFailure;
+		})();
+		return finishPromise;
+	};
+	const handle = {
+		runId: request.runId,
+		...sessionFile ? { sessionFile } : {},
+		state: () => state,
+		subscribe(listener) {
+			if (disposed || isTerminal(state)) {
+				if (lastEvent) try {
+					listener(lastEvent);
+				} catch {}
+				return () => false;
+			}
+			listeners.add(listener);
+			if (lastEvent) try {
+				listener(lastEvent);
+			} catch {}
+			return () => listeners.delete(listener);
+		},
+		async steer(message, steerSignal) {
+			if (disposed || finishPromise) throw new Error(`Child run '${request.runId}' is no longer active.`);
+			steerSignal?.throwIfAborted();
+			await runtime.steer(message);
+			steerSignal?.throwIfAborted();
+		},
+		stop(reason) {
+			stopPromise ??= (async () => {
+				if (finishPromise) return finishPromise;
+				let abortFailure;
+				try {
+					await runtime.abort();
+				} catch (error) {
+					abortFailure = error;
+				}
+				let finishFailure;
+				try {
+					await finish("stopped", reason ?? "Child session stopped.");
+				} catch (error) {
+					finishFailure = error;
+				}
+				if (abortFailure !== void 0 && finishFailure !== void 0) throw new AggregateError([abortFailure, finishFailure], "Stopping the child session failed.");
+				if (abortFailure !== void 0) throw abortFailure;
+				if (finishFailure !== void 0) throw finishFailure;
+			})();
+			return stopPromise;
+		},
+		dispose: () => finish("stopped", "Child session disposed.")
+	};
+	if (signal) {
+		const onAbort = () => {
+			handle.stop("Child session startup was cancelled.").catch(() => void 0);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		abortCleanup = () => signal.removeEventListener("abort", onAbort);
+	}
+	emit("running");
+	Promise.resolve().then(() => runtime.prompt(request.task)).then((message) => finish("completed", typeof message === "string" ? message : void 0).catch(() => void 0), (error) => finish("failed", error instanceof Error ? error.message : String(error)).catch(() => void 0));
+	return handle;
+}
+//#endregion
+export { createDoomChildSessionService };
+
+//# sourceMappingURL=index.mjs.map

package/dist/systems/child/services/childSession/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/systems/child/services/childSession/index.ts"],"sourcesContent":["import type { TranscriptPage, TranscriptPageRequest } from '../../../../schemas/sessionProtocol';\nimport type {\n  DoomChildSessionEvent,\n  DoomChildSessionHandle,\n  DoomChildSessionRequest,\n  DoomChildSessionRuntimeFactory,\n  DoomChildSessionService,\n  DoomChildSessionState,\n} from '../../types/childSession';\n\nexport interface DoomChildSessionServiceDependencies {\n  readonly now: () => number;\n}\n\n/**\n * Owns lifecycle for runtimes created by a direct host adapter.\n *\n * The factory is the host boundary: it must construct the direct harness, apply\n * history ownership, and return only after child extensions are composed.\n */\nexport function createDoomChildSessionService(\n  factory: DoomChildSessionRuntimeFactory,\n  dependencies: DoomChildSessionServiceDependencies,\n): DoomChildSessionService {\n  const handles = new Map<string, DoomChildSessionHandle>();\n  const transcriptReaders = new Map<\n    string,\n    (request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal) => Promise<TranscriptPage>\n  >();\n  const claimedRunIds = new Set<string>();\n  const starting = new Set<Promise<DoomChildSessionHandle>>();\n  const cleanupFailures: unknown[] = [];\n  let closed = false;\n  let closePromise: Promise<void> | undefined;\n\n  const release = (runId: string): void => {\n    handles.delete(runId);\n    if (!transcriptReaders.has(runId)) claimedRunIds.delete(runId);\n  };\n  const recordCleanupFailure = (error: unknown): void => {\n    cleanupFailures.push(error);\n  };\n\n  const service: DoomChildSessionService = {\n    start(request, signal) {\n      if (closed) return Promise.reject(new Error('The Doom child-session service is closed.'));\n      if (claimedRunIds.has(request.runId))\n        return Promise.reject(new Error(`Child run '${request.runId}' already exists.`));\n      claimedRunIds.add(request.runId);\n\n      const pending = (async (): Promise<DoomChildSessionHandle> => {\n        try {\n          signal?.throwIfAborted();\n          const handle = await createHandle(\n            async (ownedRequest, ownedSignal) => {\n              const runtime = await factory(ownedRequest, ownedSignal);\n              if (runtime.readTranscriptPage)\n                transcriptReaders.set(request.runId, (pageRequest, pageSignal) =>\n                  runtime.readTranscriptPage!(pageRequest, pageSignal),\n                );\n              return runtime;\n            },\n            dependencies,\n            request,\n            signal,\n            () => release(request.runId),\n            recordCleanupFailure,\n          );\n          if (closed || signal?.aborted) {\n            await handle.dispose();\n            throw signal?.reason ?? new Error('Child session startup was cancelled.');\n          }\n          if (!isTerminal(handle.state())) handles.set(request.runId, handle);\n          return handle;\n        } catch (error) {\n          transcriptReaders.delete(request.runId);\n          release(request.runId);\n          throw error;\n        }\n      })();\n      starting.add(pending);\n      void pending.then(\n        () => starting.delete(pending),\n        () => starting.delete(pending),\n      );\n      return pending;\n    },\n    get: (runId) => handles.get(runId),\n    async readTranscriptPage(runId, request, signal) {\n      if (closed) throw new Error('The Doom child-session service is closed.');\n      signal?.throwIfAborted();\n      const reader = transcriptReaders.get(runId);\n      if (!reader) throw new Error(`Child run '${runId}' has no readable transcript.`);\n      const page = await reader(request, signal);\n      signal?.throwIfAborted();\n      return page;\n    },\n    close() {\n      closePromise ??= (async () => {\n        if (closed) return;\n        closed = true;\n        await Promise.allSettled(starting);\n        const active = [...handles.values()];\n        await Promise.allSettled(active.map((handle) => handle.dispose()));\n        const failures = [...cleanupFailures];\n        handles.clear();\n        transcriptReaders.clear();\n        claimedRunIds.clear();\n        if (failures.length) throw new AggregateError(failures, 'Doom child-session shutdown failed.');\n      })();\n      return closePromise;\n    },\n  };\n  return service;\n}\n\nfunction isTerminal(state: DoomChildSessionState): boolean {\n  return state === 'completed' || state === 'failed' || state === 'stopped';\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : typeof error === 'string' ? error : 'Unknown cleanup failure';\n}\n\nasync function createHandle(\n  factory: DoomChildSessionRuntimeFactory,\n  dependencies: DoomChildSessionServiceDependencies,\n  request: DoomChildSessionRequest,\n  signal: AbortSignal | undefined,\n  onTerminal: () => void,\n  onCleanupFailure: (error: unknown) => void,\n): Promise<DoomChildSessionHandle> {\n  const runtime = await factory(request, signal);\n  if (signal?.aborted) {\n    await runtime.dispose();\n    throw signal.reason ?? new Error('Child session startup was cancelled.');\n  }\n\n  let state: DoomChildSessionState = 'starting';\n  let disposed = false;\n  let lastEvent: DoomChildSessionEvent | undefined;\n  let finishPromise: Promise<void> | undefined;\n  let stopPromise: Promise<void> | undefined;\n  let cleanupPromise: Promise<void> | undefined;\n  let abortCleanup: (() => void) | undefined;\n  const listeners = new Set<(event: DoomChildSessionEvent) => void>();\n  const sessionFile = runtime.sessionFile;\n\n  const emit = (next: DoomChildSessionState, message?: string): void => {\n    state = next;\n    const event: DoomChildSessionEvent = {\n      runId: request.runId,\n      state: next,\n      timestamp: dependencies.now(),\n      ...(message ? { message } : {}),\n      ...(sessionFile ? { sessionFile } : {}),\n    };\n    lastEvent = event;\n    for (const listener of Array.from(listeners)) {\n      try {\n        listener(event);\n      } catch {\n        // Observers must not fault child ownership.\n      }\n    }\n  };\n\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      try {\n        await runtime.dispose();\n      } finally {\n        abortCleanup?.();\n        abortCleanup = undefined;\n      }\n    })();\n    return cleanupPromise;\n  };\n\n  const finish = (\n    next: Extract<DoomChildSessionState, 'completed' | 'failed' | 'stopped'>,\n    message?: string,\n  ): Promise<void> => {\n    finishPromise ??= (async () => {\n      let cleanupFailure: unknown;\n      try {\n        await cleanup();\n      } catch (error) {\n        cleanupFailure = error;\n        onCleanupFailure(error);\n      }\n      if (cleanupFailure === undefined) {\n        emit(next, message);\n      } else {\n        const detail = errorMessage(cleanupFailure);\n        emit('failed', `Child session cleanup failed: ${detail}`);\n      }\n      disposed = true;\n      onTerminal();\n      listeners.clear();\n      if (cleanupFailure !== undefined) throw cleanupFailure;\n    })();\n    return finishPromise;\n  };\n\n  const handle: DoomChildSessionHandle = {\n    runId: request.runId,\n    ...(sessionFile ? { sessionFile } : {}),\n    state: () => state,\n    subscribe(listener) {\n      if (disposed || isTerminal(state)) {\n        if (lastEvent) {\n          try {\n            listener(lastEvent);\n          } catch {\n            // Observers must not fault child ownership.\n          }\n        }\n        return () => false;\n      }\n      listeners.add(listener);\n      if (lastEvent) {\n        try {\n          listener(lastEvent);\n        } catch {\n          // Observers must not fault child ownership.\n        }\n      }\n      return () => listeners.delete(listener);\n    },\n    async steer(message, steerSignal) {\n      if (disposed || finishPromise) throw new Error(`Child run '${request.runId}' is no longer active.`);\n      steerSignal?.throwIfAborted();\n      await runtime.steer(message);\n      steerSignal?.throwIfAborted();\n    },\n    stop(reason) {\n      stopPromise ??= (async () => {\n        if (finishPromise) return finishPromise;\n        let abortFailure: unknown;\n        try {\n          await runtime.abort();\n        } catch (error) {\n          abortFailure = error;\n        }\n        let finishFailure: unknown;\n        try {\n          await finish('stopped', reason ?? 'Child session stopped.');\n        } catch (error) {\n          finishFailure = error;\n        }\n        if (abortFailure !== undefined && finishFailure !== undefined)\n          throw new AggregateError([abortFailure, finishFailure], 'Stopping the child session failed.');\n        if (abortFailure !== undefined) throw abortFailure;\n        if (finishFailure !== undefined) throw finishFailure;\n      })();\n      return stopPromise;\n    },\n    dispose: () => finish('stopped', 'Child session disposed.'),\n  };\n\n  if (signal) {\n    const onAbort = (): void => {\n      void handle.stop('Child session startup was cancelled.').catch(() => undefined);\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    abortCleanup = () => signal.removeEventListener('abort', onAbort);\n  }\n  emit('running');\n  void Promise.resolve()\n    .then(() => runtime.prompt(request.task))\n    .then(\n      (message) => finish('completed', typeof message === 'string' ? message : undefined).catch(() => undefined),\n      (error: unknown) =>\n        finish('failed', error instanceof Error ? error.message : String(error)).catch(() => undefined),\n    );\n  return handle;\n}\n\nexport type { DoomChildSessionRuntime } from '../../types/childSession';\n"],"mappings":"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"}

package/dist/systems/child/types/childSession.cjs

@@ -0,0 +1,16 @@
+//#region src/systems/child/types/childSession.ts
+const DOOM_CHILD_SESSION_SERVICE = "doom/child-session";
+function readDoomChildSessionService(context) {
+	return context.get(DOOM_CHILD_SESSION_SERVICE);
+}
+function requireDoomChildSessionService(context) {
+	const service = readDoomChildSessionService(context);
+	if (!service) throw new Error("The Doom child-session service is unavailable.");
+	return service;
+}
+//#endregion
+exports.DOOM_CHILD_SESSION_SERVICE = DOOM_CHILD_SESSION_SERVICE;
+exports.readDoomChildSessionService = readDoomChildSessionService;
+exports.requireDoomChildSessionService = requireDoomChildSessionService;
+
+//# sourceMappingURL=childSession.cjs.map

package/dist/systems/child/types/childSession.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"childSession.cjs","names":[],"sources":["../../../../src/systems/child/types/childSession.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nimport type { TranscriptPage, TranscriptPageRequest } from '../../../schemas/sessionProtocol';\n\nexport const DOOM_CHILD_SESSION_SERVICE = 'doom/child-session';\n\nexport type DoomChildSessionState = 'starting' | 'running' | 'completed' | 'failed' | 'stopped';\n\nexport interface DoomChildSessionFreshSource {\n  readonly kind: 'fresh';\n}\n\n/** Continue one previously-owned native child journal. Providers must validate the v4 header before opening it. */\nexport interface DoomChildSessionV4RestoreSource {\n  readonly kind: 'v4-restore';\n  readonly sessionFile: string;\n}\n\n/** Fork one branch of a headless v4 journal into a separate child journal. */\nexport interface DoomChildSessionV4ForkSource {\n  readonly kind: 'v4-fork';\n  readonly sessionFile: string;\n  readonly branch: string;\n  readonly entryId?: string;\n}\n\n/**\n * Immutable terminal Pi branch captured by the thin Pi adapter.\n *\n * The serialized v3 snapshot is data, not a writable parent path. The child host\n * converts it into a separate v4 journal and never opens the active Pi history.\n */\nexport interface DoomChildSessionTerminalPiForkSource {\n  readonly kind: 'terminal-pi-fork';\n  readonly sourceSessionId: string;\n  readonly sourceLeafId: string;\n  readonly snapshotJsonl: string;\n}\n\nexport type DoomChildSessionSource =\n  | DoomChildSessionFreshSource\n  | DoomChildSessionV4RestoreSource\n  | DoomChildSessionV4ForkSource\n  | DoomChildSessionTerminalPiForkSource;\n\nexport interface DoomChildSessionScope {\n  readonly rootSessionId: string;\n  readonly scopeKey: string;\n}\n\n/** Capability data is intentionally host-neutral; the owning runtime validates its fields. */\nexport interface DoomChildSessionCapabilityCeiling {\n  readonly allowedTools?: readonly string[];\n  readonly requiredTools?: readonly string[];\n  readonly allowMcpTools?: boolean;\n  readonly allowedExternalProfiles?: readonly string[];\n  readonly denyExtensions?: boolean;\n}\n\nexport interface DoomChildSessionRequest {\n  readonly runId: string;\n  readonly parentSessionId: string;\n  readonly scope: DoomChildSessionScope;\n  readonly source: DoomChildSessionSource;\n  readonly agent: string;\n  readonly task: string;\n  readonly cwd: string;\n  readonly model?: string;\n  readonly thinking?: string;\n  readonly systemPrompt?: string;\n  readonly systemPromptMode?: 'append' | 'replace';\n  readonly extensions?: readonly string[];\n  readonly subagentOnlyExtensions?: readonly string[];\n  readonly tools?: readonly string[];\n  readonly excludeTools?: readonly string[];\n  readonly skills?: readonly string[];\n  readonly mcpDirectTools?: readonly string[];\n  readonly capabilityCeiling?: DoomChildSessionCapabilityCeiling;\n  readonly intercom?: DoomChildSessionIntercom;\n  readonly environment: Readonly<Record<string, string | undefined>>;\n}\n\nexport interface DoomChildSessionEvent {\n  readonly runId: string;\n  readonly state: DoomChildSessionState;\n  readonly timestamp: number;\n  readonly message?: string;\n  readonly sessionFile?: string;\n}\n\nexport interface DoomChildSessionToolResult {\n  readonly content: readonly { readonly type: 'text'; readonly text: string }[];\n  readonly details?: unknown;\n  readonly isError?: boolean;\n}\n\nexport interface DoomChildSessionTool {\n  readonly name: string;\n  readonly description: string;\n  readonly parameters: unknown;\n  execute(\n    operationId: string,\n    params: unknown,\n    signal?: AbortSignal,\n    onUpdate?: (result: DoomChildSessionToolResult) => void,\n  ): Promise<DoomChildSessionToolResult>;\n}\n\n/** Direct in-process Team intercom supplied by an owning extension. */\nexport interface DoomChildSessionIntercom {\n  bindRuntime(runtime: DoomChildSessionRuntime): DoomChildSessionTool;\n  dispose?(): void;\n}\n\n/** Host runtime owned by the direct headless or terminal adapter. */\nexport interface DoomChildSessionRuntime {\n  readonly sessionId: string;\n  readonly sessionFile?: string;\n  prompt(task: string): Promise<string | void>;\n  steer(message: string): Promise<void>;\n  followUp?(message: string): Promise<void>;\n  abort(): Promise<void>;\n  /** Reads only this runtime's owned journal. The callback may remain valid after runtime disposal. */\n  readTranscriptPage?(request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal): Promise<TranscriptPage>;\n  dispose(): Promise<void>;\n}\n\nexport type DoomChildSessionRuntimeFactory = (\n  request: DoomChildSessionRequest,\n  signal?: AbortSignal,\n) => Promise<DoomChildSessionRuntime>;\n\nexport interface DoomChildSessionHandle {\n  readonly runId: string;\n  readonly sessionFile?: string;\n  state(): DoomChildSessionState;\n  subscribe(listener: (event: DoomChildSessionEvent) => void): () => void;\n  steer(message: string, signal?: AbortSignal): Promise<void>;\n  stop(reason?: string): Promise<void>;\n  dispose(): Promise<void>;\n}\n\nexport interface DoomChildSessionService {\n  start(request: DoomChildSessionRequest, signal?: AbortSignal): Promise<DoomChildSessionHandle>;\n  get(runId: string): DoomChildSessionHandle | undefined;\n  /** Resolves an owned run ID inside this session service. Callers never provide journal paths. */\n  readTranscriptPage?(\n    runId: string,\n    request: Omit<TranscriptPageRequest, 'threadId'>,\n    signal?: AbortSignal,\n  ): Promise<TranscriptPage>;\n  close(): Promise<void>;\n}\n\n/** Lazy provider lets Pi and headless composition bind the host-owned service later. */\nexport interface DoomChildSessionServiceProvider {\n  get(): DoomChildSessionService | undefined;\n}\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/child-session': DoomChildSessionService;\n  }\n}\n\nexport function readDoomChildSessionService(context: Context): DoomChildSessionService | undefined {\n  return context.get(DOOM_CHILD_SESSION_SERVICE) as DoomChildSessionService | undefined;\n}\n\nexport function requireDoomChildSessionService(context: Context): DoomChildSessionService {\n  const service = readDoomChildSessionService(context);\n  if (!service) throw new Error('The Doom child-session service is unavailable.');\n  return service;\n}\n"],"mappings":";AAIA,MAAa,6BAA6B;AAgK1C,SAAgB,4BAA4B,SAAuD;CACjG,OAAO,QAAQ,IAAI,0BAA0B;AAC/C;AAEA,SAAgB,+BAA+B,SAA2C;CACxF,MAAM,UAAU,4BAA4B,OAAO;CACnD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,gDAAgD;CAC9E,OAAO;AACT"}