@agimon-ai/po-core 0.0.0-alpha.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensionScenarios.mjs","names":[],"sources":["../../../../src/testing/pi/extensionScenarios.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\n\nimport { createPiTestHost, type PiTestHost, type PiTestHostOptions } from './testHost';\n\n/**\n * The lifecycle every standard Pi entry owes its host, as runnable scenarios.\n *\n * Eight packages carry their own partial copy of this, and the copies disagree\n * about which parts matter. What they share is what a host actually depends on:\n * that loading the entry registers something, that shutdown can be delivered\n * twice, and that a `/reload` can install the entry again on the same runner.\n *\n * Scenarios are plain data, not `describe`/`it` calls, so this adds no test\n * framework to a package every extension already installs. A caller loops:\n *\n * ```ts\n * for (const scenario of standardExtensionScenarios({ factory, tools: ['x'] })) {\n *   it(scenario.name, () => scenario.run());\n * }\n * ```\n *\n * Deeper fencing is deliberately not here. A package that makes a shut-down\n * tool answer instead of run owns that message and that decision, so it keeps\n * the test too; this covers only what is true of every extension.\n */\n\nexport interface StandardExtensionContractOptions {\n  /** The package's standard Pi entry: the default export Pi invokes. */\n  factory(pi: ExtensionAPI): Promise<void> | void;\n  /** Tool names loading the entry must register. */\n  tools?: readonly string[];\n  /** Slash commands loading the entry must claim. */\n  commands?: readonly string[];\n  /** A fresh host per scenario, for a factory that needs one stubbed a certain way. */\n  createHost?: (options: PiTestHostOptions) => PiTestHost;\n}\n\nexport interface ExtensionContractScenario {\n  name: string;\n  run(): Promise<void>;\n}\n\nconst SHUTDOWN_EVENT = 'session_shutdown';\nconst START_EVENT = 'session_start';\n\nfunction fail(message: string): never {\n  throw new Error(message);\n}\n\nfunction assertContains(actual: readonly string[], expected: readonly string[], subject: string): void {\n  const missing = expected.filter((name) => !actual.includes(name));\n  if (missing.length > 0) {\n    fail(`Expected ${subject} ${missing.join(', ')}; the entry registered ${actual.join(', ') || 'nothing'}.`);\n  }\n}\n\nexport function standardExtensionScenarios(\n  options: StandardExtensionContractOptions,\n): readonly ExtensionContractScenario[] {\n  const expectedTools = options.tools ?? [];\n  const expectedCommands = options.commands ?? [];\n  const build = options.createHost ?? createPiTestHost;\n\n  /** Runs one scenario against its own host, and disposes it either way. */\n  const scenario = (\n    name: string,\n    hostOptions: PiTestHostOptions,\n    body: (host: PiTestHost) => Promise<void>,\n  ): ExtensionContractScenario => ({\n    name,\n    async run() {\n      const host = build(hostOptions);\n      try {\n        await host.cordis('standard-extension-contract');\n        await body(host);\n      } finally {\n        await host.dispose();\n      }\n    },\n  });\n\n  return [\n    scenario('registers its declared tools and commands when the host loads it', {}, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      assertContains(\n        host.tools.map(({ name }) => name),\n        expectedTools,\n        'the entry to register tools',\n      );\n      assertContains(\n        host.commands.map(({ name }) => name),\n        expectedCommands,\n        'the entry to claim commands',\n      );\n    }),\n\n    scenario('handles session_shutdown, so the host can reclaim what it registered', {}, async (host) => {\n      const before = host.handlers(SHUTDOWN_EVENT).length;\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      if (host.handlers(SHUTDOWN_EVENT).length === before) {\n        fail('The entry registered no session_shutdown handler, so nothing it holds is ever released.');\n      }\n    }),\n\n    scenario('takes a repeated shutdown without failing the second one', {}, async (host) => {\n      // Pi delivers shutdown per registered extension, and a package that\n      // installed twice on one runner receives it twice.\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n    }),\n\n    scenario('loads again on the same host after a shutdown, the way /reload does', {}, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n      await host.emit(SHUTDOWN_EVENT, { reason: 'reload' });\n      const before = host.tools.length;\n\n      await host.cordis('standard-extension-contract');\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n\n      if (expectedTools.length > 0 && host.tools.length === before) {\n        fail('Loading the entry again registered nothing: a module-level latch is surviving the reload.');\n      }\n      assertContains(\n        host.tools.slice(before).map(({ name }) => name),\n        expectedTools,\n        'the reloaded entry to register tools',\n      );\n    }),\n\n    // The cockpit and the RPC runtime both load extensions with no TUI. An\n    // entry that reaches for one there takes the whole session down.\n    scenario('installs and shuts down on a headless host', { hasUI: false, mode: 'rpc' }, async (host) => {\n      await host.cordis('standard-extension-contract');\n      await options.factory(host.pi);\n      await host.emit(START_EVENT, { reason: 'startup' });\n      await host.emit(SHUTDOWN_EVENT, { reason: 'quit' });\n    }),\n  ];\n}\n"],"mappings":";;AA0CA,MAAM,iBAAiB;AACvB,MAAM,cAAc;AAEpB,SAAS,KAAK,SAAwB;CACpC,MAAM,IAAI,MAAM,OAAO;AACzB;AAEA,SAAS,eAAe,QAA2B,UAA6B,SAAuB;CACrG,MAAM,UAAU,SAAS,QAAQ,SAAS,CAAC,OAAO,SAAS,IAAI,CAAC;CAChE,IAAI,QAAQ,SAAS,GACnB,KAAK,YAAY,QAAQ,GAAG,QAAQ,KAAK,IAAI,EAAE,yBAAyB,OAAO,KAAK,IAAI,KAAK,UAAU,EAAE;AAE7G;AAEA,SAAgB,2BACd,SACsC;CACtC,MAAM,gBAAgB,QAAQ,SAAS,CAAC;CACxC,MAAM,mBAAmB,QAAQ,YAAY,CAAC;CAC9C,MAAM,QAAQ,QAAQ,cAAc;;CAGpC,MAAM,YACJ,MACA,aACA,UAC+B;EAC/B;EACA,MAAM,MAAM;GACV,MAAM,OAAO,MAAM,WAAW;GAC9B,IAAI;IACF,MAAM,KAAK,OAAO,6BAA6B;IAC/C,MAAM,KAAK,IAAI;GACjB,UAAU;IACR,MAAM,KAAK,QAAQ;GACrB;EACF;CACF;CAEA,OAAO;EACL,SAAS,oEAAoE,CAAC,GAAG,OAAO,SAAS;GAC/F,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,eACE,KAAK,MAAM,KAAK,EAAE,WAAW,IAAI,GACjC,eACA,6BACF;GACA,eACE,KAAK,SAAS,KAAK,EAAE,WAAW,IAAI,GACpC,kBACA,6BACF;EACF,CAAC;EAED,SAAS,wEAAwE,CAAC,GAAG,OAAO,SAAS;GACnG,MAAM,SAAS,KAAK,SAAS,cAAc,CAAC,CAAC;GAC7C,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,IAAI,KAAK,SAAS,cAAc,CAAC,CAAC,WAAW,QAC3C,KAAK,yFAAyF;EAElG,CAAC;EAED,SAAS,4DAA4D,CAAC,GAAG,OAAO,SAAS;GAGvF,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;GAClD,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;EACpD,CAAC;EAED,SAAS,uEAAuE,CAAC,GAAG,OAAO,SAAS;GAClG,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAC7B,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,SAAS,CAAC;GACpD,MAAM,SAAS,KAAK,MAAM;GAE1B,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAE7B,IAAI,cAAc,SAAS,KAAK,KAAK,MAAM,WAAW,QACpD,KAAK,2FAA2F;GAElG,eACE,KAAK,MAAM,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,GAC/C,eACA,sCACF;EACF,CAAC;EAID,SAAS,8CAA8C;GAAE,OAAO;GAAO,MAAM;EAAM,GAAG,OAAO,SAAS;GACpG,MAAM,KAAK,OAAO,6BAA6B;GAC/C,MAAM,QAAQ,QAAQ,KAAK,EAAE;GAC7B,MAAM,KAAK,KAAK,aAAa,EAAE,QAAQ,UAAU,CAAC;GAClD,MAAM,KAAK,KAAK,gBAAgB,EAAE,QAAQ,OAAO,CAAC;EACpD,CAAC;CACH;AACF"}

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

@@ -0,0 +1,399 @@
+const require_runtimeCordisHost = require("../../../runtimeCordisHost.cjs");
+//#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);
+		},
+		registerToolRenderer() {},
+		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 require_runtimeCordisHost.installDoomCordisHost(pi, {
+					mode: "standalone",
+					source: `${source}:standalone-host`
+				});
+				try {
+					cordisConnection = await require_runtimeCordisHost.connectDoomCordisHost(pi, source);
+				} catch (error) {
+					await controller.shutdown();
+					throw error;
+				}
+			}
+			return cordisConnection;
+		},
+		async dispose() {
+			await cordisConnection?.dispose();
+			cordisConnection = void 0;
+		}
+	};
+}
+//#endregion
+exports.createPiTestHost = createPiTestHost;
+
+//# sourceMappingURL=testHost.cjs.map

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

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

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

@@ -0,0 +1,160 @@
+import { DoomCordisHostConnection } 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. */
+type InvokableHandler = (event: unknown, context: unknown) => unknown;
+type RunMode = ExtensionContext['mode'];
+type ShortcutId = Parameters<ExtensionAPI['registerShortcut']>[0];
+type ShortcutOptions = Parameters<ExtensionAPI['registerShortcut']>[1];
+type CommandOptions = Parameters<ExtensionAPI['registerCommand']>[1];
+type FlagOptions = Parameters<ExtensionAPI['registerFlag']>[1];
+type CustomMessagePayload = Parameters<ExtensionAPI['sendMessage']>[0];
+type SendMessageOptions = Parameters<ExtensionAPI['sendMessage']>[1];
+type UserMessageContent = Parameters<ExtensionAPI['sendUserMessage']>[0];
+type SendUserMessageOptions = Parameters<ExtensionAPI['sendUserMessage']>[1];
+type RegisteredTool = Parameters<ExtensionAPI['registerTool']>[0];
+type ToolUpdateCallback = Parameters<RegisteredTool['execute']>[3];
+type ExecutionResult = Awaited<ReturnType<ExtensionAPI['exec']>>;
+type ExecutionOptions = Parameters<ExtensionAPI['exec']>[2];
+type WidgetContent = Parameters<ExtensionContext['ui']['setWidget']>[1];
+export interface RecordedCommand {
+  name: string;
+  options: CommandOptions;
+}
+export interface RecordedShortcut {
+  shortcut: ShortcutId;
+  options: ShortcutOptions;
+}
+export interface RecordedRenderer {
+  customType: string;
+  renderer: unknown;
+}
+/** A `registerProvider` call in either of its two shapes. */
+export interface RecordedProvider {
+  /** Present for the `(name, config)` overload. */
+  name?: string;
+  value: unknown;
+}
+export interface RecordedMessage {
+  message: CustomMessagePayload;
+  options: SendMessageOptions;
+}
+export interface RecordedUserMessage {
+  content: UserMessageContent;
+  options: SendUserMessageOptions;
+}
+export interface RecordedEntry {
+  customType: string;
+  data: unknown;
+}
+export interface RecordedExec {
+  command: string;
+  args: string[];
+  options: ExecutionOptions;
+}
+export interface RecordedNotification {
+  sessionId: string;
+  message: string;
+  level: 'info' | 'warning' | 'error' | undefined;
+}
+export interface RecordedWidget {
+  sessionId: string;
+  key: string;
+  content: WidgetContent;
+}
+export interface RecordedStatus {
+  sessionId: string;
+  key: string;
+  text: string | undefined;
+}
+/**
+ * What the extension's dialogs answer.
+ *
+ * Every default is the dismissal, because that is the answer a headless host
+ * gives and the one an extension is most likely to mishandle.
+ */
+export interface PiTestDialogAnswers {
+  select(title: string, options: string[]): string | undefined;
+  confirm(title: string, message: string): boolean;
+  input(title: string, placeholder: string | undefined): string | undefined;
+  editor(title: string, prefill: string | undefined): string | undefined;
+}
+export interface PiTestContextOptions {
+  sessionId?: string;
+  cwd?: string;
+  hasUI?: boolean;
+  mode?: RunMode;
+  isIdle?: boolean;
+  isProjectTrusted?: boolean;
+  signal?: AbortSignal;
+  answers?: Partial<PiTestDialogAnswers>;
+  systemPrompt?: string;
+}
+export interface PiTestHostOptions extends PiTestContextOptions {
+  /** Answers `pi.exec`; the default reports a command that ran and printed nothing. */
+  exec?: (command: string, args: string[]) => ExecutionResult | Promise<ExecutionResult>;
+  /**
+   * Tool names Pi would already own before any extension loads.
+   *
+   * They join the inventory and start active, which is how the tool surface
+   * arbiter learns that a name like `read` exists without a definition for it.
+   */
+  builtinTools?: readonly string[];
+}
+export interface PiTestHost {
+  /** The host an extension factory receives. */
+  readonly pi: ExtensionAPI;
+  readonly tools: readonly RegisteredTool[];
+  readonly commands: readonly RecordedCommand[];
+  readonly shortcuts: readonly RecordedShortcut[];
+  readonly flags: ReadonlyMap<string, FlagOptions>;
+  readonly messageRenderers: readonly RecordedRenderer[];
+  readonly entryRenderers: readonly RecordedRenderer[];
+  readonly markdownTransformers: readonly unknown[];
+  readonly providers: readonly RecordedProvider[];
+  readonly unregisteredProviders: readonly string[];
+  readonly messages: readonly RecordedMessage[];
+  readonly userMessages: readonly RecordedUserMessage[];
+  readonly entries: readonly RecordedEntry[];
+  readonly execs: readonly RecordedExec[];
+  readonly notifications: readonly RecordedNotification[];
+  readonly statuses: readonly RecordedStatus[];
+  readonly widgets: readonly RecordedWidget[];
+  /** Tool names Pi would offer the model right now. */
+  activeTools(): readonly string[];
+  tool(name: string): RegisteredTool | undefined;
+  command(name: string): RecordedCommand | undefined;
+  /** Lifecycle handlers registered for one event, in registration order. */
+  handlers(event: string): readonly InvokableHandler[];
+  /** A context for this host; each call builds a fresh one, as Pi does per event. */
+  context(options?: PiTestContextOptions): ExtensionToolContext;
+  /**
+   * Runs every handler for one lifecycle event and returns what they answered.
+   *
+   * Sequential and awaited, matching Pi, so a test can observe one handler's
+   * effect on the next.
+   */
+  emit(event: string, payload?: unknown, context?: ExtensionContext): Promise<unknown[]>;
+  /** Calls a registered tool the way Pi's runner does. */
+  callTool(name: string, params?: unknown, options?: {
+    toolCallId?: string;
+    signal?: AbortSignal;
+    onUpdate?: ToolUpdateCallback;
+    context?: ExtensionToolContext;
+  }): Promise<unknown>;
+  /** 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>;
+  dispose(): Promise<void>;
+}
+/**
+ * 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.
+ */
+export declare function createPiTestHost(options?: PiTestHostOptions): PiTestHost;
+//#endregion
+//# sourceMappingURL=testHost.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testHost.d.mts","names":[],"sources":["../../../../src/testing/pi/testHost.ts"],"mappings":";;;;KA2CK,oBAAoB,gBAAgB;KAQpC,UAAU;KACV,aAAa,WAAW;KACxB,kBAAkB,WAAW;KAC7B,iBAAiB,WAAW;KAC5B,cAAc,WAAW;KACzB,uBAAuB,WAAW;KAClC,qBAAqB,WAAW;KAChC,qBAAqB,WAAW;KAChC,yBAAyB,WAAW;KACpC,iBAAiB,WAAW;KAC5B,qBAAqB,WAAW;KAChC,kBAAkB,QAAQ,WAAW;KACrC,mBAAmB,WAAW;KAE9B,gBAAgB,WAAW;iBAuBf;EACf;EACA,SAAS;;iBAEM;EACf,UAAU;EACV,SAAS;;iBAEM;EACf;EACA;;;iBAGe;;EAEf;EACA;;iBAEe;EACf,SAAS;EACT,SAAS;;iBAEM;EACf,SAAS;EACT,SAAS;;iBAEM;EACf;EACA;;iBAEe;EACf;EACA;EACA,SAAS;;iBAEM;EACf;EACA;EACA;;iBAEe;EACf;EACA;EACA,SAAS;;iBAEM;EACf;EACA;EACA;;;;;;;;iBASe;EACf,OAAO,eAAe;EACtB,QAAQ,eAAe;EACvB,MAAM,eAAe;EACrB,OAAO,eAAe;;iBAGP;EACf;EACA;EACA;EACA,OAAO;EACP;EACA;EACA,SAAS;EACT,UAAU,QAAQ;EAClB;;iBAGe,0BAA0B;;EAEzC,QAAQ,iBAAiB,mBAAmB,kBAAkB,QAAQ;;;;;;;EAOtE;;iBAGe;;WAEN,IAAI;WACJ,gBAAgB;WAChB,mBAAmB;WACnB,oBAAoB;WACpB,OAAO,oBAAoB;WAC3B,2BAA2B;WAC3B,yBAAyB;WACzB;WACA,oBAAoB;WACpB;WACA,mBAAmB;WACnB,uBAAuB;WACvB,kBAAkB;WAClB,gBAAgB;WAChB,wBAAwB;WACxB,mBAAmB;WACnB,kBAAkB;;EAE3B;EACA,KAAK,eAAe;EACpB,QAAQ,eAAe;;EAEvB,SAAS,yBAAyB;;EAElC,QAAQ,UAAU,uBAAuB;;;;;;;EAOzC,KAAK,eAAe,mBAAmB,UAAU,mBAAmB;;EAEpE,SACE,cACA,kBACA;IACE;IACA,SAAS;IACT,WAAW;IACX,UAAU;MAEX;;EAEH,WAAW,cAAc,eAAe,UAAU,mBAAmB;;EAErE,OAAO,kBAAkB,QAAQ;EACjC,WAAW;;;;;;;;;wBAwBG,iBAAiB,UAAS,oBAAyB"}