catui-agent 1.0.0-beta.0

package/dist/modes/interactive/controllers/auth-provider-config-controller.d.ts

@@ -0,0 +1,64 @@
+/**
+ * [WHO]: Provides AuthProviderConfigController + AuthProviderConfigContext — interactive auth/provider configuration
+ * [FROM]: Depends on @catui/ai OAuth helpers, core/model/custom-providers, config paths, TUI components
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts and model-overlay providerConfig port
+ * [HERE]: modes/interactive/controllers/auth-provider-config-controller.ts — P5 auth/provider-config slice
+ *
+ * Owns interactive credential/config prompts and OAuth UI. It does not own model selection overlay;
+ * model-overlay consumes this controller through ProviderConfigPort and receives model application
+ * callbacks through a narrow bridge.
+ */
+import type { Model } from "@catui/ai/types";
+import type { Component, Container, TUI } from "@catui/tui";
+import type { ModelRegistry } from "../../../core/model-registry.js";
+import { type ProviderSelectorItem } from "../components/oauth-selector.js";
+type AnyModel = Model<any>;
+export interface AuthProviderConfigSurface {
+    showSelector(create: (done: () => void) => {
+        component: Component;
+        focus: Component;
+    }): void;
+    showStatus(message: string): void;
+    showError(message: string): void;
+    promptInput(title: string, placeholder?: string, opts?: {
+        initialValue?: string;
+    }): Promise<string | undefined>;
+    requestRender(): void;
+    getUi(): TUI;
+    getEditorContainer(): Container;
+    getEditor(): Component;
+    remountEditorShell(): void;
+}
+export interface AuthProviderModelBridge {
+    getCurrentModel(): AnyModel | undefined;
+    setCurrentModel(model: AnyModel): Promise<void>;
+    showModelSelector(initialSearchInput?: string, filterByProvider?: string): void;
+    applySelectedModel(model: AnyModel): Promise<void>;
+    updateAvailableProviderCount(): Promise<void>;
+}
+export interface AuthProviderConfigContext {
+    modelRegistry: ModelRegistry;
+    surface: AuthProviderConfigSurface;
+    modelBridge: AuthProviderModelBridge;
+}
+export declare class AuthProviderConfigController {
+    private readonly ctx;
+    constructor(ctx: AuthProviderConfigContext);
+    handleApiKeyCommand(): Promise<void>;
+    handleLoginCommand(text: string): Promise<void>;
+    ensureProviderConfiguredForSelection(model: AnyModel): Promise<boolean>;
+    handleProviderSelectionFromSelector(provider: string, done: () => void): Promise<void>;
+    showOAuthSelector(mode: "login" | "logout"): Promise<void>;
+    getLoginSelectorProviders(mode: "login" | "logout"): ProviderSelectorItem[];
+    private getStoredApiKey;
+    private resolveProviderId;
+    promptForProviderApiKey(provider: string, options?: {
+        title?: string;
+    }): Promise<boolean>;
+    private handleProviderCredentialsCommand;
+    private configureCustomProtocolProvider;
+    private refreshCurrentModelForProvider;
+    private selectConfiguredCustomProvider;
+    private showLoginDialog;
+}
+export {};

package/dist/modes/interactive/controllers/auth-provider-config-controller.js

@@ -0,0 +1 @@
+var R=Object.defineProperty;var d=(w,e)=>R(w,"name",{value:e,configurable:!0});import{getOAuthProviders as l}from"@catui/ai/oauth";import{getAuthPath as K,getModelsPath as P}from"../../../config.js";import{getCustomProtocolProviderBaseUrl as I,getCustomProtocolProviderDefinition as k,getCustomProtocolProviderModelName as C,isCustomProtocolProvider as y,saveCustomProtocolProviderApiKey as E,saveCustomProtocolProviderConfig as L}from"../../../core/model/custom-providers.js";import{CATUI_ALI_TOKEN_PLAN_ANTHROPIC_PROVIDER as S,CATUI_ALI_TOKEN_PLAN_OPENAI_PROVIDER as v}from"../../../catui-defaults.js";import{LoginDialogComponent as M}from"../components/login-dialog.js";import{OAuthSelectorComponent as b}from"../components/oauth-selector.js";import{ProviderSelectorComponent as $}from"../components/provider-selector.js";class W{static{d(this,"AuthProviderConfigController")}ctx;constructor(e){this.ctx=e}async handleApiKeyCommand(){await this.handleProviderCredentialsCommand()}async handleLoginCommand(e){const r=e.startsWith("/login ")?e.slice(7).trim():"";if(!r){this.showOAuthSelector("login");return}const t=this.resolveProviderId(r);if(!t){this.ctx.surface.showError(`Unknown provider: ${r}`);return}const s=l().find(o=>o.id===t);if(s){await this.showLoginDialog(s.id);return}await this.promptForProviderApiKey(t,{title:`Set API key for ${t}`})}async ensureProviderConfiguredForSelection(e){return y(e.provider)?this.configureCustomProtocolProvider(e.provider):!await this.ctx.modelRegistry.getApiKey(e)&&!this.ctx.modelRegistry.isUsingOAuth(e)?this.promptForProviderApiKey(e.provider,{title:`API key for ${e.provider}`}):!0}async handleProviderSelectionFromSelector(e,r){if(r(),this.ctx.surface.requestRender(),!y(e)){this.ctx.modelBridge.showModelSelector(void 0,e);return}try{if(!await this.configureCustomProtocolProvider(e,{force:!0})){this.ctx.surface.showStatus("Configuration cancelled");return}await this.selectConfiguredCustomProvider(e)}catch(t){this.ctx.surface.showError(t instanceof Error?t.message:String(t))}}async showOAuthSelector(e){const r=this.getLoginSelectorProviders(e);if(r.length===0){this.ctx.surface.showStatus(e==="login"?"No providers available.":"No providers logged in. Use /login first.");return}this.ctx.surface.showSelector(t=>{const s=new b(e,r,async o=>{if(t(),e==="login")l().find(a=>a.id===o)?await this.showLoginDialog(o):await this.promptForProviderApiKey(o,{title:`Set API key for ${o}`});else{const a=l().find(c=>c.id===o)?.name||o;try{this.ctx.modelRegistry.authStorage.logout(o),this.ctx.modelRegistry.refresh(),await this.ctx.modelBridge.updateAvailableProviderCount(),this.ctx.surface.showStatus(`Logged out of ${a}`)}catch(c){this.ctx.surface.showError(`Logout failed: ${c instanceof Error?c.message:String(c)}`)}}},()=>{t(),this.ctx.surface.requestRender()},{title:e==="login"?"Select provider to login or configure:":"Select provider to logout:"});return{component:s,focus:s}})}getLoginSelectorProviders(e){const r=l().map(i=>({id:i.id,name:i.name,authType:"oauth",loggedIn:this.ctx.modelRegistry.authStorage.get(i.id)?.type==="oauth"}));if(e==="logout")return r.filter(i=>i.loggedIn);const t=[...r],s=new Set(t.map(i=>i.id)),o=[{id:"openrouter",name:"OpenRouter"}];for(const i of o)s.has(i.id)||t.push({id:i.id,name:i.name,authType:"api_key",loggedIn:!!this.getStoredApiKey(i.id)});return t}getStoredApiKey(e){const r=this.ctx.modelRegistry.authStorage.get(e);return r?.type==="api_key"?r.key:void 0}resolveProviderId(e){const r=e.trim().toLowerCase();if(!r)return;const t=new Map;for(const s of this.ctx.modelRegistry.getAll())t.set(s.provider.toLowerCase(),s.provider);for(const s of l())t.set(s.id.toLowerCase(),s.id);return t.get(r)}async promptForProviderApiKey(e,r={}){const t=this.getStoredApiKey(e),s=r.title??`Update API key for ${e}`,o=await this.ctx.surface.promptInput(s,"API key",{initialValue:t});if(o===void 0)return this.ctx.surface.showStatus("Configuration cancelled"),!1;const i=o.trim();return i?(this.ctx.modelRegistry.authStorage.set(e,{type:"api_key",key:i}),e===v?this.ctx.modelRegistry.authStorage.set(S,{type:"api_key",key:i}):e===S&&this.ctx.modelRegistry.authStorage.set(v,{type:"api_key",key:i}),this.ctx.modelRegistry.refresh(),this.ctx.surface.showStatus(`Updated API key for ${e}`),!0):(this.ctx.surface.showStatus("Configuration cancelled"),!1)}async handleProviderCredentialsCommand(){const e=this.ctx.modelBridge.getCurrentModel();if(!e){this.ctx.modelRegistry.refresh();const t=this.ctx.modelRegistry.getAll(),s=[...new Set(t.map(o=>o.provider))].sort();if(s.length===0){this.ctx.surface.showStatus("No providers available");return}this.ctx.surface.showSelector(o=>{const i=new $(s,void 0,a=>{o(),(async()=>(await this.promptForProviderApiKey(a,{title:`Set API key for ${a}`}),this.ctx.modelRegistry.refresh(),this.ctx.modelBridge.showModelSelector(void 0,a)))()},()=>{o(),this.ctx.surface.requestRender()});return{component:i,focus:i}});return}const r=e.provider;try{if(y(r)){await this.configureCustomProtocolProvider(r,{force:!0})||this.ctx.surface.showStatus("Configuration cancelled");return}await this.promptForProviderApiKey(r)}catch(t){this.ctx.surface.showError(t instanceof Error?t.message:String(t))}}async configureCustomProtocolProvider(e,r={}){const t=k(e),s=P(),o=this.ctx.modelRegistry.authStorage,i=I(s,e)??t.defaultBaseUrl,a=C(s,e)??"custom-model",c=this.getStoredApiKey(e)??"",h=o.has(e);if(!r.force&&h&&i.trim()&&a.trim())return!0;const f=await this.ctx.surface.promptInput(`${t.label} base URL`,t.defaultBaseUrl,{initialValue:i});if(f===void 0)return!1;const n=f.trim();if(!n)return this.ctx.surface.showError("Base URL cannot be empty."),!1;const u=await this.ctx.surface.promptInput(`${t.label} API key`,h&&r.force?"Leave empty to keep the current API key":"API key",{initialValue:c});if(u===void 0)return!1;const g=u.trim();if(!g&&!h)return this.ctx.surface.showError("API key cannot be empty."),!1;const x=await this.ctx.surface.promptInput(`${t.label} model name`,"Model name",{initialValue:a});if(x===void 0)return!1;const p=x.trim();if(!p)return this.ctx.surface.showError("Model name cannot be empty."),!1;const m=await L(s,e,{baseUrl:n,modelName:p,apiKey:g||void 0});if(g&&E(o,e,g),this.ctx.modelRegistry.refresh(),await this.refreshCurrentModelForProvider(e,p),m?.contextWindow){const A=m.contextWindow>=1e3?`${Math.round(m.contextWindow/1e3)}k`:String(m.contextWindow);this.ctx.surface.showStatus(`Saved ${t.label} configuration (context window: ${A})`)}else this.ctx.surface.showStatus(`Saved ${t.label} configuration`);return!0}async refreshCurrentModelForProvider(e,r){const t=this.ctx.modelBridge.getCurrentModel();if(!t||t.provider!==e)return;const s=(r?this.ctx.modelRegistry.find(t.provider,r):void 0)??this.ctx.modelRegistry.find(t.provider,t.id);s&&await this.ctx.modelBridge.setCurrentModel(s)}async selectConfiguredCustomProvider(e){this.ctx.modelRegistry.refresh();const r=C(P(),e);if(!r){this.ctx.surface.showError(`No model configured for ${e}`);return}const t=this.ctx.modelRegistry.find(e,r);if(!t){this.ctx.surface.showError(`Configured model not found for ${e}`);return}await this.ctx.modelBridge.applySelectedModel(t)}async showLoginDialog(e){const r=l().find(n=>n.id===e),t=r?.name||e,s=r?.usesCallbackServer??!1,o=new M(this.ctx.surface.getUi(),e,(n,u)=>{}),i=this.ctx.surface.getEditorContainer();i.clear(),i.addChild(o),this.ctx.surface.getUi().setFocus(o),this.ctx.surface.requestRender();let a,c;const h=new Promise((n,u)=>{a=n,c=u}),f=d(()=>{this.ctx.surface.remountEditorShell(),this.ctx.surface.getUi().setFocus(this.ctx.surface.getEditor()),this.ctx.surface.requestRender()},"restoreEditor");try{await this.ctx.modelRegistry.authStorage.login(e,{onAuth:d(n=>{o.showAuth(n.url,n.instructions),s?o.showManualInput("Paste redirect URL below, or complete login in browser:").then(u=>{u&&a&&(a(u),a=void 0)}).catch(()=>{c&&(c(new Error("Login cancelled")),c=void 0)}):e==="github-copilot"&&o.showWaiting("Waiting for browser authentication...")},"onAuth"),onPrompt:d(async n=>o.showPrompt(n.message,n.placeholder),"onPrompt"),onProgress:d(n=>{o.showProgress(n)},"onProgress"),onManualCodeInput:d(()=>h,"onManualCodeInput"),signal:o.signal}),f(),this.ctx.modelRegistry.refresh(),await this.ctx.modelBridge.updateAvailableProviderCount(),this.ctx.surface.showStatus(`Logged in to ${t}. Credentials saved to ${K()}`)}catch(n){f();const u=n instanceof Error?n.message:String(n);u!=="Login cancelled"&&this.ctx.surface.showError(`Failed to login to ${t}: ${u}`)}}}export{W as AuthProviderConfigController};

package/dist/modes/interactive/controllers/extension-ui/custom-overlay-host.d.ts

@@ -0,0 +1,38 @@
+/**
+ * [WHO]: Provides CustomOverlayHost, CustomOverlayContext — extension custom component (overlay/inline)
+ * [FROM]: Depends on @catui/tui (Component/Container/TUI/EditorComponent/OverlayOptions/OverlayHandle),
+ *         theme, theme-contract (Theme), keybindings (KeybindingsManager)
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.customOverlay`; wired into
+ *       ExtensionUIContext.custom)
+ * [HERE]: modes/interactive/controllers/extension-ui/custom-overlay-host.ts — P5 extension-ui rewrite, host 3/4 (UI02, 纯搬)
+ *
+ * Owns ExtensionUIContext.custom: render an extension-provided component either as an overlay (on top,
+ * via ui.showOverlay) or inline (replacing the editor in the editor shell), saving/restoring the editor
+ * text. Per-call lifecycle (no persistent state). Reaches the editor-shell handles via a narrow context.
+ * Behavior is identical to the former InteractiveMode.showExtensionCustom (纯搬).
+ */
+import type { Component, Container, EditorComponent, OverlayHandle, OverlayOptions, TUI } from "@catui/tui";
+import type { Theme } from "../../../../core/theme-contract.js";
+import type { KeybindingsManager } from "../../../../core/platform/keybindings.js";
+type DisposableComponent = Component & {
+    dispose?(): void;
+};
+/** Narrow capability seam: the editor-shell handles the custom component renders into. */
+export interface CustomOverlayContext {
+    getEditor(): EditorComponent;
+    getUi(): TUI;
+    getEditorContainer(): Container;
+    getKeybindings(): KeybindingsManager;
+    remountEditorShell(): void;
+}
+export declare class CustomOverlayHost {
+    private readonly ctx;
+    constructor(ctx: CustomOverlayContext);
+    /** Show a custom component with keyboard focus. Overlay mode renders on top of existing content. */
+    show<T>(factory: (tui: TUI, thm: Theme, keybindings: KeybindingsManager, done: (result: T) => void) => DisposableComponent | Promise<DisposableComponent>, options?: {
+        overlay?: boolean;
+        overlayOptions?: OverlayOptions | (() => OverlayOptions);
+        onHandle?: (handle: OverlayHandle) => void;
+    }): Promise<T>;
+}
+export {};

package/dist/modes/interactive/controllers/extension-ui/custom-overlay-host.js

@@ -0,0 +1 @@
+var O=Object.defineProperty;var i=(d,r)=>O(d,"name",{value:r,configurable:!0});import{theme as g}from"../../theme/theme.js";class E{static{i(this,"CustomOverlayHost")}ctx;constructor(r){this.ctx=r}async show(r,e){const t=this.ctx.getUi(),u=this.ctx.getEditor().getText(),l=e?.overlay??!1,a=i(()=>{this.ctx.remountEditorShell(),this.ctx.getEditor().setText(u),t.setFocus(this.ctx.getEditor()),t.requestRender()},"restoreEditor");return new Promise((f,x)=>{let s,n=!1;const y=i(o=>{if(!n){n=!0,l?t.hideOverlay():a(),f(o);try{s?.dispose?.()}catch{}}},"close");Promise.resolve(r(t,g,this.ctx.getKeybindings(),y)).then(o=>{if(!n)if(s=o,l){const c=i(()=>{if(e?.overlayOptions)return typeof e.overlayOptions=="function"?e.overlayOptions():e.overlayOptions;const h=s.width;return h?{width:h}:void 0},"resolveOptions"),v=t.showOverlay(s,c());e?.onHandle?.(v)}else{const c=this.ctx.getEditorContainer();c.clear(),c.addChild(s),t.setFocus(s),t.requestRender()}}).catch(o=>{n||(l||a(),x(o))})})}}export{E as CustomOverlayHost};

package/dist/modes/interactive/controllers/extension-ui/editor-component-adapter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * [WHO]: Provides EditorComponentAdapter, EditorComponentContext — extension editor replacement
+ * [FROM]: Depends on @catui/tui (Component/Container/TUI/EditorComponent/EditorTheme/
+ *         CombinedAutocompleteProvider), keybindings (KeybindingsManager), components (CustomEditor), theme
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.editorAdapter`; wired into
+ *       ExtensionUIContext.setEditorComponent; reset by resetExtensionUI)
+ * [HERE]: modes/interactive/controllers/extension-ui/editor-component-adapter.ts — P5 extension-ui rewrite, host 4/4 (UI02, 纯搬)
+ *
+ * Owns ExtensionUIContext.setEditorComponent: swap the active editor for an extension-provided one
+ * (or restore the default), preserving text, submit/change callbacks, appearance, autocomplete, and —
+ * for CustomEditor subclasses — the app-level key/action handlers. The active editor reference is
+ * mount state, so the adapter reads/writes it through the context (getEditor/setEditor). Behavior is
+ * identical to the former InteractiveMode.setCustomEditorComponent (纯搬).
+ */
+import type { CombinedAutocompleteProvider, Container, EditorComponent, EditorTheme, TUI } from "@catui/tui";
+import type { KeybindingsManager } from "../../../../core/platform/keybindings.js";
+import type { CustomEditor } from "../../components/custom-editor.js";
+/** Narrow capability seam: the active-editor reference + editor-shell the adapter swaps. */
+export interface EditorComponentContext {
+    getEditor(): EditorComponent;
+    /** Swap the active editor reference (mount state). */
+    setEditor(editor: EditorComponent): void;
+    getDefaultEditor(): CustomEditor;
+    getEditorContainer(): Container;
+    getUi(): TUI;
+    getKeybindings(): KeybindingsManager;
+    getAutocompleteProvider(): CombinedAutocompleteProvider | undefined;
+    remountEditorShell(): void;
+}
+export declare class EditorComponentAdapter {
+    private readonly ctx;
+    constructor(ctx: EditorComponentContext);
+    /**
+     * Set a custom editor component from an extension. Pass undefined to restore the default editor.
+     */
+    setComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => EditorComponent) | undefined): void;
+}

package/dist/modes/interactive/controllers/extension-ui/editor-component-adapter.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var l=(s,r)=>u(s,"name",{value:r,configurable:!0});import{getEditorTheme as E}from"../../theme/theme.js";class p{static{l(this,"EditorComponentAdapter")}ctx;constructor(r){this.ctx=r}setComponent(r){const e=this.ctx,c=e.getEditor().getText();e.getEditorContainer().clear();let i;if(r){const t=e.getDefaultEditor(),o=r(e.getUi(),E(),e.getKeybindings());o.onSubmit=t.onSubmit,o.onChange=t.onChange,o.setText(c),o.borderColor!==void 0&&(o.borderColor=t.borderColor),o.setPaddingX!==void 0&&o.setPaddingX(t.getPaddingX());const a=e.getAutocompleteProvider();o.setAutocompleteProvider&&a&&o.setAutocompleteProvider(a);const n=o;if("actionHandlers"in n&&n.actionHandlers instanceof Map){n.onEscape=()=>t.onEscape?.(),n.onCtrlD=()=>t.onCtrlD?.(),n.onPasteImage=()=>t.onPasteImage?.(),n.onExtensionShortcut=d=>t.onExtensionShortcut?.(d);for(const[d,g]of t.actionHandlers)n.actionHandlers.set(d,g)}i=o}else{const t=e.getDefaultEditor();t.setText(c),i=t}e.setEditor(i),e.remountEditorShell(),e.getUi().setFocus(i),e.getUi().requestRender()}}export{p as EditorComponentAdapter};

package/dist/modes/interactive/controllers/extension-ui/persistent-surface-registry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * [WHO]: Provides PersistentSurfaceRegistry, PersistentSurfaceContext — extension keyed persistent surfaces
+ * [FROM]: Depends on @catui/tui (Container/Component/Text/Spacer/TUI), theme, theme-contract (Theme),
+ *         extensions-host (ExtensionWidgetOptions), footer-data-provider (FooterDataProvider) — types
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.surfaces`; wired into ExtensionUIContext
+ *       setWidget/setFooter/setHeader/setStatus; called by resetExtensionUI + syncBuddyPet)
+ * [HERE]: modes/interactive/controllers/extension-ui/persistent-surface-registry.ts — P5 extension-ui rewrite, host 1/4 (UI02, 纯搬)
+ *
+ * First extension-ui host (see ../../../.dev-docs/architecture-review/interactive-ui-review/extension-ui-analysis.md).
+ * Owns the *keyed persistent surfaces* an extension can set: above/below widgets, custom footer, custom
+ * header, and footer status. The mount-owned layout containers (widget containers, header container,
+ * built-in header/footer, footer data provider, TUI) are reached through a narrow context. Behavior is
+ * identical to the former InteractiveMode methods (纯搬).
+ */
+import { type Component, Container, type TUI } from "@catui/tui";
+import type { ExtensionWidgetOptions } from "../../../../core/extensions-host/index.js";
+import type { Theme } from "../../../../core/theme-contract.js";
+import type { FooterDataProvider } from "../../footer-data-provider.js";
+type DisposableComponent = Component & {
+    dispose?(): void;
+};
+/** Narrow capability seam: the mount-owned layout/render handles the surfaces manipulate. */
+export interface PersistentSurfaceContext {
+    requestRender(): void;
+    getUi(): TUI;
+    getWidgetContainerAbove(): Container | undefined;
+    getWidgetContainerBelow(): Container | undefined;
+    getHeaderContainer(): Container;
+    getBuiltInHeader(): Component | undefined;
+    /** The built-in footer component (swapped out when a custom footer is set). */
+    getFooter(): Component;
+    getFooterDataProvider(): FooterDataProvider;
+}
+export declare class PersistentSurfaceRegistry {
+    private readonly ctx;
+    private readonly widgetsAbove;
+    private readonly widgetsBelow;
+    private customFooter;
+    private customHeader;
+    constructor(ctx: PersistentSurfaceContext);
+    setStatus(key: string, text: string | undefined): void;
+    /** Set an extension widget (string array or custom component). */
+    setWidget(key: string, content: string[] | ((tui: TUI, thm: Theme) => DisposableComponent) | undefined, options?: ExtensionWidgetOptions): void;
+    clearWidgets(): void;
+    /** Render all extension widgets to the widget containers. */
+    renderWidgets(): void;
+    private renderWidgetContainer;
+    /** Set a custom footer component, or restore the built-in footer. */
+    setFooter(factory: ((tui: TUI, thm: Theme, footerData: FooterDataProvider) => DisposableComponent) | undefined): void;
+    /** Set a custom header component, or restore the built-in header. */
+    setHeader(factory: ((tui: TUI, thm: Theme) => DisposableComponent) | undefined): void;
+}
+export {};

package/dist/modes/interactive/controllers/extension-ui/persistent-surface-registry.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var h=(a,e)=>f(a,"name",{value:e,configurable:!0});import{Container as w,Spacer as l,Text as u}from"@catui/tui";import{theme as c}from"../../theme/theme.js";const g=10;class C{static{h(this,"PersistentSurfaceRegistry")}ctx;widgetsAbove=new Map;widgetsBelow=new Map;customFooter=void 0;customHeader=void 0;constructor(e){this.ctx=e}setStatus(e,t){this.ctx.getFooterDataProvider().setExtensionStatus(e,t),this.ctx.requestRender()}setWidget(e,t,o){const s=o?.placement??"aboveEditor",d=h(r=>{const n=r.get(e);n?.dispose&&n.dispose(),r.delete(e)},"removeExisting");if(d(this.widgetsAbove),d(this.widgetsBelow),t===void 0){this.renderWidgets();return}let i;if(Array.isArray(t)){const r=new w;for(const n of t.slice(0,g))r.addChild(new u(n,1,0));t.length>g&&r.addChild(new u(c.fg("muted","... (widget truncated)"),1,0)),i=r}else i=t(this.ctx.getUi(),c);(s==="belowEditor"?this.widgetsBelow:this.widgetsAbove).set(e,i),this.renderWidgets()}clearWidgets(){for(const e of this.widgetsAbove.values())e.dispose?.();for(const e of this.widgetsBelow.values())e.dispose?.();this.widgetsAbove.clear(),this.widgetsBelow.clear(),this.renderWidgets()}renderWidgets(){const e=this.ctx.getWidgetContainerAbove(),t=this.ctx.getWidgetContainerBelow();!e||!t||(this.renderWidgetContainer(e,this.widgetsAbove,!0,!0),this.renderWidgetContainer(t,this.widgetsBelow,!1,!1),this.ctx.requestRender())}renderWidgetContainer(e,t,o,s){if(e.clear(),t.size===0){o&&e.addChild(new l(1));return}s&&e.addChild(new l(1));for(const d of t.values())e.addChild(d)}setFooter(e){const t=this.ctx.getUi();this.customFooter?.dispose&&this.customFooter.dispose(),this.customFooter?t.removeChild(this.customFooter):t.removeChild(this.ctx.getFooter()),e?(this.customFooter=e(t,c,this.ctx.getFooterDataProvider()),t.addChild(this.customFooter)):(this.customFooter=void 0,t.addChild(this.ctx.getFooter())),t.requestRender()}setHeader(e){const t=this.ctx.getBuiltInHeader();if(!t)return;const o=this.ctx.getUi(),s=this.ctx.getHeaderContainer();this.customHeader?.dispose&&this.customHeader.dispose();const d=this.customHeader||t,i=s.children.indexOf(d);e?(this.customHeader=e(o,c),i!==-1?s.children[i]=this.customHeader:s.children.unshift(this.customHeader)):(this.customHeader=void 0,i!==-1&&(s.children[i]=t)),o.requestRender()}}export{C as PersistentSurfaceRegistry};

package/dist/modes/interactive/controllers/extension-ui/prompt-host.d.ts

@@ -0,0 +1,52 @@
+/**
+ * [WHO]: Provides PromptHost, PromptHostContext — single-active-prompt slot for extension dialogs
+ * [FROM]: Depends on @catui/tui (Component/Container/TUI), keybindings (KeybindingsManager),
+ *         extensions-host (ExtensionUIDialogOptions), components (Extension{Selector,Input,Editor}Component)
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.promptHost`; wired into
+ *       ExtensionUIContext select/confirm/input/editor; focus restore called by handleEvent + resetExtensionUI)
+ * [HERE]: modes/interactive/controllers/extension-ui/prompt-host.ts — P5 extension-ui rewrite, host 2/4 (UI02, 重写)
+ *
+ * Rewrite of the three byte-identical show/hide/dismiss lifecycles (selector / input / editor) into a
+ * single "active prompt" slot (see extension-ui-analysis.md §3, rewrite-acceptance.md). The three prompt
+ * types are now thin builders plugged into one generic `show` that owns the shared skeleton: abort
+ * handling, single-active-prompt invariant, mount-into-editor-shell + focus, and dismiss → dispose +
+ * remount + restore focus. NOT a generic overlay stack — there is one slot (no nesting need today).
+ * Behavior of select/confirm/input/editor is identical to the former InteractiveMode methods.
+ */
+import type { Component, Container, TUI } from "@catui/tui";
+import type { ExtensionUIDialogOptions } from "../../../../core/extensions-host/index.js";
+import type { KeybindingsManager } from "../../../../core/platform/keybindings.js";
+/** Narrow capability seam: the editor-shell handles the prompt slot mounts into. */
+export interface PromptHostContext {
+    getEditorContainer(): Container;
+    getUi(): TUI;
+    /** The editor component (focused when the prompt is dismissed and the shell is mounted). */
+    getEditor(): Component;
+    /** The editor/buddy layout node — its presence means the editor shell is mounted. */
+    getEditorBuddyLayout(): Component;
+    getKeybindings(): KeybindingsManager;
+    /** Rebuild the editor shell (attachments bar + editor row) after a prompt is removed. */
+    remountEditorShell(): void;
+}
+export declare class PromptHost {
+    private readonly ctx;
+    private active;
+    constructor(ctx: PromptHostContext);
+    hasActivePrompt(): boolean;
+    /** Focus the editor when no prompt is active and the editor shell is mounted. */
+    restoreEditorFocusIfPossible(): void;
+    /** Dismiss the active prompt (dispose + remount editor shell + restore focus + render). */
+    dismiss(restoreFocus?: boolean): void;
+    selector(title: string, options: string[], opts?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    confirm(title: string, message: string, opts?: ExtensionUIDialogOptions): Promise<boolean>;
+    input(title: string, placeholder?: string, opts?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    editor(title: string, prefill?: string): Promise<string | undefined>;
+    /**
+     * Show one prompt as the single active slot. `build` receives a `settle` callback
+     * to resolve the promise (with the chosen value, or undefined on cancel/abort);
+     * it must wire that into the component's submit/cancel callbacks.
+     */
+    private show;
+    private mount;
+    private clear;
+}

package/dist/modes/interactive/controllers/extension-ui/prompt-host.js

@@ -0,0 +1,2 @@
+var d=Object.defineProperty;var n=(o,t)=>d(o,"name",{value:t,configurable:!0});import{ExtensionEditorComponent as h}from"../../components/extension-editor.js";import{ExtensionInputComponent as a}from"../../components/extension-input.js";import{ExtensionSelectorComponent as f}from"../../components/extension-selector.js";class E{static{n(this,"PromptHost")}ctx;active=void 0;constructor(t){this.ctx=t}hasActivePrompt(){return!!this.active}restoreEditorFocusIfPossible(){if(this.active)return;this.ctx.getEditorContainer().children.includes(this.ctx.getEditorBuddyLayout())&&this.ctx.getUi().setFocus(this.ctx.getEditor())}dismiss(t=!0){this.clear(t),this.ctx.getUi().requestRender()}selector(t,e,i){return this.show(s=>new f(t,e,r=>s(r),()=>s(void 0),{tui:this.ctx.getUi(),timeout:i?.timeout}),i?.signal)}async confirm(t,e,i){return await this.selector(`${t}
+${e}`,["Yes","No"],i)==="Yes"}input(t,e,i){return this.show(s=>new a(t,e,r=>s(r),()=>s(void 0),{tui:this.ctx.getUi(),timeout:i?.timeout,initialValue:i?.initialValue}),i?.signal)}editor(t,e){return this.show(i=>new h(this.ctx.getUi(),this.ctx.getKeybindings(),t,e,s=>i(s),()=>i(void 0)))}show(t,e){return new Promise(i=>{if(e?.aborted){i(void 0);return}let s=!1;const r=n(u=>{s||(s=!0,e?.removeEventListener("abort",c),this.dismiss(),i(u))},"finish"),c=n(()=>r(void 0),"onAbort");e?.addEventListener("abort",c,{once:!0}),this.clear(!1),this.mount(t(r))})}mount(t){this.active=t;const e=this.ctx.getEditorContainer();e.clear(),e.addChild(t),this.ctx.getUi().setFocus(t),this.ctx.getUi().requestRender()}clear(t){this.active&&(this.active.dispose?.(),this.active=void 0,this.ctx.remountEditorShell()),t&&this.restoreEditorFocusIfPossible()}}export{E as PromptHost};

package/dist/modes/interactive/controllers/image-pipeline-controller.d.ts

@@ -0,0 +1,106 @@
+/**
+ * [WHO]: Provides ImagePipelineController, ImagePipelineContext, Attachment — clipboard/attachment/image handling
+ * [FROM]: Depends on @catui/tui (Container/Component/matchesKey), @catui/ai (ImageContent),
+ *         modes/utils (clipboard-image, image-resize), utils/mime, components/attachments-bar, theme
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (constructs one, delegates paste/attachment/image methods)
+ * [HERE]: modes/interactive/controllers/image-pipeline-controller.ts — first P5 UI slice (UI02, 纯搬)
+ *
+ * Extracted from InteractiveMode (P5 image-pipeline). Owns clipboard image paste, the attachments
+ * bar state, attachment key navigation, and text→image extraction. Reads the editor-shell layout and
+ * mount capabilities through a narrow ImagePipelineContext (no InteractiveMode reference). Behavior is
+ * identical to the former InteractiveMode methods.
+ */
+import type { ImageContent } from "@catui/ai/types";
+import { type Component, Container } from "@catui/tui";
+export interface Attachment {
+    path: string;
+    mimeType?: string;
+    bytes?: Uint8Array;
+}
+/** Narrow capability seam: mount/render capabilities the image pipeline needs, no InteractiveMode. */
+export interface ImagePipelineContext {
+    /** Current working directory (where clipboard images are written). */
+    getCwd(): string;
+    /** Request a TUI re-render. */
+    requestRender(): void;
+    /** Show a transient status line. */
+    showStatus(message: string): void;
+    /** Active theme name (for the attachments bar). */
+    getThemeName(): string | undefined;
+    /**
+     * Whether the editor cursor is on the first (visual) line, so ↑ has nowhere to
+     * move the cursor up — that's when ↑ should enter the attachments bar instead.
+     * With multi-line text below the first line, ↑ keeps moving the cursor.
+     */
+    isEditorCursorAtTop(): boolean;
+    /** The editor shell container that hosts the attachments bar. */
+    getEditorContainer(): Container;
+    /** The container the attachments bar is mounted into. */
+    getAttachmentsContainer(): Container | undefined;
+    /** The editor/buddy layout node the attachments bar is placed before. */
+    getEditorBuddyLayout(): Component;
+}
+export declare class ImagePipelineController {
+    private readonly ctx;
+    private clipboardImageSeq;
+    private clipboardImageFiles;
+    private clipboardPastePromise;
+    private attachments;
+    private selectedAttachmentIndex;
+    private attachmentsBar;
+    constructor(ctx: ImagePipelineContext);
+    /** Await any in-flight clipboard paste so a rapid Enter still waits for attachment registration. */
+    awaitPendingPaste(): Promise<void>;
+    /** Whether there are pending attachments (for editor-shell remount). */
+    hasAttachments(): boolean;
+    /**
+     * Take all pending attachments (clears the bar, resets selection + sequence).
+     * Returns [] without side effects when empty. Used by the submit pipeline.
+     */
+    takePendingAttachments(): Attachment[];
+    /**
+     * Discard attachments and their on-disk clipboard files — used on turn end and
+     * session new/switch/fork/tree. Deleting the files (not just the in-memory list)
+     * is what prevents a new paste from reusing a stale path: the sequence restarts
+     * at 1, so without deleting `_np_clipboard_image_1.png` the next paste would
+     * collide with the previous image's filename. Sent images already live in the
+     * model context; the on-disk copies are only scratch.
+     */
+    clearAttachments(): void;
+    handleClipboardImagePaste(): void;
+    /**
+     * Arrow/Delete handling for the attachments bar. The editor offers these keys
+     * here before its own cursor/history handling.
+     *
+     * Model: the bar sits above the editor.
+     * - ↑ from the editor (only when the editor is empty, so ↑ would otherwise browse
+     *   history) ENTERS the bar at the last (most recent) attachment.
+     * - Inside the bar, ↑/↓ move the selection; stepping past the top/bottom leaves
+     *   the bar (returns false so the editor handles the key, e.g. history).
+     * - Delete/Backspace removes the selected attachment.
+     * This works for a single attachment too (the previous code only intercepted when
+     * there were 2+, so one image could never be selected/deleted by keyboard).
+     */
+    handleAttachmentKeyNavigation(data: string): boolean;
+    private setSelectedIndex;
+    /**
+     * Convert attachment files to ImageContent array for sending to the model.
+     * Prefers in-memory bytes (clipboard) then falls back to disk read.
+     */
+    processAttachmentFiles(attachments: Attachment[]): Promise<ImageContent[]>;
+    /**
+     * Extract image file paths from text, read them as base64 ImageContent,
+     * and return the cleaned text with image references plus the image array.
+     */
+    extractImagesFromText(text: string): Promise<{
+        text: string;
+        images: ImageContent[];
+    }>;
+    cleanupStaleClipboardFiles(): void;
+    cleanupClipboardImages(): void;
+    /** Chain clipboard work so rapid Enter after paste still waits for attachment registration. */
+    private enqueueClipboardPaste;
+    private loadClipboardImageIntoAttachments;
+    private deleteAttachment;
+    private updateAttachmentsBar;
+}

package/dist/modes/interactive/controllers/image-pipeline-controller.js

@@ -0,0 +1 @@
+var I=Object.defineProperty;var l=(u,t)=>I(u,"name",{value:t,configurable:!0});import{matchesKey as o}from"@catui/tui";import{detectSupportedImageMimeTypeFromFile as p}from"../../../utils/mime.js";import{extensionForImageMimeType as A,readClipboardImage as S}from"../../utils/clipboard-image.js";import{formatDimensionNote as w,resizeImage as g}from"../../utils/image-resize.js";import{AttachmentsBarComponent as C}from"../components/attachments-bar.js";import{getThemeByName as y}from"../theme/theme.js";import*as i from"node:fs";import*as P from"node:os";import*as m from"node:path";class M{static{l(this,"ImagePipelineController")}ctx;clipboardImageSeq=0;clipboardImageFiles=[];clipboardPastePromise=Promise.resolve();attachments=[];selectedAttachmentIndex=-1;attachmentsBar=void 0;constructor(t){this.ctx=t}async awaitPendingPaste(){await this.clipboardPastePromise}hasAttachments(){return this.attachments.length>0}takePendingAttachments(){if(this.attachments.length===0)return[];const t=this.attachments.splice(0);return this.selectedAttachmentIndex=-1,this.clipboardImageSeq=0,this.updateAttachmentsBar(),this.ctx.requestRender(),t}clearAttachments(){const t=this.attachments.length>0;this.attachments=[],this.selectedAttachmentIndex=-1,this.clipboardImageSeq=0,this.cleanupClipboardImages(),t&&this.updateAttachmentsBar(),this.ctx.requestRender()}handleClipboardImagePaste(){this.enqueueClipboardPaste(()=>this.loadClipboardImageIntoAttachments())}handleAttachmentKeyNavigation(t){if(this.attachments.length===0)return!1;const e=this.selectedAttachmentIndex>=0;return o(t,"up")?e?this.selectedAttachmentIndex>0?(this.setSelectedIndex(this.selectedAttachmentIndex-1),!0):(this.setSelectedIndex(-1),!1):this.ctx.isEditorCursorAtTop()?(this.setSelectedIndex(this.attachments.length-1),!0):!1:o(t,"down")?e?this.selectedAttachmentIndex<this.attachments.length-1?(this.setSelectedIndex(this.selectedAttachmentIndex+1),!0):(this.setSelectedIndex(-1),!1):!1:e&&(o(t,"delete")||o(t,"backspace"))?(this.deleteAttachment(this.selectedAttachmentIndex),!0):!1}setSelectedIndex(t){this.selectedAttachmentIndex=t,this.updateAttachmentsBar(),this.ctx.requestRender()}async processAttachmentFiles(t){const e=new Set(["image/png","image/jpeg","image/gif","image/webp"]),c=l(a=>{if(!a)return null;const s=a.split(";")[0]?.trim().toLowerCase()??"";return e.has(s)?s:null},"normalizedMime"),r=[];for(const a of t)try{let s=c(a.mimeType),n;if(a.bytes&&a.bytes.length>0)n=Buffer.from(a.bytes).toString("base64"),s||(s=i.existsSync(a.path)?await p(a.path):null);else{if(!i.existsSync(a.path)||(s=s??await p(a.path),!s))continue;n=i.readFileSync(a.path).toString("base64")}if(!s)continue;const h=await g({type:"image",data:n,mimeType:s});r.push({type:"image",mimeType:h.mimeType,data:h.data})}catch(s){const n=s instanceof Error?s.message:"Unknown error";console.warn(`[Attachments] Skipped unreadable file ${a.path}: ${n}`)}return r}async extractImagesFromText(t){const e=[],c=P.tmpdir(),r=new RegExp(`${c.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}[/\\\\]catui-clipboard-[a-f0-9-]+\\.(?:png|jpg|jpeg|gif|webp)`,"gi"),a=t.match(r);if(!a)return{text:t,images:e};let s=t;for(const n of a)try{if(!i.existsSync(n))continue;const h=await p(n);if(!h)continue;const b=i.readFileSync(n).toString("base64"),d=await g({type:"image",data:b,mimeType:h}),f=w(d);e.push({type:"image",mimeType:d.mimeType,data:d.data});const x=f?`[image: ${m.basename(n)}] ${f}`:`[image: ${m.basename(n)}]`;s=s.replace(n,x)}catch{}return{text:s,images:e}}cleanupStaleClipboardFiles(){try{const t=this.ctx.getCwd();for(const e of i.readdirSync(t))if(/^_clipboard_\d+\.\w+$/.test(e)||/^_np_clipboard_image_\d+\.\w+$/.test(e))try{i.unlinkSync(m.join(t,e))}catch{}}catch{}}cleanupClipboardImages(){for(const t of this.clipboardImageFiles)try{i.existsSync(t)&&i.unlinkSync(t)}catch{}this.clipboardImageFiles=[]}enqueueClipboardPaste(t){this.clipboardPastePromise=this.clipboardPastePromise.catch(()=>{}).then(()=>t()).catch(()=>{})}async loadClipboardImageIntoAttachments(){try{const t=await S();if(!t)return;const e=A(t.mimeType)??"png",r=`_np_clipboard_image_${++this.clipboardImageSeq}.${e}`,a=m.join(this.ctx.getCwd(),r);i.writeFileSync(a,Buffer.from(t.bytes)),this.clipboardImageFiles.push(a),this.attachments.push({path:a,mimeType:t.mimeType,bytes:Uint8Array.from(t.bytes)}),this.updateAttachmentsBar();const s=Math.round(t.bytes.length/1024);this.ctx.showStatus(`Image pasted (${s} KB). Press Enter to send, \u2191\u2193 Del to manage.`),this.ctx.requestRender()}catch(t){const e=t instanceof Error?t.message:"Unknown error";this.ctx.showStatus(`Clipboard paste failed: ${e}`),this.ctx.requestRender()}}deleteAttachment(t){if(t<0||t>=this.attachments.length)return;const e=this.attachments[t];try{i.unlinkSync(e.path)}catch{}this.attachments.splice(t,1),this.selectedAttachmentIndex>=this.attachments.length&&(this.selectedAttachmentIndex=this.attachments.length-1),this.updateAttachmentsBar(),this.ctx.requestRender()}updateAttachmentsBar(){const t=this.ctx.getAttachmentsContainer();if(!t)return;const e=this.ctx.getEditorContainer();if(t.clear(),this.attachments.length===0){this.attachmentsBar=void 0,e.removeChild(t);return}if(!e.children.includes(t)){const a=e.children.indexOf(this.ctx.getEditorBuddyLayout());a>=0?e.children.splice(a,0,t):e.addChild(t)}const c=this.ctx.getThemeName(),r=y(c||"dark")??y("dark");this.attachmentsBar=new C(this.attachments,this.selectedAttachmentIndex,r),t.addChild(this.attachmentsBar)}}export{M as ImagePipelineController};

package/dist/modes/interactive/controllers/input-submit-controller.d.ts

@@ -0,0 +1,80 @@
+/**
+ * [WHO]: Provides InputSubmitController + InputSubmitContext — editor submit pipeline orchestration
+ * [FROM]: Depends on @catui/ai content types, AgentSession prompt options, image pipeline attachment type
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts as the default editor onSubmit handler
+ * [HERE]: modes/interactive/controllers/input-submit-controller.ts — P5 input-submit slice (UI06, rewrite)
+ *
+ * Owns submit classification and ordering only. Slash dispatch, image/attachment processing, bash execution,
+ * session prompt/steer, and rendering details are delegated through ports.
+ */
+import type { ImageContent, Model, TextContent } from "@catui/ai/types";
+import type { PromptOptions } from "../../../core/runtime/agent-session.js";
+import type { Attachment } from "./image-pipeline-controller.js";
+type AnyModel = Model<any>;
+export interface InputSubmitEditorPort {
+    setText(text: string): void;
+    addToHistory(text: string): void;
+    handleExternalInput(text: string): boolean;
+    setBashMode(enabled: boolean): void;
+    updateBorderColor(): void;
+}
+export interface InputSubmitSlashPort {
+    execute(text: string): Promise<boolean>;
+}
+export interface InputSubmitImagePort {
+    awaitPendingPaste(): Promise<void>;
+    extractImagesFromText(text: string): Promise<{
+        text: string;
+        images: ImageContent[];
+    }>;
+    takePendingAttachments(): Attachment[];
+    processAttachmentFiles(attachments: Attachment[]): Promise<ImageContent[]>;
+    cleanupClipboardImages(): void;
+}
+export interface InputSubmitSessionPort {
+    isBashRunning(): boolean;
+    isCompacting(): boolean;
+    isStreaming(): boolean;
+    getModel(): AnyModel | undefined;
+    getCwd(): string;
+    promptAfterRender(text: string, options?: PromptOptions): Promise<void>;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+}
+export interface InputSubmitCommandPort {
+    isExtensionCommand(text: string): boolean;
+    handlePersonaCommand(text: string): Promise<void>;
+    handleBashCommand(command: string, excludeFromContext: boolean): Promise<void>;
+}
+export interface InputSubmitRenderPort {
+    showStatus(message: string): void;
+    showWarning(message: string): void;
+    showError(message: string): void;
+    notify(message: string, options?: {
+        key?: string;
+        priority?: "immediate" | "high" | "medium" | "low";
+        type?: "info" | "warning" | "error";
+        duration?: number;
+    }): void;
+    requestRender(): void;
+    flushPendingBashComponents(): void;
+    updatePendingMessagesDisplay(): void;
+    addOptimisticUserMessage(text: string, content: Array<TextContent | ImageContent>): void;
+    rollbackFirstOptimisticUserMessageIfMatches(text: string): void;
+}
+export interface InputSubmitContext {
+    editor: InputSubmitEditorPort;
+    slash: InputSubmitSlashPort;
+    image: InputSubmitImagePort;
+    session: InputSubmitSessionPort;
+    commands: InputSubmitCommandPort;
+    render: InputSubmitRenderPort;
+}
+export declare class InputSubmitController {
+    private readonly ctx;
+    constructor(ctx: InputSubmitContext);
+    handleSubmit(rawText: string): Promise<void>;
+    private handleStreamingSubmit;
+    private handleIdleSubmit;
+    private imageSupportSuggestion;
+}
+export {};

package/dist/modes/interactive/controllers/input-submit-controller.js

@@ -0,0 +1,2 @@
+var x=Object.defineProperty;var h=(d,e)=>x(d,"name",{value:e,configurable:!0});import*as l from"node:fs";import*as f from"node:os";import*as g from"node:path";const S=process.env.CATUI_DEBUG==="1",u=g.join(f.homedir(),".catui","agent","catui-debug.log");function a(d){if(S)try{l.mkdirSync(g.dirname(u),{recursive:!0}),l.appendFileSync(u,`[${new Date().toISOString()}] [submit] ${d}
+`)}catch{}}h(a,"dbg");class I{static{h(this,"InputSubmitController")}ctx;constructor(e){this.ctx=e}async handleSubmit(e){const t=e.trim();if(!t)return;if(a(`handleSubmit: "${t.slice(0,80)}"`),await this.ctx.image.awaitPendingPaste(),await this.ctx.slash.execute(t)){a("handleSubmit \u2192 built-in slash handled");return}const s=t.match(/\s+\/persona\b/);if(s){const n=t.slice(s.index+1),r=t.slice(0,s.index).trim();this.ctx.editor.setText(""),await this.ctx.commands.handlePersonaCommand(n),r&&await this.ctx.session.promptAfterRender(r);return}if(t.startsWith("!")){const n=t.startsWith("!!"),r=n?t.slice(2).trim():t.slice(1).trim();if(r){if(this.ctx.session.isBashRunning()){this.ctx.render.showWarning("A bash command is already running. Press Esc to cancel it first."),this.ctx.editor.setText(t);return}this.ctx.editor.addToHistory(t),await this.ctx.commands.handleBashCommand(r,n),this.ctx.editor.setBashMode(!1),this.ctx.editor.updateBorderColor();return}}if(this.ctx.session.isCompacting()){this.ctx.commands.isExtensionCommand(t)?(this.ctx.editor.addToHistory(t),this.ctx.editor.setText(""),await this.ctx.session.promptAfterRender(t)):this.ctx.session.queueCompactionMessage(t,"steer");return}if(this.ctx.session.isStreaming()){await this.handleStreamingSubmit(t);return}await this.handleIdleSubmit(t)}async handleStreamingSubmit(e){this.ctx.editor.addToHistory(e),this.ctx.editor.setText("");const t=[{type:"text",text:e}];this.ctx.render.addOptimisticUserMessage(e,t),this.ctx.render.requestRender();const s=await this.ctx.image.extractImagesFromText(e),n=s.images;let r=[];const i=this.ctx.image.takePendingAttachments();i.length>0&&(r=i.map(m=>m.path));const o=this.ctx.session.getModel();(n.length>0||r.length>0)&&o&&!o.input.includes("image")&&(n.length=0,r=[],this.ctx.render.showStatus(`Images dropped: ${o.name} does not support images.${this.imageSupportSuggestion(o,!1)}`),this.ctx.render.requestRender());let c=s.text;if(r.length>0){const m=this.ctx.session.getCwd();c=r.map(p=>`@${g.relative(m,p).replace(/\\/g,"/")}`).join(" ")+"  "+c}await this.ctx.session.promptAfterRender(c,{streamingBehavior:"steer",images:n.length>0?n:void 0}),this.ctx.render.updatePendingMessagesDisplay(),this.ctx.render.requestRender()}async handleIdleSubmit(e){a(`handleIdleSubmit: "${e.slice(0,80)}"`),this.ctx.render.flushPendingBashComponents(),this.ctx.editor.addToHistory(e),this.ctx.editor.setText("");const{text:t,images:s}=await this.ctx.image.extractImagesFromText(e),n=this.ctx.image.takePendingAttachments();if(n.length>0){const i=await this.ctx.image.processAttachmentFiles(n);s.push(...i)}if(s.length>0){const i=this.ctx.session.getModel();i&&!i.input.includes("image")&&(this.ctx.render.showWarning(`Model "${i.name}" does not support image input. Images have been removed from this message.${this.imageSupportSuggestion(i,!0)}`),s.length=0)}if(this.ctx.commands.isExtensionCommand(t))a("handleIdleSubmit \u2192 skipping optimistic message for extension command");else{const i=[{type:"text",text:t}];s.length>0&&i.push(...s),this.ctx.render.addOptimisticUserMessage(t,i),this.ctx.render.requestRender(),a("handleIdleSubmit \u2192 optimistic message added")}if(this.ctx.editor.handleExternalInput(e)){a("handleIdleSubmit \u2192 handed off to main loop via handleExternalInput");return}try{delete process.env.CATUI_JUST_SWITCHED_PERSONA,await this.ctx.session.promptAfterRender(t,{images:s.length>0?s:void 0}),a("handleIdleSubmit \u2192 promptAfterRender returned normally")}catch(i){a(`handleIdleSubmit \u2192 promptAfterRender threw: ${i}`),this.ctx.render.rollbackFirstOptimisticUserMessageIfMatches(t);const o=i instanceof Error?i.message:"Unknown error occurred";this.ctx.render.showError(o)}this.ctx.render.updatePendingMessagesDisplay(),this.ctx.render.requestRender(),this.ctx.image.cleanupClipboardImages()}imageSupportSuggestion(e,t){const s=t?" Try using":" Try";return e.id==="glm-5"||e.id==="glm-5-turbo"?`${s} glm-5v-turbo for image support.`:e.id==="glm-4.5"||e.id==="glm-4.5-air"?`${s} glm-4.5v for image support.`:""}}export{I as InputSubmitController};

package/dist/modes/interactive/controllers/interrupt-controller.d.ts

@@ -0,0 +1,75 @@
+/**
+ * [WHO]: Provides InterruptController + InterruptContext (queue/runtime/bash/editor/tree/lifecycle ports)
+ *        — interactive escape + Ctrl-C/D/Z interrupt classification
+ * [FROM]: Depends only on injected capability closures (no core/ai imports); reads no TUI types directly
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.interrupt`; onEscape + Ctrl key
+ *       actions delegate here)
+ * [HERE]: modes/interactive/controllers/interrupt-controller.ts — P5 cancellation slice (scope B: interactive
+ *         interrupt-controller only; shutdown/signal registration stay in mount; `modes/_shell` deferred)
+ *
+ * Owns interrupt *classification* only: the single-key/multi-target escape priority, the two independent
+ * double-tap timers (esc→tree/fork, Ctrl-C→shutdown), and Ctrl-D/Ctrl-Z dispatch. It does NOT own the
+ * graceful-shutdown sequence, process-signal registration, queue/bash/tree mechanics, or TUI suspend
+ * mechanics — those are delegated through ports. onEscape stays mount-wired (gates: mount 接线, 分支委托
+ * owner); mount forwards to dispatchEscape() and the escape swap sites (compaction/retry) save/restore that
+ * forwarding closure unchanged. See ../../../.dev-docs/architecture-review/interactive-ui-review/cancellation-analysis.md
+ */
+/** Streaming/loader queue state + restore-on-abort. */
+export interface InterruptQueuePort {
+    isLoadingAnimationActive(): boolean;
+    restoreQueuedMessagesWithAbort(): void;
+}
+/** Runtime cancellation capability. */
+export interface InterruptRuntimePort {
+    isStreaming(): boolean;
+    isBashRunning(): boolean;
+    abortAgent(): void;
+    abortBash(): void;
+}
+/** Bash-mode editor state (mount-owned until a bash controller exists). */
+export interface InterruptBashPort {
+    isBashMode(): boolean;
+    /** Clear bash-mode text, reset the flag, and restore the editor border color. */
+    exitBashMode(): void;
+}
+export interface InterruptEditorPort {
+    getText(): string;
+    clearEditor(): void;
+}
+/** Empty-editor double-escape navigation. */
+export interface InterruptTreePort {
+    getDoubleEscapeAction(): string;
+    showTreeSelector(): void;
+    showForkSelector(): void;
+}
+/** Process lifecycle — graceful shutdown + TUI suspend stay mount-owned. */
+export interface InterruptLifecyclePort {
+    requestShutdown(): void;
+    suspend(): void;
+}
+export interface InterruptContext {
+    queue: InterruptQueuePort;
+    runtime: InterruptRuntimePort;
+    bash: InterruptBashPort;
+    editor: InterruptEditorPort;
+    tree: InterruptTreePort;
+    lifecycle: InterruptLifecyclePort;
+}
+export declare class InterruptController {
+    private readonly ctx;
+    private lastEscapeTime;
+    private lastSigintTime;
+    constructor(ctx: InterruptContext);
+    /**
+     * Single-key, multi-target escape dispatch (priority order preserved from the original onEscape):
+     * loader → restore queued + abort; streaming → abort agent; bash running → abort bash;
+     * bash mode → exit; empty editor → double-tap tree/fork.
+     */
+    dispatchEscape(): void;
+    /** Ctrl-C: double-tap (<500ms) shuts down; single tap clears the editor and arms the timer. */
+    handleCtrlC(): void;
+    /** Ctrl-D: only fires when the editor is empty (enforced by CustomEditor) → shutdown. */
+    handleCtrlD(): void;
+    /** Ctrl-Z: suspend the TUI and stop the process group (resume restores the TUI). */
+    handleCtrlZ(): void;
+}

package/dist/modes/interactive/controllers/interrupt-controller.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var s=(e,t)=>c(e,"name",{value:t,configurable:!0});const n=500;class o{static{s(this,"InterruptController")}ctx;lastEscapeTime=0;lastSigintTime=0;constructor(t){this.ctx=t}dispatchEscape(){if(this.ctx.queue.isLoadingAnimationActive())this.ctx.queue.restoreQueuedMessagesWithAbort();else if(this.ctx.runtime.isStreaming())this.ctx.runtime.abortAgent();else if(this.ctx.runtime.isBashRunning())this.ctx.runtime.abortBash();else if(this.ctx.bash.isBashMode())this.ctx.bash.exitBashMode();else if(!this.ctx.editor.getText().trim()){const t=this.ctx.tree.getDoubleEscapeAction();if(t!=="none"){const i=Date.now();i-this.lastEscapeTime<500?(t==="tree"?this.ctx.tree.showTreeSelector():this.ctx.tree.showForkSelector(),this.lastEscapeTime=0):this.lastEscapeTime=i}}}handleCtrlC(){const t=Date.now();t-this.lastSigintTime<500?this.ctx.lifecycle.requestShutdown():(this.ctx.editor.clearEditor(),this.lastSigintTime=t)}handleCtrlD(){this.ctx.lifecycle.requestShutdown()}handleCtrlZ(){this.ctx.lifecycle.suspend()}}export{o as InterruptController};