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

package/dist/src/systems/child/types/childSession.d.mts

@@ -1,75 +1,95 @@
-import { TranscriptPage, TranscriptPageRequest } from "../../../schemas/sessionProtocol.mjs";
+import { SessionServiceState, TranscriptPage, TranscriptPageRequest } from "../../../schemas/sessionProtocol.mjs";
 import { DirectHarnessRuntimeOptions } from "../../../types/server/directHarnessRuntime.mjs";
 import { Context } from "@deepseek-ai/cordis";
-import { JsonValue } from "@earendil-works/chord";
+import { JsonValue, ReplicatedState } from "@earendil-works/chord";
 //#region src/systems/child/types/childSession.d.ts
-export declare const DOOM_CHILD_SESSION_HOOKS_SERVICE = "doom/child-session-hooks";
-export interface DoomChildSessionHookScope {
-  readonly request: DoomChildSessionRequest;
+/** One child run's transcript for a thread view: live state while it runs, pages for the session's lifetime. */
+export interface PoChildThread {
+  readonly state?: ReplicatedState<SessionServiceState>;
+  readTranscriptPage(request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal): Promise<TranscriptPage>;
+}
+export declare const PO_CHILD_SESSION_HOOKS_SERVICE = "po/child-session-hooks";
+export interface PoChildSessionHookScope {
+  readonly request: PoChildSessionRequest;
   sessionId(): string | undefined;
   readonly signal: AbortSignal;
   sendMessage(text: string, delivery: 'steer' | 'followUp'): Promise<void>;
   appendCustomEntry(type: string, data: JsonValue): Promise<void>;
 }
-export interface DoomChildSessionHookBinding {
+export interface PoChildSessionHookBinding {
   readonly beforeTool: NonNullable<DirectHarnessRuntimeOptions['beforeTool']>;
   readonly afterTool: NonNullable<DirectHarnessRuntimeOptions['afterTool']>;
   dispose(): Promise<void>;
 }
-export interface DoomChildSessionHooks {
-  bind(scope: DoomChildSessionHookScope): DoomChildSessionHookBinding;
+export interface PoChildSessionHooks {
+  bind(scope: PoChildSessionHookScope): PoChildSessionHookBinding;
 }
-export declare const DOOM_CHILD_SESSION_SERVICE = "doom/child-session";
+/**
+ * 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.
+ */
+export declare const PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE = "po/child-session-hook-registry";
+export interface PoChildSessionHookRegistry {
+  register(hooks: PoChildSessionHooks): {
+    dispose(): void;
+  };
+  list(): readonly PoChildSessionHooks[];
+}
+/** Optional display names for in-process child runs, keyed by run id. Absent without a team layer. */
+export declare const PO_CHILD_SESSION_LABELS_SERVICE = "po/child-session-labels";
+export interface PoChildSessionLabels {
+  labelFor(runId: string): string | undefined;
+}
+export declare const PO_CHILD_SESSION_SERVICE = "po/child-session";
 /** Optional session-owned MCP dispatcher. Children borrow it without owning its connections. */
-export declare const DOOM_CHILD_SESSION_MCP_TOOL_SERVICE = "doom/child-session-mcp-tool";
-export type DoomChildSessionState = 'starting' | 'running' | 'completed' | 'failed' | 'stopped';
-export interface DoomChildSessionFreshSource {
+export declare const PO_CHILD_SESSION_MCP_TOOL_SERVICE = "po/child-session-mcp-tool";
+export type PoChildSessionState = 'starting' | 'running' | 'completed' | 'failed' | 'stopped';
+export interface PoChildSessionFreshSource {
   readonly kind: 'fresh';
 }
-/** Continue one previously-owned native child journal. Providers must validate the v4 header before opening it. */
-export interface DoomChildSessionV4RestoreSource {
-  readonly kind: 'v4-restore';
-  readonly sessionFile: string;
-}
-/** Fork one branch of a headless v4 journal into a separate child journal. */
-export interface DoomChildSessionV4ForkSource {
-  readonly kind: 'v4-fork';
-  readonly sessionFile: string;
-  readonly branch: string;
+/** Start from the parent's own history through `entryId`, or through its newest entry when omitted. */
+export interface PoChildSessionForkSource {
+  readonly kind: 'fork';
   readonly entryId?: string;
 }
-/**
- * Immutable terminal Pi branch captured by the thin Pi adapter.
- *
- * The serialized v3 snapshot is data, not a writable parent path. The child host
- * converts it into a separate v4 journal and never opens the active Pi history.
- */
-export interface DoomChildSessionTerminalPiForkSource {
-  readonly kind: 'terminal-pi-fork';
-  readonly sourceSessionId: string;
-  readonly sourceLeafId: string;
-  readonly snapshotJsonl: string;
-}
-export type DoomChildSessionSource = DoomChildSessionFreshSource | DoomChildSessionV4RestoreSource | DoomChildSessionV4ForkSource | DoomChildSessionTerminalPiForkSource;
-export interface DoomChildSessionScope {
+export type PoChildSessionSource = PoChildSessionFreshSource | PoChildSessionForkSource;
+export interface PoChildSessionScope {
   readonly rootSessionId: string;
   readonly scopeKey: string;
 }
 /** Capability data is intentionally host-neutral; the owning runtime validates its fields. */
-export interface DoomChildSessionCapabilityCeiling {
+export interface PoChildSessionCapabilityCeiling {
   readonly allowedTools?: readonly string[];
   readonly requiredTools?: readonly string[];
   readonly allowMcpTools?: boolean;
   readonly allowedExternalProfiles?: readonly string[];
   readonly denyExtensions?: boolean;
 }
-export interface DoomChildSessionRequest {
+/**
+ * Who sent one input to a child. Stamped by the host that admitted it, never
+ * read back from message text, so a transcript can say who spoke.
+ */
+export interface PoChildSessionSender {
+  readonly kind: 'human' | 'agent' | 'system';
+  readonly id?: string;
+  readonly name: string;
+}
+/** A bare string is an input whose sender was not recorded. */
+export type PoChildSessionInput = string | {
+  readonly text: string;
+  readonly sender: PoChildSessionSender;
+};
+/** Custom message type of an attributed child input; its details carry `{ sender }`. */
+export declare const PO_CHILD_INPUT_CUSTOM_TYPE = "po-input";
+export interface PoChildSessionRequest {
   readonly runId: string;
   readonly parentSessionId: string;
-  readonly scope: DoomChildSessionScope;
-  readonly source: DoomChildSessionSource;
+  readonly scope: PoChildSessionScope;
+  readonly source: PoChildSessionSource;
   readonly agent: string;
   readonly task: string;
+  /** Who gave the task. Absent when the launcher did not record it. */
+  readonly sender?: PoChildSessionSender;
   readonly cwd: string;
   readonly model?: string;
   readonly thinking?: string;
@@ -81,23 +101,50 @@ export interface DoomChildSessionRequest {
   readonly excludeTools?: readonly string[];
   readonly skills?: readonly string[];
   readonly mcpDirectTools?: readonly string[];
-  readonly capabilityCeiling?: DoomChildSessionCapabilityCeiling;
-  readonly intercom?: DoomChildSessionIntercom;
+  readonly capabilityCeiling?: PoChildSessionCapabilityCeiling;
+  readonly intercom?: PoChildSessionIntercom;
   readonly environment: Readonly<Record<string, string | undefined>>;
-}
-export interface DoomChildSessionUsage {
+  /** Data the launcher keeps beside the run, such as its own identity for it; returned by `stored()`. */
+  readonly meta?: {
+    readonly [key: string]: JsonValue;
+  };
+}
+/** A run this session stored and has not reported: its request without the live parts. */
+export interface PoStoredChildRun {
+  readonly request: Omit<PoChildSessionRequest, 'intercom' | 'environment' | 'source'>;
+  /** Its task input already has its answer or ended, so restoring it finishes at once. */
+  readonly settled: boolean;
+}
+/** A run whose completion reached its launcher, as stored; absent fields were not recorded. */
+export interface PoReportedChildRun {
+  readonly agent?: string;
+  readonly task?: string;
+  readonly state?: 'completed' | 'failed' | 'stopped';
+}
+export interface PoChildSessionUsage {
   readonly rowId: string;
   readonly cost: number;
+  readonly tokens?: number;
 }
-export interface DoomChildSessionEvent {
+/** Model and thinking effort as the runtime holds them, never as requested. */
+export interface PoChildSessionConfig {
+  /** `provider/model`. */
+  readonly model?: string;
+  readonly thinking?: string;
+}
+export interface PoChildSessionEvent {
   readonly runId: string;
-  readonly state: DoomChildSessionState;
+  readonly state: PoChildSessionState;
   readonly timestamp: number;
   readonly message?: string;
-  readonly sessionFile?: string;
   readonly cost?: number;
+  /** Observed by the runtime; absent until it reports them. */
+  readonly model?: string;
+  readonly thinking?: string;
+  readonly tokens?: number;
+  readonly toolCount?: number;
 }
-export interface DoomChildSessionToolResult {
+export interface PoChildSessionToolResult {
   readonly content: readonly ({
     readonly type: 'text';
     readonly text: string;
@@ -109,25 +156,25 @@ export interface DoomChildSessionToolResult {
   readonly details?: unknown;
   readonly isError?: boolean;
 }
-export interface DoomChildSessionTool {
+export interface PoChildSessionTool {
   readonly name: string;
   readonly description: string;
   readonly parameters: unknown;
-  execute(operationId: string, params: unknown, signal?: AbortSignal, onUpdate?: (result: DoomChildSessionToolResult) => void): Promise<DoomChildSessionToolResult>;
+  execute(operationId: string, params: unknown, signal?: AbortSignal, onUpdate?: (result: PoChildSessionToolResult) => void): Promise<PoChildSessionToolResult>;
 }
 /** Borrowed active parent declarations. Children never own the catalog's connections. */
-export interface DoomChildSessionMcpCatalog {
-  snapshot(): readonly DoomChildSessionTool[];
+export interface PoChildSessionMcpCatalog {
+  snapshot(): readonly PoChildSessionTool[];
   resolveSelectors(selectors: readonly string[]): readonly string[];
   subscribe(listener: () => void): () => void;
 }
 /** The private dispatcher remains available to compatibility consumers. */
-export interface DoomChildSessionMcpTool extends DoomChildSessionTool {
-  readonly catalog?: DoomChildSessionMcpCatalog;
+export interface PoChildSessionMcpTool extends PoChildSessionTool {
+  readonly catalog?: PoChildSessionMcpCatalog;
 }
 /** Direct in-process Team intercom supplied by an owning extension. */
-export interface DoomChildSessionIntercom {
-  bindRuntime(runtime: DoomChildSessionRuntime): DoomChildSessionTool;
+export interface PoChildSessionIntercom {
+  bindRuntime(runtime: PoChildSessionRuntime): PoChildSessionTool;
   dispose?(): void;
   /**
    * Called after each child turn settles. Resolves true when intercom activity may have started
@@ -135,48 +182,64 @@ export interface DoomChildSessionIntercom {
    */
   hold?(): Promise<boolean>;
 }
-/** Host runtime owned by the direct headless or terminal adapter. */
-export interface DoomChildSessionRuntime {
+/** Host runtime owned by the direct headless adapter. */
+export interface PoChildSessionRuntime {
   readonly sessionId: string;
-  readonly sessionFile?: string;
-  prompt(task: string): Promise<string | void>;
-  steer(message: string): Promise<void>;
-  followUp?(message: string): Promise<void>;
+  prompt(task: PoChildSessionInput): Promise<string | void>;
+  steer(message: PoChildSessionInput): Promise<void>;
+  followUp?(message: PoChildSessionInput): Promise<void>;
   abort(): Promise<void>;
-  onUsage?(listener: (usage: DoomChildSessionUsage) => void): () => void;
-  /** Reads only this runtime's owned journal. The callback may remain valid after runtime disposal. */
+  onUsage?(listener: (usage: PoChildSessionUsage) => void): () => void;
+  /** Reports the current configuration once, then each change. */
+  onConfig?(listener: (config: PoChildSessionConfig) => void): () => void;
+  /** One call per tool execution started. */
+  onToolStart?(listener: (toolCallId: string) => void): () => void;
+  /** Reads only this runtime's own conversation. The callback may remain valid after runtime disposal. */
   readTranscriptPage?(request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal): Promise<TranscriptPage>;
   dispose(): Promise<void>;
 }
-export type DoomChildSessionRuntimeFactory = (request: DoomChildSessionRequest, signal?: AbortSignal) => Promise<DoomChildSessionRuntime>;
-export interface DoomChildSessionHandle {
+export type PoChildSessionRuntimeFactory = (request: PoChildSessionRequest, signal?: AbortSignal) => Promise<PoChildSessionRuntime>;
+export interface PoChildSessionHandle {
   readonly runId: string;
-  readonly sessionFile?: string;
-  state(): DoomChildSessionState;
-  subscribe(listener: (event: DoomChildSessionEvent) => void): () => void;
-  steer(message: string, signal?: AbortSignal): Promise<void>;
+  state(): PoChildSessionState;
+  subscribe(listener: (event: PoChildSessionEvent) => void): () => void;
+  steer(message: PoChildSessionInput, signal?: AbortSignal): Promise<void>;
   stop(reason?: string): Promise<void>;
   dispose(): Promise<void>;
 }
-export interface DoomChildSessionService {
-  start(request: DoomChildSessionRequest, signal?: AbortSignal): Promise<DoomChildSessionHandle>;
-  get(runId: string): DoomChildSessionHandle | undefined;
+export interface PoChildSessionService {
+  start(request: PoChildSessionRequest, signal?: AbortSignal): Promise<PoChildSessionHandle>;
+  get(runId: string): PoChildSessionHandle | undefined;
   /** Resolves an owned run ID inside this session service. Callers never provide journal paths. */
   readTranscriptPage?(runId: string, request: Omit<TranscriptPageRequest, 'threadId'>, signal?: AbortSignal): Promise<TranscriptPage>;
+  /** Runs this session started and has not reported; each child resumes with the session once restored. */
+  stored?(): Promise<readonly PoStoredChildRun[]>;
+  /** Re-attaches a stored run, giving it the launcher's live intercom. */
+  restore?(runId: string, live?: {
+    readonly intercom?: PoChildSessionIntercom;
+  }): Promise<PoChildSessionHandle>;
+  /** Records that a run's completion reached its launcher, so a restart never reports it again. */
+  markReported?(runId: string): Promise<void>;
+  /** A reported run's stored outcome, so its status outlives memory and restarts; undefined when unreported. */
+  reported?(runId: string): Promise<PoReportedChildRun | undefined>;
   close(): Promise<void>;
 }
 /** Lazy provider lets Pi and headless composition bind the host-owned service later. */
-export interface DoomChildSessionServiceProvider {
-  get(): DoomChildSessionService | undefined;
+export interface PoChildSessionServiceProvider {
+  get(): PoChildSessionService | undefined;
 }
 declare module '@deepseek-ai/cordis' {
   interface Context {
-    'doom/child-session': DoomChildSessionService;
-    'doom/child-session-hooks': DoomChildSessionHooks;
-    'doom/child-session-mcp-tool': DoomChildSessionMcpTool;
+    'po/child-session': PoChildSessionService;
+    'po/child-session-hooks': PoChildSessionHooks;
+    'po/child-session-hook-registry': PoChildSessionHookRegistry;
+    'po/child-session-labels': PoChildSessionLabels;
+    'po/child-session-mcp-tool': PoChildSessionMcpTool;
   }
 }
-export declare function readDoomChildSessionService(context: Context): DoomChildSessionService | undefined;
-export declare function requireDoomChildSessionService(context: Context): DoomChildSessionService;
+export declare function readPoChildSessionHookRegistry(context: Context): PoChildSessionHookRegistry | undefined;
+export declare function readPoChildSessionLabels(context: Context): PoChildSessionLabels | undefined;
+export declare function readPoChildSessionService(context: Context): PoChildSessionService | undefined;
+export declare function requirePoChildSessionService(context: Context): PoChildSessionService;
 //#endregion
 //# sourceMappingURL=childSession.d.mts.map

package/dist/src/systems/child/types/childSession.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"childSession.d.mts","names":[],"sources":["../../../../../src/systems/child/types/childSession.ts"],"mappings":";;;;;qBAMa;iBAEI;WACN,SAAS;EAClB;WACS,QAAQ;EACjB,YAAY,cAAc,iCAAiC;EAC3D,kBAAkB,cAAc,MAAM,YAAY;;iBAGnC;WACN,YAAY,YAAY;WACxB,WAAW,YAAY;EAChC,WAAW;;iBAGI;EACf,KAAK,OAAO,4BAA4B;;qBAG7B;;qBAEA;YAED;iBAEK;WACN;;;iBAIM;WACN;WACA;;;iBAIM;WACN;WACA;WACA;WACA;;;;;;;;iBASM;WACN;WACA;WACA;WACA;;YAGC,yBACR,8BACA,kCACA,+BACA;iBAEa;WACN;WACA;;;iBAIM;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA,OAAO;WACP,QAAQ;WACR;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA,oBAAoB;WACpB,WAAW;WACX,aAAa,SAAS;;iBAGhB;WACN;WACA;;iBAGM;WACN;WACA,OAAO;WACP;WACA;WACA;WACA;;iBAGM;WACN;aACM;aAAuB;;aACvB;aAAwB;aAAuB;;WAErD;WACA;;iBAGM;WACN;WACA;WACA;EACT,QACE,qBACA,iBACA,SAAS,aACT,YAAY,QAAQ,sCACnB,QAAQ;;;iBAII;EACf,qBAAqB;EACrB,iBAAiB;EACjB,UAAU;;;iBAIK,gCAAgC;WACtC,UAAU;;;iBAIJ;EACf,YAAY,SAAS,0BAA0B;EAC/C;;;;;EAKA,SAAS;;;iBAIM;WACN;WACA;EACT,OAAO,eAAe;EACtB,MAAM,kBAAkB;EACxB,UAAU,kBAAkB;EAC5B,SAAS;EACT,SAAS,WAAW,OAAO;;EAE3B,oBAAoB,SAAS,KAAK,oCAAoC,SAAS,cAAc,QAAQ;EACrG,WAAW;;YAGD,kCACV,SAAS,yBACT,SAAS,gBACN,QAAQ;iBAEI;WACN;WACA;EACT,SAAS;EACT,UAAU,WAAW,OAAO;EAC5B,MAAM,iBAAiB,SAAS,cAAc;EAC9C,KAAK,kBAAkB;EACvB,WAAW;;iBAGI;EACf,MAAM,SAAS,yBAAyB,SAAS,cAAc,QAAQ;EACvE,IAAI,gBAAgB;;EAEpB,oBACE,eACA,SAAS,KAAK,oCACd,SAAS,cACR,QAAQ;EACX,SAAS;;;iBAIM;EACf,OAAO;;;YAGG;IACR,sBAAsB;IACtB,4BAA4B;IAC5B,+BAA+B;;;wBAInB,4BAA4B,SAAS,UAAU;wBAI/C,+BAA+B,SAAS,UAAU"}
+{"version":3,"file":"childSession.d.mts","names":[],"sources":["../../../../../src/systems/child/types/childSession.ts"],"mappings":";;;;;;iBAOiB;WACN,QAAQ,gBAAgB;EACjC,mBAAmB,SAAS,KAAK,oCAAoC,SAAS,cAAc,QAAQ;;qBAGzF;iBAEI;WACN,SAAS;EAClB;WACS,QAAQ;EACjB,YAAY,cAAc,iCAAiC;EAC3D,kBAAkB,cAAc,MAAM,YAAY;;iBAGnC;WACN,YAAY,YAAY;WACxB,WAAW,YAAY;EAChC,WAAW;;iBAGI;EACf,KAAK,OAAO,0BAA0B;;;;;;qBAO3B;iBAEI;EACf,SAAS,OAAO;IAAwB;;EACxC,iBAAiB;;;qBAIN;iBAEI;EACf,SAAS;;qBAGE;;qBAEA;YAED;iBAEK;WACN;;;iBAIM;WACN;WACA;;YAGC,uBAAuB,4BAA4B;iBAE9C;WACN;WACA;;;iBAIM;WACN;WACA;WACA;WACA;WACA;;;;;;iBAOM;WACN;WACA;WACA;;;YAIC;WAA0C;WAAuB,QAAQ;;;qBAGxE;iBACI;WACN;WACA;WACA,OAAO;WACP,QAAQ;WACR;WACA;;WAEA,SAAS;WACT;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA,oBAAoB;WACpB,WAAW;WACX,aAAa,SAAS;;WAEtB;cAAmB,cAAc;;;;iBAI3B;WACN,SAAS,KAAK;;WAEd;;;iBAIM;WACN;WACA;WACA;;iBAGM;WACN;WACA;WACA;;;iBAIM;;WAEN;WACA;;iBAGM;WACN;WACA,OAAO;WACP;WACA;WACA;;WAEA;WACA;WACA;WACA;;iBAGM;WACN;aACM;aAAuB;;aACvB;aAAwB;aAAuB;;WAErD;WACA;;iBAGM;WACN;WACA;WACA;EACT,QACE,qBACA,iBACA,SAAS,aACT,YAAY,QAAQ,oCACnB,QAAQ;;;iBAII;EACf,qBAAqB;EACrB,iBAAiB;EACjB,UAAU;;;iBAIK,8BAA8B;WACpC,UAAU;;;iBAIJ;EACf,YAAY,SAAS,wBAAwB;EAC7C;;;;;EAKA,SAAS;;;iBAIM;WACN;EACT,OAAO,MAAM,sBAAsB;EACnC,MAAM,SAAS,sBAAsB;EACrC,UAAU,SAAS,sBAAsB;EACzC,SAAS;EACT,SAAS,WAAW,OAAO;;EAE3B,UAAU,WAAW,QAAQ;;EAE7B,aAAa,WAAW;;EAExB,oBAAoB,SAAS,KAAK,oCAAoC,SAAS,cAAc,QAAQ;EACrG,WAAW;;YAGD,gCACV,SAAS,uBACT,SAAS,gBACN,QAAQ;iBAEI;WACN;EACT,SAAS;EACT,UAAU,WAAW,OAAO;EAC5B,MAAM,SAAS,qBAAqB,SAAS,cAAc;EAC3D,KAAK,kBAAkB;EACvB,WAAW;;iBAGI;EACf,MAAM,SAAS,uBAAuB,SAAS,cAAc,QAAQ;EACrE,IAAI,gBAAgB;;EAEpB,oBACE,eACA,SAAS,KAAK,oCACd,SAAS,cACR,QAAQ;;EAEX,WAAW,iBAAiB;;EAE5B,SAAS,eAAe;aAAkB,WAAW;MAA2B,QAAQ;;EAExF,cAAc,gBAAgB;;EAE9B,UAAU,gBAAgB,QAAQ;EAClC,SAAS;;;iBAIM;EACf,OAAO;;;YAGG;IACR,oBAAoB;IACpB,0BAA0B;IAC1B,kCAAkC;IAClC,2BAA2B;IAC3B,6BAA6B;;;wBAIjB,+BAA+B,SAAS,UAAU;wBAIlD,yBAAyB,SAAS,UAAU;wBAI5C,0BAA0B,SAAS,UAAU;wBAI7C,6BAA6B,SAAS,UAAU"}

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

@@ -1,17 +1,32 @@
 //#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
-export { DOOM_CHILD_SESSION_HOOKS_SERVICE, DOOM_CHILD_SESSION_MCP_TOOL_SERVICE, DOOM_CHILD_SESSION_SERVICE, readDoomChildSessionService, requireDoomChildSessionService };
+export { PO_CHILD_INPUT_CUSTOM_TYPE, PO_CHILD_SESSION_HOOKS_SERVICE, PO_CHILD_SESSION_HOOK_REGISTRY_SERVICE, PO_CHILD_SESSION_LABELS_SERVICE, PO_CHILD_SESSION_MCP_TOOL_SERVICE, PO_CHILD_SESSION_SERVICE, readPoChildSessionHookRegistry, readPoChildSessionLabels, readPoChildSessionService, requirePoChildSessionService };
 
 //# sourceMappingURL=childSession.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"childSession.mjs","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.mjs","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"}

package/dist/src/systems/main/adapters/headlessHost.cjs

@@ -2,7 +2,7 @@ const require_index = require("../../../services/kernel/index.cjs");
 const require_headless = require("../../../schemas/headless.cjs");
 const require_mcpStatus = require("../../../schemas/mcpStatus.cjs");
 require("../../../../mcpStatus.cjs");
-const require_index$1 = require("../../../services/piExtensionHost/index.cjs");
+const require_index$1 = require("../../../services/skillPrompt/index.cjs");
 let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
 //#region src/systems/main/adapters/headlessHost.ts
 function sameStrings(left, right) {
@@ -19,7 +19,7 @@ function sameSelection(left, right) {
 *
 * Prefers the resource's own `description` and `path`. The fallbacks below are what
 * every skill used to get, and they are only good enough for explicit invocation,
-* which matches on name: `doom-headless://` is not a path any tool can open, and
+* which matches on name: `po-headless://` is not a path any tool can open, and
 * "Headless skill from <source>" gives the model nothing to select on. A skill is
 * only advertised in the prompt once it carries a real path.
 */
@@ -28,7 +28,7 @@ function headlessHarnessSkill(resource) {
 		name: resource.name,
 		description: resource.description ?? `Headless skill from ${resource.source}`,
 		content: resource.text,
-		filePath: resource.path ?? `doom-headless://${resource.source}/${resource.name}`
+		filePath: resource.path ?? `po-headless://${resource.source}/${resource.name}`
 	};
 }
 function escapeXml(value) {
@@ -54,9 +54,9 @@ function describeLoadSkillTool(base, skills) {
 		"</available_skills>"
 	].join("\n");
 }
-/** Retains facets and their state; only kernel-computed active contributions change. */
+/** Retains packages and their state; only kernel-computed active contributions change. */
 var HeadlessHost = class extends _deepseek_ai_cordis.Service {
-	kernel = require_index.createDoomKernel();
+	kernel = require_index.createPoKernel();
 	selectionListeners = /* @__PURE__ */ new Set();
 	restrictions = [];
 	restrictionsChanged = false;
@@ -83,7 +83,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 	hooks = [];
 	activities = /* @__PURE__ */ new Map();
 	constructor(context, options) {
-		super(context, require_headless.DOOM_HEADLESS_HOST_SERVICE);
+		super(context, require_headless.PO_HEADLESS_HOST_SERVICE);
 		this.options = options;
 		this.selectionOverrides = new Set(options.selectionOverrides);
 		this.applied = structuredClone(options.selection);
@@ -138,7 +138,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 					this.activities.set(entry, stop);
 				} catch (error) {
 					if (this.options.candidates.some((candidate) => candidate.packageName === entry.source && candidate.required)) throw error;
-					this.options.onError?.(error);
+					this.options.onError?.(error, "activity");
 				}
 			}
 		});
@@ -177,7 +177,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 		if (ready) {
 			for (const entry of this.kernel.activeValues("tools")) {
 				const active = this.tools.get(entry.value.name) === entry;
-				const discoverable = active && require_headless.isDoomHeadlessToolModelVisible(entry.value);
+				const discoverable = active && require_headless.isPoHeadlessToolModelVisible(entry.value);
 				const reason = active ? discoverable ? void 0 : "not-discoverable" : !this.matches(entry.value.when) ? "inactive" : !this.allowsTool(entry.value.name) ? "restricted" : "shadowed";
 				capabilities.push({
 					source: entry.source,
@@ -219,7 +219,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 	* ones a condition or a restriction currently gates out.
 	*
 	* `appliedTools` answers what runs now. A merge that places another surface's
-	* tools beside these needs what is spoken for, so a name a facet deliberately
+	* tools beside these needs what is spoken for, so a name a package deliberately
 	* withheld is not handed to an unreconciled surface instead. Owner
 	* eligibility stays the outer gate: a package the selection excluded declares
 	* nothing here.
@@ -234,13 +234,13 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 			mode: when.domain
 		});
 		const mcpOwners = /* @__PURE__ */ new Map();
-		for (const server of require_mcpStatus.readDoomMcpStatus(this.ctx)?.getSnapshot().servers ?? []) for (const name of server.tools) mcpOwners.set(name, server.name);
+		for (const server of require_mcpStatus.readPoMcpStatus(this.ctx)?.getSnapshot().servers ?? []) for (const name of server.tools) mcpOwners.set(name, server.name);
 		const mcpPackages = /* @__PURE__ */ new Map();
 		const toolsBySource = /* @__PURE__ */ new Map();
 		for (const contribution of this.kernel.contributions("tools")) {
 			if (!currentSources.has(contribution.source)) continue;
 			const tool = contribution.value.value;
-			if (!require_headless.isDoomHeadlessToolModelVisible(tool)) continue;
+			if (!require_headless.isPoHeadlessToolModelVisible(tool)) continue;
 			const contextAttribution = conditionAttribution(tool.when);
 			const entry = {
 				name: tool.name,
@@ -316,7 +316,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 			this.selectionListeners.delete(listener);
 		};
 	}
-	/** Shared by facet reconciliation and the final Pi/facet merge. */
+	/** Shared by package reconciliation and the final Pi/package merge. */
 	allowsTool(name) {
 		const allowed = this.options.allowedTools?.(this.applying);
 		return (allowed === void 0 || allowed.includes(name)) && this.restrictions.every((restriction) => (restriction.allowedTools === void 0 || restriction.allowedTools.includes(name)) && !restriction.excludedTools?.includes(name));
@@ -328,14 +328,17 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 		return entry.scopes.includes("session") && entry.owners.some((owner) => owner.majorMode === selection.majorMode && (owner.layer === "default" || selection.activeLayers.includes(owner.layer)));
 	}
 	changeSelection(change) {
-		this.selectionOverrides.add(change.axis);
-		if (change.axis === "majorMode") return this.select({ majorMode: change.majorMode });
-		if (change.axis === "domains") return this.select({ domains: change.domains });
-		if (change.axis === "profile") return this.select({ profile: change.profile });
-		return this.select({ state: {
-			...this.requested.state,
-			[change.key]: [...change.values]
-		} });
+		const apply = (change) => {
+			this.selectionOverrides.add(change.axis);
+			if (change.axis === "majorMode") return this.select({ majorMode: change.majorMode });
+			if (change.axis === "domains") return this.select({ domains: change.domains });
+			if (change.axis === "profile") return this.select({ profile: change.profile });
+			return this.select({ state: {
+				...this.requested.state,
+				[change.key]: [...change.values]
+			} });
+		};
+		return this.options.scheduleSelection?.(change, apply) ?? apply(change);
 	}
 	async refreshChangedSelection(previous, selection, previousValues) {
 		const majorChanged = previous.majorMode !== selection.majorMode || !sameStrings(previous.activeLayers, selection.activeLayers);
@@ -404,7 +407,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 			try {
 				for (const listener of this.selectionListeners) await listener(selection);
 			} catch (error) {
-				if (require_headless.isDoomHeadlessPromptAdmissionError(error)) this.recoveryRevision = revision;
+				if (require_headless.isPoHeadlessPromptAdmissionError(error)) this.recoveryRevision = revision;
 				throw error;
 			}
 			if (compositionChanged) await this.options.onApplied?.(selection, revision);
@@ -413,7 +416,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 		this.tail = result.catch((error) => {
 			this.failure = error;
 			this.ready = false;
-			if (!this.disposed) this.options.onError?.(error);
+			if (!this.disposed) this.options.onError?.(error, "apply");
 		});
 		await result;
 		await this.settled();
@@ -432,7 +435,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 		if (this.disposed || !this.ready) throw new Error("Headless dispatch is blocked until selection is coherently applied");
 	}
 	add(slot, value) {
-		const owner = require_headless.readDoomHeadlessOwner(this.ctx);
+		const owner = require_headless.readPoHeadlessOwner(this.ctx);
 		if (!owner) throw new Error("A headless contribution must have descriptor-owned package identity");
 		this.ready = false;
 		this.contributionsChanged = true;
@@ -473,7 +476,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 		return this.add("activities", activity);
 	}
 	canRecoverSelection() {
-		return !this.disposed && !this.ready && !this.refreshing && !this.contributionsChanged && !this.restrictionsChanged && this.recoveryRevision === this.requestedRevision && this.appliedRevision === this.requestedRevision && require_headless.isDoomHeadlessPromptAdmissionError(this.failure);
+		return !this.disposed && !this.ready && !this.refreshing && !this.contributionsChanged && !this.restrictionsChanged && this.recoveryRevision === this.requestedRevision && this.appliedRevision === this.requestedRevision && require_headless.isPoHeadlessPromptAdmissionError(this.failure);
 	}
 	listCommands() {
 		const recovering = this.canRecoverSelection();
@@ -507,9 +510,9 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 				} : this.context);
 				signal?.throwIfAborted();
 			} catch (error) {
-				if (require_headless.isDoomHeadlessPromptAdmissionError(error)) throw error;
+				if (require_headless.isPoHeadlessPromptAdmissionError(error)) throw error;
 				signal?.throwIfAborted();
-				this.options.onError?.(error);
+				this.options.onError?.(error, "hook");
 				continue;
 			}
 			if (event === "session_start") {
@@ -550,7 +553,7 @@ var HeadlessHost = class extends _deepseek_ai_cordis.Service {
 			try {
 				value = await resource.value.read(context);
 			} catch (error) {
-				this.options.onError?.(new Error(`Could not read headless resource '${resource.source}/${resource.value.name}'`, { cause: error }));
+				this.options.onError?.(new Error(`Could not read headless resource '${resource.source}/${resource.value.name}'`, { cause: error }), "resource");
 				continue;
 			}
 			result.push({