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

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

@@ -0,0 +1,398 @@
+import { connectDoomCordisHost, installDoomCordisHost } from "../../../runtimeCordisHost.mjs";
+//#region src/testing/pi/testHost.ts
+function invokable(handler) {
+	return handler;
+}
+/** Inventory entry for a host-owned tool this harness cannot execute. */
+function builtinToolInfo(name) {
+	return {
+		name,
+		description: `Built-in ${name}`,
+		parameters: {
+			type: "object",
+			properties: {},
+			additionalProperties: false
+		},
+		sourceInfo: { type: "builtin" }
+	};
+}
+/** Inventory view of a tool an extension registered with this host. */
+function registeredToolInfo(tool) {
+	return {
+		name: tool.name,
+		description: tool.description,
+		parameters: tool.parameters,
+		promptGuidelines: tool.promptGuidelines,
+		sourceInfo: { type: "extension" }
+	};
+}
+const DEFAULT_CWD = "/repo";
+const DEFAULT_SESSION_ID = "test-session";
+const DEFAULT_MODE = "tui";
+const DEFAULT_SYSTEM_PROMPT = "";
+const DEFAULT_CORDIS_SOURCE = "pi-test-host";
+const DEFAULT_EXEC = {
+	code: 0,
+	killed: false,
+	stdout: "",
+	stderr: ""
+};
+const DISMISSED = {
+	select: () => void 0,
+	confirm: () => false,
+	input: () => void 0,
+	editor: () => void 0
+};
+/**
+* A Pi host and the records of what an extension did to it.
+*
+* Nothing here is a spy from a test framework: the records are plain arrays, so
+* the harness works under any runner and adds no dependency to a package that
+* every extension already installs.
+*/
+function createPiTestHost(options = {}) {
+	const builtinTools = options.builtinTools ?? [];
+	const tools = [];
+	const commands = [];
+	const shortcuts = [];
+	const flags = /* @__PURE__ */ new Map();
+	const messageRenderers = [];
+	const entryRenderers = [];
+	const markdownTransformers = [];
+	const providers = [];
+	const unregisteredProviders = [];
+	const messages = [];
+	const userMessages = [];
+	const entries = [];
+	const execs = [];
+	const notifications = [];
+	const statuses = [];
+	const widgets = [];
+	const lifecycle = /* @__PURE__ */ new Map();
+	const channels = /* @__PURE__ */ new Map();
+	let activeToolNames = [...builtinTools];
+	let sessionName;
+	let thinkingLevel = "off";
+	let cordisConnection;
+	const runExec = options.exec ?? (() => DEFAULT_EXEC);
+	const pi = {
+		on(event, handler) {
+			const registered = lifecycle.get(event) ?? [];
+			registered.push(handler);
+			lifecycle.set(event, registered);
+			return () => {
+				const index = registered.indexOf(handler);
+				if (index === -1) return;
+				registered.splice(index, 1);
+				if (registered.length === 0) lifecycle.delete(event);
+			};
+		},
+		registerTool(tool) {
+			tools.push(tool);
+			if (!activeToolNames.includes(tool.name)) activeToolNames.push(tool.name);
+		},
+		registerCommand(name, commandOptions) {
+			commands.push({
+				name,
+				options: commandOptions
+			});
+		},
+		registerShortcut(shortcut, shortcutOptions) {
+			shortcuts.push({
+				shortcut,
+				options: shortcutOptions
+			});
+		},
+		registerFlag(name, flagOptions) {
+			flags.set(name, flagOptions);
+		},
+		getFlag(name) {
+			return flags.get(name)?.default;
+		},
+		registerMessageRenderer(customType, renderer) {
+			messageRenderers.push({
+				customType,
+				renderer
+			});
+		},
+		registerMarkdownTransformer(transformer) {
+			markdownTransformers.push(transformer);
+		},
+		registerEntryRenderer(customType, renderer) {
+			entryRenderers.push({
+				customType,
+				renderer
+			});
+		},
+		sendMessage(message, sendOptions) {
+			messages.push({
+				message,
+				options: sendOptions
+			});
+		},
+		sendUserMessage(content, sendOptions) {
+			userMessages.push({
+				content,
+				options: sendOptions
+			});
+		},
+		appendEntry(customType, data) {
+			entries.push({
+				customType,
+				data
+			});
+		},
+		setSessionName(name) {
+			sessionName = name;
+		},
+		getSessionName() {
+			return sessionName;
+		},
+		setLabel() {},
+		async exec(command, args, execOptions) {
+			execs.push({
+				command,
+				args,
+				options: execOptions
+			});
+			return runExec(command, args);
+		},
+		getActiveTools() {
+			return [...activeToolNames];
+		},
+		getAllTools() {
+			return [...builtinTools.map(builtinToolInfo), ...tools.map(registeredToolInfo)];
+		},
+		setActiveTools(toolNames) {
+			activeToolNames = [...toolNames];
+		},
+		getSettings() {
+			return {};
+		},
+		registerMcpServer() {},
+		unregisterMcpServer() {},
+		getMcpServers() {
+			return [];
+		},
+		registerVirtualModel() {},
+		unregisterVirtualModel() {},
+		getCommands() {
+			return [];
+		},
+		async setModel() {
+			return false;
+		},
+		getThinkingLevel() {
+			return thinkingLevel;
+		},
+		setThinkingLevel(level) {
+			thinkingLevel = level;
+		},
+		registerProvider(providerOrName, config) {
+			providers.push(typeof providerOrName === "string" ? {
+				name: providerOrName,
+				value: config
+			} : { value: providerOrName });
+		},
+		unregisterProvider(name) {
+			unregisteredProviders.push(name);
+		},
+		events: {
+			emit(channel, data) {
+				const delivered = [...channels.get(channel) ?? []];
+				for (const listener of delivered) listener(data);
+			},
+			on(channel, listener) {
+				const listeners = channels.get(channel) ?? /* @__PURE__ */ new Set();
+				listeners.add(listener);
+				channels.set(channel, listeners);
+				return () => listeners.delete(listener);
+			}
+		}
+	};
+	function buildContext(contextOptions = {}) {
+		const sessionId = contextOptions.sessionId ?? options.sessionId ?? DEFAULT_SESSION_ID;
+		const cwd = contextOptions.cwd ?? options.cwd ?? DEFAULT_CWD;
+		const answers = {
+			...DISMISSED,
+			...options.answers,
+			...contextOptions.answers
+		};
+		return {
+			ui: {
+				select: async (title, selectOptions) => answers.select(title, selectOptions),
+				confirm: async (title, message) => answers.confirm(title, message),
+				input: async (title, placeholder) => answers.input(title, placeholder),
+				editor: async (title, prefill) => answers.editor(title, prefill),
+				notify: (message, level) => {
+					notifications.push({
+						sessionId,
+						message,
+						level
+					});
+				},
+				onTerminalInput: () => () => void 0,
+				setStatus: (key, text) => {
+					statuses.push({
+						sessionId,
+						key,
+						text
+					});
+				},
+				setWorkingMessage: () => void 0,
+				setWorkingVisible: () => void 0,
+				setWorkingIndicator: () => void 0,
+				setHiddenThinkingLabel: () => void 0,
+				setWidget: (key, content) => {
+					widgets.push({
+						sessionId,
+						key,
+						content
+					});
+				},
+				setFooter: () => void 0,
+				setHeader: () => void 0,
+				setTitle: () => void 0,
+				custom: () => new Promise(() => void 0),
+				pasteToEditor: () => void 0,
+				setEditorText: () => void 0,
+				getEditorText: () => "",
+				addAutocompleteProvider: () => void 0,
+				setEditorComponent: () => void 0,
+				getEditorComponent: () => void 0,
+				theme: void 0,
+				getAllThemes: () => [],
+				getTheme: () => void 0,
+				setTheme: () => ({
+					success: false,
+					error: "This host renders nothing."
+				}),
+				getToolsExpanded: () => false,
+				setToolsExpanded: () => void 0
+			},
+			mode: contextOptions.mode ?? options.mode ?? DEFAULT_MODE,
+			hasUI: contextOptions.hasUI ?? options.hasUI ?? true,
+			cwd,
+			sessionManager: {
+				getCwd: () => cwd,
+				getSessionId: () => sessionId,
+				getSessionName: () => sessionName,
+				getSessionDir: () => cwd,
+				getSessionFile: () => `${cwd}/${sessionId}.jsonl`,
+				getLeafId: () => void 0,
+				getLeafEntry: () => void 0,
+				getEntry: () => void 0,
+				getLabel: () => void 0,
+				getBranch: () => [],
+				buildContextEntries: () => [],
+				getHeader: () => void 0,
+				getEntries: () => [],
+				getTree: () => []
+			},
+			modelRegistry: void 0,
+			model: void 0,
+			scopedModels: [],
+			isIdle: () => contextOptions.isIdle ?? options.isIdle ?? true,
+			isProjectTrusted: () => contextOptions.isProjectTrusted ?? options.isProjectTrusted ?? true,
+			signal: contextOptions.signal ?? options.signal,
+			abort: () => void 0,
+			hasPendingMessages: () => false,
+			shutdown: () => void 0,
+			getContextUsage: () => void 0,
+			compact: () => void 0,
+			getSystemPrompt: () => contextOptions.systemPrompt ?? options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+			getSystemPromptOptions: () => ({}),
+			waitForIdle: async () => void 0,
+			newSession: async () => ({ cancelled: true }),
+			fork: async () => ({ cancelled: true }),
+			navigateTree: async () => ({ cancelled: true }),
+			switchSession: async () => ({ cancelled: true }),
+			reload: async () => void 0,
+			tools: [],
+			executeTool: async (name) => ({
+				toolCall: {
+					type: "toolCall",
+					id: "nested/0",
+					name,
+					arguments: {}
+				},
+				result: {
+					content: [{
+						type: "text",
+						text: "Nested tool calls are not available in this context"
+					}],
+					details: {}
+				},
+				isError: true
+			})
+		};
+	}
+	return {
+		pi,
+		tools,
+		commands,
+		shortcuts,
+		flags,
+		messageRenderers,
+		entryRenderers,
+		markdownTransformers,
+		providers,
+		unregisteredProviders,
+		messages,
+		userMessages,
+		entries,
+		execs,
+		notifications,
+		statuses,
+		widgets,
+		activeTools: () => [...activeToolNames],
+		tool: (name) => tools.findLast((candidate) => candidate.name === name),
+		command: (name) => commands.find((candidate) => candidate.name === name),
+		handlers: (event) => (lifecycle.get(event) ?? []).map(invokable),
+		context: buildContext,
+		async emit(event, payload, context) {
+			const eventContext = context ?? buildContext();
+			const answered = [];
+			const delivered = [...lifecycle.get(event) ?? []];
+			for (const handler of delivered) answered.push(await invokable(handler)({
+				type: event,
+				...payload
+			}, eventContext));
+			if (event === "session_shutdown") cordisConnection = void 0;
+			return answered;
+		},
+		async callTool(name, params = {}, callOptions = {}) {
+			const tool = tools.findLast((candidate) => candidate.name === name);
+			if (!tool) throw new Error(`No tool named '${name}' is registered on this host.`);
+			return tool.execute(callOptions.toolCallId ?? `call-${String(tools.indexOf(tool))}`, params, callOptions.signal, callOptions.onUpdate, callOptions.context ?? buildContext());
+		},
+		async runCommand(name, args = "", context) {
+			const command = commands.find((candidate) => candidate.name === name);
+			if (!command) throw new Error(`No command named '${name}' is registered on this host.`);
+			await command.options.handler(args, context ?? buildContext());
+		},
+		async cordis(source = DEFAULT_CORDIS_SOURCE) {
+			if (cordisConnection === void 0) {
+				const controller = await installDoomCordisHost(pi, {
+					mode: "standalone",
+					source: `${source}:standalone-host`
+				});
+				try {
+					cordisConnection = await connectDoomCordisHost(pi, source);
+				} catch (error) {
+					await controller.shutdown();
+					throw error;
+				}
+			}
+			return cordisConnection;
+		},
+		async dispose() {
+			await cordisConnection?.dispose();
+			cordisConnection = void 0;
+		}
+	};
+}
+//#endregion
+export { createPiTestHost };
+
+//# sourceMappingURL=testHost.mjs.map

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

@@ -0,0 +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    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 DoomPi 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 DoomPi 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 DoomPi 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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"}

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

@@ -0,0 +1,20 @@
+//#region src/types/config.d.ts
+/**
+ * Cross-package service contract for the immutable configuration snapshot.
+ *
+ * The provider supplies the concrete snapshot and file-config types. Keeping
+ * 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> {
+  /** Identifies the currently published session service for stale-work fencing. */
+  readonly generation: string;
+  /** Returns the immutable snapshot currently visible to consumers. */
+  getSnapshot(): TSnapshot;
+  /** Atomically replaces the immutable live snapshot after a successful transition. */
+  replaceSnapshot(snapshot: TSnapshot): TSnapshot;
+  /** Loads the package's file configuration outside the live session snapshot. */
+  load(repoRoot: string, homeDirectory?: string): TFileConfig;
+}
+//#endregion
+//# sourceMappingURL=config.d.mts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,69 @@
+//#region src/types/kernel.d.ts
+/**
+ * Kernel contribution contracts.
+ *
+ * DESIGN PATTERNS:
+ * - One concept: a slot. Tools, commands, resources and hooks are all slots,
+ *   so a new surface costs a `defineSlot` call rather than a new registry.
+ * - Contributions are gated by the layer that owns them. A layer is the unit a
+ *   major mode selects, so recomputing the active union is the whole of a
+ *   major-mode switch.
+ * - Sinks receive the complete active list, never a delta. Whole-list
+ *   replacement makes removal inherent, which is what lets a switch take
+ *   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.
+ * - Mutating a contribution after registration. Re-register instead, so the
+ *   recomputed union stays a pure function of the registered set.
+ */
+/** A contribution the kernel may hand to a sink. */
+export interface KernelContribution<TValue> {
+  /** Owning package, for diagnostics and for `contributionsOf`. */
+  readonly source: string;
+  /**
+   * Layer that must be active for this contribution to apply. Omitted means
+   * always active, which is how host-owned contributions opt out of gating.
+   */
+  readonly layer?: string;
+  readonly value: TValue;
+}
+/** Receives the complete active list for one slot whenever it changes. */
+export type KernelSlotSink<TValue> = (active: readonly TValue[]) => void | Promise<void>;
+/** Removes a contribution or a slot. Calling it twice is a no-op. */
+export interface KernelRegistration {
+  dispose(): void;
+}
+export interface KernelSlotHandle<TValue> extends KernelRegistration {
+  readonly name: string;
+  /** Registers a contribution against this slot without naming it again. */
+  contribute(entry: KernelContribution<TValue>): KernelRegistration;
+}
+export interface DoomKernel {
+  /** Layers currently selected by the active major mode. */
+  readonly activeLayers: readonly string[];
+  /** Slot names defined so far, in definition order. */
+  readonly slots: readonly string[];
+  defineSlot<TValue>(name: string, sink: KernelSlotSink<TValue>): KernelSlotHandle<TValue>;
+  contribute<TValue>(slot: string, entry: KernelContribution<TValue>): KernelRegistration;
+  /**
+   * Replaces the active layer set and pushes every affected slot.
+   *
+   * Overlapping calls coalesce: a host converges on the last layer set rather
+   * than replaying each one, so tapping through modes costs one apply.
+   */
+  setActiveLayers(layers: readonly string[]): Promise<void>;
+  /**
+   * Re-pushes a slot whose contribution values now render differently, such as
+   * resources after a domain change. Omit the name to push every slot.
+   */
+  refresh(slot?: string): Promise<void>;
+  /** Active values for one slot, in registration order. Empty if undefined. */
+  activeValues<TValue>(slot: string): readonly TValue[];
+  /** All registered contributions for one slot, including inactive layers. */
+  contributions<TValue>(slot: string): readonly KernelContribution<TValue>[];
+  dispose(): void;
+}
+//#endregion
+//# sourceMappingURL=kernel.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.mts","names":[],"sources":["../../../src/types/kernel.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;iBAqBiB,mBAAmB;;WAEzB;;;;;WAKA;WACA,OAAO;;;YAIN,eAAe,WAAW,iBAAiB,oBAAoB;;iBAG1D;EACf;;iBAGe,iBAAiB,gBAAgB;WACvC;;EAET,WAAW,OAAO,mBAAmB,UAAU;;iBAGhC;;WAEN;;WAEA;EACT,WAAW,QAAQ,cAAc,MAAM,eAAe,UAAU,iBAAiB;EACjF,WAAW,QAAQ,cAAc,OAAO,mBAAmB,UAAU;;;;;;;EAOrE,gBAAgB,4BAA4B;;;;;EAK5C,QAAQ,gBAAgB;;EAExB,aAAa,QAAQ,wBAAwB;;EAE7C,cAAc,QAAQ,wBAAwB,mBAAmB;EACjE"}

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

@@ -0,0 +1,124 @@
+//#region src/types/remote.d.ts
+export type RemoteChannelScope = 'session' | 'protocol' | 'http';
+/**
+ * How the tunnel is established.
+ *
+ * `named` carries a hostname rather than discovering one, which is why it is
+ * the mode that supports passkeys, a service worker, and durable pairing: all
+ * three are bound to the origin, and a quick tunnel's hostname rotates on every
+ * start. The token is referenced by path, never stored inline, because it is a
+ * Cloudflare account credential and an inlined one ends up in a bug report.
+ */
+export type TunnelConfig = {
+  kind: 'quick';
+} | {
+  kind: 'named';
+  hostname: string;
+  name?: string;
+  tokenFile?: string;
+  configFile?: string;
+};
+/**
+ * Running the cockpit in a container.
+ *
+ * Tied to remote access rather than offered separately: the reason to contain
+ * the cockpit is that a paired device drives an agent holding a shell, and the
+ * containment only means anything if it is in place before the tunnel is.
+ *
+ * The workspace list is the boundary. A hub inside the container cannot create
+ * a session in a path that is not mounted, so arbitrary-directory spawning is
+ * closed by construction rather than by a check.
+ */
+export interface SandboxSettings {
+  enabled: boolean;
+  /** Absolute host directories the contained cockpit may work in. */
+  workspaces: string[];
+}
+/** Nullable numbers are not used: a disabled toggle keeps its value so flipping it back restores it. */
+export interface RemoteAccessSettings {
+  /** Close the tunnel on a timer. */
+  autoCloseEnabled: boolean;
+  autoCloseMinutes: number;
+  /** Expire paired sessions on idle and on total age. */
+  sessionExpiryEnabled: boolean;
+  idleMinutes: number;
+  absoluteHours: number;
+  tunnel: TunnelConfig;
+  sandbox: SandboxSettings;
+}
+export interface BundlePairingTrust {
+  publicKey: string;
+  fingerprint: string;
+  revision: number;
+}
+export type RemoteAccessStatus = 'off' | 'starting' | 'on' | 'failed';
+export interface PairedDeviceView {
+  id: string;
+  label: string;
+  userAgent: string;
+  /** ISO 8601. */
+  createdAt: string;
+  /** ISO 8601. */
+  lastSeenAt: string;
+  /** True for the device making the request, so the UI can say "this device". */
+  self: boolean;
+}
+export interface PairingRequestView {
+  id: string;
+  userAgent: string;
+  /**
+   * The address Cloudflare's edge reported. Display only: any local process can
+   * reach the tunnel listener directly and set this header to anything, so it
+   * never gates a decision. The UI labels it "reported by the edge".
+   */
+  edgeIp: string;
+  /** ISO 8601. */
+  createdAt: string;
+  /** ISO 8601. */
+  expiresAt: string;
+}
+export interface RemoteAccessStateView {
+  status: RemoteAccessStatus;
+  /** Present once the tunnel reports its hostname. */
+  publicUrl?: string;
+  /** ISO 8601, present while the tunnel is up. */
+  startedAt?: string;
+  /** ISO 8601, absent when auto-close is switched off. */
+  closesAt?: string;
+  /** Why the tunnel failed, once it has. */
+  error?: string;
+  devices: PairedDeviceView[];
+  /** Populated for local callers only; a paired phone must not see approval prompts. */
+  pending: PairingRequestView[];
+  settings: RemoteAccessSettings;
+}
+export type PairingStatus = 'pending' | 'approved' | 'denied' | 'expired' | 'consumed';
+export type TunnelFailure = 'not_installed' | 'spawn_failed' | 'timeout' | 'self_test_failed' | 'exited';
+export interface TunnelStartInput {
+  /** The loopback port the tunnel should publish. */
+  port: number;
+  config: TunnelConfig;
+  /** Arms the exact public origin before the launcher probes through it. */
+  acceptOrigin?: (origin: string) => void;
+  /** Cancels startup and asks the launcher to stop any process it has spawned. */
+  signal?: AbortSignal;
+}
+export type TunnelStartResult = {
+  ok: true;
+  publicOrigin: string;
+  stop: () => Promise<void>;
+} | {
+  ok: false;
+  failure: TunnelFailure;
+  message: string;
+};
+/**
+ * Starting a tunnel, as a port rather than a concrete process.
+ *
+ * Declared here so a test can inject a fake without pulling in the cloudflared
+ * adapter, and so `WebServerOptions` can name the seam without reaching across
+ * a layer to do it.
+ */
+export type TunnelLauncher = (input: TunnelStartInput) => Promise<TunnelStartResult>;
+//#endregion
+//# sourceMappingURL=remote.d.mts.map