@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

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

@@ -5,8 +5,9 @@
 * 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) {
+function createPoChildSessionService(factory, dependencies) {
 	const handles = /* @__PURE__ */ new Map();
+	const outcomes = /* @__PURE__ */ new Map();
 	const transcriptReaders = /* @__PURE__ */ new Map();
 	const claimedRunIds = /* @__PURE__ */ new Set();
 	const starting = /* @__PURE__ */ new Set();
@@ -20,24 +21,29 @@ function createDoomChildSessionService(factory, dependencies) {
 	const recordCleanupFailure = (error) => {
 		cleanupFailures.push(error);
 	};
-	return {
+	const store = dependencies.store;
+	const service = {
 		start(request, signal) {
-			if (closed) return Promise.reject(/* @__PURE__ */ new Error("The Doom child-session service is closed."));
+			if (closed) return Promise.reject(/* @__PURE__ */ new Error("The Po 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 owned = 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);
+					}, dependencies, request, signal, (outcome) => {
+						if (outcome) outcomes.set(request.runId, outcome);
+						release(request.runId);
+					}, recordCleanupFailure);
+					const handle = owned.handle;
 					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);
+					if (!isTerminal(handle.state())) handles.set(request.runId, owned);
 					return handle;
 				} catch (error) {
 					transcriptReaders.delete(request.runId);
@@ -49,9 +55,9 @@ function createDoomChildSessionService(factory, dependencies) {
 			pending.then(() => starting.delete(pending), () => starting.delete(pending));
 			return pending;
 		},
-		get: (runId) => handles.get(runId),
+		get: (runId) => handles.get(runId)?.handle,
 		async readTranscriptPage(runId, request, signal) {
-			if (closed) throw new Error("The Doom child-session service is closed.");
+			if (closed) throw new Error("The Po child-session service is closed.");
 			signal?.throwIfAborted();
 			const reader = transcriptReaders.get(runId);
 			if (!reader) throw new Error(`Child run '${runId}' has no readable transcript.`);
@@ -59,26 +65,50 @@ function createDoomChildSessionService(factory, dependencies) {
 			signal?.throwIfAborted();
 			return page;
 		},
+		...store ? {
+			stored: () => store.stored(),
+			async restore(runId, live) {
+				const active = handles.get(runId);
+				if (active) return active.handle;
+				const run = (await store.stored()).find((stored) => stored.request.runId === runId);
+				if (!run) throw new Error(`No stored child run matches '${runId}'.`);
+				return service.start({
+					...run.request,
+					source: { kind: "fresh" },
+					environment: {},
+					...live?.intercom ? { intercom: live.intercom } : {}
+				});
+			},
+			async markReported(runId) {
+				await store.markReported(runId, outcomes.get(runId));
+				outcomes.delete(runId);
+			}
+		} : {},
 		close() {
 			closePromise ??= (async () => {
 				if (closed) return;
 				closed = true;
 				await Promise.allSettled(starting);
 				const active = [...handles.values()];
-				await Promise.allSettled(active.map((handle) => handle.dispose()));
+				await Promise.allSettled(active.map((owned) => owned.detach()));
 				const failures = [...cleanupFailures];
 				handles.clear();
 				transcriptReaders.clear();
 				claimedRunIds.clear();
-				if (failures.length) throw new AggregateError(failures, "Doom child-session shutdown failed.");
+				outcomes.clear();
+				if (failures.length) throw new AggregateError(failures, "Po child-session shutdown failed.");
 			})();
 			return closePromise;
 		}
 	};
+	return service;
 }
 function isTerminal(state) {
 	return state === "completed" || state === "failed" || state === "stopped";
 }
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 function errorMessage(error) {
 	return error instanceof Error ? error.message : typeof error === "string" ? error : "Unknown cleanup failure";
 }
@@ -96,9 +126,11 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 	let cleanupPromise;
 	let abortCleanup;
 	const listeners = /* @__PURE__ */ new Set();
-	const sessionFile = runtime.sessionFile;
 	const usageRows = /* @__PURE__ */ new Set();
+	const toolCalls = /* @__PURE__ */ new Set();
 	let cost;
+	let tokens;
+	let config = {};
 	let usageCleanup;
 	const emit = (next, message) => {
 		state = next;
@@ -107,8 +139,10 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 			state: next,
 			timestamp: dependencies.now(),
 			...message ? { message } : {},
-			...sessionFile ? { sessionFile } : {},
-			...cost === void 0 ? {} : { cost }
+			...cost === void 0 ? {} : { cost },
+			...tokens === void 0 ? {} : { tokens },
+			...toolCalls.size === 0 ? {} : { toolCount: toolCalls.size },
+			...config
 		};
 		lastEvent = event;
 		for (const listener of Array.from(listeners)) try {
@@ -119,7 +153,21 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 		if (usageRows.has(usage.rowId) || !Number.isFinite(usage.cost)) return;
 		usageRows.add(usage.rowId);
 		cost = (cost ?? 0) + usage.cost;
-		emit("running");
+		if (usage.tokens !== void 0 && Number.isFinite(usage.tokens)) tokens = (tokens ?? 0) + usage.tokens;
+		if (!isTerminal(state)) emit("running");
+	};
+	const onConfig = (next) => {
+		config = {
+			...config,
+			...next.model ? { model: next.model } : {},
+			...next.thinking ? { thinking: next.thinking } : {}
+		};
+		if (!isTerminal(state)) emit("running");
+	};
+	const onToolStart = (toolCallId) => {
+		if (toolCalls.has(toolCallId)) return;
+		toolCalls.add(toolCallId);
+		if (!isTerminal(state)) emit("running");
 	};
 	const cleanup = () => {
 		cleanupPromise ??= (async () => {
@@ -149,7 +197,7 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 				emit("failed", `Child session cleanup failed: ${detail}`);
 			}
 			disposed = true;
-			onTerminal();
+			onTerminal({ state });
 			listeners.clear();
 			if (cleanupFailure !== void 0) throw cleanupFailure;
 		})();
@@ -157,7 +205,6 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 	};
 	const handle = {
 		runId: request.runId,
-		...sessionFile ? { sessionFile } : {},
 		state: () => state,
 		subscribe(listener) {
 			if (disposed || isTerminal(state)) {
@@ -201,6 +248,20 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 		},
 		dispose: () => finish("stopped", "Child session disposed.")
 	};
+	const detach = () => {
+		finishPromise ??= (async () => {
+			disposed = true;
+			listeners.clear();
+			try {
+				await cleanup();
+			} catch (error) {
+				onCleanupFailure(error);
+			} finally {
+				onTerminal();
+			}
+		})();
+		return finishPromise.catch(() => void 0);
+	};
 	if (signal) {
 		const onAbort = () => {
 			handle.stop("Child session startup was cancelled.").catch(() => void 0);
@@ -208,12 +269,25 @@ async function createHandle(factory, dependencies, request, signal, onTerminal,
 		signal.addEventListener("abort", onAbort, { once: true });
 		abortCleanup = () => signal.removeEventListener("abort", onAbort);
 	}
-	usageCleanup = runtime.onUsage?.(onUsage);
+	const unsubscribe = [
+		runtime.onUsage?.(onUsage),
+		runtime.onConfig?.(onConfig),
+		runtime.onToolStart?.(onToolStart)
+	];
+	usageCleanup = () => {
+		for (const stop of unsubscribe) stop?.();
+	};
 	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;
+	Promise.resolve().then(() => runtime.prompt(request.sender ? {
+		text: request.task,
+		sender: request.sender
+	} : request.task)).then((message) => stopPromise ? void 0 : finish("completed", typeof message === "string" ? message : void 0).catch(() => void 0), (error) => stopPromise ? void 0 : finish(isAbortError(error) ? "stopped" : "failed", error instanceof Error ? error.message : String(error)).catch(() => void 0));
+	return {
+		handle,
+		detach
+	};
 }
 //#endregion
-export { createDoomChildSessionService };
+export { createPoChildSessionService };
 
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +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  DoomChildSessionUsage,\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  const usageRows = new Set<string>();\n  let cost: number | undefined;\n  let usageCleanup: (() => void) | undefined;\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      ...(cost === undefined ? {} : { cost }),\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 onUsage = (usage: DoomChildSessionUsage): void => {\n    if (usageRows.has(usage.rowId) || !Number.isFinite(usage.cost)) return;\n    usageRows.add(usage.rowId);\n    cost = (cost ?? 0) + usage.cost;\n    emit('running');\n  };\n\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      try {\n        await runtime.dispose();\n      } finally {\n        usageCleanup?.();\n        usageCleanup = undefined;\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  usageCleanup = runtime.onUsage?.(onUsage);\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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"}
+{"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  PoChildSessionEvent,\n  PoChildSessionHandle,\n  PoChildSessionRequest,\n  PoChildSessionRuntimeFactory,\n  PoChildSessionService,\n  PoChildSessionState,\n  PoChildSessionUsage,\n  PoChildSessionConfig,\n  PoStoredChildRun,\n} from '../../types/childSession';\n\n/** How a run ended, kept with its stored record once it is reported. */\nexport interface PoChildRunOutcome {\n  readonly state: Extract<PoChildSessionState, 'completed' | 'failed' | 'stopped'>;\n}\n\nexport interface PoChildSessionServiceDependencies {\n  readonly now: () => number;\n  /** The host's stored runs, for re-attaching them after a restart. */\n  readonly store?: {\n    stored(): Promise<readonly PoStoredChildRun[]>;\n    markReported(runId: string, outcome?: PoChildRunOutcome): Promise<void>;\n  };\n}\n\n/** A handle and the shutdown path that leaves its run unfinished, so it resumes after a restart. */\ninterface OwnedChildHandle {\n  readonly handle: PoChildSessionHandle;\n  detach(): Promise<void>;\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 createPoChildSessionService(\n  factory: PoChildSessionRuntimeFactory,\n  dependencies: PoChildSessionServiceDependencies,\n): PoChildSessionService {\n  const handles = new Map<string, OwnedChildHandle>();\n  const outcomes = new Map<string, PoChildRunOutcome>();\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<PoChildSessionHandle>>();\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  const store = dependencies.store;\n\n  const service: PoChildSessionService = {\n    start(request, signal) {\n      if (closed) return Promise.reject(new Error('The Po 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<PoChildSessionHandle> => {\n        try {\n          signal?.throwIfAborted();\n          const owned = 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            (outcome) => {\n              if (outcome) outcomes.set(request.runId, outcome);\n              release(request.runId);\n            },\n            recordCleanupFailure,\n          );\n          const handle = owned.handle;\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, owned);\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)?.handle,\n    async readTranscriptPage(runId, request, signal) {\n      if (closed) throw new Error('The Po 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    ...(store\n      ? {\n          stored: () => store.stored(),\n          async restore(runId, live) {\n            const active = handles.get(runId);\n            if (active) return active.handle;\n            const run = (await store.stored()).find((stored) => stored.request.runId === runId);\n            if (!run) throw new Error(`No stored child run matches '${runId}'.`);\n            // The host recognises a stored run ID and re-attaches its conversation instead of creating one.\n            return service.start({\n              ...run.request,\n              source: { kind: 'fresh' },\n              environment: {},\n              ...(live?.intercom ? { intercom: live.intercom } : {}),\n            });\n          },\n          async markReported(runId: string) {\n            await store.markReported(runId, outcomes.get(runId));\n            outcomes.delete(runId);\n          },\n        }\n      : {}),\n    close() {\n      closePromise ??= (async () => {\n        if (closed) return;\n        closed = true;\n        await Promise.allSettled(starting);\n        // Shutdown is not an outcome: a running child detaches without reporting and resumes after a restart.\n        const active = [...handles.values()];\n        await Promise.allSettled(active.map((owned) => owned.detach()));\n        const failures = [...cleanupFailures];\n        handles.clear();\n        transcriptReaders.clear();\n        claimedRunIds.clear();\n        outcomes.clear();\n        if (failures.length) throw new AggregateError(failures, 'Po child-session shutdown failed.');\n      })();\n      return closePromise;\n    },\n  };\n  return service;\n}\n\nfunction isTerminal(state: PoChildSessionState): boolean {\n  return state === 'completed' || state === 'failed' || state === 'stopped';\n}\n\nfunction isAbortError(error: unknown): boolean {\n  return error instanceof Error && error.name === 'AbortError';\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: PoChildSessionRuntimeFactory,\n  dependencies: PoChildSessionServiceDependencies,\n  request: PoChildSessionRequest,\n  signal: AbortSignal | undefined,\n  onTerminal: (outcome?: PoChildRunOutcome) => void,\n  onCleanupFailure: (error: unknown) => void,\n): Promise<OwnedChildHandle> {\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: PoChildSessionState = 'starting';\n  let disposed = false;\n  let lastEvent: PoChildSessionEvent | 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: PoChildSessionEvent) => void>();\n  const usageRows = new Set<string>();\n  const toolCalls = new Set<string>();\n  let cost: number | undefined;\n  let tokens: number | undefined;\n  let config: { model?: string; thinking?: string } = {};\n  let usageCleanup: (() => void) | undefined;\n\n  const emit = (next: PoChildSessionState, message?: string): void => {\n    state = next;\n    const event: PoChildSessionEvent = {\n      runId: request.runId,\n      state: next,\n      timestamp: dependencies.now(),\n      ...(message ? { message } : {}),\n      ...(cost === undefined ? {} : { cost }),\n      ...(tokens === undefined ? {} : { tokens }),\n      ...(toolCalls.size === 0 ? {} : { toolCount: toolCalls.size }),\n      ...config,\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 onUsage = (usage: PoChildSessionUsage): void => {\n    if (usageRows.has(usage.rowId) || !Number.isFinite(usage.cost)) return;\n    usageRows.add(usage.rowId);\n    cost = (cost ?? 0) + usage.cost;\n    if (usage.tokens !== undefined && Number.isFinite(usage.tokens)) tokens = (tokens ?? 0) + usage.tokens;\n    if (!isTerminal(state)) emit('running');\n  };\n  const onConfig = (next: PoChildSessionConfig): void => {\n    config = {\n      ...config,\n      ...(next.model ? { model: next.model } : {}),\n      ...(next.thinking ? { thinking: next.thinking } : {}),\n    };\n    if (!isTerminal(state)) emit('running');\n  };\n  const onToolStart = (toolCallId: string): void => {\n    if (toolCalls.has(toolCallId)) return;\n    toolCalls.add(toolCallId);\n    if (!isTerminal(state)) emit('running');\n  };\n\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      try {\n        await runtime.dispose();\n      } finally {\n        usageCleanup?.();\n        usageCleanup = undefined;\n        abortCleanup?.();\n        abortCleanup = undefined;\n      }\n    })();\n    return cleanupPromise;\n  };\n\n  const finish = (\n    next: Extract<PoChildSessionState, '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({ state: state as PoChildRunOutcome['state'] });\n      listeners.clear();\n      if (cleanupFailure !== undefined) throw cleanupFailure;\n    })();\n    return finishPromise;\n  };\n\n  const handle: PoChildSessionHandle = {\n    runId: request.runId,\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  // Releases the runtime without a terminal event; a later prompt settlement finds the run finished and stays silent.\n  const detach = (): Promise<void> => {\n    finishPromise ??= (async () => {\n      disposed = true;\n      listeners.clear();\n      try {\n        await cleanup();\n      } catch (error) {\n        onCleanupFailure(error);\n      } finally {\n        onTerminal();\n      }\n    })();\n    return finishPromise.catch(() => undefined);\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  const unsubscribe = [runtime.onUsage?.(onUsage), runtime.onConfig?.(onConfig), runtime.onToolStart?.(onToolStart)];\n  usageCleanup = () => {\n    for (const stop of unsubscribe) stop?.();\n  };\n  emit('running');\n  // A stop settles the prompt as aborted; the stop then reports the run as stopped, not as its prompt ended.\n  void Promise.resolve()\n    .then(() => runtime.prompt(request.sender ? { text: request.task, sender: request.sender } : request.task))\n    .then(\n      (message) =>\n        stopPromise\n          ? undefined\n          : finish('completed', typeof message === 'string' ? message : undefined).catch(() => undefined),\n      (error: unknown) =>\n        stopPromise\n          ? undefined\n          : // A restored run whose input was aborted before the restart ends as stopped, not failed.\n            finish(\n              isAbortError(error) ? 'stopped' : 'failed',\n              error instanceof Error ? error.message : String(error),\n            ).catch(() => undefined),\n    );\n  return { handle, detach };\n}\n\nexport type { PoChildSessionRuntime } from '../../types/childSession';\n"],"mappings":"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"}

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

@@ -1,21 +1,41 @@
 //#region src/systems/child/types/childSession.ts
-const DOOM_CHILD_SESSION_HOOKS_SERVICE = "doom/child-session-hooks";
-const DOOM_CHILD_SESSION_SERVICE = "doom/child-session";
+const PO_CHILD_SESSION_HOOKS_SERVICE = "po/child-session-hooks";
+/**
+* Additional child hooks from any package. `po/child-session-hooks` admits one provider, so
+* observers register here instead; they run after that provider and see its patched result.
+*/
+const PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE = "po/child-session-hook-registry";
+/** Optional display names for in-process child runs, keyed by run id. Absent without a team layer. */
+const PO_CHILD_SESSION_LABELS_SERVICE = "po/child-session-labels";
+const PO_CHILD_SESSION_SERVICE = "po/child-session";
 /** Optional session-owned MCP dispatcher. Children borrow it without owning its connections. */
-const DOOM_CHILD_SESSION_MCP_TOOL_SERVICE = "doom/child-session-mcp-tool";
-function readDoomChildSessionService(context) {
-	return context.get(DOOM_CHILD_SESSION_SERVICE);
+const PO_CHILD_SESSION_MCP_TOOL_SERVICE = "po/child-session-mcp-tool";
+/** Custom message type of an attributed child input; its details carry `{ sender }`. */
+const PO_CHILD_INPUT_CUSTOM_TYPE = "po-input";
+function readPoChildSessionHookRegistry(context) {
+	return context.get(PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE);
 }
-function requireDoomChildSessionService(context) {
-	const service = readDoomChildSessionService(context);
-	if (!service) throw new Error("The Doom child-session service is unavailable.");
+function readPoChildSessionLabels(context) {
+	return context.get(PO_CHILD_SESSION_LABELS_SERVICE);
+}
+function readPoChildSessionService(context) {
+	return context.get(PO_CHILD_SESSION_SERVICE);
+}
+function requirePoChildSessionService(context) {
+	const service = readPoChildSessionService(context);
+	if (!service) throw new Error("The Po child-session service is unavailable.");
 	return service;
 }
 //#endregion
-exports.DOOM_CHILD_SESSION_HOOKS_SERVICE = DOOM_CHILD_SESSION_HOOKS_SERVICE;
-exports.DOOM_CHILD_SESSION_MCP_TOOL_SERVICE = DOOM_CHILD_SESSION_MCP_TOOL_SERVICE;
-exports.DOOM_CHILD_SESSION_SERVICE = DOOM_CHILD_SESSION_SERVICE;
-exports.readDoomChildSessionService = readDoomChildSessionService;
-exports.requireDoomChildSessionService = requireDoomChildSessionService;
+exports.PO_CHILD_INPUT_CUSTOM_TYPE = PO_CHILD_INPUT_CUSTOM_TYPE;
+exports.PO_CHILD_SESSION_HOOKS_SERVICE = PO_CHILD_SESSION_HOOKS_SERVICE;
+exports.PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE = PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE;
+exports.PO_CHILD_SESSION_LABELS_SERVICE = PO_CHILD_SESSION_LABELS_SERVICE;
+exports.PO_CHILD_SESSION_MCP_TOOL_SERVICE = PO_CHILD_SESSION_MCP_TOOL_SERVICE;
+exports.PO_CHILD_SESSION_SERVICE = PO_CHILD_SESSION_SERVICE;
+exports.readPoChildSessionHookRegistry = readPoChildSessionHookRegistry;
+exports.readPoChildSessionLabels = readPoChildSessionLabels;
+exports.readPoChildSessionService = readPoChildSessionService;
+exports.requirePoChildSessionService = requirePoChildSessionService;
 
 //# sourceMappingURL=childSession.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"childSession.cjs","names":[],"sources":["../../../../../src/systems/child/types/childSession.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { JsonValue } from '@earendil-works/chord';\n\nimport type { TranscriptPage, TranscriptPageRequest } from '../../../schemas/sessionProtocol';\nimport type { DirectHarnessRuntimeOptions } from '../../../types/server/directHarnessRuntime';\n\nexport const DOOM_CHILD_SESSION_HOOKS_SERVICE = 'doom/child-session-hooks';\n\nexport interface DoomChildSessionHookScope {\n  readonly request: DoomChildSessionRequest;\n  sessionId(): string | undefined;\n  readonly signal: AbortSignal;\n  sendMessage(text: string, delivery: 'steer' | 'followUp'): Promise<void>;\n  appendCustomEntry(type: string, data: JsonValue): Promise<void>;\n}\n\nexport interface DoomChildSessionHookBinding {\n  readonly beforeTool: NonNullable<DirectHarnessRuntimeOptions['beforeTool']>;\n  readonly afterTool: NonNullable<DirectHarnessRuntimeOptions['afterTool']>;\n  dispose(): Promise<void>;\n}\n\nexport interface DoomChildSessionHooks {\n  bind(scope: DoomChildSessionHookScope): DoomChildSessionHookBinding;\n}\n\nexport const DOOM_CHILD_SESSION_SERVICE = 'doom/child-session';\n/** Optional session-owned MCP dispatcher. Children borrow it without owning its connections. */\nexport const DOOM_CHILD_SESSION_MCP_TOOL_SERVICE = 'doom/child-session-mcp-tool';\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 DoomChildSessionUsage {\n  readonly rowId: string;\n  readonly cost: number;\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  readonly cost?: number;\n}\n\nexport interface DoomChildSessionToolResult {\n  readonly content: readonly (\n    | { readonly type: 'text'; readonly text: string }\n    | { readonly type: 'image'; readonly data: string; readonly mimeType: string }\n  )[];\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/** Borrowed active parent declarations. Children never own the catalog's connections. */\nexport interface DoomChildSessionMcpCatalog {\n  snapshot(): readonly DoomChildSessionTool[];\n  resolveSelectors(selectors: readonly string[]): readonly string[];\n  subscribe(listener: () => void): () => void;\n}\n\n/** The private dispatcher remains available to compatibility consumers. */\nexport interface DoomChildSessionMcpTool extends DoomChildSessionTool {\n  readonly catalog?: DoomChildSessionMcpCatalog;\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   * Called after each child turn settles. Resolves true when intercom activity may have started\n   * another turn (the caller waits for idle and asks again), false when the run may finish.\n   */\n  hold?(): Promise<boolean>;\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  onUsage?(listener: (usage: DoomChildSessionUsage) => void): () => 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    'doom/child-session-hooks': DoomChildSessionHooks;\n    'doom/child-session-mcp-tool': DoomChildSessionMcpTool;\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":";AAMA,MAAa,mCAAmC;AAoBhD,MAAa,6BAA6B;;AAE1C,MAAa,sCAAsC;AA6LnD,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"}
+{"version":3,"file":"childSession.cjs","names":[],"sources":["../../../../../src/systems/child/types/childSession.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { JsonValue, ReplicatedState } from '@earendil-works/chord';\n\nimport type { SessionServiceState, TranscriptPage, TranscriptPageRequest } from '../../../schemas/sessionProtocol';\nimport type { DirectHarnessRuntimeOptions } from '../../../types/server/directHarnessRuntime';\n\n/** One child run's transcript for a thread view: live state while it runs, pages for the session's lifetime. */\nexport interface PoChildThread {\n  readonly state?: ReplicatedState<SessionServiceState>;\n  readTranscriptPage(request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal): Promise<TranscriptPage>;\n}\n\nexport const PO_CHILD_SESSION_HOOKS_SERVICE = 'po/child-session-hooks';\n\nexport interface PoChildSessionHookScope {\n  readonly request: PoChildSessionRequest;\n  sessionId(): string | undefined;\n  readonly signal: AbortSignal;\n  sendMessage(text: string, delivery: 'steer' | 'followUp'): Promise<void>;\n  appendCustomEntry(type: string, data: JsonValue): Promise<void>;\n}\n\nexport interface PoChildSessionHookBinding {\n  readonly beforeTool: NonNullable<DirectHarnessRuntimeOptions['beforeTool']>;\n  readonly afterTool: NonNullable<DirectHarnessRuntimeOptions['afterTool']>;\n  dispose(): Promise<void>;\n}\n\nexport interface PoChildSessionHooks {\n  bind(scope: PoChildSessionHookScope): PoChildSessionHookBinding;\n}\n\n/**\n * Additional child hooks from any package. `po/child-session-hooks` admits one provider, so\n * observers register here instead; they run after that provider and see its patched result.\n */\nexport const PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE = 'po/child-session-hook-registry';\n\nexport interface PoChildSessionHookRegistry {\n  register(hooks: PoChildSessionHooks): { dispose(): void };\n  list(): readonly PoChildSessionHooks[];\n}\n\n/** Optional display names for in-process child runs, keyed by run id. Absent without a team layer. */\nexport const PO_CHILD_SESSION_LABELS_SERVICE = 'po/child-session-labels';\n\nexport interface PoChildSessionLabels {\n  labelFor(runId: string): string | undefined;\n}\n\nexport const PO_CHILD_SESSION_SERVICE = 'po/child-session';\n/** Optional session-owned MCP dispatcher. Children borrow it without owning its connections. */\nexport const PO_CHILD_SESSION_MCP_TOOL_SERVICE = 'po/child-session-mcp-tool';\n\nexport type PoChildSessionState = 'starting' | 'running' | 'completed' | 'failed' | 'stopped';\n\nexport interface PoChildSessionFreshSource {\n  readonly kind: 'fresh';\n}\n\n/** Start from the parent's own history through `entryId`, or through its newest entry when omitted. */\nexport interface PoChildSessionForkSource {\n  readonly kind: 'fork';\n  readonly entryId?: string;\n}\n\nexport type PoChildSessionSource = PoChildSessionFreshSource | PoChildSessionForkSource;\n\nexport interface PoChildSessionScope {\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 PoChildSessionCapabilityCeiling {\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\n/**\n * Who sent one input to a child. Stamped by the host that admitted it, never\n * read back from message text, so a transcript can say who spoke.\n */\nexport interface PoChildSessionSender {\n  readonly kind: 'human' | 'agent' | 'system';\n  readonly id?: string;\n  readonly name: string;\n}\n\n/** A bare string is an input whose sender was not recorded. */\nexport type PoChildSessionInput = string | { readonly text: string; readonly sender: PoChildSessionSender };\n\n/** Custom message type of an attributed child input; its details carry `{ sender }`. */\nexport const PO_CHILD_INPUT_CUSTOM_TYPE = 'po-input';\nexport interface PoChildSessionRequest {\n  readonly runId: string;\n  readonly parentSessionId: string;\n  readonly scope: PoChildSessionScope;\n  readonly source: PoChildSessionSource;\n  readonly agent: string;\n  readonly task: string;\n  /** Who gave the task. Absent when the launcher did not record it. */\n  readonly sender?: PoChildSessionSender;\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?: PoChildSessionCapabilityCeiling;\n  readonly intercom?: PoChildSessionIntercom;\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  /** Data the launcher keeps beside the run, such as its own identity for it; returned by `stored()`. */\n  readonly meta?: { readonly [key: string]: JsonValue };\n}\n\n/** A run this session stored and has not reported: its request without the live parts. */\nexport interface PoStoredChildRun {\n  readonly request: Omit<PoChildSessionRequest, 'intercom' | 'environment' | 'source'>;\n  /** Its task input already has its answer or ended, so restoring it finishes at once. */\n  readonly settled: boolean;\n}\n\n/** A run whose completion reached its launcher, as stored; absent fields were not recorded. */\nexport interface PoReportedChildRun {\n  readonly agent?: string;\n  readonly task?: string;\n  readonly state?: 'completed' | 'failed' | 'stopped';\n}\n\nexport interface PoChildSessionUsage {\n  readonly rowId: string;\n  readonly cost: number;\n  readonly tokens?: number;\n}\n\n/** Model and thinking effort as the runtime holds them, never as requested. */\nexport interface PoChildSessionConfig {\n  /** `provider/model`. */\n  readonly model?: string;\n  readonly thinking?: string;\n}\n\nexport interface PoChildSessionEvent {\n  readonly runId: string;\n  readonly state: PoChildSessionState;\n  readonly timestamp: number;\n  readonly message?: string;\n  readonly cost?: number;\n  /** Observed by the runtime; absent until it reports them. */\n  readonly model?: string;\n  readonly thinking?: string;\n  readonly tokens?: number;\n  readonly toolCount?: number;\n}\n\nexport interface PoChildSessionToolResult {\n  readonly content: readonly (\n    | { readonly type: 'text'; readonly text: string }\n    | { readonly type: 'image'; readonly data: string; readonly mimeType: string }\n  )[];\n  readonly details?: unknown;\n  readonly isError?: boolean;\n}\n\nexport interface PoChildSessionTool {\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: PoChildSessionToolResult) => void,\n  ): Promise<PoChildSessionToolResult>;\n}\n\n/** Borrowed active parent declarations. Children never own the catalog's connections. */\nexport interface PoChildSessionMcpCatalog {\n  snapshot(): readonly PoChildSessionTool[];\n  resolveSelectors(selectors: readonly string[]): readonly string[];\n  subscribe(listener: () => void): () => void;\n}\n\n/** The private dispatcher remains available to compatibility consumers. */\nexport interface PoChildSessionMcpTool extends PoChildSessionTool {\n  readonly catalog?: PoChildSessionMcpCatalog;\n}\n\n/** Direct in-process Team intercom supplied by an owning extension. */\nexport interface PoChildSessionIntercom {\n  bindRuntime(runtime: PoChildSessionRuntime): PoChildSessionTool;\n  dispose?(): void;\n  /**\n   * Called after each child turn settles. Resolves true when intercom activity may have started\n   * another turn (the caller waits for idle and asks again), false when the run may finish.\n   */\n  hold?(): Promise<boolean>;\n}\n\n/** Host runtime owned by the direct headless adapter. */\nexport interface PoChildSessionRuntime {\n  readonly sessionId: string;\n  prompt(task: PoChildSessionInput): Promise<string | void>;\n  steer(message: PoChildSessionInput): Promise<void>;\n  followUp?(message: PoChildSessionInput): Promise<void>;\n  abort(): Promise<void>;\n  onUsage?(listener: (usage: PoChildSessionUsage) => void): () => void;\n  /** Reports the current configuration once, then each change. */\n  onConfig?(listener: (config: PoChildSessionConfig) => void): () => void;\n  /** One call per tool execution started. */\n  onToolStart?(listener: (toolCallId: string) => void): () => void;\n  /** Reads only this runtime's own conversation. 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 PoChildSessionRuntimeFactory = (\n  request: PoChildSessionRequest,\n  signal?: AbortSignal,\n) => Promise<PoChildSessionRuntime>;\n\nexport interface PoChildSessionHandle {\n  readonly runId: string;\n  state(): PoChildSessionState;\n  subscribe(listener: (event: PoChildSessionEvent) => void): () => void;\n  steer(message: PoChildSessionInput, signal?: AbortSignal): Promise<void>;\n  stop(reason?: string): Promise<void>;\n  dispose(): Promise<void>;\n}\n\nexport interface PoChildSessionService {\n  start(request: PoChildSessionRequest, signal?: AbortSignal): Promise<PoChildSessionHandle>;\n  get(runId: string): PoChildSessionHandle | 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  /** Runs this session started and has not reported; each child resumes with the session once restored. */\n  stored?(): Promise<readonly PoStoredChildRun[]>;\n  /** Re-attaches a stored run, giving it the launcher's live intercom. */\n  restore?(runId: string, live?: { readonly intercom?: PoChildSessionIntercom }): Promise<PoChildSessionHandle>;\n  /** Records that a run's completion reached its launcher, so a restart never reports it again. */\n  markReported?(runId: string): Promise<void>;\n  /** A reported run's stored outcome, so its status outlives memory and restarts; undefined when unreported. */\n  reported?(runId: string): Promise<PoReportedChildRun | undefined>;\n  close(): Promise<void>;\n}\n\n/** Lazy provider lets Pi and headless composition bind the host-owned service later. */\nexport interface PoChildSessionServiceProvider {\n  get(): PoChildSessionService | undefined;\n}\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/child-session': PoChildSessionService;\n    'po/child-session-hooks': PoChildSessionHooks;\n    'po/child-session-hook-registry': PoChildSessionHookRegistry;\n    'po/child-session-labels': PoChildSessionLabels;\n    'po/child-session-mcp-tool': PoChildSessionMcpTool;\n  }\n}\n\nexport function readPoChildSessionHookRegistry(context: Context): PoChildSessionHookRegistry | undefined {\n  return context.get(PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE) as PoChildSessionHookRegistry | undefined;\n}\n\nexport function readPoChildSessionLabels(context: Context): PoChildSessionLabels | undefined {\n  return context.get(PO_CHILD_SESSION_LABELS_SERVICE) as PoChildSessionLabels | undefined;\n}\n\nexport function readPoChildSessionService(context: Context): PoChildSessionService | undefined {\n  return context.get(PO_CHILD_SESSION_SERVICE) as PoChildSessionService | undefined;\n}\n\nexport function requirePoChildSessionService(context: Context): PoChildSessionService {\n  const service = readPoChildSessionService(context);\n  if (!service) throw new Error('The Po child-session service is unavailable.');\n  return service;\n}\n"],"mappings":";AAYA,MAAa,iCAAiC;;;;;AAwB9C,MAAa,yCAAyC;;AAQtD,MAAa,kCAAkC;AAM/C,MAAa,2BAA2B;;AAExC,MAAa,oCAAoC;;AA4CjD,MAAa,6BAA6B;AAiL1C,SAAgB,+BAA+B,SAA0D;CACvG,OAAO,QAAQ,IAAI,sCAAsC;AAC3D;AAEA,SAAgB,yBAAyB,SAAoD;CAC3F,OAAO,QAAQ,IAAI,+BAA+B;AACpD;AAEA,SAAgB,0BAA0B,SAAqD;CAC7F,OAAO,QAAQ,IAAI,wBAAwB;AAC7C;AAEA,SAAgB,6BAA6B,SAAyC;CACpF,MAAM,UAAU,0BAA0B,OAAO;CACjD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,8CAA8C;CAC5E,OAAO;AACT"}