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

package/dist/src/systems/main/types/headlessHost.d.mts

@@ -1,10 +1,10 @@
 import { ContextSkillInventory, ContextToolSource, PackageAttribution } from "../../../../contextProjection.mjs";
-import { DoomServerBundleEntry } from "../../../schemas/serverBundle.mjs";
-import { DoomHeadlessExecutionContext, DoomHeadlessHostService, DoomHeadlessResource, DoomHeadlessSelection, DoomHeadlessTool } from "../../../schemas/headless.mjs";
+import { PoServerBundleEntry } from "../../../schemas/serverBundle.mjs";
+import { PoHeadlessExecutionContext, PoHeadlessHostService, PoHeadlessResource, PoHeadlessSelection, PoHeadlessSelectionChange, PoHeadlessTool } from "../../../schemas/headless.mjs";
 import "../../../../headless.mjs";
-import "../../../../serverFacet.mjs";
+import "../../../../serverPlugin.mjs";
 //#region src/systems/main/types/headlessHost.d.ts
-export type ResolvedHeadlessResource = Pick<DoomHeadlessResource, 'name' | 'kind' | 'description' | 'path'> & {
+export type ResolvedHeadlessResource = Pick<PoHeadlessResource, 'name' | 'kind' | 'description' | 'path'> & {
   source: string;
   text: string;
 };
@@ -14,18 +14,20 @@ export interface HeadlessContextInventory {
   readonly attribution: Readonly<Record<string, PackageAttribution>>;
 }
 export interface HeadlessHostOptions {
-  candidates: readonly DoomServerBundleEntry[];
-  selection: DoomHeadlessSelection;
+  candidates: readonly PoServerBundleEntry[];
+  selection: PoHeadlessSelection;
   selectionOverrides?: readonly ('majorMode' | 'domains' | 'profile')[];
-  context(selection: DoomHeadlessSelection): DoomHeadlessExecutionContext;
-  toolSurface?(): DoomHeadlessHostService['toolSurface'];
-  applyTools(tools: readonly DoomHeadlessTool[]): void | Promise<void>;
+  context(selection: PoHeadlessSelection): PoHeadlessExecutionContext;
+  /** Defer operator selection writes without making the currently applied host unready. */
+  scheduleSelection?(change: PoHeadlessSelectionChange, apply: (change: PoHeadlessSelectionChange) => Promise<void>): Promise<void>;
+  toolSurface?(): PoHeadlessHostService['toolSurface'];
+  applyTools(tools: readonly PoHeadlessTool[]): void | Promise<void>;
   applyResources(resources: readonly ResolvedHeadlessResource[]): void | Promise<void>;
-  resolveSelection?(selection: DoomHeadlessSelection): DoomHeadlessSelection | Promise<DoomHeadlessSelection>;
-  validateSelection?(selection: DoomHeadlessSelection): void | Promise<void>;
-  allowedTools?(selection: DoomHeadlessSelection): readonly string[] | undefined;
-  onApplied?(selection: DoomHeadlessSelection, revision: number): void | Promise<void>;
-  onError?(error: unknown): void;
+  resolveSelection?(selection: PoHeadlessSelection): PoHeadlessSelection | Promise<PoHeadlessSelection>;
+  validateSelection?(selection: PoHeadlessSelection): void | Promise<void>;
+  allowedTools?(selection: PoHeadlessSelection): readonly string[] | undefined;
+  onApplied?(selection: PoHeadlessSelection, revision: number): void | Promise<void>;
+  onError?(error: unknown, source?: 'activity' | 'apply' | 'hook' | 'resource'): void;
 }
 export interface HeadlessSelectionStatus {
   requestedRevision: number;

package/dist/src/systems/main/types/headlessHost.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"headlessHost.d.mts","names":[],"sources":["../../../../../src/systems/main/types/headlessHost.ts"],"mappings":";;;;;;YAWY,2BAA2B,KAAK;EAC1C;EACA;;iBAGe;WACN,kBAAkB;WAClB,iBAAiB;WACjB,aAAa,SAAS,eAAe;;iBAG/B;EACf,qBAAqB;EACrB,WAAW;EACX;EACA,QAAQ,WAAW,wBAAwB;EAC3C,gBAAgB;EAChB,WAAW,gBAAgB,4BAA4B;EACvD,eAAe,oBAAoB,oCAAoC;EACvE,kBAAkB,WAAW,wBAAwB,wBAAwB,QAAQ;EACrF,mBAAmB,WAAW,+BAA+B;EAC7D,cAAc,WAAW;EACzB,WAAW,WAAW,uBAAuB,0BAA0B;EACvE,SAAS;;iBAGM;EACf;EACA;EACA;EACA"}
+{"version":3,"file":"headlessHost.d.mts","names":[],"sources":["../../../../../src/systems/main/types/headlessHost.ts"],"mappings":";;;;;;YAYY,2BAA2B,KAAK;EAC1C;EACA;;iBAGe;WACN,kBAAkB;WAClB,iBAAiB;WACjB,aAAa,SAAS,eAAe;;iBAG/B;EACf,qBAAqB;EACrB,WAAW;EACX;EACA,QAAQ,WAAW,sBAAsB;;EAEzC,mBACE,QAAQ,2BACR,QAAQ,QAAQ,8BAA8B,gBAC7C;EACH,gBAAgB;EAChB,WAAW,gBAAgB,0BAA0B;EACrD,eAAe,oBAAoB,oCAAoC;EACvE,kBAAkB,WAAW,sBAAsB,sBAAsB,QAAQ;EACjF,mBAAmB,WAAW,6BAA6B;EAC3D,cAAc,WAAW;EACzB,WAAW,WAAW,qBAAqB,0BAA0B;EACrE,SAAS,gBAAgB;;iBAGV;EACf;EACA;EACA;EACA"}

package/dist/src/testing/pi/testHost.cjs

@@ -374,12 +374,12 @@ function createPiTestHost(options = {}) {
 		},
 		async cordis(source = DEFAULT_CORDIS_SOURCE) {
 			if (cordisConnection === void 0) {
-				const controller = await require_runtimeCordisHost.installDoomCordisHost(pi, {
+				const controller = await require_runtimeCordisHost.installPoCordisHost(pi, {
 					mode: "standalone",
 					source: `${source}:standalone-host`
 				});
 				try {
-					cordisConnection = await require_runtimeCordisHost.connectDoomCordisHost(pi, source);
+					cordisConnection = await require_runtimeCordisHost.connectPoCordisHost(pi, source);
 				} catch (error) {
 					await controller.shutdown();
 					throw error;

package/dist/src/testing/pi/testHost.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testHost.cjs","names":["installDoomCordisHost","connectDoomCordisHost"],"sources":["../../../../src/testing/pi/testHost.ts"],"sourcesContent":["import type {\n  ExtensionAPI,\n  ExtensionContext,\n  ExtensionToolContext,\n  ToolDefinition,\n  ToolInfo,\n} from '@earendil-works/pi-coding-agent';\nimport type { TSchema } from 'typebox';\n\nimport { connectDoomCordisHost, installDoomCordisHost, type DoomCordisHostConnection } from '../../pi/cordisHost';\n\n/**\n * A Pi host a test drives, in place of the one Pi builds at runtime.\n *\n * Every extension package needs one, and before this each wrote its own as an\n * `as unknown as ExtensionAPI` cast over the four or five members that package\n * happened to call. A cast type-checks whatever Pi's interface becomes, so the\n * casts all kept passing while diverging from each other and from Pi.\n *\n * `pi` here is a plain `ExtensionAPI`, assigned without a cast. When a Pi\n * upgrade adds or reshapes a member, this file stops compiling, which is the\n * whole point: one place to notice, instead of ninety places that never do.\n *\n * `ExtensionContext` cannot be held to the same standard and is built with one\n * cast, named at the site. Three of its members are unsatisfiable by an object\n * literal: `modelRegistry` is a class with a private field, so it is nominally\n * typed; `ui.theme` is typed from a module Pi does not export; and `model` is\n * a populated provider record no test asserts on. The context is otherwise\n * built member by member, and the surface extensions actually program against,\n * `ExtensionAPI`, carries no cast at all.\n */\n\n/**\n * Every handler Pi's 34 `on` overloads accept, stored as one.\n *\n * `never` in the parameter positions is what makes all 34 assignable: a handler\n * is only accepted where the stored type asks for less than the handler does.\n * The consequence is that a stored handler cannot be called without widening it\n * back, which `invokable` does once, below. No single type both accepts every\n * overload and is callable with an arbitrary payload.\n */\ntype LifecycleHandler = (event: never, context: never) => unknown;\n/** One stored handler, widened at the single point that calls it. */\ntype InvokableHandler = (event: unknown, context: unknown) => unknown;\n\nfunction invokable(handler: LifecycleHandler): InvokableHandler {\n  return handler as InvokableHandler;\n}\n\n/** Types Pi declares but does not re-export from its package root. */\ntype SessionManagerView = ExtensionContext['sessionManager'];\ntype RunMode = ExtensionContext['mode'];\ntype ShortcutId = Parameters<ExtensionAPI['registerShortcut']>[0];\ntype ShortcutOptions = Parameters<ExtensionAPI['registerShortcut']>[1];\ntype CommandOptions = Parameters<ExtensionAPI['registerCommand']>[1];\ntype FlagOptions = Parameters<ExtensionAPI['registerFlag']>[1];\ntype CustomMessagePayload = Parameters<ExtensionAPI['sendMessage']>[0];\ntype SendMessageOptions = Parameters<ExtensionAPI['sendMessage']>[1];\ntype UserMessageContent = Parameters<ExtensionAPI['sendUserMessage']>[0];\ntype SendUserMessageOptions = Parameters<ExtensionAPI['sendUserMessage']>[1];\ntype RegisteredTool = Parameters<ExtensionAPI['registerTool']>[0];\ntype ToolUpdateCallback = Parameters<RegisteredTool['execute']>[3];\ntype ExecutionResult = Awaited<ReturnType<ExtensionAPI['exec']>>;\ntype ExecutionOptions = Parameters<ExtensionAPI['exec']>[2];\ntype ThinkingLevelValue = ReturnType<ExtensionAPI['getThinkingLevel']>;\ntype WidgetContent = Parameters<ExtensionContext['ui']['setWidget']>[1];\n\n/** Inventory entry for a host-owned tool this harness cannot execute. */\nfunction builtinToolInfo(name: string): ToolInfo {\n  return {\n    name,\n    description: `Built-in ${name}`,\n    parameters: { type: 'object', properties: {}, additionalProperties: false },\n    sourceInfo: { type: 'builtin' },\n  } as unknown as ToolInfo;\n}\n\n/** Inventory view of a tool an extension registered with this host. */\nfunction registeredToolInfo(tool: RegisteredTool): ToolInfo {\n  return {\n    name: tool.name,\n    description: tool.description,\n    parameters: tool.parameters,\n    promptGuidelines: (tool as { promptGuidelines?: unknown }).promptGuidelines,\n    sourceInfo: { type: 'extension' },\n  } as unknown as ToolInfo;\n}\n\nexport interface RecordedCommand {\n  name: string;\n  options: CommandOptions;\n}\nexport interface RecordedShortcut {\n  shortcut: ShortcutId;\n  options: ShortcutOptions;\n}\nexport interface RecordedRenderer {\n  customType: string;\n  renderer: unknown;\n}\n/** A `registerProvider` call in either of its two shapes. */\nexport interface RecordedProvider {\n  /** Present for the `(name, config)` overload. */\n  name?: string;\n  value: unknown;\n}\nexport interface RecordedMessage {\n  message: CustomMessagePayload;\n  options: SendMessageOptions;\n}\nexport interface RecordedUserMessage {\n  content: UserMessageContent;\n  options: SendUserMessageOptions;\n}\nexport interface RecordedEntry {\n  customType: string;\n  data: unknown;\n}\nexport interface RecordedExec {\n  command: string;\n  args: string[];\n  options: ExecutionOptions;\n}\nexport interface RecordedNotification {\n  sessionId: string;\n  message: string;\n  level: 'info' | 'warning' | 'error' | undefined;\n}\nexport interface RecordedWidget {\n  sessionId: string;\n  key: string;\n  content: WidgetContent;\n}\nexport interface RecordedStatus {\n  sessionId: string;\n  key: string;\n  text: string | undefined;\n}\n\n/**\n * What the extension's dialogs answer.\n *\n * Every default is the dismissal, because that is the answer a headless host\n * gives and the one an extension is most likely to mishandle.\n */\nexport interface PiTestDialogAnswers {\n  select(title: string, options: string[]): string | undefined;\n  confirm(title: string, message: string): boolean;\n  input(title: string, placeholder: string | undefined): string | undefined;\n  editor(title: string, prefill: string | undefined): string | undefined;\n}\n\nexport interface PiTestContextOptions {\n  sessionId?: string;\n  cwd?: string;\n  hasUI?: boolean;\n  mode?: RunMode;\n  isIdle?: boolean;\n  isProjectTrusted?: boolean;\n  signal?: AbortSignal;\n  answers?: Partial<PiTestDialogAnswers>;\n  systemPrompt?: string;\n}\n\nexport interface PiTestHostOptions extends PiTestContextOptions {\n  /** Answers `pi.exec`; the default reports a command that ran and printed nothing. */\n  exec?: (command: string, args: string[]) => ExecutionResult | Promise<ExecutionResult>;\n  /**\n   * Tool names Pi would already own before any extension loads.\n   *\n   * They join the inventory and start active, which is how the tool surface\n   * arbiter learns that a name like `read` exists without a definition for it.\n   */\n  builtinTools?: readonly string[];\n}\n\nexport interface PiTestHost {\n  /** The host an extension factory receives. */\n  readonly pi: ExtensionAPI;\n  readonly tools: readonly RegisteredTool[];\n  readonly commands: readonly RecordedCommand[];\n  readonly shortcuts: readonly RecordedShortcut[];\n  readonly flags: ReadonlyMap<string, FlagOptions>;\n  readonly messageRenderers: readonly RecordedRenderer[];\n  readonly entryRenderers: readonly RecordedRenderer[];\n  readonly markdownTransformers: readonly unknown[];\n  readonly providers: readonly RecordedProvider[];\n  readonly unregisteredProviders: readonly string[];\n  readonly messages: readonly RecordedMessage[];\n  readonly userMessages: readonly RecordedUserMessage[];\n  readonly entries: readonly RecordedEntry[];\n  readonly execs: readonly RecordedExec[];\n  readonly notifications: readonly RecordedNotification[];\n  readonly statuses: readonly RecordedStatus[];\n  readonly widgets: readonly RecordedWidget[];\n  /** Tool names Pi would offer the model right now. */\n  activeTools(): readonly string[];\n  tool(name: string): RegisteredTool | undefined;\n  command(name: string): RecordedCommand | undefined;\n  /** Lifecycle handlers registered for one event, in registration order. */\n  handlers(event: string): readonly InvokableHandler[];\n  /** A context for this host; each call builds a fresh one, as Pi does per event. */\n  context(options?: PiTestContextOptions): ExtensionToolContext;\n  /**\n   * Runs every handler for one lifecycle event and returns what they answered.\n   *\n   * Sequential and awaited, matching Pi, so a test can observe one handler's\n   * effect on the next.\n   */\n  emit(event: string, payload?: unknown, context?: ExtensionContext): Promise<unknown[]>;\n  /** Calls a registered tool the way Pi's runner does. */\n  callTool(\n    name: string,\n    params?: unknown,\n    options?: {\n      toolCallId?: string;\n      signal?: AbortSignal;\n      onUpdate?: ToolUpdateCallback;\n      context?: ExtensionToolContext;\n    },\n  ): Promise<unknown>;\n  /** Runs a registered slash command the way Pi's palette does. */\n  runCommand(name: string, args?: string, context?: ExtensionContext): Promise<void>;\n  /** The real Cordis host on this runner, installed on first use and disposed by `dispose`. */\n  cordis(source?: string): Promise<DoomCordisHostConnection>;\n  dispose(): Promise<void>;\n}\n\nconst DEFAULT_CWD = '/repo';\nconst DEFAULT_SESSION_ID = 'test-session';\nconst DEFAULT_MODE: RunMode = 'tui';\nconst DEFAULT_SYSTEM_PROMPT = '';\nconst DEFAULT_CORDIS_SOURCE = 'pi-test-host';\nconst DEFAULT_EXEC: ExecutionResult = { code: 0, killed: false, stdout: '', stderr: '' };\n\nconst DISMISSED: PiTestDialogAnswers = {\n  select: () => undefined,\n  confirm: () => false,\n  input: () => undefined,\n  editor: () => undefined,\n};\n\n/**\n * A Pi host and the records of what an extension did to it.\n *\n * Nothing here is a spy from a test framework: the records are plain arrays, so\n * the harness works under any runner and adds no dependency to a package that\n * every extension already installs.\n */\nexport function createPiTestHost(options: PiTestHostOptions = {}): PiTestHost {\n  const builtinTools: readonly string[] = options.builtinTools ?? [];\n  const tools: RegisteredTool[] = [];\n  const commands: RecordedCommand[] = [];\n  const shortcuts: RecordedShortcut[] = [];\n  const flags = new Map<string, FlagOptions>();\n  const messageRenderers: RecordedRenderer[] = [];\n  const entryRenderers: RecordedRenderer[] = [];\n  const markdownTransformers: unknown[] = [];\n  const providers: RecordedProvider[] = [];\n  const unregisteredProviders: string[] = [];\n  const messages: RecordedMessage[] = [];\n  const userMessages: RecordedUserMessage[] = [];\n  const entries: RecordedEntry[] = [];\n  const execs: RecordedExec[] = [];\n  const notifications: RecordedNotification[] = [];\n  const statuses: RecordedStatus[] = [];\n  const widgets: RecordedWidget[] = [];\n\n  const lifecycle = new Map<string, LifecycleHandler[]>();\n  const channels = new Map<string, Set<(data: unknown) => void>>();\n  let activeToolNames: string[] = [...builtinTools];\n  let sessionName: string | undefined;\n  let thinkingLevel: ThinkingLevelValue = 'off';\n  let cordisConnection: DoomCordisHostConnection | undefined;\n\n  const runExec = options.exec ?? ((): ExecutionResult => DEFAULT_EXEC);\n\n  const pi: ExtensionAPI = {\n    on(event: string, handler: LifecycleHandler): () => void {\n      const registered = lifecycle.get(event) ?? [];\n      registered.push(handler);\n      lifecycle.set(event, registered);\n      return () => {\n        const index = registered.indexOf(handler);\n        if (index === -1) return;\n        registered.splice(index, 1);\n        if (registered.length === 0) lifecycle.delete(event);\n      };\n    },\n    // Generic exactly as Pi declares it. Storage erases the schema generics; the\n    // signature is the half that has to keep matching.\n    registerTool<TParams extends TSchema = TSchema, TDetails = unknown, TState = unknown>(\n      tool: ToolDefinition<TParams, TDetails, TState>,\n    ): void {\n      tools.push(tool as unknown as RegisteredTool);\n      if (!activeToolNames.includes(tool.name)) activeToolNames.push(tool.name);\n    },\n    registerToolRenderer(): void {},\n    registerCommand(name: string, commandOptions: CommandOptions): void {\n      commands.push({ name, options: commandOptions });\n    },\n    registerShortcut(shortcut: ShortcutId, shortcutOptions: ShortcutOptions): void {\n      shortcuts.push({ shortcut, options: shortcutOptions });\n    },\n    registerFlag(name: string, flagOptions: FlagOptions): void {\n      flags.set(name, flagOptions);\n    },\n    getFlag(name: string): boolean | string | undefined {\n      return flags.get(name)?.default;\n    },\n    registerMessageRenderer(customType: string, renderer: unknown): void {\n      messageRenderers.push({ customType, renderer });\n    },\n    registerMarkdownTransformer(transformer: unknown): void {\n      markdownTransformers.push(transformer);\n    },\n    registerEntryRenderer(customType: string, renderer: unknown): void {\n      entryRenderers.push({ customType, renderer });\n    },\n    sendMessage(message: CustomMessagePayload, sendOptions?: SendMessageOptions): void {\n      messages.push({ message, options: sendOptions });\n    },\n    sendUserMessage(content: UserMessageContent, sendOptions?: SendUserMessageOptions): void {\n      userMessages.push({ content, options: sendOptions });\n    },\n    appendEntry(customType: string, data?: unknown): void {\n      entries.push({ customType, data });\n    },\n    setSessionName(name: string): void {\n      sessionName = name;\n    },\n    getSessionName(): string | undefined {\n      return sessionName;\n    },\n    setLabel(): void {\n      // Labels are session bookmarks; no Po extension reads them back.\n    },\n    async exec(command: string, args: string[], execOptions?: ExecutionOptions): Promise<ExecutionResult> {\n      execs.push({ command, args, options: execOptions });\n      return runExec(command, args);\n    },\n    getActiveTools(): string[] {\n      return [...activeToolNames];\n    },\n    getAllTools(): ToolInfo[] {\n      // Pi's inventory folds in built-in and MCP tools, which this host models\n      // as names only: a test asserts on the surface, never on their behaviour.\n      return [...builtinTools.map(builtinToolInfo), ...tools.map(registeredToolInfo)];\n    },\n    setActiveTools(toolNames: string[]): void {\n      activeToolNames = [...toolNames];\n    },\n    getSettings() {\n      return {};\n    },\n    // No Po extension registers MCP servers or virtual models through Pi yet.\n    registerMcpServer(): void {},\n    unregisterMcpServer(): void {},\n    getMcpServers() {\n      return [];\n    },\n    registerVirtualModel(): void {},\n    unregisterVirtualModel(): void {},\n    getCommands(): never[] {\n      return [];\n    },\n    async setModel(): Promise<boolean> {\n      // No API key is configured, which is the answer Pi gives for the same reason.\n      return false;\n    },\n    getThinkingLevel(): ThinkingLevelValue {\n      return thinkingLevel;\n    },\n    setThinkingLevel(level: ThinkingLevelValue): void {\n      thinkingLevel = level;\n    },\n    registerProvider(providerOrName: unknown, config?: unknown): void {\n      providers.push(\n        typeof providerOrName === 'string' ? { name: providerOrName, value: config } : { value: providerOrName },\n      );\n    },\n    unregisterProvider(name: string): void {\n      unregisteredProviders.push(name);\n    },\n    events: {\n      emit(channel: string, data: unknown): void {\n        // A snapshot: a listener that unsubscribes on delivery would otherwise\n        // reshape the set this loop is walking.\n        const delivered = [...(channels.get(channel) ?? [])];\n        for (const listener of delivered) listener(data);\n      },\n      on(channel: string, listener: (data: unknown) => void): () => void {\n        const listeners = channels.get(channel) ?? new Set<(data: unknown) => void>();\n        listeners.add(listener);\n        channels.set(channel, listeners);\n        return () => listeners.delete(listener);\n      },\n    },\n  };\n\n  function buildContext(contextOptions: PiTestContextOptions = {}): ExtensionToolContext {\n    const sessionId = contextOptions.sessionId ?? options.sessionId ?? DEFAULT_SESSION_ID;\n    const cwd = contextOptions.cwd ?? options.cwd ?? DEFAULT_CWD;\n    const answers = { ...DISMISSED, ...options.answers, ...contextOptions.answers };\n    const sessionManager = {\n      getCwd: () => cwd,\n      getSessionId: () => sessionId,\n      getSessionName: () => sessionName,\n      getSessionDir: () => cwd,\n      getSessionFile: () => `${cwd}/${sessionId}.jsonl`,\n      getLeafId: () => undefined,\n      getLeafEntry: () => undefined,\n      getEntry: () => undefined,\n      getLabel: () => undefined,\n      getBranch: () => [],\n      buildContextEntries: () => [],\n      getHeader: () => undefined,\n      getEntries: () => [],\n      getTree: () => [],\n    };\n    const ui = {\n      select: async (title: string, selectOptions: string[]) => answers.select(title, selectOptions),\n      confirm: async (title: string, message: string) => answers.confirm(title, message),\n      input: async (title: string, placeholder?: string) => answers.input(title, placeholder),\n      editor: async (title: string, prefill?: string) => answers.editor(title, prefill),\n      notify: (message: string, level?: 'info' | 'warning' | 'error') => {\n        notifications.push({ sessionId, message, level });\n      },\n      onTerminalInput: () => () => undefined,\n      setStatus: (key: string, text: string | undefined) => {\n        statuses.push({ sessionId, key, text });\n      },\n      setWorkingMessage: () => undefined,\n      setWorkingVisible: () => undefined,\n      setWorkingIndicator: () => undefined,\n      setHiddenThinkingLabel: () => undefined,\n      setWidget: (key: string, content: WidgetContent) => {\n        widgets.push({ sessionId, key, content });\n      },\n      setFooter: () => undefined,\n      setHeader: () => undefined,\n      setTitle: () => undefined,\n      // A custom component needs a real TUI to resolve, so it never does. An\n      // extension awaiting one must stay responsive, which is what this proves.\n      custom: () => new Promise<never>(() => undefined),\n      pasteToEditor: () => undefined,\n      setEditorText: () => undefined,\n      getEditorText: () => '',\n      addAutocompleteProvider: () => undefined,\n      setEditorComponent: () => undefined,\n      getEditorComponent: () => undefined,\n      theme: undefined,\n      getAllThemes: () => [],\n      getTheme: () => undefined,\n      setTheme: () => ({ success: false, error: 'This host renders nothing.' }),\n      getToolsExpanded: () => false,\n      setToolsExpanded: () => undefined,\n    };\n    const context = {\n      ui,\n      mode: contextOptions.mode ?? options.mode ?? DEFAULT_MODE,\n      hasUI: contextOptions.hasUI ?? options.hasUI ?? true,\n      cwd,\n      sessionManager: sessionManager as unknown as SessionManagerView,\n      modelRegistry: undefined,\n      model: undefined,\n      scopedModels: [],\n      isIdle: () => contextOptions.isIdle ?? options.isIdle ?? true,\n      isProjectTrusted: () => contextOptions.isProjectTrusted ?? options.isProjectTrusted ?? true,\n      signal: contextOptions.signal ?? options.signal,\n      abort: () => undefined,\n      hasPendingMessages: () => false,\n      shutdown: () => undefined,\n      getContextUsage: () => undefined,\n      compact: () => undefined,\n      getSystemPrompt: () => contextOptions.systemPrompt ?? options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,\n      // Command handlers receive the wider context, and an extension that only\n      // reads it should not have to be handed a second fixture to be exercised.\n      getSystemPromptOptions: () => ({}),\n      waitForIdle: async () => undefined,\n      newSession: async () => ({ cancelled: true }),\n      fork: async () => ({ cancelled: true }),\n      navigateTree: async () => ({ cancelled: true }),\n      switchSession: async () => ({ cancelled: true }),\n      reload: async () => undefined,\n      // Tool execute() receives the tool context. Nested calls answer as Pi does when unbound.\n      tools: [],\n      executeTool: async (name: string) => ({\n        toolCall: { type: 'toolCall', id: 'nested/0', name, arguments: {} },\n        result: {\n          content: [{ type: 'text', text: 'Nested tool calls are not available in this context' }],\n          details: {},\n        },\n        isError: true,\n      }),\n    };\n    // The one cast. `modelRegistry` is a class with a private field and so is\n    // nominally typed, `ui.theme` is typed from a module Pi does not export,\n    // and `model` is a populated provider record. No object literal can satisfy\n    // those three, and no Po extension reads them.\n    return context as unknown as ExtensionToolContext;\n  }\n\n  return {\n    pi,\n    tools,\n    commands,\n    shortcuts,\n    flags,\n    messageRenderers,\n    entryRenderers,\n    markdownTransformers,\n    providers,\n    unregisteredProviders,\n    messages,\n    userMessages,\n    entries,\n    execs,\n    notifications,\n    statuses,\n    widgets,\n    activeTools: () => [...activeToolNames],\n    tool: (name) => tools.findLast((candidate) => candidate.name === name),\n    command: (name) => commands.find((candidate) => candidate.name === name),\n    handlers: (event) => (lifecycle.get(event) ?? []).map(invokable),\n    context: buildContext,\n    async emit(event, payload, context) {\n      const eventContext = context ?? buildContext();\n      const answered: unknown[] = [];\n      // A snapshot, because a handler may register another for the same event\n      // and Pi does not deliver this emission to it.\n      const delivered = [...(lifecycle.get(event) ?? [])];\n      for (const handler of delivered) {\n        answered.push(await invokable(handler)({ type: event, ...(payload as object) }, eventContext));\n      }\n      if (event === 'session_shutdown') cordisConnection = undefined;\n      return answered;\n    },\n    async callTool(name, params = {}, callOptions = {}) {\n      const tool = tools.findLast((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`No tool named '${name}' is registered on this host.`);\n      return tool.execute(\n        callOptions.toolCallId ?? `call-${String(tools.indexOf(tool))}`,\n        params,\n        callOptions.signal,\n        callOptions.onUpdate,\n        callOptions.context ?? buildContext(),\n      );\n    },\n    async runCommand(name, args = '', context) {\n      const command = commands.find((candidate) => candidate.name === name);\n      if (!command) throw new Error(`No command named '${name}' is registered on this host.`);\n      await command.options.handler(args, (context ?? buildContext()) as never);\n    },\n    async cordis(source = DEFAULT_CORDIS_SOURCE) {\n      if (cordisConnection === undefined) {\n        const controller = await installDoomCordisHost(pi, {\n          mode: 'standalone',\n          source: `${source}:standalone-host`,\n        });\n        try {\n          cordisConnection = await connectDoomCordisHost(pi, source);\n        } catch (error) {\n          await controller.shutdown();\n          throw error;\n        }\n      }\n      return cordisConnection;\n    },\n    async dispose() {\n      await cordisConnection?.dispose();\n      cordisConnection = undefined;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"testHost.cjs","names":["installPoCordisHost","connectPoCordisHost"],"sources":["../../../../src/testing/pi/testHost.ts"],"sourcesContent":["import type {\n  ExtensionAPI,\n  ExtensionContext,\n  ExtensionToolContext,\n  ToolDefinition,\n  ToolInfo,\n} from '@earendil-works/pi-coding-agent';\nimport type { TSchema } from 'typebox';\n\nimport { connectPoCordisHost, installPoCordisHost, type PoCordisHostConnection } from '../../pi/cordisHost';\n\n/**\n * A Pi host a test drives, in place of the one Pi builds at runtime.\n *\n * Every extension package needs one, and before this each wrote its own as an\n * `as unknown as ExtensionAPI` cast over the four or five members that package\n * happened to call. A cast type-checks whatever Pi's interface becomes, so the\n * casts all kept passing while diverging from each other and from Pi.\n *\n * `pi` here is a plain `ExtensionAPI`, assigned without a cast. When a Pi\n * upgrade adds or reshapes a member, this file stops compiling, which is the\n * whole point: one place to notice, instead of ninety places that never do.\n *\n * `ExtensionContext` cannot be held to the same standard and is built with one\n * cast, named at the site. Three of its members are unsatisfiable by an object\n * literal: `modelRegistry` is a class with a private field, so it is nominally\n * typed; `ui.theme` is typed from a module Pi does not export; and `model` is\n * a populated provider record no test asserts on. The context is otherwise\n * built member by member, and the surface extensions actually program against,\n * `ExtensionAPI`, carries no cast at all.\n */\n\n/**\n * Every handler Pi's 34 `on` overloads accept, stored as one.\n *\n * `never` in the parameter positions is what makes all 34 assignable: a handler\n * is only accepted where the stored type asks for less than the handler does.\n * The consequence is that a stored handler cannot be called without widening it\n * back, which `invokable` does once, below. No single type both accepts every\n * overload and is callable with an arbitrary payload.\n */\ntype LifecycleHandler = (event: never, context: never) => unknown;\n/** One stored handler, widened at the single point that calls it. */\ntype InvokableHandler = (event: unknown, context: unknown) => unknown;\n\nfunction invokable(handler: LifecycleHandler): InvokableHandler {\n  return handler as InvokableHandler;\n}\n\n/** Types Pi declares but does not re-export from its package root. */\ntype SessionManagerView = ExtensionContext['sessionManager'];\ntype RunMode = ExtensionContext['mode'];\ntype ShortcutId = Parameters<ExtensionAPI['registerShortcut']>[0];\ntype ShortcutOptions = Parameters<ExtensionAPI['registerShortcut']>[1];\ntype CommandOptions = Parameters<ExtensionAPI['registerCommand']>[1];\ntype FlagOptions = Parameters<ExtensionAPI['registerFlag']>[1];\ntype CustomMessagePayload = Parameters<ExtensionAPI['sendMessage']>[0];\ntype SendMessageOptions = Parameters<ExtensionAPI['sendMessage']>[1];\ntype UserMessageContent = Parameters<ExtensionAPI['sendUserMessage']>[0];\ntype SendUserMessageOptions = Parameters<ExtensionAPI['sendUserMessage']>[1];\ntype RegisteredTool = Parameters<ExtensionAPI['registerTool']>[0];\ntype ToolUpdateCallback = Parameters<RegisteredTool['execute']>[3];\ntype ExecutionResult = Awaited<ReturnType<ExtensionAPI['exec']>>;\ntype ExecutionOptions = Parameters<ExtensionAPI['exec']>[2];\ntype ThinkingLevelValue = ReturnType<ExtensionAPI['getThinkingLevel']>;\ntype WidgetContent = Parameters<ExtensionContext['ui']['setWidget']>[1];\n\n/** Inventory entry for a host-owned tool this harness cannot execute. */\nfunction builtinToolInfo(name: string): ToolInfo {\n  return {\n    name,\n    description: `Built-in ${name}`,\n    parameters: { type: 'object', properties: {}, additionalProperties: false },\n    sourceInfo: { type: 'builtin' },\n  } as unknown as ToolInfo;\n}\n\n/** Inventory view of a tool an extension registered with this host. */\nfunction registeredToolInfo(tool: RegisteredTool): ToolInfo {\n  return {\n    name: tool.name,\n    description: tool.description,\n    parameters: tool.parameters,\n    promptGuidelines: (tool as { promptGuidelines?: unknown }).promptGuidelines,\n    sourceInfo: { type: 'extension' },\n  } as unknown as ToolInfo;\n}\n\nexport interface RecordedCommand {\n  name: string;\n  options: CommandOptions;\n}\nexport interface RecordedShortcut {\n  shortcut: ShortcutId;\n  options: ShortcutOptions;\n}\nexport interface RecordedRenderer {\n  customType: string;\n  renderer: unknown;\n}\n/** A `registerProvider` call in either of its two shapes. */\nexport interface RecordedProvider {\n  /** Present for the `(name, config)` overload. */\n  name?: string;\n  value: unknown;\n}\nexport interface RecordedMessage {\n  message: CustomMessagePayload;\n  options: SendMessageOptions;\n}\nexport interface RecordedUserMessage {\n  content: UserMessageContent;\n  options: SendUserMessageOptions;\n}\nexport interface RecordedEntry {\n  customType: string;\n  data: unknown;\n}\nexport interface RecordedExec {\n  command: string;\n  args: string[];\n  options: ExecutionOptions;\n}\nexport interface RecordedNotification {\n  sessionId: string;\n  message: string;\n  level: 'info' | 'warning' | 'error' | undefined;\n}\nexport interface RecordedWidget {\n  sessionId: string;\n  key: string;\n  content: WidgetContent;\n}\nexport interface RecordedStatus {\n  sessionId: string;\n  key: string;\n  text: string | undefined;\n}\n\n/**\n * What the extension's dialogs answer.\n *\n * Every default is the dismissal, because that is the answer a headless host\n * gives and the one an extension is most likely to mishandle.\n */\nexport interface PiTestDialogAnswers {\n  select(title: string, options: string[]): string | undefined;\n  confirm(title: string, message: string): boolean;\n  input(title: string, placeholder: string | undefined): string | undefined;\n  editor(title: string, prefill: string | undefined): string | undefined;\n}\n\nexport interface PiTestContextOptions {\n  sessionId?: string;\n  cwd?: string;\n  hasUI?: boolean;\n  mode?: RunMode;\n  isIdle?: boolean;\n  isProjectTrusted?: boolean;\n  signal?: AbortSignal;\n  answers?: Partial<PiTestDialogAnswers>;\n  systemPrompt?: string;\n}\n\nexport interface PiTestHostOptions extends PiTestContextOptions {\n  /** Answers `pi.exec`; the default reports a command that ran and printed nothing. */\n  exec?: (command: string, args: string[]) => ExecutionResult | Promise<ExecutionResult>;\n  /**\n   * Tool names Pi would already own before any extension loads.\n   *\n   * They join the inventory and start active, which is how the tool surface\n   * arbiter learns that a name like `read` exists without a definition for it.\n   */\n  builtinTools?: readonly string[];\n}\n\nexport interface PiTestHost {\n  /** The host an extension factory receives. */\n  readonly pi: ExtensionAPI;\n  readonly tools: readonly RegisteredTool[];\n  readonly commands: readonly RecordedCommand[];\n  readonly shortcuts: readonly RecordedShortcut[];\n  readonly flags: ReadonlyMap<string, FlagOptions>;\n  readonly messageRenderers: readonly RecordedRenderer[];\n  readonly entryRenderers: readonly RecordedRenderer[];\n  readonly markdownTransformers: readonly unknown[];\n  readonly providers: readonly RecordedProvider[];\n  readonly unregisteredProviders: readonly string[];\n  readonly messages: readonly RecordedMessage[];\n  readonly userMessages: readonly RecordedUserMessage[];\n  readonly entries: readonly RecordedEntry[];\n  readonly execs: readonly RecordedExec[];\n  readonly notifications: readonly RecordedNotification[];\n  readonly statuses: readonly RecordedStatus[];\n  readonly widgets: readonly RecordedWidget[];\n  /** Tool names Pi would offer the model right now. */\n  activeTools(): readonly string[];\n  tool(name: string): RegisteredTool | undefined;\n  command(name: string): RecordedCommand | undefined;\n  /** Lifecycle handlers registered for one event, in registration order. */\n  handlers(event: string): readonly InvokableHandler[];\n  /** A context for this host; each call builds a fresh one, as Pi does per event. */\n  context(options?: PiTestContextOptions): ExtensionToolContext;\n  /**\n   * Runs every handler for one lifecycle event and returns what they answered.\n   *\n   * Sequential and awaited, matching Pi, so a test can observe one handler's\n   * effect on the next.\n   */\n  emit(event: string, payload?: unknown, context?: ExtensionContext): Promise<unknown[]>;\n  /** Calls a registered tool the way Pi's runner does. */\n  callTool(\n    name: string,\n    params?: unknown,\n    options?: {\n      toolCallId?: string;\n      signal?: AbortSignal;\n      onUpdate?: ToolUpdateCallback;\n      context?: ExtensionToolContext;\n    },\n  ): Promise<unknown>;\n  /** Runs a registered slash command the way Pi's palette does. */\n  runCommand(name: string, args?: string, context?: ExtensionContext): Promise<void>;\n  /** The real Cordis host on this runner, installed on first use and disposed by `dispose`. */\n  cordis(source?: string): Promise<PoCordisHostConnection>;\n  dispose(): Promise<void>;\n}\n\nconst DEFAULT_CWD = '/repo';\nconst DEFAULT_SESSION_ID = 'test-session';\nconst DEFAULT_MODE: RunMode = 'tui';\nconst DEFAULT_SYSTEM_PROMPT = '';\nconst DEFAULT_CORDIS_SOURCE = 'pi-test-host';\nconst DEFAULT_EXEC: ExecutionResult = { code: 0, killed: false, stdout: '', stderr: '' };\n\nconst DISMISSED: PiTestDialogAnswers = {\n  select: () => undefined,\n  confirm: () => false,\n  input: () => undefined,\n  editor: () => undefined,\n};\n\n/**\n * A Pi host and the records of what an extension did to it.\n *\n * Nothing here is a spy from a test framework: the records are plain arrays, so\n * the harness works under any runner and adds no dependency to a package that\n * every extension already installs.\n */\nexport function createPiTestHost(options: PiTestHostOptions = {}): PiTestHost {\n  const builtinTools: readonly string[] = options.builtinTools ?? [];\n  const tools: RegisteredTool[] = [];\n  const commands: RecordedCommand[] = [];\n  const shortcuts: RecordedShortcut[] = [];\n  const flags = new Map<string, FlagOptions>();\n  const messageRenderers: RecordedRenderer[] = [];\n  const entryRenderers: RecordedRenderer[] = [];\n  const markdownTransformers: unknown[] = [];\n  const providers: RecordedProvider[] = [];\n  const unregisteredProviders: string[] = [];\n  const messages: RecordedMessage[] = [];\n  const userMessages: RecordedUserMessage[] = [];\n  const entries: RecordedEntry[] = [];\n  const execs: RecordedExec[] = [];\n  const notifications: RecordedNotification[] = [];\n  const statuses: RecordedStatus[] = [];\n  const widgets: RecordedWidget[] = [];\n\n  const lifecycle = new Map<string, LifecycleHandler[]>();\n  const channels = new Map<string, Set<(data: unknown) => void>>();\n  let activeToolNames: string[] = [...builtinTools];\n  let sessionName: string | undefined;\n  let thinkingLevel: ThinkingLevelValue = 'off';\n  let cordisConnection: PoCordisHostConnection | undefined;\n\n  const runExec = options.exec ?? ((): ExecutionResult => DEFAULT_EXEC);\n\n  const pi: ExtensionAPI = {\n    on(event: string, handler: LifecycleHandler): () => void {\n      const registered = lifecycle.get(event) ?? [];\n      registered.push(handler);\n      lifecycle.set(event, registered);\n      return () => {\n        const index = registered.indexOf(handler);\n        if (index === -1) return;\n        registered.splice(index, 1);\n        if (registered.length === 0) lifecycle.delete(event);\n      };\n    },\n    // Generic exactly as Pi declares it. Storage erases the schema generics; the\n    // signature is the half that has to keep matching.\n    registerTool<TParams extends TSchema = TSchema, TDetails = unknown, TState = unknown>(\n      tool: ToolDefinition<TParams, TDetails, TState>,\n    ): void {\n      tools.push(tool as unknown as RegisteredTool);\n      if (!activeToolNames.includes(tool.name)) activeToolNames.push(tool.name);\n    },\n    registerToolRenderer(): void {},\n    registerCommand(name: string, commandOptions: CommandOptions): void {\n      commands.push({ name, options: commandOptions });\n    },\n    registerShortcut(shortcut: ShortcutId, shortcutOptions: ShortcutOptions): void {\n      shortcuts.push({ shortcut, options: shortcutOptions });\n    },\n    registerFlag(name: string, flagOptions: FlagOptions): void {\n      flags.set(name, flagOptions);\n    },\n    getFlag(name: string): boolean | string | undefined {\n      return flags.get(name)?.default;\n    },\n    registerMessageRenderer(customType: string, renderer: unknown): void {\n      messageRenderers.push({ customType, renderer });\n    },\n    registerMarkdownTransformer(transformer: unknown): void {\n      markdownTransformers.push(transformer);\n    },\n    registerEntryRenderer(customType: string, renderer: unknown): void {\n      entryRenderers.push({ customType, renderer });\n    },\n    sendMessage(message: CustomMessagePayload, sendOptions?: SendMessageOptions): void {\n      messages.push({ message, options: sendOptions });\n    },\n    sendUserMessage(content: UserMessageContent, sendOptions?: SendUserMessageOptions): void {\n      userMessages.push({ content, options: sendOptions });\n    },\n    appendEntry(customType: string, data?: unknown): void {\n      entries.push({ customType, data });\n    },\n    setSessionName(name: string): void {\n      sessionName = name;\n    },\n    getSessionName(): string | undefined {\n      return sessionName;\n    },\n    setLabel(): void {\n      // Labels are session bookmarks; no Po extension reads them back.\n    },\n    async exec(command: string, args: string[], execOptions?: ExecutionOptions): Promise<ExecutionResult> {\n      execs.push({ command, args, options: execOptions });\n      return runExec(command, args);\n    },\n    getActiveTools(): string[] {\n      return [...activeToolNames];\n    },\n    getAllTools(): ToolInfo[] {\n      // Pi's inventory folds in built-in and MCP tools, which this host models\n      // as names only: a test asserts on the surface, never on their behaviour.\n      return [...builtinTools.map(builtinToolInfo), ...tools.map(registeredToolInfo)];\n    },\n    setActiveTools(toolNames: string[]): void {\n      activeToolNames = [...toolNames];\n    },\n    getSettings() {\n      return {};\n    },\n    // No Po extension registers MCP servers or virtual models through Pi yet.\n    registerMcpServer(): void {},\n    unregisterMcpServer(): void {},\n    getMcpServers() {\n      return [];\n    },\n    registerVirtualModel(): void {},\n    unregisterVirtualModel(): void {},\n    getCommands(): never[] {\n      return [];\n    },\n    async setModel(): Promise<boolean> {\n      // No API key is configured, which is the answer Pi gives for the same reason.\n      return false;\n    },\n    getThinkingLevel(): ThinkingLevelValue {\n      return thinkingLevel;\n    },\n    setThinkingLevel(level: ThinkingLevelValue): void {\n      thinkingLevel = level;\n    },\n    registerProvider(providerOrName: unknown, config?: unknown): void {\n      providers.push(\n        typeof providerOrName === 'string' ? { name: providerOrName, value: config } : { value: providerOrName },\n      );\n    },\n    unregisterProvider(name: string): void {\n      unregisteredProviders.push(name);\n    },\n    events: {\n      emit(channel: string, data: unknown): void {\n        // A snapshot: a listener that unsubscribes on delivery would otherwise\n        // reshape the set this loop is walking.\n        const delivered = [...(channels.get(channel) ?? [])];\n        for (const listener of delivered) listener(data);\n      },\n      on(channel: string, listener: (data: unknown) => void): () => void {\n        const listeners = channels.get(channel) ?? new Set<(data: unknown) => void>();\n        listeners.add(listener);\n        channels.set(channel, listeners);\n        return () => listeners.delete(listener);\n      },\n    },\n  };\n\n  function buildContext(contextOptions: PiTestContextOptions = {}): ExtensionToolContext {\n    const sessionId = contextOptions.sessionId ?? options.sessionId ?? DEFAULT_SESSION_ID;\n    const cwd = contextOptions.cwd ?? options.cwd ?? DEFAULT_CWD;\n    const answers = { ...DISMISSED, ...options.answers, ...contextOptions.answers };\n    const sessionManager = {\n      getCwd: () => cwd,\n      getSessionId: () => sessionId,\n      getSessionName: () => sessionName,\n      getSessionDir: () => cwd,\n      getSessionFile: () => `${cwd}/${sessionId}.jsonl`,\n      getLeafId: () => undefined,\n      getLeafEntry: () => undefined,\n      getEntry: () => undefined,\n      getLabel: () => undefined,\n      getBranch: () => [],\n      buildContextEntries: () => [],\n      getHeader: () => undefined,\n      getEntries: () => [],\n      getTree: () => [],\n    };\n    const ui = {\n      select: async (title: string, selectOptions: string[]) => answers.select(title, selectOptions),\n      confirm: async (title: string, message: string) => answers.confirm(title, message),\n      input: async (title: string, placeholder?: string) => answers.input(title, placeholder),\n      editor: async (title: string, prefill?: string) => answers.editor(title, prefill),\n      notify: (message: string, level?: 'info' | 'warning' | 'error') => {\n        notifications.push({ sessionId, message, level });\n      },\n      onTerminalInput: () => () => undefined,\n      setStatus: (key: string, text: string | undefined) => {\n        statuses.push({ sessionId, key, text });\n      },\n      setWorkingMessage: () => undefined,\n      setWorkingVisible: () => undefined,\n      setWorkingIndicator: () => undefined,\n      setHiddenThinkingLabel: () => undefined,\n      setWidget: (key: string, content: WidgetContent) => {\n        widgets.push({ sessionId, key, content });\n      },\n      setFooter: () => undefined,\n      setHeader: () => undefined,\n      setTitle: () => undefined,\n      // A custom component needs a real TUI to resolve, so it never does. An\n      // extension awaiting one must stay responsive, which is what this proves.\n      custom: () => new Promise<never>(() => undefined),\n      pasteToEditor: () => undefined,\n      setEditorText: () => undefined,\n      getEditorText: () => '',\n      addAutocompleteProvider: () => undefined,\n      setEditorComponent: () => undefined,\n      getEditorComponent: () => undefined,\n      theme: undefined,\n      getAllThemes: () => [],\n      getTheme: () => undefined,\n      setTheme: () => ({ success: false, error: 'This host renders nothing.' }),\n      getToolsExpanded: () => false,\n      setToolsExpanded: () => undefined,\n    };\n    const context = {\n      ui,\n      mode: contextOptions.mode ?? options.mode ?? DEFAULT_MODE,\n      hasUI: contextOptions.hasUI ?? options.hasUI ?? true,\n      cwd,\n      sessionManager: sessionManager as unknown as SessionManagerView,\n      modelRegistry: undefined,\n      model: undefined,\n      scopedModels: [],\n      isIdle: () => contextOptions.isIdle ?? options.isIdle ?? true,\n      isProjectTrusted: () => contextOptions.isProjectTrusted ?? options.isProjectTrusted ?? true,\n      signal: contextOptions.signal ?? options.signal,\n      abort: () => undefined,\n      hasPendingMessages: () => false,\n      shutdown: () => undefined,\n      getContextUsage: () => undefined,\n      compact: () => undefined,\n      getSystemPrompt: () => contextOptions.systemPrompt ?? options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,\n      // Command handlers receive the wider context, and an extension that only\n      // reads it should not have to be handed a second fixture to be exercised.\n      getSystemPromptOptions: () => ({}),\n      waitForIdle: async () => undefined,\n      newSession: async () => ({ cancelled: true }),\n      fork: async () => ({ cancelled: true }),\n      navigateTree: async () => ({ cancelled: true }),\n      switchSession: async () => ({ cancelled: true }),\n      reload: async () => undefined,\n      // Tool execute() receives the tool context. Nested calls answer as Pi does when unbound.\n      tools: [],\n      executeTool: async (name: string) => ({\n        toolCall: { type: 'toolCall', id: 'nested/0', name, arguments: {} },\n        result: {\n          content: [{ type: 'text', text: 'Nested tool calls are not available in this context' }],\n          details: {},\n        },\n        isError: true,\n      }),\n    };\n    // The one cast. `modelRegistry` is a class with a private field and so is\n    // nominally typed, `ui.theme` is typed from a module Pi does not export,\n    // and `model` is a populated provider record. No object literal can satisfy\n    // those three, and no Po extension reads them.\n    return context as unknown as ExtensionToolContext;\n  }\n\n  return {\n    pi,\n    tools,\n    commands,\n    shortcuts,\n    flags,\n    messageRenderers,\n    entryRenderers,\n    markdownTransformers,\n    providers,\n    unregisteredProviders,\n    messages,\n    userMessages,\n    entries,\n    execs,\n    notifications,\n    statuses,\n    widgets,\n    activeTools: () => [...activeToolNames],\n    tool: (name) => tools.findLast((candidate) => candidate.name === name),\n    command: (name) => commands.find((candidate) => candidate.name === name),\n    handlers: (event) => (lifecycle.get(event) ?? []).map(invokable),\n    context: buildContext,\n    async emit(event, payload, context) {\n      const eventContext = context ?? buildContext();\n      const answered: unknown[] = [];\n      // A snapshot, because a handler may register another for the same event\n      // and Pi does not deliver this emission to it.\n      const delivered = [...(lifecycle.get(event) ?? [])];\n      for (const handler of delivered) {\n        answered.push(await invokable(handler)({ type: event, ...(payload as object) }, eventContext));\n      }\n      if (event === 'session_shutdown') cordisConnection = undefined;\n      return answered;\n    },\n    async callTool(name, params = {}, callOptions = {}) {\n      const tool = tools.findLast((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`No tool named '${name}' is registered on this host.`);\n      return tool.execute(\n        callOptions.toolCallId ?? `call-${String(tools.indexOf(tool))}`,\n        params,\n        callOptions.signal,\n        callOptions.onUpdate,\n        callOptions.context ?? buildContext(),\n      );\n    },\n    async runCommand(name, args = '', context) {\n      const command = commands.find((candidate) => candidate.name === name);\n      if (!command) throw new Error(`No command named '${name}' is registered on this host.`);\n      await command.options.handler(args, (context ?? buildContext()) as never);\n    },\n    async cordis(source = DEFAULT_CORDIS_SOURCE) {\n      if (cordisConnection === undefined) {\n        const controller = await installPoCordisHost(pi, {\n          mode: 'standalone',\n          source: `${source}:standalone-host`,\n        });\n        try {\n          cordisConnection = await connectPoCordisHost(pi, source);\n        } catch (error) {\n          await controller.shutdown();\n          throw error;\n        }\n      }\n      return cordisConnection;\n    },\n    async dispose() {\n      await cordisConnection?.dispose();\n      cordisConnection = undefined;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/testing/pi/testHost.d.mts

@@ -1,4 +1,4 @@
-import { DoomCordisHostConnection } from "../../../runtimeCordisHost.mjs";
+import { PoCordisHostConnection } from "../../../runtimeCordisHost.mjs";
 import { ExtensionAPI, ExtensionContext, ExtensionToolContext } from "@earendil-works/pi-coding-agent";
 //#region src/testing/pi/testHost.d.ts
 /** One stored handler, widened at the single point that calls it. */
@@ -145,7 +145,7 @@ export interface PiTestHost {
   /** Runs a registered slash command the way Pi's palette does. */
   runCommand(name: string, args?: string, context?: ExtensionContext): Promise<void>;
   /** The real Cordis host on this runner, installed on first use and disposed by `dispose`. */
-  cordis(source?: string): Promise<DoomCordisHostConnection>;
+  cordis(source?: string): Promise<PoCordisHostConnection>;
   dispose(): Promise<void>;
 }
 /**
@@ -157,4 +157,5 @@ export interface PiTestHost {
  */
 export declare function createPiTestHost(options?: PiTestHostOptions): PiTestHost;
 //#endregion
+export {};
 //# sourceMappingURL=testHost.d.mts.map

package/dist/src/testing/pi/testHost.mjs

@@ -1,4 +1,4 @@
-import { connectDoomCordisHost, installDoomCordisHost } from "../../../runtimeCordisHost.mjs";
+import { connectPoCordisHost, installPoCordisHost } from "../../../runtimeCordisHost.mjs";
 //#region src/testing/pi/testHost.ts
 function invokable(handler) {
 	return handler;
@@ -374,12 +374,12 @@ function createPiTestHost(options = {}) {
 		},
 		async cordis(source = DEFAULT_CORDIS_SOURCE) {
 			if (cordisConnection === void 0) {
-				const controller = await installDoomCordisHost(pi, {
+				const controller = await installPoCordisHost(pi, {
 					mode: "standalone",
 					source: `${source}:standalone-host`
 				});
 				try {
-					cordisConnection = await connectDoomCordisHost(pi, source);
+					cordisConnection = await connectPoCordisHost(pi, source);
 				} catch (error) {
 					await controller.shutdown();
 					throw error;

package/dist/src/testing/pi/testHost.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testHost.mjs","names":[],"sources":["../../../../src/testing/pi/testHost.ts"],"sourcesContent":["import type {\n  ExtensionAPI,\n  ExtensionContext,\n  ExtensionToolContext,\n  ToolDefinition,\n  ToolInfo,\n} from '@earendil-works/pi-coding-agent';\nimport type { TSchema } from 'typebox';\n\nimport { connectDoomCordisHost, installDoomCordisHost, type DoomCordisHostConnection } from '../../pi/cordisHost';\n\n/**\n * A Pi host a test drives, in place of the one Pi builds at runtime.\n *\n * Every extension package needs one, and before this each wrote its own as an\n * `as unknown as ExtensionAPI` cast over the four or five members that package\n * happened to call. A cast type-checks whatever Pi's interface becomes, so the\n * casts all kept passing while diverging from each other and from Pi.\n *\n * `pi` here is a plain `ExtensionAPI`, assigned without a cast. When a Pi\n * upgrade adds or reshapes a member, this file stops compiling, which is the\n * whole point: one place to notice, instead of ninety places that never do.\n *\n * `ExtensionContext` cannot be held to the same standard and is built with one\n * cast, named at the site. Three of its members are unsatisfiable by an object\n * literal: `modelRegistry` is a class with a private field, so it is nominally\n * typed; `ui.theme` is typed from a module Pi does not export; and `model` is\n * a populated provider record no test asserts on. The context is otherwise\n * built member by member, and the surface extensions actually program against,\n * `ExtensionAPI`, carries no cast at all.\n */\n\n/**\n * Every handler Pi's 34 `on` overloads accept, stored as one.\n *\n * `never` in the parameter positions is what makes all 34 assignable: a handler\n * is only accepted where the stored type asks for less than the handler does.\n * The consequence is that a stored handler cannot be called without widening it\n * back, which `invokable` does once, below. No single type both accepts every\n * overload and is callable with an arbitrary payload.\n */\ntype LifecycleHandler = (event: never, context: never) => unknown;\n/** One stored handler, widened at the single point that calls it. */\ntype InvokableHandler = (event: unknown, context: unknown) => unknown;\n\nfunction invokable(handler: LifecycleHandler): InvokableHandler {\n  return handler as InvokableHandler;\n}\n\n/** Types Pi declares but does not re-export from its package root. */\ntype SessionManagerView = ExtensionContext['sessionManager'];\ntype RunMode = ExtensionContext['mode'];\ntype ShortcutId = Parameters<ExtensionAPI['registerShortcut']>[0];\ntype ShortcutOptions = Parameters<ExtensionAPI['registerShortcut']>[1];\ntype CommandOptions = Parameters<ExtensionAPI['registerCommand']>[1];\ntype FlagOptions = Parameters<ExtensionAPI['registerFlag']>[1];\ntype CustomMessagePayload = Parameters<ExtensionAPI['sendMessage']>[0];\ntype SendMessageOptions = Parameters<ExtensionAPI['sendMessage']>[1];\ntype UserMessageContent = Parameters<ExtensionAPI['sendUserMessage']>[0];\ntype SendUserMessageOptions = Parameters<ExtensionAPI['sendUserMessage']>[1];\ntype RegisteredTool = Parameters<ExtensionAPI['registerTool']>[0];\ntype ToolUpdateCallback = Parameters<RegisteredTool['execute']>[3];\ntype ExecutionResult = Awaited<ReturnType<ExtensionAPI['exec']>>;\ntype ExecutionOptions = Parameters<ExtensionAPI['exec']>[2];\ntype ThinkingLevelValue = ReturnType<ExtensionAPI['getThinkingLevel']>;\ntype WidgetContent = Parameters<ExtensionContext['ui']['setWidget']>[1];\n\n/** Inventory entry for a host-owned tool this harness cannot execute. */\nfunction builtinToolInfo(name: string): ToolInfo {\n  return {\n    name,\n    description: `Built-in ${name}`,\n    parameters: { type: 'object', properties: {}, additionalProperties: false },\n    sourceInfo: { type: 'builtin' },\n  } as unknown as ToolInfo;\n}\n\n/** Inventory view of a tool an extension registered with this host. */\nfunction registeredToolInfo(tool: RegisteredTool): ToolInfo {\n  return {\n    name: tool.name,\n    description: tool.description,\n    parameters: tool.parameters,\n    promptGuidelines: (tool as { promptGuidelines?: unknown }).promptGuidelines,\n    sourceInfo: { type: 'extension' },\n  } as unknown as ToolInfo;\n}\n\nexport interface RecordedCommand {\n  name: string;\n  options: CommandOptions;\n}\nexport interface RecordedShortcut {\n  shortcut: ShortcutId;\n  options: ShortcutOptions;\n}\nexport interface RecordedRenderer {\n  customType: string;\n  renderer: unknown;\n}\n/** A `registerProvider` call in either of its two shapes. */\nexport interface RecordedProvider {\n  /** Present for the `(name, config)` overload. */\n  name?: string;\n  value: unknown;\n}\nexport interface RecordedMessage {\n  message: CustomMessagePayload;\n  options: SendMessageOptions;\n}\nexport interface RecordedUserMessage {\n  content: UserMessageContent;\n  options: SendUserMessageOptions;\n}\nexport interface RecordedEntry {\n  customType: string;\n  data: unknown;\n}\nexport interface RecordedExec {\n  command: string;\n  args: string[];\n  options: ExecutionOptions;\n}\nexport interface RecordedNotification {\n  sessionId: string;\n  message: string;\n  level: 'info' | 'warning' | 'error' | undefined;\n}\nexport interface RecordedWidget {\n  sessionId: string;\n  key: string;\n  content: WidgetContent;\n}\nexport interface RecordedStatus {\n  sessionId: string;\n  key: string;\n  text: string | undefined;\n}\n\n/**\n * What the extension's dialogs answer.\n *\n * Every default is the dismissal, because that is the answer a headless host\n * gives and the one an extension is most likely to mishandle.\n */\nexport interface PiTestDialogAnswers {\n  select(title: string, options: string[]): string | undefined;\n  confirm(title: string, message: string): boolean;\n  input(title: string, placeholder: string | undefined): string | undefined;\n  editor(title: string, prefill: string | undefined): string | undefined;\n}\n\nexport interface PiTestContextOptions {\n  sessionId?: string;\n  cwd?: string;\n  hasUI?: boolean;\n  mode?: RunMode;\n  isIdle?: boolean;\n  isProjectTrusted?: boolean;\n  signal?: AbortSignal;\n  answers?: Partial<PiTestDialogAnswers>;\n  systemPrompt?: string;\n}\n\nexport interface PiTestHostOptions extends PiTestContextOptions {\n  /** Answers `pi.exec`; the default reports a command that ran and printed nothing. */\n  exec?: (command: string, args: string[]) => ExecutionResult | Promise<ExecutionResult>;\n  /**\n   * Tool names Pi would already own before any extension loads.\n   *\n   * They join the inventory and start active, which is how the tool surface\n   * arbiter learns that a name like `read` exists without a definition for it.\n   */\n  builtinTools?: readonly string[];\n}\n\nexport interface PiTestHost {\n  /** The host an extension factory receives. */\n  readonly pi: ExtensionAPI;\n  readonly tools: readonly RegisteredTool[];\n  readonly commands: readonly RecordedCommand[];\n  readonly shortcuts: readonly RecordedShortcut[];\n  readonly flags: ReadonlyMap<string, FlagOptions>;\n  readonly messageRenderers: readonly RecordedRenderer[];\n  readonly entryRenderers: readonly RecordedRenderer[];\n  readonly markdownTransformers: readonly unknown[];\n  readonly providers: readonly RecordedProvider[];\n  readonly unregisteredProviders: readonly string[];\n  readonly messages: readonly RecordedMessage[];\n  readonly userMessages: readonly RecordedUserMessage[];\n  readonly entries: readonly RecordedEntry[];\n  readonly execs: readonly RecordedExec[];\n  readonly notifications: readonly RecordedNotification[];\n  readonly statuses: readonly RecordedStatus[];\n  readonly widgets: readonly RecordedWidget[];\n  /** Tool names Pi would offer the model right now. */\n  activeTools(): readonly string[];\n  tool(name: string): RegisteredTool | undefined;\n  command(name: string): RecordedCommand | undefined;\n  /** Lifecycle handlers registered for one event, in registration order. */\n  handlers(event: string): readonly InvokableHandler[];\n  /** A context for this host; each call builds a fresh one, as Pi does per event. */\n  context(options?: PiTestContextOptions): ExtensionToolContext;\n  /**\n   * Runs every handler for one lifecycle event and returns what they answered.\n   *\n   * Sequential and awaited, matching Pi, so a test can observe one handler's\n   * effect on the next.\n   */\n  emit(event: string, payload?: unknown, context?: ExtensionContext): Promise<unknown[]>;\n  /** Calls a registered tool the way Pi's runner does. */\n  callTool(\n    name: string,\n    params?: unknown,\n    options?: {\n      toolCallId?: string;\n      signal?: AbortSignal;\n      onUpdate?: ToolUpdateCallback;\n      context?: ExtensionToolContext;\n    },\n  ): Promise<unknown>;\n  /** Runs a registered slash command the way Pi's palette does. */\n  runCommand(name: string, args?: string, context?: ExtensionContext): Promise<void>;\n  /** The real Cordis host on this runner, installed on first use and disposed by `dispose`. */\n  cordis(source?: string): Promise<DoomCordisHostConnection>;\n  dispose(): Promise<void>;\n}\n\nconst DEFAULT_CWD = '/repo';\nconst DEFAULT_SESSION_ID = 'test-session';\nconst DEFAULT_MODE: RunMode = 'tui';\nconst DEFAULT_SYSTEM_PROMPT = '';\nconst DEFAULT_CORDIS_SOURCE = 'pi-test-host';\nconst DEFAULT_EXEC: ExecutionResult = { code: 0, killed: false, stdout: '', stderr: '' };\n\nconst DISMISSED: PiTestDialogAnswers = {\n  select: () => undefined,\n  confirm: () => false,\n  input: () => undefined,\n  editor: () => undefined,\n};\n\n/**\n * A Pi host and the records of what an extension did to it.\n *\n * Nothing here is a spy from a test framework: the records are plain arrays, so\n * the harness works under any runner and adds no dependency to a package that\n * every extension already installs.\n */\nexport function createPiTestHost(options: PiTestHostOptions = {}): PiTestHost {\n  const builtinTools: readonly string[] = options.builtinTools ?? [];\n  const tools: RegisteredTool[] = [];\n  const commands: RecordedCommand[] = [];\n  const shortcuts: RecordedShortcut[] = [];\n  const flags = new Map<string, FlagOptions>();\n  const messageRenderers: RecordedRenderer[] = [];\n  const entryRenderers: RecordedRenderer[] = [];\n  const markdownTransformers: unknown[] = [];\n  const providers: RecordedProvider[] = [];\n  const unregisteredProviders: string[] = [];\n  const messages: RecordedMessage[] = [];\n  const userMessages: RecordedUserMessage[] = [];\n  const entries: RecordedEntry[] = [];\n  const execs: RecordedExec[] = [];\n  const notifications: RecordedNotification[] = [];\n  const statuses: RecordedStatus[] = [];\n  const widgets: RecordedWidget[] = [];\n\n  const lifecycle = new Map<string, LifecycleHandler[]>();\n  const channels = new Map<string, Set<(data: unknown) => void>>();\n  let activeToolNames: string[] = [...builtinTools];\n  let sessionName: string | undefined;\n  let thinkingLevel: ThinkingLevelValue = 'off';\n  let cordisConnection: DoomCordisHostConnection | undefined;\n\n  const runExec = options.exec ?? ((): ExecutionResult => DEFAULT_EXEC);\n\n  const pi: ExtensionAPI = {\n    on(event: string, handler: LifecycleHandler): () => void {\n      const registered = lifecycle.get(event) ?? [];\n      registered.push(handler);\n      lifecycle.set(event, registered);\n      return () => {\n        const index = registered.indexOf(handler);\n        if (index === -1) return;\n        registered.splice(index, 1);\n        if (registered.length === 0) lifecycle.delete(event);\n      };\n    },\n    // Generic exactly as Pi declares it. Storage erases the schema generics; the\n    // signature is the half that has to keep matching.\n    registerTool<TParams extends TSchema = TSchema, TDetails = unknown, TState = unknown>(\n      tool: ToolDefinition<TParams, TDetails, TState>,\n    ): void {\n      tools.push(tool as unknown as RegisteredTool);\n      if (!activeToolNames.includes(tool.name)) activeToolNames.push(tool.name);\n    },\n    registerToolRenderer(): void {},\n    registerCommand(name: string, commandOptions: CommandOptions): void {\n      commands.push({ name, options: commandOptions });\n    },\n    registerShortcut(shortcut: ShortcutId, shortcutOptions: ShortcutOptions): void {\n      shortcuts.push({ shortcut, options: shortcutOptions });\n    },\n    registerFlag(name: string, flagOptions: FlagOptions): void {\n      flags.set(name, flagOptions);\n    },\n    getFlag(name: string): boolean | string | undefined {\n      return flags.get(name)?.default;\n    },\n    registerMessageRenderer(customType: string, renderer: unknown): void {\n      messageRenderers.push({ customType, renderer });\n    },\n    registerMarkdownTransformer(transformer: unknown): void {\n      markdownTransformers.push(transformer);\n    },\n    registerEntryRenderer(customType: string, renderer: unknown): void {\n      entryRenderers.push({ customType, renderer });\n    },\n    sendMessage(message: CustomMessagePayload, sendOptions?: SendMessageOptions): void {\n      messages.push({ message, options: sendOptions });\n    },\n    sendUserMessage(content: UserMessageContent, sendOptions?: SendUserMessageOptions): void {\n      userMessages.push({ content, options: sendOptions });\n    },\n    appendEntry(customType: string, data?: unknown): void {\n      entries.push({ customType, data });\n    },\n    setSessionName(name: string): void {\n      sessionName = name;\n    },\n    getSessionName(): string | undefined {\n      return sessionName;\n    },\n    setLabel(): void {\n      // Labels are session bookmarks; no Po extension reads them back.\n    },\n    async exec(command: string, args: string[], execOptions?: ExecutionOptions): Promise<ExecutionResult> {\n      execs.push({ command, args, options: execOptions });\n      return runExec(command, args);\n    },\n    getActiveTools(): string[] {\n      return [...activeToolNames];\n    },\n    getAllTools(): ToolInfo[] {\n      // Pi's inventory folds in built-in and MCP tools, which this host models\n      // as names only: a test asserts on the surface, never on their behaviour.\n      return [...builtinTools.map(builtinToolInfo), ...tools.map(registeredToolInfo)];\n    },\n    setActiveTools(toolNames: string[]): void {\n      activeToolNames = [...toolNames];\n    },\n    getSettings() {\n      return {};\n    },\n    // No Po extension registers MCP servers or virtual models through Pi yet.\n    registerMcpServer(): void {},\n    unregisterMcpServer(): void {},\n    getMcpServers() {\n      return [];\n    },\n    registerVirtualModel(): void {},\n    unregisterVirtualModel(): void {},\n    getCommands(): never[] {\n      return [];\n    },\n    async setModel(): Promise<boolean> {\n      // No API key is configured, which is the answer Pi gives for the same reason.\n      return false;\n    },\n    getThinkingLevel(): ThinkingLevelValue {\n      return thinkingLevel;\n    },\n    setThinkingLevel(level: ThinkingLevelValue): void {\n      thinkingLevel = level;\n    },\n    registerProvider(providerOrName: unknown, config?: unknown): void {\n      providers.push(\n        typeof providerOrName === 'string' ? { name: providerOrName, value: config } : { value: providerOrName },\n      );\n    },\n    unregisterProvider(name: string): void {\n      unregisteredProviders.push(name);\n    },\n    events: {\n      emit(channel: string, data: unknown): void {\n        // A snapshot: a listener that unsubscribes on delivery would otherwise\n        // reshape the set this loop is walking.\n        const delivered = [...(channels.get(channel) ?? [])];\n        for (const listener of delivered) listener(data);\n      },\n      on(channel: string, listener: (data: unknown) => void): () => void {\n        const listeners = channels.get(channel) ?? new Set<(data: unknown) => void>();\n        listeners.add(listener);\n        channels.set(channel, listeners);\n        return () => listeners.delete(listener);\n      },\n    },\n  };\n\n  function buildContext(contextOptions: PiTestContextOptions = {}): ExtensionToolContext {\n    const sessionId = contextOptions.sessionId ?? options.sessionId ?? DEFAULT_SESSION_ID;\n    const cwd = contextOptions.cwd ?? options.cwd ?? DEFAULT_CWD;\n    const answers = { ...DISMISSED, ...options.answers, ...contextOptions.answers };\n    const sessionManager = {\n      getCwd: () => cwd,\n      getSessionId: () => sessionId,\n      getSessionName: () => sessionName,\n      getSessionDir: () => cwd,\n      getSessionFile: () => `${cwd}/${sessionId}.jsonl`,\n      getLeafId: () => undefined,\n      getLeafEntry: () => undefined,\n      getEntry: () => undefined,\n      getLabel: () => undefined,\n      getBranch: () => [],\n      buildContextEntries: () => [],\n      getHeader: () => undefined,\n      getEntries: () => [],\n      getTree: () => [],\n    };\n    const ui = {\n      select: async (title: string, selectOptions: string[]) => answers.select(title, selectOptions),\n      confirm: async (title: string, message: string) => answers.confirm(title, message),\n      input: async (title: string, placeholder?: string) => answers.input(title, placeholder),\n      editor: async (title: string, prefill?: string) => answers.editor(title, prefill),\n      notify: (message: string, level?: 'info' | 'warning' | 'error') => {\n        notifications.push({ sessionId, message, level });\n      },\n      onTerminalInput: () => () => undefined,\n      setStatus: (key: string, text: string | undefined) => {\n        statuses.push({ sessionId, key, text });\n      },\n      setWorkingMessage: () => undefined,\n      setWorkingVisible: () => undefined,\n      setWorkingIndicator: () => undefined,\n      setHiddenThinkingLabel: () => undefined,\n      setWidget: (key: string, content: WidgetContent) => {\n        widgets.push({ sessionId, key, content });\n      },\n      setFooter: () => undefined,\n      setHeader: () => undefined,\n      setTitle: () => undefined,\n      // A custom component needs a real TUI to resolve, so it never does. An\n      // extension awaiting one must stay responsive, which is what this proves.\n      custom: () => new Promise<never>(() => undefined),\n      pasteToEditor: () => undefined,\n      setEditorText: () => undefined,\n      getEditorText: () => '',\n      addAutocompleteProvider: () => undefined,\n      setEditorComponent: () => undefined,\n      getEditorComponent: () => undefined,\n      theme: undefined,\n      getAllThemes: () => [],\n      getTheme: () => undefined,\n      setTheme: () => ({ success: false, error: 'This host renders nothing.' }),\n      getToolsExpanded: () => false,\n      setToolsExpanded: () => undefined,\n    };\n    const context = {\n      ui,\n      mode: contextOptions.mode ?? options.mode ?? DEFAULT_MODE,\n      hasUI: contextOptions.hasUI ?? options.hasUI ?? true,\n      cwd,\n      sessionManager: sessionManager as unknown as SessionManagerView,\n      modelRegistry: undefined,\n      model: undefined,\n      scopedModels: [],\n      isIdle: () => contextOptions.isIdle ?? options.isIdle ?? true,\n      isProjectTrusted: () => contextOptions.isProjectTrusted ?? options.isProjectTrusted ?? true,\n      signal: contextOptions.signal ?? options.signal,\n      abort: () => undefined,\n      hasPendingMessages: () => false,\n      shutdown: () => undefined,\n      getContextUsage: () => undefined,\n      compact: () => undefined,\n      getSystemPrompt: () => contextOptions.systemPrompt ?? options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,\n      // Command handlers receive the wider context, and an extension that only\n      // reads it should not have to be handed a second fixture to be exercised.\n      getSystemPromptOptions: () => ({}),\n      waitForIdle: async () => undefined,\n      newSession: async () => ({ cancelled: true }),\n      fork: async () => ({ cancelled: true }),\n      navigateTree: async () => ({ cancelled: true }),\n      switchSession: async () => ({ cancelled: true }),\n      reload: async () => undefined,\n      // Tool execute() receives the tool context. Nested calls answer as Pi does when unbound.\n      tools: [],\n      executeTool: async (name: string) => ({\n        toolCall: { type: 'toolCall', id: 'nested/0', name, arguments: {} },\n        result: {\n          content: [{ type: 'text', text: 'Nested tool calls are not available in this context' }],\n          details: {},\n        },\n        isError: true,\n      }),\n    };\n    // The one cast. `modelRegistry` is a class with a private field and so is\n    // nominally typed, `ui.theme` is typed from a module Pi does not export,\n    // and `model` is a populated provider record. No object literal can satisfy\n    // those three, and no Po extension reads them.\n    return context as unknown as ExtensionToolContext;\n  }\n\n  return {\n    pi,\n    tools,\n    commands,\n    shortcuts,\n    flags,\n    messageRenderers,\n    entryRenderers,\n    markdownTransformers,\n    providers,\n    unregisteredProviders,\n    messages,\n    userMessages,\n    entries,\n    execs,\n    notifications,\n    statuses,\n    widgets,\n    activeTools: () => [...activeToolNames],\n    tool: (name) => tools.findLast((candidate) => candidate.name === name),\n    command: (name) => commands.find((candidate) => candidate.name === name),\n    handlers: (event) => (lifecycle.get(event) ?? []).map(invokable),\n    context: buildContext,\n    async emit(event, payload, context) {\n      const eventContext = context ?? buildContext();\n      const answered: unknown[] = [];\n      // A snapshot, because a handler may register another for the same event\n      // and Pi does not deliver this emission to it.\n      const delivered = [...(lifecycle.get(event) ?? [])];\n      for (const handler of delivered) {\n        answered.push(await invokable(handler)({ type: event, ...(payload as object) }, eventContext));\n      }\n      if (event === 'session_shutdown') cordisConnection = undefined;\n      return answered;\n    },\n    async callTool(name, params = {}, callOptions = {}) {\n      const tool = tools.findLast((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`No tool named '${name}' is registered on this host.`);\n      return tool.execute(\n        callOptions.toolCallId ?? `call-${String(tools.indexOf(tool))}`,\n        params,\n        callOptions.signal,\n        callOptions.onUpdate,\n        callOptions.context ?? buildContext(),\n      );\n    },\n    async runCommand(name, args = '', context) {\n      const command = commands.find((candidate) => candidate.name === name);\n      if (!command) throw new Error(`No command named '${name}' is registered on this host.`);\n      await command.options.handler(args, (context ?? buildContext()) as never);\n    },\n    async cordis(source = DEFAULT_CORDIS_SOURCE) {\n      if (cordisConnection === undefined) {\n        const controller = await installDoomCordisHost(pi, {\n          mode: 'standalone',\n          source: `${source}:standalone-host`,\n        });\n        try {\n          cordisConnection = await connectDoomCordisHost(pi, source);\n        } catch (error) {\n          await controller.shutdown();\n          throw error;\n        }\n      }\n      return cordisConnection;\n    },\n    async dispose() {\n      await cordisConnection?.dispose();\n      cordisConnection = undefined;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"testHost.mjs","names":[],"sources":["../../../../src/testing/pi/testHost.ts"],"sourcesContent":["import type {\n  ExtensionAPI,\n  ExtensionContext,\n  ExtensionToolContext,\n  ToolDefinition,\n  ToolInfo,\n} from '@earendil-works/pi-coding-agent';\nimport type { TSchema } from 'typebox';\n\nimport { connectPoCordisHost, installPoCordisHost, type PoCordisHostConnection } from '../../pi/cordisHost';\n\n/**\n * A Pi host a test drives, in place of the one Pi builds at runtime.\n *\n * Every extension package needs one, and before this each wrote its own as an\n * `as unknown as ExtensionAPI` cast over the four or five members that package\n * happened to call. A cast type-checks whatever Pi's interface becomes, so the\n * casts all kept passing while diverging from each other and from Pi.\n *\n * `pi` here is a plain `ExtensionAPI`, assigned without a cast. When a Pi\n * upgrade adds or reshapes a member, this file stops compiling, which is the\n * whole point: one place to notice, instead of ninety places that never do.\n *\n * `ExtensionContext` cannot be held to the same standard and is built with one\n * cast, named at the site. Three of its members are unsatisfiable by an object\n * literal: `modelRegistry` is a class with a private field, so it is nominally\n * typed; `ui.theme` is typed from a module Pi does not export; and `model` is\n * a populated provider record no test asserts on. The context is otherwise\n * built member by member, and the surface extensions actually program against,\n * `ExtensionAPI`, carries no cast at all.\n */\n\n/**\n * Every handler Pi's 34 `on` overloads accept, stored as one.\n *\n * `never` in the parameter positions is what makes all 34 assignable: a handler\n * is only accepted where the stored type asks for less than the handler does.\n * The consequence is that a stored handler cannot be called without widening it\n * back, which `invokable` does once, below. No single type both accepts every\n * overload and is callable with an arbitrary payload.\n */\ntype LifecycleHandler = (event: never, context: never) => unknown;\n/** One stored handler, widened at the single point that calls it. */\ntype InvokableHandler = (event: unknown, context: unknown) => unknown;\n\nfunction invokable(handler: LifecycleHandler): InvokableHandler {\n  return handler as InvokableHandler;\n}\n\n/** Types Pi declares but does not re-export from its package root. */\ntype SessionManagerView = ExtensionContext['sessionManager'];\ntype RunMode = ExtensionContext['mode'];\ntype ShortcutId = Parameters<ExtensionAPI['registerShortcut']>[0];\ntype ShortcutOptions = Parameters<ExtensionAPI['registerShortcut']>[1];\ntype CommandOptions = Parameters<ExtensionAPI['registerCommand']>[1];\ntype FlagOptions = Parameters<ExtensionAPI['registerFlag']>[1];\ntype CustomMessagePayload = Parameters<ExtensionAPI['sendMessage']>[0];\ntype SendMessageOptions = Parameters<ExtensionAPI['sendMessage']>[1];\ntype UserMessageContent = Parameters<ExtensionAPI['sendUserMessage']>[0];\ntype SendUserMessageOptions = Parameters<ExtensionAPI['sendUserMessage']>[1];\ntype RegisteredTool = Parameters<ExtensionAPI['registerTool']>[0];\ntype ToolUpdateCallback = Parameters<RegisteredTool['execute']>[3];\ntype ExecutionResult = Awaited<ReturnType<ExtensionAPI['exec']>>;\ntype ExecutionOptions = Parameters<ExtensionAPI['exec']>[2];\ntype ThinkingLevelValue = ReturnType<ExtensionAPI['getThinkingLevel']>;\ntype WidgetContent = Parameters<ExtensionContext['ui']['setWidget']>[1];\n\n/** Inventory entry for a host-owned tool this harness cannot execute. */\nfunction builtinToolInfo(name: string): ToolInfo {\n  return {\n    name,\n    description: `Built-in ${name}`,\n    parameters: { type: 'object', properties: {}, additionalProperties: false },\n    sourceInfo: { type: 'builtin' },\n  } as unknown as ToolInfo;\n}\n\n/** Inventory view of a tool an extension registered with this host. */\nfunction registeredToolInfo(tool: RegisteredTool): ToolInfo {\n  return {\n    name: tool.name,\n    description: tool.description,\n    parameters: tool.parameters,\n    promptGuidelines: (tool as { promptGuidelines?: unknown }).promptGuidelines,\n    sourceInfo: { type: 'extension' },\n  } as unknown as ToolInfo;\n}\n\nexport interface RecordedCommand {\n  name: string;\n  options: CommandOptions;\n}\nexport interface RecordedShortcut {\n  shortcut: ShortcutId;\n  options: ShortcutOptions;\n}\nexport interface RecordedRenderer {\n  customType: string;\n  renderer: unknown;\n}\n/** A `registerProvider` call in either of its two shapes. */\nexport interface RecordedProvider {\n  /** Present for the `(name, config)` overload. */\n  name?: string;\n  value: unknown;\n}\nexport interface RecordedMessage {\n  message: CustomMessagePayload;\n  options: SendMessageOptions;\n}\nexport interface RecordedUserMessage {\n  content: UserMessageContent;\n  options: SendUserMessageOptions;\n}\nexport interface RecordedEntry {\n  customType: string;\n  data: unknown;\n}\nexport interface RecordedExec {\n  command: string;\n  args: string[];\n  options: ExecutionOptions;\n}\nexport interface RecordedNotification {\n  sessionId: string;\n  message: string;\n  level: 'info' | 'warning' | 'error' | undefined;\n}\nexport interface RecordedWidget {\n  sessionId: string;\n  key: string;\n  content: WidgetContent;\n}\nexport interface RecordedStatus {\n  sessionId: string;\n  key: string;\n  text: string | undefined;\n}\n\n/**\n * What the extension's dialogs answer.\n *\n * Every default is the dismissal, because that is the answer a headless host\n * gives and the one an extension is most likely to mishandle.\n */\nexport interface PiTestDialogAnswers {\n  select(title: string, options: string[]): string | undefined;\n  confirm(title: string, message: string): boolean;\n  input(title: string, placeholder: string | undefined): string | undefined;\n  editor(title: string, prefill: string | undefined): string | undefined;\n}\n\nexport interface PiTestContextOptions {\n  sessionId?: string;\n  cwd?: string;\n  hasUI?: boolean;\n  mode?: RunMode;\n  isIdle?: boolean;\n  isProjectTrusted?: boolean;\n  signal?: AbortSignal;\n  answers?: Partial<PiTestDialogAnswers>;\n  systemPrompt?: string;\n}\n\nexport interface PiTestHostOptions extends PiTestContextOptions {\n  /** Answers `pi.exec`; the default reports a command that ran and printed nothing. */\n  exec?: (command: string, args: string[]) => ExecutionResult | Promise<ExecutionResult>;\n  /**\n   * Tool names Pi would already own before any extension loads.\n   *\n   * They join the inventory and start active, which is how the tool surface\n   * arbiter learns that a name like `read` exists without a definition for it.\n   */\n  builtinTools?: readonly string[];\n}\n\nexport interface PiTestHost {\n  /** The host an extension factory receives. */\n  readonly pi: ExtensionAPI;\n  readonly tools: readonly RegisteredTool[];\n  readonly commands: readonly RecordedCommand[];\n  readonly shortcuts: readonly RecordedShortcut[];\n  readonly flags: ReadonlyMap<string, FlagOptions>;\n  readonly messageRenderers: readonly RecordedRenderer[];\n  readonly entryRenderers: readonly RecordedRenderer[];\n  readonly markdownTransformers: readonly unknown[];\n  readonly providers: readonly RecordedProvider[];\n  readonly unregisteredProviders: readonly string[];\n  readonly messages: readonly RecordedMessage[];\n  readonly userMessages: readonly RecordedUserMessage[];\n  readonly entries: readonly RecordedEntry[];\n  readonly execs: readonly RecordedExec[];\n  readonly notifications: readonly RecordedNotification[];\n  readonly statuses: readonly RecordedStatus[];\n  readonly widgets: readonly RecordedWidget[];\n  /** Tool names Pi would offer the model right now. */\n  activeTools(): readonly string[];\n  tool(name: string): RegisteredTool | undefined;\n  command(name: string): RecordedCommand | undefined;\n  /** Lifecycle handlers registered for one event, in registration order. */\n  handlers(event: string): readonly InvokableHandler[];\n  /** A context for this host; each call builds a fresh one, as Pi does per event. */\n  context(options?: PiTestContextOptions): ExtensionToolContext;\n  /**\n   * Runs every handler for one lifecycle event and returns what they answered.\n   *\n   * Sequential and awaited, matching Pi, so a test can observe one handler's\n   * effect on the next.\n   */\n  emit(event: string, payload?: unknown, context?: ExtensionContext): Promise<unknown[]>;\n  /** Calls a registered tool the way Pi's runner does. */\n  callTool(\n    name: string,\n    params?: unknown,\n    options?: {\n      toolCallId?: string;\n      signal?: AbortSignal;\n      onUpdate?: ToolUpdateCallback;\n      context?: ExtensionToolContext;\n    },\n  ): Promise<unknown>;\n  /** Runs a registered slash command the way Pi's palette does. */\n  runCommand(name: string, args?: string, context?: ExtensionContext): Promise<void>;\n  /** The real Cordis host on this runner, installed on first use and disposed by `dispose`. */\n  cordis(source?: string): Promise<PoCordisHostConnection>;\n  dispose(): Promise<void>;\n}\n\nconst DEFAULT_CWD = '/repo';\nconst DEFAULT_SESSION_ID = 'test-session';\nconst DEFAULT_MODE: RunMode = 'tui';\nconst DEFAULT_SYSTEM_PROMPT = '';\nconst DEFAULT_CORDIS_SOURCE = 'pi-test-host';\nconst DEFAULT_EXEC: ExecutionResult = { code: 0, killed: false, stdout: '', stderr: '' };\n\nconst DISMISSED: PiTestDialogAnswers = {\n  select: () => undefined,\n  confirm: () => false,\n  input: () => undefined,\n  editor: () => undefined,\n};\n\n/**\n * A Pi host and the records of what an extension did to it.\n *\n * Nothing here is a spy from a test framework: the records are plain arrays, so\n * the harness works under any runner and adds no dependency to a package that\n * every extension already installs.\n */\nexport function createPiTestHost(options: PiTestHostOptions = {}): PiTestHost {\n  const builtinTools: readonly string[] = options.builtinTools ?? [];\n  const tools: RegisteredTool[] = [];\n  const commands: RecordedCommand[] = [];\n  const shortcuts: RecordedShortcut[] = [];\n  const flags = new Map<string, FlagOptions>();\n  const messageRenderers: RecordedRenderer[] = [];\n  const entryRenderers: RecordedRenderer[] = [];\n  const markdownTransformers: unknown[] = [];\n  const providers: RecordedProvider[] = [];\n  const unregisteredProviders: string[] = [];\n  const messages: RecordedMessage[] = [];\n  const userMessages: RecordedUserMessage[] = [];\n  const entries: RecordedEntry[] = [];\n  const execs: RecordedExec[] = [];\n  const notifications: RecordedNotification[] = [];\n  const statuses: RecordedStatus[] = [];\n  const widgets: RecordedWidget[] = [];\n\n  const lifecycle = new Map<string, LifecycleHandler[]>();\n  const channels = new Map<string, Set<(data: unknown) => void>>();\n  let activeToolNames: string[] = [...builtinTools];\n  let sessionName: string | undefined;\n  let thinkingLevel: ThinkingLevelValue = 'off';\n  let cordisConnection: PoCordisHostConnection | undefined;\n\n  const runExec = options.exec ?? ((): ExecutionResult => DEFAULT_EXEC);\n\n  const pi: ExtensionAPI = {\n    on(event: string, handler: LifecycleHandler): () => void {\n      const registered = lifecycle.get(event) ?? [];\n      registered.push(handler);\n      lifecycle.set(event, registered);\n      return () => {\n        const index = registered.indexOf(handler);\n        if (index === -1) return;\n        registered.splice(index, 1);\n        if (registered.length === 0) lifecycle.delete(event);\n      };\n    },\n    // Generic exactly as Pi declares it. Storage erases the schema generics; the\n    // signature is the half that has to keep matching.\n    registerTool<TParams extends TSchema = TSchema, TDetails = unknown, TState = unknown>(\n      tool: ToolDefinition<TParams, TDetails, TState>,\n    ): void {\n      tools.push(tool as unknown as RegisteredTool);\n      if (!activeToolNames.includes(tool.name)) activeToolNames.push(tool.name);\n    },\n    registerToolRenderer(): void {},\n    registerCommand(name: string, commandOptions: CommandOptions): void {\n      commands.push({ name, options: commandOptions });\n    },\n    registerShortcut(shortcut: ShortcutId, shortcutOptions: ShortcutOptions): void {\n      shortcuts.push({ shortcut, options: shortcutOptions });\n    },\n    registerFlag(name: string, flagOptions: FlagOptions): void {\n      flags.set(name, flagOptions);\n    },\n    getFlag(name: string): boolean | string | undefined {\n      return flags.get(name)?.default;\n    },\n    registerMessageRenderer(customType: string, renderer: unknown): void {\n      messageRenderers.push({ customType, renderer });\n    },\n    registerMarkdownTransformer(transformer: unknown): void {\n      markdownTransformers.push(transformer);\n    },\n    registerEntryRenderer(customType: string, renderer: unknown): void {\n      entryRenderers.push({ customType, renderer });\n    },\n    sendMessage(message: CustomMessagePayload, sendOptions?: SendMessageOptions): void {\n      messages.push({ message, options: sendOptions });\n    },\n    sendUserMessage(content: UserMessageContent, sendOptions?: SendUserMessageOptions): void {\n      userMessages.push({ content, options: sendOptions });\n    },\n    appendEntry(customType: string, data?: unknown): void {\n      entries.push({ customType, data });\n    },\n    setSessionName(name: string): void {\n      sessionName = name;\n    },\n    getSessionName(): string | undefined {\n      return sessionName;\n    },\n    setLabel(): void {\n      // Labels are session bookmarks; no Po extension reads them back.\n    },\n    async exec(command: string, args: string[], execOptions?: ExecutionOptions): Promise<ExecutionResult> {\n      execs.push({ command, args, options: execOptions });\n      return runExec(command, args);\n    },\n    getActiveTools(): string[] {\n      return [...activeToolNames];\n    },\n    getAllTools(): ToolInfo[] {\n      // Pi's inventory folds in built-in and MCP tools, which this host models\n      // as names only: a test asserts on the surface, never on their behaviour.\n      return [...builtinTools.map(builtinToolInfo), ...tools.map(registeredToolInfo)];\n    },\n    setActiveTools(toolNames: string[]): void {\n      activeToolNames = [...toolNames];\n    },\n    getSettings() {\n      return {};\n    },\n    // No Po extension registers MCP servers or virtual models through Pi yet.\n    registerMcpServer(): void {},\n    unregisterMcpServer(): void {},\n    getMcpServers() {\n      return [];\n    },\n    registerVirtualModel(): void {},\n    unregisterVirtualModel(): void {},\n    getCommands(): never[] {\n      return [];\n    },\n    async setModel(): Promise<boolean> {\n      // No API key is configured, which is the answer Pi gives for the same reason.\n      return false;\n    },\n    getThinkingLevel(): ThinkingLevelValue {\n      return thinkingLevel;\n    },\n    setThinkingLevel(level: ThinkingLevelValue): void {\n      thinkingLevel = level;\n    },\n    registerProvider(providerOrName: unknown, config?: unknown): void {\n      providers.push(\n        typeof providerOrName === 'string' ? { name: providerOrName, value: config } : { value: providerOrName },\n      );\n    },\n    unregisterProvider(name: string): void {\n      unregisteredProviders.push(name);\n    },\n    events: {\n      emit(channel: string, data: unknown): void {\n        // A snapshot: a listener that unsubscribes on delivery would otherwise\n        // reshape the set this loop is walking.\n        const delivered = [...(channels.get(channel) ?? [])];\n        for (const listener of delivered) listener(data);\n      },\n      on(channel: string, listener: (data: unknown) => void): () => void {\n        const listeners = channels.get(channel) ?? new Set<(data: unknown) => void>();\n        listeners.add(listener);\n        channels.set(channel, listeners);\n        return () => listeners.delete(listener);\n      },\n    },\n  };\n\n  function buildContext(contextOptions: PiTestContextOptions = {}): ExtensionToolContext {\n    const sessionId = contextOptions.sessionId ?? options.sessionId ?? DEFAULT_SESSION_ID;\n    const cwd = contextOptions.cwd ?? options.cwd ?? DEFAULT_CWD;\n    const answers = { ...DISMISSED, ...options.answers, ...contextOptions.answers };\n    const sessionManager = {\n      getCwd: () => cwd,\n      getSessionId: () => sessionId,\n      getSessionName: () => sessionName,\n      getSessionDir: () => cwd,\n      getSessionFile: () => `${cwd}/${sessionId}.jsonl`,\n      getLeafId: () => undefined,\n      getLeafEntry: () => undefined,\n      getEntry: () => undefined,\n      getLabel: () => undefined,\n      getBranch: () => [],\n      buildContextEntries: () => [],\n      getHeader: () => undefined,\n      getEntries: () => [],\n      getTree: () => [],\n    };\n    const ui = {\n      select: async (title: string, selectOptions: string[]) => answers.select(title, selectOptions),\n      confirm: async (title: string, message: string) => answers.confirm(title, message),\n      input: async (title: string, placeholder?: string) => answers.input(title, placeholder),\n      editor: async (title: string, prefill?: string) => answers.editor(title, prefill),\n      notify: (message: string, level?: 'info' | 'warning' | 'error') => {\n        notifications.push({ sessionId, message, level });\n      },\n      onTerminalInput: () => () => undefined,\n      setStatus: (key: string, text: string | undefined) => {\n        statuses.push({ sessionId, key, text });\n      },\n      setWorkingMessage: () => undefined,\n      setWorkingVisible: () => undefined,\n      setWorkingIndicator: () => undefined,\n      setHiddenThinkingLabel: () => undefined,\n      setWidget: (key: string, content: WidgetContent) => {\n        widgets.push({ sessionId, key, content });\n      },\n      setFooter: () => undefined,\n      setHeader: () => undefined,\n      setTitle: () => undefined,\n      // A custom component needs a real TUI to resolve, so it never does. An\n      // extension awaiting one must stay responsive, which is what this proves.\n      custom: () => new Promise<never>(() => undefined),\n      pasteToEditor: () => undefined,\n      setEditorText: () => undefined,\n      getEditorText: () => '',\n      addAutocompleteProvider: () => undefined,\n      setEditorComponent: () => undefined,\n      getEditorComponent: () => undefined,\n      theme: undefined,\n      getAllThemes: () => [],\n      getTheme: () => undefined,\n      setTheme: () => ({ success: false, error: 'This host renders nothing.' }),\n      getToolsExpanded: () => false,\n      setToolsExpanded: () => undefined,\n    };\n    const context = {\n      ui,\n      mode: contextOptions.mode ?? options.mode ?? DEFAULT_MODE,\n      hasUI: contextOptions.hasUI ?? options.hasUI ?? true,\n      cwd,\n      sessionManager: sessionManager as unknown as SessionManagerView,\n      modelRegistry: undefined,\n      model: undefined,\n      scopedModels: [],\n      isIdle: () => contextOptions.isIdle ?? options.isIdle ?? true,\n      isProjectTrusted: () => contextOptions.isProjectTrusted ?? options.isProjectTrusted ?? true,\n      signal: contextOptions.signal ?? options.signal,\n      abort: () => undefined,\n      hasPendingMessages: () => false,\n      shutdown: () => undefined,\n      getContextUsage: () => undefined,\n      compact: () => undefined,\n      getSystemPrompt: () => contextOptions.systemPrompt ?? options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,\n      // Command handlers receive the wider context, and an extension that only\n      // reads it should not have to be handed a second fixture to be exercised.\n      getSystemPromptOptions: () => ({}),\n      waitForIdle: async () => undefined,\n      newSession: async () => ({ cancelled: true }),\n      fork: async () => ({ cancelled: true }),\n      navigateTree: async () => ({ cancelled: true }),\n      switchSession: async () => ({ cancelled: true }),\n      reload: async () => undefined,\n      // Tool execute() receives the tool context. Nested calls answer as Pi does when unbound.\n      tools: [],\n      executeTool: async (name: string) => ({\n        toolCall: { type: 'toolCall', id: 'nested/0', name, arguments: {} },\n        result: {\n          content: [{ type: 'text', text: 'Nested tool calls are not available in this context' }],\n          details: {},\n        },\n        isError: true,\n      }),\n    };\n    // The one cast. `modelRegistry` is a class with a private field and so is\n    // nominally typed, `ui.theme` is typed from a module Pi does not export,\n    // and `model` is a populated provider record. No object literal can satisfy\n    // those three, and no Po extension reads them.\n    return context as unknown as ExtensionToolContext;\n  }\n\n  return {\n    pi,\n    tools,\n    commands,\n    shortcuts,\n    flags,\n    messageRenderers,\n    entryRenderers,\n    markdownTransformers,\n    providers,\n    unregisteredProviders,\n    messages,\n    userMessages,\n    entries,\n    execs,\n    notifications,\n    statuses,\n    widgets,\n    activeTools: () => [...activeToolNames],\n    tool: (name) => tools.findLast((candidate) => candidate.name === name),\n    command: (name) => commands.find((candidate) => candidate.name === name),\n    handlers: (event) => (lifecycle.get(event) ?? []).map(invokable),\n    context: buildContext,\n    async emit(event, payload, context) {\n      const eventContext = context ?? buildContext();\n      const answered: unknown[] = [];\n      // A snapshot, because a handler may register another for the same event\n      // and Pi does not deliver this emission to it.\n      const delivered = [...(lifecycle.get(event) ?? [])];\n      for (const handler of delivered) {\n        answered.push(await invokable(handler)({ type: event, ...(payload as object) }, eventContext));\n      }\n      if (event === 'session_shutdown') cordisConnection = undefined;\n      return answered;\n    },\n    async callTool(name, params = {}, callOptions = {}) {\n      const tool = tools.findLast((candidate) => candidate.name === name);\n      if (!tool) throw new Error(`No tool named '${name}' is registered on this host.`);\n      return tool.execute(\n        callOptions.toolCallId ?? `call-${String(tools.indexOf(tool))}`,\n        params,\n        callOptions.signal,\n        callOptions.onUpdate,\n        callOptions.context ?? buildContext(),\n      );\n    },\n    async runCommand(name, args = '', context) {\n      const command = commands.find((candidate) => candidate.name === name);\n      if (!command) throw new Error(`No command named '${name}' is registered on this host.`);\n      await command.options.handler(args, (context ?? buildContext()) as never);\n    },\n    async cordis(source = DEFAULT_CORDIS_SOURCE) {\n      if (cordisConnection === undefined) {\n        const controller = await installPoCordisHost(pi, {\n          mode: 'standalone',\n          source: `${source}:standalone-host`,\n        });\n        try {\n          cordisConnection = await connectPoCordisHost(pi, source);\n        } catch (error) {\n          await controller.shutdown();\n          throw error;\n        }\n      }\n      return cordisConnection;\n    },\n    async dispose() {\n      await cordisConnection?.dispose();\n      cordisConnection = undefined;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/types/config.d.mts

@@ -6,7 +6,7 @@
  * this contract generic lets independently bundled consumers share the Cordis
  * service definition without making the contracts package depend on config.
  */
-export interface IDoomConfigService<TSnapshot = unknown, TFileConfig = unknown> {
+export interface IPoConfigService<TSnapshot = unknown, TFileConfig = unknown> {
   /** Identifies the currently published session service for stale-work fencing. */
   readonly generation: string;
   /** Returns the immutable snapshot currently visible to consumers. */

package/dist/src/types/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../../src/types/config.ts"],"mappings":";;;;;;;;iBAOiB,mBAAmB,qBAAqB;;WAE9C;;EAET,eAAe;;EAEf,gBAAgB,UAAU,YAAY;;EAEtC,KAAK,kBAAkB,yBAAyB"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../../src/types/config.ts"],"mappings":";;;;;;;;iBAOiB,iBAAiB,qBAAqB;;WAE5C;;EAET,eAAe;;EAEf,gBAAgB,UAAU,YAAY;;EAEtC,KAAK,kBAAkB,yBAAyB"}

package/dist/src/types/kernel.d.mts

@@ -13,8 +13,8 @@
  *   effect without tearing the process down.
  *
  * AVOID:
- * - Host types in this file. The kernel is host-neutral so the Pi facet and
- *   the headless server facet can share one registry.
+ * - Host types in this file. The kernel is host-neutral so the Pi extension host and
+ *   the headless server host can share one registry.
  * - Mutating a contribution after registration. Re-register instead, so the
  *   recomputed union stays a pure function of the registered set.
  */
@@ -40,7 +40,7 @@ export interface KernelSlotHandle<TValue> extends KernelRegistration {
   /** Registers a contribution against this slot without naming it again. */
   contribute(entry: KernelContribution<TValue>): KernelRegistration;
 }
-export interface DoomKernel {
+export interface PoKernel {
   /** Layers currently selected by the active major mode. */
   readonly activeLayers: readonly string[];
   /** Slot names defined so far, in definition order. */