@xopcai/xopc 0.0.103 → 0.0.104

package/dist/src/tui/extension-host/host.d.ts

@@ -1,15 +1,45 @@
 import type { Component } from '@earendil-works/pi-tui';
-import type { TuiAutocompleteProvider, TuiExtensionHostContract, TuiExtensionRegistrar, TuiNotifyLevel, TuiSlashCommandHandler } from '../../extensions/types/tui.js';
+import type { TuiAutocompleteProvider, TuiAutocompleteProviderFactory, TuiCustomFactory, TuiCustomOptions, TuiDialogOptions, TuiEditorFactory, TuiExtensionHostContract, TuiExtensionRegistrar, TuiFooterFactory, TuiHeaderFactory, TuiMessageRenderer, TuiNotifyLevel, TuiShortcutHandler, TuiSlashCommandHandler, TuiTerminalInputHandler, TuiSetThemeResult, TuiTheme, TuiThemeInfo, TuiWidgetFactory, TuiWorkingIndicatorOptions } from '../../extensions/types/tui.js';
 import { TuiExtensionSurface } from './surface.js';
 export interface TuiExtensionHostDeps {
     extensionId: string;
     surface: TuiExtensionSurface;
     getSessionKey: () => string;
     notify: (message: string, level?: TuiNotifyLevel) => void;
+    onTerminalInputAdded: (handler: TuiTerminalInputHandler) => () => void;
     showOverlay: (component: Component) => void;
     hideOverlay: () => void;
+    custom: <T>(factory: TuiCustomFactory<T>, options?: TuiCustomOptions) => Promise<T>;
+    createWidgetComponent: (factory: TuiWidgetFactory) => Component & {
+        dispose?(): void;
+    };
+    setFooter: (factory: TuiFooterFactory | undefined) => void;
+    setHeader: (factory: TuiHeaderFactory | undefined) => void;
+    setTitle: (title: string) => void;
+    pasteToEditor: (text: string) => void;
+    setEditorText: (text: string) => void;
+    getEditorText: () => string;
+    editor: (title: string, prefill?: string) => Promise<string | undefined>;
+    setEditorComponent: (factory: TuiEditorFactory | undefined) => void;
+    getEditorComponent: () => TuiEditorFactory | undefined;
+    getThemeObject: () => TuiTheme;
+    getAllThemes: () => TuiThemeInfo[];
+    getTheme: (name: string) => TuiTheme | undefined;
+    setTheme: (theme: string) => TuiSetThemeResult;
+    getToolsExpanded: () => boolean;
+    setToolsExpanded: (expanded: boolean) => void;
+    select: (title: string, options: string[], opts?: TuiDialogOptions) => Promise<string | undefined>;
+    confirm: (title: string, message: string, opts?: TuiDialogOptions) => Promise<boolean>;
+    input: (title: string, placeholder?: string, opts?: TuiDialogOptions) => Promise<string | undefined>;
     onAutocompleteProviderAdded: (provider: TuiAutocompleteProvider) => () => void;
+    onAutocompleteProviderFactoryAdded: (factory: TuiAutocompleteProviderFactory) => () => void;
+    onMessageRendererAdded: (customType: string, renderer: TuiMessageRenderer) => () => void;
     onSlashCommandAdded: (name: string, description: string, handler: TuiSlashCommandHandler) => () => void;
+    onShortcutAdded: (key: string, description: string, handler: TuiShortcutHandler) => () => void;
+    setWorkingMessage: (message?: string) => void;
+    setWorkingVisible: (visible: boolean) => void;
+    setWorkingIndicator: (options?: TuiWorkingIndicatorOptions) => void;
+    setHiddenThinkingLabel: (label?: string) => void;
     onInvalidate: () => void;
 }
 export declare function createTuiExtensionHost(deps: TuiExtensionHostDeps): TuiExtensionHostContract;

package/dist/src/tui/extension-host/host.js

@@ -1,44 +1,161 @@
 import { registerTuiToolRenderer } from "./tool-renderers.js";
 //#region src/tui/extension-host/host.ts
+const MAX_WIDGET_LINES = 10;
+const WIDGET_TRUNCATED_LINE = "... (widget truncated)";
 function createTuiExtensionHost(deps) {
 	const widgetKey = (key) => `${deps.extensionId}:${key}`;
+	const setWidgetLines = (map, fullKey, lines, options = {}) => {
+		if (!lines || lines.length === 0) map.delete(fullKey);
+		else map.set(fullKey, options.bounded ? boundedWidgetLines(lines) : lines);
+	};
+	const boundedWidgetLines = (lines) => {
+		if (lines.length <= MAX_WIDGET_LINES) return lines;
+		return [...lines.slice(0, MAX_WIDGET_LINES), WIDGET_TRUNCATED_LINE];
+	};
+	const disposeComponent = (component) => {
+		try {
+			component?.dispose?.();
+		} catch {}
+	};
+	const clearWidgetKey = (fullKey) => {
+		deps.surface.headerWidgets.delete(fullKey);
+		deps.surface.footerWidgets.delete(fullKey);
+		const headerComponent = deps.surface.headerWidgetComponents.get(fullKey);
+		const footerComponent = deps.surface.footerWidgetComponents.get(fullKey);
+		deps.surface.headerWidgetComponents.delete(fullKey);
+		deps.surface.footerWidgetComponents.delete(fullKey);
+		disposeComponent(headerComponent);
+		disposeComponent(footerComponent);
+	};
 	return {
 		extensionId: deps.extensionId,
+		get theme() {
+			return deps.getThemeObject();
+		},
 		setFooterWidget(key, lines) {
 			const fullKey = widgetKey(key);
-			if (!lines || lines.length === 0) deps.surface.footerWidgets.delete(fullKey);
-			else deps.surface.footerWidgets.set(fullKey, lines);
+			setWidgetLines(deps.surface.footerWidgets, fullKey, lines);
 			deps.onInvalidate();
 		},
 		setHeaderWidget(key, lines) {
 			const fullKey = widgetKey(key);
-			if (!lines || lines.length === 0) deps.surface.headerWidgets.delete(fullKey);
-			else deps.surface.headerWidgets.set(fullKey, lines);
+			setWidgetLines(deps.surface.headerWidgets, fullKey, lines);
 			deps.onInvalidate();
 		},
-		addAutocompleteProvider(provider) {
-			return deps.onAutocompleteProviderAdded(provider);
+		setWidget(key, content, options) {
+			const fullKey = widgetKey(key);
+			clearWidgetKey(fullKey);
+			if (!content) {
+				deps.onInvalidate();
+				return;
+			}
+			if (typeof content === "function") (options?.placement === "belowEditor" ? deps.surface.footerWidgetComponents : deps.surface.headerWidgetComponents).set(fullKey, deps.createWidgetComponent(content));
+			else setWidgetLines(options?.placement === "belowEditor" ? deps.surface.footerWidgets : deps.surface.headerWidgets, fullKey, content, { bounded: true });
+			deps.onInvalidate();
+		},
+		setFooter(factory) {
+			deps.setFooter(factory);
+		},
+		setHeader(factory) {
+			deps.setHeader(factory);
+		},
+		addAutocompleteProvider(providerOrFactory) {
+			if (providerOrFactory.length <= 1) return deps.onAutocompleteProviderFactoryAdded(providerOrFactory);
+			return deps.onAutocompleteProviderAdded(providerOrFactory);
 		},
 		registerToolRenderer(toolName, renderer) {
 			return registerTuiToolRenderer(toolName, renderer);
 		},
+		registerMessageRenderer(customType, renderer) {
+			return deps.onMessageRendererAdded(customType, renderer);
+		},
 		registerSlashCommand(name, description, handler) {
 			return deps.onSlashCommandAdded(name, description, handler);
 		},
+		registerShortcut(key, description, handler) {
+			return deps.onShortcutAdded(key, description, handler);
+		},
 		notify(message, level) {
 			deps.notify(message, level);
 		},
+		onTerminalInput(handler) {
+			return deps.onTerminalInputAdded(handler);
+		},
 		showOverlay(component) {
 			deps.showOverlay(component);
 		},
 		hideOverlay() {
 			deps.hideOverlay();
 		},
+		custom(factory, options) {
+			return deps.custom(factory, options);
+		},
+		setTitle(title) {
+			deps.setTitle(title);
+		},
+		pasteToEditor(text) {
+			deps.pasteToEditor(text);
+		},
+		setEditorText(text) {
+			deps.setEditorText(text);
+		},
+		getEditorText() {
+			return deps.getEditorText();
+		},
+		editor(title, prefill) {
+			return deps.editor(title, prefill);
+		},
+		setEditorComponent(factory) {
+			deps.setEditorComponent(factory);
+		},
+		getEditorComponent() {
+			return deps.getEditorComponent();
+		},
+		getAllThemes() {
+			return deps.getAllThemes();
+		},
+		getTheme(name) {
+			return deps.getTheme(name);
+		},
+		setTheme(theme) {
+			return deps.setTheme(theme);
+		},
+		getToolsExpanded() {
+			return deps.getToolsExpanded();
+		},
+		setToolsExpanded(expanded) {
+			deps.setToolsExpanded(expanded);
+		},
+		select(title, options, opts) {
+			return deps.select(title, options, opts);
+		},
+		confirm(title, message, opts) {
+			return deps.confirm(title, message, opts);
+		},
+		input(title, placeholder, opts) {
+			return deps.input(title, placeholder, opts);
+		},
 		setStatus(key, text) {
 			const fullKey = widgetKey(key);
 			if (!text) deps.surface.statusSlots.delete(fullKey);
 			else deps.surface.statusSlots.set(fullKey, text);
 			deps.onInvalidate();
+		},
+		setHiddenThinkingLabel(label) {
+			deps.setHiddenThinkingLabel(label ?? void 0);
+			deps.onInvalidate();
+		},
+		setWorkingMessage(message) {
+			deps.setWorkingMessage(message ?? void 0);
+			deps.onInvalidate();
+		},
+		setWorkingVisible(visible) {
+			deps.setWorkingVisible(visible);
+			deps.onInvalidate();
+		},
+		setWorkingIndicator(options) {
+			deps.setWorkingIndicator(options ?? void 0);
+			deps.onInvalidate();
 		}
 	};
 }

package/dist/src/tui/extension-host/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","names":[],"sources":["../../../../src/tui/extension-host/host.ts"],"sourcesContent":["import type { Component } from '@earendil-works/pi-tui';\n\nimport type {\n  TuiAutocompleteProvider,\n  TuiExtensionHostContract,\n  TuiExtensionRegistrar,\n  TuiNotifyLevel,\n  TuiSlashCommandHandler,\n} from '../../extensions/types/tui.js';\nimport { TuiExtensionSurface } from './surface.js';\nimport { registerTuiToolRenderer } from './tool-renderers.js';\n\nexport interface TuiExtensionHostDeps {\n  extensionId: string;\n  surface: TuiExtensionSurface;\n  getSessionKey: () => string;\n  notify: (message: string, level?: TuiNotifyLevel) => void;\n  showOverlay: (component: Component) => void;\n  hideOverlay: () => void;\n  onAutocompleteProviderAdded: (provider: TuiAutocompleteProvider) => () => void;\n  onSlashCommandAdded: (\n    name: string,\n    description: string,\n    handler: TuiSlashCommandHandler,\n  ) => () => void;\n  onInvalidate: () => void;\n}\n\nexport function createTuiExtensionHost(deps: TuiExtensionHostDeps): TuiExtensionHostContract {\n  const widgetKey = (key: string) => `${deps.extensionId}:${key}`;\n\n  return {\n    extensionId: deps.extensionId,\n\n    setFooterWidget(key, lines) {\n      const fullKey = widgetKey(key);\n      if (!lines || lines.length === 0) {\n        deps.surface.footerWidgets.delete(fullKey);\n      } else {\n        deps.surface.footerWidgets.set(fullKey, lines);\n      }\n      deps.onInvalidate();\n    },\n\n    setHeaderWidget(key, lines) {\n      const fullKey = widgetKey(key);\n      if (!lines || lines.length === 0) {\n        deps.surface.headerWidgets.delete(fullKey);\n      } else {\n        deps.surface.headerWidgets.set(fullKey, lines);\n      }\n      deps.onInvalidate();\n    },\n\n    addAutocompleteProvider(provider) {\n      return deps.onAutocompleteProviderAdded(provider);\n    },\n\n    registerToolRenderer(toolName, renderer) {\n      return registerTuiToolRenderer(toolName, renderer);\n    },\n\n    registerSlashCommand(name, description, handler) {\n      return deps.onSlashCommandAdded(name, description, handler);\n    },\n\n    notify(message, level) {\n      deps.notify(message, level);\n    },\n\n    showOverlay(component) {\n      deps.showOverlay(component as Component);\n    },\n\n    hideOverlay() {\n      deps.hideOverlay();\n    },\n\n    setStatus(key, text) {\n      const fullKey = widgetKey(key);\n      if (!text) {\n        deps.surface.statusSlots.delete(fullKey);\n      } else {\n        deps.surface.statusSlots.set(fullKey, text);\n      }\n      deps.onInvalidate();\n    },\n  };\n}\n\nexport async function invokeTuiExtensionRegistrars(\n  registrars: ReadonlyArray<{ extensionId: string; register: TuiExtensionRegistrar }>,\n  createHost: (extensionId: string) => TuiExtensionHostContract,\n  onError?: (extensionId: string, errorMessage: string) => void,\n): Promise<void> {\n  for (const { extensionId, register } of registrars) {\n    try {\n      await register(createHost(extensionId));\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      onError?.(extensionId, errorMessage);\n    }\n  }\n}\n"],"mappings":";;AA4BA,SAAgB,uBAAuB,MAAsD;CAC3F,MAAM,aAAa,QAAgB,GAAG,KAAK,YAAY,GAAG;AAE1D,QAAO;EACL,aAAa,KAAK;EAElB,gBAAgB,KAAK,OAAO;GAC1B,MAAM,UAAU,UAAU,IAAI;AAC9B,OAAI,CAAC,SAAS,MAAM,WAAW,EAC7B,MAAK,QAAQ,cAAc,OAAO,QAAQ;OAE1C,MAAK,QAAQ,cAAc,IAAI,SAAS,MAAM;AAEhD,QAAK,cAAc;;EAGrB,gBAAgB,KAAK,OAAO;GAC1B,MAAM,UAAU,UAAU,IAAI;AAC9B,OAAI,CAAC,SAAS,MAAM,WAAW,EAC7B,MAAK,QAAQ,cAAc,OAAO,QAAQ;OAE1C,MAAK,QAAQ,cAAc,IAAI,SAAS,MAAM;AAEhD,QAAK,cAAc;;EAGrB,wBAAwB,UAAU;AAChC,UAAO,KAAK,4BAA4B,SAAS;;EAGnD,qBAAqB,UAAU,UAAU;AACvC,UAAO,wBAAwB,UAAU,SAAS;;EAGpD,qBAAqB,MAAM,aAAa,SAAS;AAC/C,UAAO,KAAK,oBAAoB,MAAM,aAAa,QAAQ;;EAG7D,OAAO,SAAS,OAAO;AACrB,QAAK,OAAO,SAAS,MAAM;;EAG7B,YAAY,WAAW;AACrB,QAAK,YAAY,UAAuB;;EAG1C,cAAc;AACZ,QAAK,aAAa;;EAGpB,UAAU,KAAK,MAAM;GACnB,MAAM,UAAU,UAAU,IAAI;AAC9B,OAAI,CAAC,KACH,MAAK,QAAQ,YAAY,OAAO,QAAQ;OAExC,MAAK,QAAQ,YAAY,IAAI,SAAS,KAAK;AAE7C,QAAK,cAAc;;EAEtB;;AAGH,eAAsB,6BACpB,YACA,YACA,SACe;AACf,MAAK,MAAM,EAAE,aAAa,cAAc,WACtC,KAAI;AACF,QAAM,SAAS,WAAW,YAAY,CAAC;UAChC,KAAK;EACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACrE,YAAU,aAAa,aAAa"}
+{"version":3,"file":"host.js","names":[],"sources":["../../../../src/tui/extension-host/host.ts"],"sourcesContent":["import type { Component } from '@earendil-works/pi-tui';\n\nimport type {\n  TuiAutocompleteProvider,\n  TuiAutocompleteProviderFactory,\n  TuiCustomFactory,\n  TuiCustomOptions,\n  TuiDialogOptions,\n  TuiEditorFactory,\n  TuiExtensionHostContract,\n  TuiExtensionRegistrar,\n  TuiFooterFactory,\n  TuiHeaderFactory,\n  TuiMessageRenderer,\n  TuiNotifyLevel,\n  TuiShortcutHandler,\n  TuiSlashCommandHandler,\n  TuiTerminalInputHandler,\n  TuiSetThemeResult,\n  TuiTheme,\n  TuiThemeInfo,\n  TuiWidgetFactory,\n  TuiWorkingIndicatorOptions,\n} from '../../extensions/types/tui.js';\nimport { TuiExtensionSurface } from './surface.js';\nimport { registerTuiToolRenderer } from './tool-renderers.js';\n\nconst MAX_WIDGET_LINES = 10;\nconst WIDGET_TRUNCATED_LINE = '... (widget truncated)';\n\nexport interface TuiExtensionHostDeps {\n  extensionId: string;\n  surface: TuiExtensionSurface;\n  getSessionKey: () => string;\n  notify: (message: string, level?: TuiNotifyLevel) => void;\n  onTerminalInputAdded: (handler: TuiTerminalInputHandler) => () => void;\n  showOverlay: (component: Component) => void;\n  hideOverlay: () => void;\n  custom: <T>(factory: TuiCustomFactory<T>, options?: TuiCustomOptions) => Promise<T>;\n  createWidgetComponent: (factory: TuiWidgetFactory) => Component & { dispose?(): void };\n  setFooter: (factory: TuiFooterFactory | undefined) => void;\n  setHeader: (factory: TuiHeaderFactory | undefined) => void;\n  setTitle: (title: string) => void;\n  pasteToEditor: (text: string) => void;\n  setEditorText: (text: string) => void;\n  getEditorText: () => string;\n  editor: (title: string, prefill?: string) => Promise<string | undefined>;\n  setEditorComponent: (factory: TuiEditorFactory | undefined) => void;\n  getEditorComponent: () => TuiEditorFactory | undefined;\n  getThemeObject: () => TuiTheme;\n  getAllThemes: () => TuiThemeInfo[];\n  getTheme: (name: string) => TuiTheme | undefined;\n  setTheme: (theme: string) => TuiSetThemeResult;\n  getToolsExpanded: () => boolean;\n  setToolsExpanded: (expanded: boolean) => void;\n  select: (\n    title: string,\n    options: string[],\n    opts?: TuiDialogOptions,\n  ) => Promise<string | undefined>;\n  confirm: (title: string, message: string, opts?: TuiDialogOptions) => Promise<boolean>;\n  input: (\n    title: string,\n    placeholder?: string,\n    opts?: TuiDialogOptions,\n  ) => Promise<string | undefined>;\n  onAutocompleteProviderAdded: (provider: TuiAutocompleteProvider) => () => void;\n  onAutocompleteProviderFactoryAdded: (factory: TuiAutocompleteProviderFactory) => () => void;\n  onMessageRendererAdded: (customType: string, renderer: TuiMessageRenderer) => () => void;\n  onSlashCommandAdded: (\n    name: string,\n    description: string,\n    handler: TuiSlashCommandHandler,\n  ) => () => void;\n  onShortcutAdded: (\n    key: string,\n    description: string,\n    handler: TuiShortcutHandler,\n  ) => () => void;\n  setWorkingMessage: (message?: string) => void;\n  setWorkingVisible: (visible: boolean) => void;\n  setWorkingIndicator: (options?: TuiWorkingIndicatorOptions) => void;\n  setHiddenThinkingLabel: (label?: string) => void;\n  onInvalidate: () => void;\n}\n\nexport function createTuiExtensionHost(deps: TuiExtensionHostDeps): TuiExtensionHostContract {\n  const widgetKey = (key: string) => `${deps.extensionId}:${key}`;\n  const setWidgetLines = (\n    map: Map<string, string[]>,\n    fullKey: string,\n    lines: string[] | null | undefined,\n    options: { bounded?: boolean } = {},\n  ) => {\n    if (!lines || lines.length === 0) {\n      map.delete(fullKey);\n    } else {\n      map.set(fullKey, options.bounded ? boundedWidgetLines(lines) : lines);\n    }\n  };\n\n  const boundedWidgetLines = (lines: string[]): string[] => {\n    if (lines.length <= MAX_WIDGET_LINES) return lines;\n    return [...lines.slice(0, MAX_WIDGET_LINES), WIDGET_TRUNCATED_LINE];\n  };\n\n  const disposeComponent = (component: { dispose?(): void } | undefined) => {\n    try {\n      component?.dispose?.();\n    } catch {\n      // Ignore extension component cleanup failures.\n    }\n  };\n\n  const clearWidgetKey = (fullKey: string) => {\n    deps.surface.headerWidgets.delete(fullKey);\n    deps.surface.footerWidgets.delete(fullKey);\n    const headerComponent = deps.surface.headerWidgetComponents.get(fullKey);\n    const footerComponent = deps.surface.footerWidgetComponents.get(fullKey);\n    deps.surface.headerWidgetComponents.delete(fullKey);\n    deps.surface.footerWidgetComponents.delete(fullKey);\n    disposeComponent(headerComponent);\n    disposeComponent(footerComponent);\n  };\n\n  return {\n    extensionId: deps.extensionId,\n\n    get theme() {\n      return deps.getThemeObject();\n    },\n\n    setFooterWidget(key, lines) {\n      const fullKey = widgetKey(key);\n      setWidgetLines(deps.surface.footerWidgets, fullKey, lines);\n      deps.onInvalidate();\n    },\n\n    setHeaderWidget(key, lines) {\n      const fullKey = widgetKey(key);\n      setWidgetLines(deps.surface.headerWidgets, fullKey, lines);\n      deps.onInvalidate();\n    },\n\n    setWidget(key, content, options) {\n      const fullKey = widgetKey(key);\n      clearWidgetKey(fullKey);\n      if (!content) {\n        deps.onInvalidate();\n        return;\n      }\n      if (typeof content === 'function') {\n        const target = options?.placement === 'belowEditor'\n          ? deps.surface.footerWidgetComponents\n          : deps.surface.headerWidgetComponents;\n        target.set(fullKey, deps.createWidgetComponent(content as TuiWidgetFactory));\n      } else {\n        const target = options?.placement === 'belowEditor'\n          ? deps.surface.footerWidgets\n          : deps.surface.headerWidgets;\n        setWidgetLines(target, fullKey, content, { bounded: true });\n      }\n      deps.onInvalidate();\n    },\n\n    setFooter(factory) {\n      deps.setFooter(factory);\n    },\n\n    setHeader(factory) {\n      deps.setHeader(factory);\n    },\n\n    addAutocompleteProvider(providerOrFactory) {\n      if (providerOrFactory.length <= 1) {\n        return deps.onAutocompleteProviderFactoryAdded(\n          providerOrFactory as TuiAutocompleteProviderFactory,\n        );\n      }\n      return deps.onAutocompleteProviderAdded(providerOrFactory as TuiAutocompleteProvider);\n    },\n\n    registerToolRenderer(toolName, renderer) {\n      return registerTuiToolRenderer(toolName, renderer);\n    },\n\n    registerMessageRenderer(customType, renderer) {\n      return deps.onMessageRendererAdded(customType, renderer as TuiMessageRenderer);\n    },\n\n    registerSlashCommand(name, description, handler) {\n      return deps.onSlashCommandAdded(name, description, handler);\n    },\n\n    registerShortcut(key, description, handler) {\n      return deps.onShortcutAdded(key, description, handler);\n    },\n\n    notify(message, level) {\n      deps.notify(message, level);\n    },\n\n    onTerminalInput(handler) {\n      return deps.onTerminalInputAdded(handler);\n    },\n\n    showOverlay(component) {\n      deps.showOverlay(component as Component);\n    },\n\n    hideOverlay() {\n      deps.hideOverlay();\n    },\n\n    custom(factory, options) {\n      return deps.custom(factory, options);\n    },\n\n    setTitle(title) {\n      deps.setTitle(title);\n    },\n\n    pasteToEditor(text) {\n      deps.pasteToEditor(text);\n    },\n\n    setEditorText(text) {\n      deps.setEditorText(text);\n    },\n\n    getEditorText() {\n      return deps.getEditorText();\n    },\n\n    editor(title, prefill) {\n      return deps.editor(title, prefill);\n    },\n\n    setEditorComponent(factory) {\n      deps.setEditorComponent(factory);\n    },\n\n    getEditorComponent() {\n      return deps.getEditorComponent();\n    },\n\n    getAllThemes() {\n      return deps.getAllThemes();\n    },\n\n    getTheme(name) {\n      return deps.getTheme(name);\n    },\n\n    setTheme(theme) {\n      return deps.setTheme(theme);\n    },\n\n    getToolsExpanded() {\n      return deps.getToolsExpanded();\n    },\n\n    setToolsExpanded(expanded) {\n      deps.setToolsExpanded(expanded);\n    },\n\n    select(title, options, opts) {\n      return deps.select(title, options, opts);\n    },\n\n    confirm(title, message, opts) {\n      return deps.confirm(title, message, opts);\n    },\n\n    input(title, placeholder, opts) {\n      return deps.input(title, placeholder, opts);\n    },\n\n    setStatus(key, text) {\n      const fullKey = widgetKey(key);\n      if (!text) {\n        deps.surface.statusSlots.delete(fullKey);\n      } else {\n        deps.surface.statusSlots.set(fullKey, text);\n      }\n      deps.onInvalidate();\n    },\n\n    setHiddenThinkingLabel(label) {\n      deps.setHiddenThinkingLabel(label ?? undefined);\n      deps.onInvalidate();\n    },\n\n    setWorkingMessage(message) {\n      deps.setWorkingMessage(message ?? undefined);\n      deps.onInvalidate();\n    },\n\n    setWorkingVisible(visible) {\n      deps.setWorkingVisible(visible);\n      deps.onInvalidate();\n    },\n\n    setWorkingIndicator(options) {\n      deps.setWorkingIndicator(options ?? undefined);\n      deps.onInvalidate();\n    },\n  };\n}\n\nexport async function invokeTuiExtensionRegistrars(\n  registrars: ReadonlyArray<{ extensionId: string; register: TuiExtensionRegistrar }>,\n  createHost: (extensionId: string) => TuiExtensionHostContract,\n  onError?: (extensionId: string, errorMessage: string) => void,\n): Promise<void> {\n  for (const { extensionId, register } of registrars) {\n    try {\n      await register(createHost(extensionId));\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err);\n      onError?.(extensionId, errorMessage);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/src/tui/extension-host/load-extensions.d.ts

@@ -1,3 +1,8 @@
 import type { ExtensionRegistryImpl } from '../../extensions/loader.js';
 /** Load activated extensions for embedded TUI (shared registry with AgentService). */
-export declare function loadExtensionsForTuiLocalMode(): Promise<ExtensionRegistryImpl>;
+export declare function loadExtensionsForTuiLocalMode(runtime?: {
+    setLabel?: (entryId: string, label: string | undefined) => void;
+    sendUserMessage?: import('../../extensions/types/core.js').ExtensionRuntime['sendUserMessage'];
+    appendEntry?: import('../../extensions/types/core.js').ExtensionRuntime['appendEntry'];
+    sendMessage?: import('../../extensions/types/core.js').ExtensionRuntime['sendMessage'];
+}): Promise<ExtensionRegistryImpl>;

package/dist/src/tui/extension-host/load-extensions.js

@@ -2,21 +2,22 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveExtensionsDir } from "../../config/paths.js";
 import { loadConfig } from "../../config/loader.js";
-import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
 import { ExtensionLoader } from "../../extensions/loader.js";
+import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
 import "../../config/index.js";
 //#region src/tui/extension-host/load-extensions.ts
 init_paths();
 init_logger();
 const log = createLogger("TUI:Extensions");
 /** Load activated extensions for embedded TUI (shared registry with AgentService). */
-async function loadExtensionsForTuiLocalMode() {
+async function loadExtensionsForTuiLocalMode(runtime) {
 	const config = loadConfig();
 	const loader = new ExtensionLoader({
-		workspaceDir: getWorkspacePath(config) ?? process.cwd(),
+		workspaceDir: getWorkspacePath(config),
 		extensionsDir: resolveExtensionsDir()
 	});
 	loader.setConfig(config);
+	if (runtime) loader.setRuntimeContext(runtime);
 	try {
 		await loader.loadByActivationPlan();
 		const registry = loader.getRegistry();

package/dist/src/tui/extension-host/load-extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-extensions.js","names":[],"sources":["../../../../src/tui/extension-host/load-extensions.ts"],"sourcesContent":["import { ExtensionLoader } from '../../extensions/loader.js';\nimport type { ExtensionRegistryImpl } from '../../extensions/loader.js';\nimport { loadConfig, getWorkspacePath } from '../../config/index.js';\nimport { resolveExtensionsDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('TUI:Extensions');\n\n/** Load activated extensions for embedded TUI (shared registry with AgentService). */\nexport async function loadExtensionsForTuiLocalMode(): Promise<ExtensionRegistryImpl> {\n  const config = loadConfig();\n  const workspaceDir = getWorkspacePath(config) ?? process.cwd();\n  const loader = new ExtensionLoader({\n    workspaceDir,\n    extensionsDir: resolveExtensionsDir(),\n  });\n  loader.setConfig(config);\n  try {\n    await loader.loadByActivationPlan();\n    const registry = loader.getRegistry();\n    log.info(\n      {\n        extensions: registry.extensions.size,\n        tuiRegistrations: registry.getTuiRegistrations().length,\n      },\n      'Extensions loaded for local TUI',\n    );\n    return registry;\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, errorMessage }, `Extension load for TUI failed: ${errorMessage}`);\n    return loader.getRegistry();\n  }\n}\n"],"mappings":";;;;;;;;YAG6D;aACR;AAErD,MAAM,MAAM,aAAa,iBAAiB;;AAG1C,eAAsB,gCAAgE;CACpF,MAAM,SAAS,YAAY;CAE3B,MAAM,SAAS,IAAI,gBAAgB;EACjC,cAFmB,iBAAiB,OAAO,IAAI,QAAQ,KAAK;EAG5D,eAAe,sBAAsB;EACtC,CAAC;AACF,QAAO,UAAU,OAAO;AACxB,KAAI;AACF,QAAM,OAAO,sBAAsB;EACnC,MAAM,WAAW,OAAO,aAAa;AACrC,MAAI,KACF;GACE,YAAY,SAAS,WAAW;GAChC,kBAAkB,SAAS,qBAAqB,CAAC;GAClD,EACD,kCACD;AACD,SAAO;UACA,KAAK;EACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACrE,MAAI,KAAK;GAAE;GAAK;GAAc,EAAE,kCAAkC,eAAe;AACjF,SAAO,OAAO,aAAa"}
+{"version":3,"file":"load-extensions.js","names":[],"sources":["../../../../src/tui/extension-host/load-extensions.ts"],"sourcesContent":["import { ExtensionLoader } from '../../extensions/loader.js';\nimport type { ExtensionRegistryImpl } from '../../extensions/loader.js';\nimport { loadConfig, getWorkspacePath } from '../../config/index.js';\nimport { resolveExtensionsDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('TUI:Extensions');\n\n/** Load activated extensions for embedded TUI (shared registry with AgentService). */\nexport async function loadExtensionsForTuiLocalMode(runtime?: {\n  setLabel?: (entryId: string, label: string | undefined) => void;\n  sendUserMessage?: import('../../extensions/types/core.js').ExtensionRuntime['sendUserMessage'];\n  appendEntry?: import('../../extensions/types/core.js').ExtensionRuntime['appendEntry'];\n  sendMessage?: import('../../extensions/types/core.js').ExtensionRuntime['sendMessage'];\n}): Promise<ExtensionRegistryImpl> {\n  const config = loadConfig();\n  const workspaceDir = getWorkspacePath(config);\n  const loader = new ExtensionLoader({\n    workspaceDir,\n    extensionsDir: resolveExtensionsDir(),\n  });\n  loader.setConfig(config);\n  if (runtime) {\n    loader.setRuntimeContext(runtime);\n  }\n  try {\n    await loader.loadByActivationPlan();\n    const registry = loader.getRegistry();\n    log.info(\n      {\n        extensions: registry.extensions.size,\n        tuiRegistrations: registry.getTuiRegistrations().length,\n      },\n      'Extensions loaded for local TUI',\n    );\n    return registry;\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.warn({ err, errorMessage }, `Extension load for TUI failed: ${errorMessage}`);\n    return loader.getRegistry();\n  }\n}\n"],"mappings":";;;;;;;;YAG6D;aACR;AAErD,MAAM,MAAM,aAAa,iBAAiB;;AAG1C,eAAsB,8BAA8B,SAKjB;CACjC,MAAM,SAAS,YAAY;CAE3B,MAAM,SAAS,IAAI,gBAAgB;EACjC,cAFmB,iBAAiB,OAExB;EACZ,eAAe,sBAAsB;EACtC,CAAC;AACF,QAAO,UAAU,OAAO;AACxB,KAAI,QACF,QAAO,kBAAkB,QAAQ;AAEnC,KAAI;AACF,QAAM,OAAO,sBAAsB;EACnC,MAAM,WAAW,OAAO,aAAa;AACrC,MAAI,KACF;GACE,YAAY,SAAS,WAAW;GAChC,kBAAkB,SAAS,qBAAqB,CAAC;GAClD,EACD,kCACD;AACD,SAAO;UACA,KAAK;EACZ,MAAM,eAAe,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AACrE,MAAI,KAAK;GAAE;GAAK;GAAc,EAAE,kCAAkC,eAAe;AACjF,SAAO,OAAO,aAAa"}

package/dist/src/tui/extension-host/runtime-context.d.ts

@@ -0,0 +1,21 @@
+import type { KeybindingsManager, OverlayOptions, TUI } from '@earendil-works/pi-tui';
+import type { TuiContextUsage, TuiCustomComponent, TuiCustomFactory, TuiCustomOptions, TuiModelInfo, TuiModelRegistry, TuiNotifyLevel, TuiReadonlySessionManager, TuiReasoningLevel, TuiThinkingLevel, TuiVerboseLevel } from '../../extensions/types/tui.js';
+import type { ChatLog } from '../components/chat-log.js';
+import type { TuiState } from '../tui-types.js';
+export declare const STALE_EXTENSION_CONTEXT_MESSAGE = "This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().";
+export declare function boundedWidgetLines(lines: string[]): string[];
+export declare function createEmptySessionManager(cwd: string, sessionKey: string): TuiReadonlySessionManager;
+export declare function createDefaultModelRegistry(): TuiModelRegistry;
+export declare function resolveCustomOverlayOptions(component: TuiCustomComponent, customOpts?: TuiCustomOptions): OverlayOptions | undefined;
+export declare function invokeCustomFactory<T>(factory: TuiCustomFactory<T>, tui: TUI, keybindings: KeybindingsManager | undefined, done: (result: T) => void): TuiCustomComponent | Promise<TuiCustomComponent>;
+export declare function disposeComponent(component: {
+    dispose?(): void;
+} | undefined): void;
+export declare function notifyInChatLog(chatLog: ChatLog, tui: TUI, message: string, level?: TuiNotifyLevel): void;
+export declare function isTuiIdle(state: Partial<TuiState>): boolean;
+export declare function hasPendingTuiMessages(state: Partial<TuiState>): boolean;
+export declare function getTuiContextUsage(state: Partial<TuiState>): TuiContextUsage | undefined;
+export declare function getTuiModelInfo(state: Partial<TuiState>): TuiModelInfo | undefined;
+export declare function getTuiThinkingLevel(state: Partial<TuiState>): TuiThinkingLevel | undefined;
+export declare function getTuiReasoningLevel(state: Partial<TuiState>): TuiReasoningLevel | undefined;
+export declare function getTuiVerboseLevel(state: Partial<TuiState>): TuiVerboseLevel | undefined;

package/dist/src/tui/extension-host/runtime-context.js

@@ -0,0 +1,152 @@
+import { getAllModels, getApiKey, init_providers } from "../../providers/index.js";
+import { theme } from "../theme.js";
+import { computeContextUsagePercent } from "../tui-context-usage.js";
+//#region src/tui/extension-host/runtime-context.ts
+init_providers();
+const BUSY_ACTIVITY_STATUSES = new Set([
+	"sending",
+	"waiting",
+	"streaming",
+	"running",
+	"compacting"
+]);
+const MAX_WIDGET_LINES = 10;
+const WIDGET_TRUNCATED_LINE = "... (widget truncated)";
+const STALE_EXTENSION_CONTEXT_MESSAGE = "This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().";
+function boundedWidgetLines(lines) {
+	if (lines.length <= MAX_WIDGET_LINES) return lines;
+	return [...lines.slice(0, MAX_WIDGET_LINES), WIDGET_TRUNCATED_LINE];
+}
+function createEmptySessionManager(cwd, sessionKey) {
+	return {
+		getEntries: () => [],
+		getBranch: () => [],
+		getLeafEntry: () => void 0,
+		getLeafId: () => null,
+		getEntry: () => void 0,
+		getLabel: () => void 0,
+		getHeader: () => null,
+		getTree: () => [],
+		getSessionId: () => sessionKey,
+		getSessionFile: () => void 0,
+		getSessionDir: () => void 0,
+		getSessionName: () => void 0,
+		getCwd: () => cwd
+	};
+}
+function createDefaultModelRegistry() {
+	return {
+		find(provider, modelId) {
+			return getAllModels().find((model) => model.provider === provider && model.id === modelId);
+		},
+		async getApiKeyAndHeaders(model) {
+			const provider = typeof model.provider === "string" ? model.provider : void 0;
+			if (!provider) return {
+				ok: false,
+				error: "Model provider is missing."
+			};
+			try {
+				return {
+					ok: true,
+					apiKey: await getApiKey(provider),
+					headers: {}
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: error instanceof Error ? error.message : String(error)
+				};
+			}
+		}
+	};
+}
+function resolveCustomOverlayOptions(component, customOpts) {
+	const configured = typeof customOpts?.overlayOptions === "function" ? customOpts.overlayOptions() : customOpts?.overlayOptions;
+	if (configured) return configured;
+	const width = component.width;
+	if (typeof width === "number") return { width };
+	if (typeof width === "string" && /^\d+%$/.test(width)) return { width };
+}
+function invokeCustomFactory(factory, tui, keybindings, done) {
+	if (factory.length <= 1) return factory(done);
+	return factory(tui, theme, keybindings, done);
+}
+function disposeComponent(component) {
+	try {
+		component?.dispose?.();
+	} catch {}
+}
+function notifyInChatLog(chatLog, tui, message, level) {
+	const prefix = level === "error" ? theme.error("✖ ") : level === "warn" || level === "warning" ? "⚠ " : "";
+	chatLog.addSystem(`${prefix}${message}`);
+	tui.requestRender();
+}
+function isTuiIdle(state) {
+	return state.activeRunId == null && !state.isCompacting && !BUSY_ACTIVITY_STATUSES.has(state.activityStatus);
+}
+function hasPendingTuiMessages(state) {
+	return (state.messageFollowUpQueue?.length ?? 0) > 0 || (state.steeringQueue?.length ?? 0) > 0 || (state.compactionQueue?.length ?? 0) > 0;
+}
+function getTuiContextUsage(state) {
+	const sessionInfo = state.sessionInfo;
+	if (!sessionInfo) return void 0;
+	const estimatedTokens = sessionInfo.totalTokens ?? sessionInfo.contextTokens ?? null;
+	const contextWindow = sessionInfo.contextWindow ?? null;
+	if (estimatedTokens == null && contextWindow == null) return void 0;
+	const usagePercent = sessionInfo.contextUsagePercent ?? computeContextUsagePercent(estimatedTokens, contextWindow);
+	return {
+		estimatedTokens,
+		tokens: estimatedTokens,
+		contextWindow,
+		usagePercent,
+		percent: usagePercent
+	};
+}
+function getTuiModelInfo(state) {
+	const sessionInfo = state.sessionInfo;
+	if (!sessionInfo) return void 0;
+	const provider = sessionInfo.modelProvider?.trim() || void 0;
+	const id = sessionInfo.model?.trim();
+	if (!id && !provider) return void 0;
+	return {
+		...provider ? { provider } : {},
+		id: id || provider,
+		ref: provider && id ? `${provider}/${id}` : id ?? provider,
+		contextWindow: sessionInfo.contextWindow ?? null
+	};
+}
+function getTuiThinkingLevel(state) {
+	const level = state.sessionInfo?.thinkingLevel?.trim();
+	switch (level) {
+		case "off":
+		case "minimal":
+		case "low":
+		case "medium":
+		case "high":
+		case "xhigh":
+		case "adaptive": return level;
+		default: return;
+	}
+}
+function getTuiReasoningLevel(state) {
+	const level = state.sessionInfo?.reasoningLevel?.trim();
+	switch (level) {
+		case "off":
+		case "on":
+		case "stream": return level;
+		default: return;
+	}
+}
+function getTuiVerboseLevel(state) {
+	const level = state.sessionInfo?.verboseLevel?.trim();
+	switch (level) {
+		case "off":
+		case "on":
+		case "full": return level;
+		default: return;
+	}
+}
+//#endregion
+export { STALE_EXTENSION_CONTEXT_MESSAGE, boundedWidgetLines, createDefaultModelRegistry, createEmptySessionManager, disposeComponent, getTuiContextUsage, getTuiModelInfo, getTuiReasoningLevel, getTuiThinkingLevel, getTuiVerboseLevel, hasPendingTuiMessages, invokeCustomFactory, isTuiIdle, notifyInChatLog, resolveCustomOverlayOptions };
+
+//# sourceMappingURL=runtime-context.js.map

package/dist/src/tui/extension-host/runtime-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.js","names":["getProviderApiKey"],"sources":["../../../../src/tui/extension-host/runtime-context.ts"],"sourcesContent":["import type { KeybindingsManager, OverlayOptions, TUI } from '@earendil-works/pi-tui';\n\nimport type {\n  TuiContextUsage,\n  TuiCustomComponent,\n  TuiCustomFactory,\n  TuiCustomFullFactory,\n  TuiCustomLegacyFactory,\n  TuiCustomOptions,\n  TuiModelInfo,\n  TuiModelRegistry,\n  TuiModelRegistryModel,\n  TuiNotifyLevel,\n  TuiReadonlySessionManager,\n  TuiReasoningLevel,\n  TuiThinkingLevel,\n  TuiVerboseLevel,\n} from '../../extensions/types/tui.js';\nimport { getAllModels, getApiKey as getProviderApiKey } from '../../providers/index.js';\nimport type { ChatLog } from '../components/chat-log.js';\nimport type { TuiState } from '../tui-types.js';\nimport { computeContextUsagePercent } from '../tui-context-usage.js';\nimport { theme } from '../theme.js';\n\nconst BUSY_ACTIVITY_STATUSES = new Set<Partial<TuiState>['activityStatus']>([\n  'sending',\n  'waiting',\n  'streaming',\n  'running',\n  'compacting',\n]);\n\nconst MAX_WIDGET_LINES = 10;\nconst WIDGET_TRUNCATED_LINE = '... (widget truncated)';\nexport const STALE_EXTENSION_CONTEXT_MESSAGE =\n  'This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().';\n\nexport function boundedWidgetLines(lines: string[]): string[] {\n  if (lines.length <= MAX_WIDGET_LINES) return lines;\n  return [...lines.slice(0, MAX_WIDGET_LINES), WIDGET_TRUNCATED_LINE];\n}\n\nexport function createEmptySessionManager(cwd: string, sessionKey: string): TuiReadonlySessionManager {\n  return {\n    getEntries: () => [],\n    getBranch: () => [],\n    getLeafEntry: () => undefined,\n    getLeafId: () => null,\n    getEntry: () => undefined,\n    getLabel: () => undefined,\n    getHeader: () => null,\n    getTree: () => [],\n    getSessionId: () => sessionKey,\n    getSessionFile: () => undefined,\n    getSessionDir: () => undefined,\n    getSessionName: () => undefined,\n    getCwd: () => cwd,\n  };\n}\n\nexport function createDefaultModelRegistry(): TuiModelRegistry {\n  return {\n    find(provider, modelId) {\n      return getAllModels().find(\n        (model) => model.provider === provider && model.id === modelId,\n      ) as unknown as TuiModelRegistryModel | undefined;\n    },\n    async getApiKeyAndHeaders(model) {\n      const provider = typeof model.provider === 'string' ? model.provider : undefined;\n      if (!provider) return { ok: false, error: 'Model provider is missing.' };\n      try {\n        const apiKey = await getProviderApiKey(provider);\n        return { ok: true, apiKey, headers: {} };\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return { ok: false, error: errorMessage };\n      }\n    },\n  };\n}\n\nexport function resolveCustomOverlayOptions(\n  component: TuiCustomComponent,\n  customOpts?: TuiCustomOptions,\n): OverlayOptions | undefined {\n  const configured =\n    typeof customOpts?.overlayOptions === 'function'\n      ? customOpts.overlayOptions()\n      : customOpts?.overlayOptions;\n  if (configured) return configured as OverlayOptions;\n\n  const width = (component as { width?: unknown }).width;\n  if (typeof width === 'number') return { width };\n  if (typeof width === 'string' && /^\\d+%$/.test(width)) {\n    return { width: width as `${number}%` };\n  }\n  return undefined;\n}\n\nexport function invokeCustomFactory<T>(\n  factory: TuiCustomFactory<T>,\n  tui: TUI,\n  keybindings: KeybindingsManager | undefined,\n  done: (result: T) => void,\n): TuiCustomComponent | Promise<TuiCustomComponent> {\n  if (factory.length <= 1) {\n    return (factory as TuiCustomLegacyFactory<T>)(done);\n  }\n  return (factory as TuiCustomFullFactory<T>)(tui, theme, keybindings, done);\n}\n\nexport function disposeComponent(component: { dispose?(): void } | undefined): void {\n  try {\n    component?.dispose?.();\n  } catch {\n    // Ignore extension component cleanup failures.\n  }\n}\n\nexport function notifyInChatLog(chatLog: ChatLog, tui: TUI, message: string, level?: TuiNotifyLevel) {\n  const prefix =\n    level === 'error'\n      ? theme.error('✖ ')\n      : level === 'warn' || level === 'warning'\n        ? '⚠ '\n        : '';\n  chatLog.addSystem(`${prefix}${message}`);\n  tui.requestRender();\n}\n\nexport function isTuiIdle(state: Partial<TuiState>): boolean {\n  return (\n    state.activeRunId == null &&\n    !state.isCompacting &&\n    !BUSY_ACTIVITY_STATUSES.has(state.activityStatus)\n  );\n}\n\nexport function hasPendingTuiMessages(state: Partial<TuiState>): boolean {\n  return (\n    (state.messageFollowUpQueue?.length ?? 0) > 0 ||\n    (state.steeringQueue?.length ?? 0) > 0 ||\n    (state.compactionQueue?.length ?? 0) > 0\n  );\n}\n\nexport function getTuiContextUsage(state: Partial<TuiState>): TuiContextUsage | undefined {\n  const sessionInfo = state.sessionInfo;\n  if (!sessionInfo) return undefined;\n  const estimatedTokens = sessionInfo.totalTokens ?? sessionInfo.contextTokens ?? null;\n  const contextWindow = sessionInfo.contextWindow ?? null;\n  if (estimatedTokens == null && contextWindow == null) return undefined;\n  const usagePercent =\n    sessionInfo.contextUsagePercent ??\n    computeContextUsagePercent(estimatedTokens, contextWindow);\n  return {\n    estimatedTokens,\n    tokens: estimatedTokens,\n    contextWindow,\n    usagePercent,\n    percent: usagePercent,\n  };\n}\n\nexport function getTuiModelInfo(state: Partial<TuiState>): TuiModelInfo | undefined {\n  const sessionInfo = state.sessionInfo;\n  if (!sessionInfo) return undefined;\n  const provider = sessionInfo.modelProvider?.trim() || undefined;\n  const id = sessionInfo.model?.trim();\n  if (!id && !provider) return undefined;\n  return {\n    ...(provider ? { provider } : {}),\n    id: id || provider!,\n    ref: provider && id ? `${provider}/${id}` : (id ?? provider!),\n    contextWindow: sessionInfo.contextWindow ?? null,\n  };\n}\n\nexport function getTuiThinkingLevel(state: Partial<TuiState>): TuiThinkingLevel | undefined {\n  const level = state.sessionInfo?.thinkingLevel?.trim();\n  switch (level) {\n    case 'off':\n    case 'minimal':\n    case 'low':\n    case 'medium':\n    case 'high':\n    case 'xhigh':\n    case 'adaptive':\n      return level;\n    default:\n      return undefined;\n  }\n}\n\nexport function getTuiReasoningLevel(state: Partial<TuiState>): TuiReasoningLevel | undefined {\n  const level = state.sessionInfo?.reasoningLevel?.trim();\n  switch (level) {\n    case 'off':\n    case 'on':\n    case 'stream':\n      return level;\n    default:\n      return undefined;\n  }\n}\n\nexport function getTuiVerboseLevel(state: Partial<TuiState>): TuiVerboseLevel | undefined {\n  const level = state.sessionInfo?.verboseLevel?.trim();\n  switch (level) {\n    case 'off':\n    case 'on':\n    case 'full':\n      return level;\n    default:\n      return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/src/tui/extension-host/runtime.d.ts

@@ -1,21 +1,30 @@
-import type { Component, TUI } from '@earendil-works/pi-tui';
-import { type AutocompleteItem, type AutocompleteProvider } from '@earendil-works/pi-tui';
+import { type Component, type AutocompleteItem, type AutocompleteProvider, type KeybindingsManager, type OverlayHandle, type OverlayOptions, type TUI } from '@earendil-works/pi-tui';
 import type { ExtensionRegistryImpl } from '../../extensions/loader.js';
-import type { TuiAutocompleteSuggestion, TuiSlashCommandHandler } from '../../extensions/types/tui.js';
+import type { TuiAutocompleteSuggestion, TuiCompactOptions, TuiCompactResult, TuiEditorFactory, TuiForkOptions, TuiModelRegistry, TuiNavigateTreeOptions, TuiNewSessionOptions, TuiReasoningLevel, TuiReplacedSessionContext, TuiReplacementResult, TuiReadonlySessionManager, TuiSlashCommandContext, TuiShortcutHandler, TuiSlashCommandHandler, TuiSwitchSessionOptions, TuiSystemPromptOptions, TuiTerminalInputHandler, TuiSetThemeResult, TuiTheme, TuiThemeInfo, TuiThinkingLevel, TuiVerboseLevel, TuiWorkingIndicatorOptions } from '../../extensions/types/tui.js';
 import type { ChatLog } from '../components/chat-log.js';
 import type { TuiHeader } from '../components/tui-header.js';
 import type { TuiBottomBar } from '../components/tui-bottom-bar.js';
 import type { TuiState } from '../tui-types.js';
 import { TuiExtensionSurface } from './surface.js';
 export interface TuiExtensionSlashCommand {
+    originalName: string;
     name: string;
     description: string;
     handler: TuiSlashCommandHandler;
+    getContext: () => TuiSlashCommandContext;
+}
+export interface TuiExtensionShortcut {
+    key: string;
+    description: string;
+    handler: TuiShortcutHandler;
+    getContext: () => TuiSlashCommandContext;
 }
 export interface TuiExtensionRuntime {
     surface: TuiExtensionSurface;
     slashCommands: TuiExtensionSlashCommand[];
+    shortcuts: TuiExtensionShortcut[];
     autocompleteProvider: AutocompleteProvider;
+    handleShortcut(data: string): boolean;
     activate(): Promise<void>;
     dispose(): void;
 }
@@ -30,11 +39,50 @@ export interface CreateTuiExtensionRuntimeOptions {
         name: string;
         description: string;
     }>;
+    keybindings?: KeybindingsManager;
+    addInputListener?: (handler: TuiTerminalInputHandler) => () => void;
+    setTitle?: (title: string) => void;
+    pasteToEditor?: (text: string) => void;
+    setEditorText?: (text: string) => void;
+    getEditorText?: () => string;
+    setEditorComponent?: (factory: TuiEditorFactory | undefined) => void;
+    getEditorComponent?: () => TuiEditorFactory | undefined;
+    getThemeObject?: () => TuiTheme;
+    getAllThemes?: () => TuiThemeInfo[];
+    getTheme?: (name: string) => TuiTheme | undefined;
+    setTheme?: (theme: string) => TuiSetThemeResult;
+    getToolsExpanded?: () => boolean;
+    setToolsExpanded?: (expanded: boolean) => void;
+    getAvailableProviderCount?: () => number;
+    getActiveSignal?: () => AbortSignal | undefined;
+    isProjectTrusted?: () => boolean;
+    getSessionManager?: () => TuiReadonlySessionManager;
+    getModelRegistry?: () => TuiModelRegistry;
+    getSystemPrompt?: () => string;
+    getSystemPromptOptions?: () => TuiSystemPromptOptions;
+    waitForIdle?: () => Promise<void>;
+    newSession?: (options?: TuiNewSessionOptions) => Promise<TuiReplacementResult>;
+    forkSession?: (entryId: string, options?: TuiForkOptions) => Promise<TuiReplacementResult>;
+    navigateTree?: (targetId: string, options?: TuiNavigateTreeOptions) => Promise<TuiReplacementResult>;
+    switchSession?: (sessionPath: string, options?: TuiSwitchSessionOptions) => Promise<TuiReplacementResult>;
+    reload?: () => Promise<void>;
+    sendUserMessage?: TuiReplacedSessionContext['sendUserMessage'];
+    sendMessage?: TuiReplacedSessionContext['sendMessage'];
     cwd: string;
     fdPath: string | null;
-    openOverlay: (component: Component) => void;
+    openOverlay: (component: Component, options?: OverlayOptions) => OverlayHandle | void;
     closeOverlay: () => void;
     onInvalidate: () => void;
+    abortActive?: () => void | Promise<void>;
+    requestExit?: () => void;
+    compactSession?: (options?: TuiCompactOptions) => void | Promise<void | TuiCompactResult>;
+    setModel?: (modelRef: string) => void | Promise<void>;
+    setThinkingLevel?: (level: TuiThinkingLevel) => void | Promise<void>;
+    setReasoningLevel?: (level: TuiReasoningLevel) => void | Promise<void>;
+    setVerboseLevel?: (level: TuiVerboseLevel) => void | Promise<void>;
+    setWorkingMessage?: (message?: string) => void;
+    setWorkingVisible?: (visible: boolean) => void;
+    setWorkingIndicator?: (options?: TuiWorkingIndicatorOptions) => void;
 }
 declare function suggestionsToAutocompleteItems(suggestions: TuiAutocompleteSuggestion[]): AutocompleteItem[];
 export declare function createTuiExtensionRuntime(opts: CreateTuiExtensionRuntimeOptions): TuiExtensionRuntime;