catui-agent 1.0.0-beta.0

package/dist/modes/interactive/controllers/model-overlay-controller.d.ts

@@ -0,0 +1,127 @@
+/**
+ * [WHO]: Provides ModelOverlayController + ModelOverlayContext (ModelSessionPort/ModelCatalogPort/
+ *        ModelSettingsPort/ProviderConfigPort/ModelOverlaySurface/ModelOverlayFooter) — interactive model selection
+ * [FROM]: Depends on @catui/ai (Model), agent-core (ThinkingLevel), core/runtime/agent-session
+ *         (CycleModelError), @catui/tui (Component/TUI), core/model-resolver (resolveModelScope),
+ *         components (Model/Provider/ScopedModels selectors)
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.modelOverlay`; /model, cycle keybindings,
+ *       /scoped-models delegate here)
+ * [HERE]: modes/interactive/controllers/model-overlay-controller.ts — P5 model-overlay slice (UI08, hybrid)
+ *
+ * Interactive TUI orchestration of model selection (UI08). It DELEGATES the reusable model capability
+ * (set/cycle model, thinking level, scoped models) to AgentSession via ModelSessionPort — it does NOT
+ * own model switching rules, thinking clamping/persistence, API-key validation, or provider credentials.
+ * Provider configuration is consumed through ProviderConfigPort (points to mount during transition,
+ * repointed to auth/provider-config later). The context is intentionally the widest P5 controller, but
+ * grouped by capability and serving one workflow; it must not keep growing. No InteractiveMode reference.
+ */
+import type { Model } from "@catui/ai/types";
+import type { ThinkingLevel } from "@catui/agent-core";
+import type { Component, TUI } from "@catui/tui";
+import type { ModelRegistry } from "../../../core/model-registry.js";
+type AnyModel = Model<any>;
+type ScopedModel = {
+    model: AnyModel;
+    thinkingLevel: ThinkingLevel;
+};
+/** Reusable model capability — delegated to AgentSession; model-overlay never reimplements it. */
+export interface ModelSessionPort {
+    getModel(): AnyModel | undefined;
+    setModel(model: AnyModel): Promise<void>;
+    cycleModel(direction: "forward" | "backward"): Promise<{
+        model: AnyModel;
+        thinkingLevel: ThinkingLevel;
+    } | undefined>;
+    getThinkingLevel(): string;
+    setThinkingLevel(level: ThinkingLevel): void;
+    cycleThinkingLevel(): string | undefined;
+    getAvailableThinkingLevels(): string[];
+    getScopedModels(): ReadonlyArray<ScopedModel>;
+    setScopedModels(models: ScopedModel[]): void;
+}
+/** Registry/catalog access needed by interactive selection. */
+export interface ModelCatalogPort {
+    refresh(): void;
+    getAvailable(): AnyModel[];
+    getAll(): AnyModel[];
+    find(provider: string, id: string): AnyModel | undefined;
+    appendOpenRouterModel(id: string, opts: {
+        name?: string;
+    }): void;
+    /** Credential type for a provider (to suggest /login on OAuth cycle failures). */
+    getCredentialType(provider: string): string | undefined;
+    /**
+     * The concrete ModelRegistry object — required by ModelSelectorComponent and resolveModelScope,
+     * which consume the registry directly. ModelRegistry is the catalog domain object (not AgentSession
+     * or InteractiveMode), so exposing it is allowed under UI-G2.
+     */
+    getRegistry(): ModelRegistry;
+}
+/** Enabled/default model settings only — not the whole settings surface. */
+export interface ModelSettingsPort {
+    getEnabledModels(): string[] | undefined;
+    setEnabledModels(patterns: string[] | undefined): void;
+    setDefaultModelAndProvider(provider: string, id: string): void;
+}
+/** Provider configuration precondition (points to mount in transition; repointed to auth/provider-config). */
+export interface ProviderConfigPort {
+    ensureProviderConfiguredForSelection(model: AnyModel): Promise<boolean>;
+    handleProviderSelectionFromSelector(provider: string, done: () => void): Promise<void>;
+    promptForProviderApiKey(provider: string, options?: {
+        title?: string;
+    }): Promise<boolean>;
+}
+/** Selector/status/error/prompt/render TUI surface. */
+export interface ModelOverlaySurface {
+    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>;
+    getUi(): TUI;
+}
+/** Footer/editor-border refresh after selection. */
+export interface ModelOverlayFooter {
+    invalidate(): void;
+    setAvailableProviderCount(count: number): void;
+    updateEditorBorderColor(): void;
+}
+export interface ModelOverlayContext {
+    modelSession: ModelSessionPort;
+    modelCatalog: ModelCatalogPort;
+    modelSettings: ModelSettingsPort;
+    providerConfig: ProviderConfigPort;
+    surface: ModelOverlaySurface;
+    footer: ModelOverlayFooter;
+    /** Interactive-only side effect after a model is applied (the daxnuts easter egg). */
+    playDaxnuts(): void;
+}
+export declare class ModelOverlayController {
+    private readonly ctx;
+    constructor(ctx: ModelOverlayContext);
+    cycleThinkingLevel(): void;
+    handleThinkingCommand(text: string): void;
+    cycleModel(direction: "forward" | "backward"): Promise<void>;
+    handleModelCommand(searchTerm?: string): Promise<void>;
+    showModelSelector(initialSearchInput?: string, filterByProvider?: string): void;
+    showProviderThenModelSelector(): Promise<void>;
+    showModelsSelector(): Promise<void>;
+    /** Update the footer's available provider count from current model candidates. */
+    updateAvailableProviderCount(): Promise<void>;
+    private findExactModelMatch;
+    private getModelCandidates;
+    /**
+     * Apply a chosen model: persist as default, refresh footer/border, status, daxnuts hook.
+     * Public because the provider-config path (mount, future provider-config-controller) applies a
+     * model after configuring a custom protocol provider. Selection mutation still goes through the
+     * modelSession port (AgentSession), keeping UI08's runtime-owned capability boundary.
+     */
+    applySelectedModel(model: AnyModel): Promise<void>;
+    private selectModelWithProviderEnsure;
+    private checkDaxnutsEasterEgg;
+}
+export {};

package/dist/modes/interactive/controllers/model-overlay-controller.js

@@ -0,0 +1,3 @@
+var v=Object.defineProperty;var a=(f,t)=>v(f,"name",{value:t,configurable:!0});import{CycleModelError as m}from"../../../core/runtime/agent-session.js";import{resolveModelScope as p}from"../../../core/model-resolver.js";import{ModelSelectorComponent as S}from"../components/model-selector.js";import{ProviderSelectorComponent as w}from"../components/provider-selector.js";import{ScopedModelsSelectorComponent as M}from"../components/scoped-models-selector.js";class T{static{a(this,"ModelOverlayController")}ctx;constructor(t){this.ctx=t}cycleThinkingLevel(){const t=this.ctx.modelSession.cycleThinkingLevel();t===void 0?this.ctx.surface.showStatus("Current model does not support thinking"):(this.ctx.footer.invalidate(),this.ctx.footer.updateEditorBorderColor(),this.ctx.surface.showStatus(`Thinking level: ${t}`))}handleThinkingCommand(t){const e=t.slice(9).trim().toLowerCase(),o=this.ctx.modelSession.getAvailableThinkingLevels();if(!e){this.ctx.surface.showStatus(`Thinking level: ${this.ctx.modelSession.getThinkingLevel()} (available: ${o.join(", ")})`);return}if(!o.includes(e)){this.ctx.surface.showStatus(`Unknown thinking level: ${e} (available: ${o.join(", ")})`);return}this.ctx.modelSession.setThinkingLevel(e),this.ctx.footer.invalidate(),this.ctx.footer.updateEditorBorderColor(),this.ctx.surface.showStatus(`Thinking level: ${this.ctx.modelSession.getThinkingLevel()}`)}async cycleModel(t){try{const e=await this.ctx.modelSession.cycleModel(t);if(e===void 0){const o=this.ctx.modelSession.getScopedModels().length>0?"Only one model in scope":"Only one model available";this.ctx.surface.showStatus(o)}else{this.ctx.footer.invalidate(),this.ctx.footer.updateEditorBorderColor();const o=e.model.reasoning&&e.thinkingLevel!=="off"?` (thinking: ${e.thinkingLevel})`:"";this.ctx.surface.showStatus(`Switched to ${e.model.name||e.model.id}${o}`)}}catch(e){const o=e instanceof Error?e.message:String(e);e instanceof m&&e.provider?this.ctx.modelCatalog.getCredentialType(e.provider)==="oauth"||e.code==="oauth_expired"?this.ctx.surface.showError(`${o}
+Use /login ${e.provider} to re-authenticate.`):this.ctx.surface.showError(o):this.ctx.surface.showError(o)}}async handleModelCommand(t){if(!t){this.showProviderThenModelSelector();return}const e=await this.findExactModelMatch(t);if(e){await this.selectModelWithProviderEnsure(e);return}this.showModelSelector(t)}showModelSelector(t,e){this.ctx.surface.showSelector(o=>{const r=new S(this.ctx.surface.getUi(),this.ctx.modelSession.getModel(),this.ctx.modelCatalog.getRegistry(),this.ctx.modelSession.getScopedModels(),async i=>{o(),await this.selectModelWithProviderEnsure(i)},()=>{o(),this.ctx.surface.getUi().requestRender()},t,e,()=>{(async()=>{o();const i=await this.ctx.surface.promptInput("Add OpenRouter model","Model id (e.g. x-ai/grok-4.20)");if(!i?.trim()){this.showModelSelector(t,e);return}const s=await this.ctx.surface.promptInput("Display name (optional)","Leave empty to use model id",{initialValue:i.trim()});if(s===void 0){this.showModelSelector(t,e);return}try{this.ctx.modelCatalog.appendOpenRouterModel(i.trim(),{name:s.trim()||void 0}),this.ctx.surface.showStatus(`Added OpenRouter model ${i.trim()}`)}catch(n){this.ctx.surface.showError(n instanceof Error?n.message:String(n))}this.showModelSelector(t,e)})()},()=>{(async()=>{o();const i=e??this.ctx.modelSession.getModel()?.provider;i&&await this.ctx.providerConfig.promptForProviderApiKey(i),this.showModelSelector(t,e)})()});return{component:r,focus:r}})}async showProviderThenModelSelector(){this.ctx.modelCatalog.refresh();const t=this.ctx.modelCatalog.getAll(),e=[...new Set(t.map(o=>o.provider))].sort();if(e.length===0){this.ctx.surface.showStatus("No providers available");return}if(e.length===1){this.showModelSelector(void 0,e[0]);return}this.ctx.surface.showSelector(o=>{const r=new w(e,this.ctx.modelSession.getModel()?.provider,i=>{this.ctx.providerConfig.handleProviderSelectionFromSelector(i,o)},()=>{o(),this.ctx.surface.getUi().requestRender()});return{component:r,focus:r}})}async showModelsSelector(){this.ctx.modelCatalog.refresh();const t=this.ctx.modelCatalog.getAvailable();if(t.length===0){this.ctx.surface.showStatus("No models available");return}const e=this.ctx.modelSession.getScopedModels(),o=e.length>0,r=new Set;let i=!1;if(o){for(const l of e)r.add(`${l.model.provider}/${l.model.id}`);i=!0}else{const l=this.ctx.modelSettings.getEnabledModels();if(l!==void 0&&l.length>0){i=!0;const u=await p(l,this.ctx.modelCatalog.getRegistry());for(const c of u)r.add(`${c.model.provider}/${c.model.id}`)}}const s=new Set(r);let n=i;const h=a(async l=>{if(l.size>0&&l.size<t.length){const u=this.ctx.modelSession.getThinkingLevel(),c=await p(Array.from(l),this.ctx.modelCatalog.getRegistry());this.ctx.modelSession.setScopedModels(c.map(d=>({model:d.model,thinkingLevel:d.thinkingLevel??u})))}else this.ctx.modelSession.setScopedModels([]);await this.updateAvailableProviderCount(),this.ctx.surface.getUi().requestRender()},"updateSessionModels");this.ctx.surface.showSelector(l=>{const u=new M({allModels:t,enabledModelIds:s,hasEnabledModelsFilter:n},{onModelToggle:a(async(c,d)=>{d?s.add(c):s.delete(c),n=!0,await h(s)},"onModelToggle"),onEnableAll:a(async c=>{s.clear();for(const d of c)s.add(d);n=!1,await h(s)},"onEnableAll"),onClearAll:a(async()=>{s.clear(),n=!0,await h(s)},"onClearAll"),onToggleProvider:a(async(c,d,x)=>{for(const g of d)x?s.add(g):s.delete(g);n=!0,await h(s)},"onToggleProvider"),onPersist:a(c=>{const d=c.length===t.length?void 0:c;this.ctx.modelSettings.setEnabledModels(d),this.ctx.surface.showStatus("Model selection saved to settings")},"onPersist"),onCancel:a(()=>{l(),this.ctx.surface.getUi().requestRender()},"onCancel")});return{component:u,focus:u}})}async updateAvailableProviderCount(){const t=await this.getModelCandidates(),e=new Set(t.map(o=>o.provider));this.ctx.footer.setAvailableProviderCount(e.size)}async findExactModelMatch(t){const e=t.trim();if(!e)return;let o,r="";if(e.includes("/")){const n=e.split("/",2);o=n[0]?.trim().toLowerCase(),r=n[1]?.trim().toLowerCase()??""}else r=e.toLowerCase();if(!r)return;const s=(await this.getModelCandidates()).filter(n=>{const h=n.id.toLowerCase()===r,l=!o||n.provider.toLowerCase()===o;return h&&l});return s.length===1?s[0]:void 0}async getModelCandidates(){const t=this.ctx.modelSession.getScopedModels();if(t.length>0)return t.map(e=>e.model);this.ctx.modelCatalog.refresh();try{return this.ctx.modelCatalog.getAll()}catch{return[]}}async applySelectedModel(t){await this.ctx.modelSession.setModel(t),this.ctx.modelSettings.setDefaultModelAndProvider(t.provider,t.id),this.ctx.footer.invalidate(),this.ctx.footer.updateEditorBorderColor(),this.ctx.surface.showStatus(`Model: ${t.id}`),this.checkDaxnutsEasterEgg(t)}async selectModelWithProviderEnsure(t){try{if(!await this.ctx.providerConfig.ensureProviderConfiguredForSelection(t)){this.ctx.surface.showStatus("Configuration cancelled");return}this.ctx.modelCatalog.refresh();const o=this.ctx.modelCatalog.find(t.provider,t.id)??t;await this.applySelectedModel(o)}catch(e){const o=e instanceof Error?e.message:String(e);e instanceof m&&e.provider?this.ctx.surface.showError(`${o}
+Use /login ${e.provider} to re-authenticate.`):this.ctx.surface.showError(o)}}checkDaxnutsEasterEgg(t){t.provider==="opencode"&&t.id.toLowerCase().includes("kimi-k2.5")&&this.ctx.playDaxnuts()}}export{T as ModelOverlayController};

package/dist/modes/interactive/controllers/self-update-controller.d.ts

@@ -0,0 +1,71 @@
+/**
+ * [WHO]: Provides SelfUpdateController, SelfUpdateContext — version check / update / reinstall / restart
+ * [FROM]: Depends on @catui/tui (Container/Text/Spacer), config (VERSION/PACKAGE_NAME/getUpdateInstruction),
+ *         theme, components/dynamic-border, node:child_process (spawn)
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (constructs one, delegates /update, /reinstall, startup check)
+ * [HERE]: modes/interactive/controllers/self-update-controller.ts — P5 UI slice (UI02, 纯搬)
+ *
+ * Extracted from InteractiveMode (P5 self-update). Owns the npm-based update/reinstall workflow
+ * and the startup version check — an ops flow that happens to use the TUI for prompts. Reads chat
+ * container / render / settings / selector through a narrow SelfUpdateContext (no InteractiveMode
+ * reference). Behavior is identical to the former InteractiveMode methods. P5 keeps it inside
+ * modes/interactive; only a second mode consumer would justify moving it to modes/_shell/update.
+ */
+import { type Container } from "@catui/tui";
+/** Narrow capability seam: the chat/render/settings/selector capabilities the updater needs. */
+export interface SelfUpdateContext {
+    /** The chat container the updater renders progress/results into. */
+    getChatContainer(): Container;
+    /** Request a TUI re-render. */
+    requestRender(): void;
+    getAutoUpdate(): "always" | "prompt" | "never";
+    getSkippedVersion(): string | undefined;
+    setSkippedVersion(version: string | undefined): void;
+    setAutoUpdate(mode: "always" | "prompt" | "never"): void;
+    /** Present a selector overlay (delegates to the extension-selector UI). */
+    showSelector(title: string, options: string[]): Promise<string | undefined>;
+}
+export declare class SelfUpdateController {
+    private readonly ctx;
+    constructor(ctx: SelfUpdateContext);
+    private get chat();
+    private render;
+    checkForNewVersion(): Promise<string | undefined>;
+    showNewVersionNotification(newVersion: string): void;
+    handleUpdateCommand(): Promise<void>;
+    /**
+     * Handle /reinstall command - force clean reinstall.
+     */
+    handleReinstallCommand(): void;
+    /**
+     * Check for updates on startup if auto-update is enabled.
+     */
+    checkAutoUpdateOnStartup(): Promise<void>;
+    /**
+     * Show interactive update options when a new version is available.
+     */
+    private showUpdateOptions;
+    /**
+     * Perform the actual npm install update.
+     */
+    private performUpdate;
+    /**
+     * Show retry options after a failed update attempt.
+     */
+    private showRetryOptions;
+    /**
+     * Wait for a specific key press from user.
+     * Falls back to selector UI if TTY is not available.
+     */
+    private waitForKeyPress;
+    /**
+     * Restart Catui by spawning a new process.
+     * Tries to detect the correct command to restart.
+     */
+    private restartCatui;
+    /**
+     * Compare two version strings (semver style).
+     * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+     */
+    private compareVersion;
+}

package/dist/modes/interactive/controllers/self-update-controller.js

@@ -0,0 +1,24 @@
+var $=Object.defineProperty;var u=(w,e)=>$(w,"name",{value:e,configurable:!0});import{spawn as g}from"node:child_process";import{Spacer as c,Text as i}from"@catui/tui";import{getUpdateInstruction as k,PACKAGE_NAME as l,VERSION as f}from"../../../config.js";import{DynamicBorder as y}from"../components/dynamic-border.js";import{theme as t}from"../theme/theme.js";function m(w){if(process.platform==="win32"){const e=["npm",...w].map(n=>n.includes(" ")?`"${n}"`:n).join(" ");return g(e,{stdio:["ignore","pipe","pipe"],env:process.env,shell:!0})}return g("npm",w,{stdio:["ignore","pipe","pipe"],env:process.env})}u(m,"spawnNpm");class A{static{u(this,"SelfUpdateController")}ctx;constructor(e){this.ctx=e}get chat(){return this.ctx.getChatContainer()}render(){this.ctx.requestRender()}async checkForNewVersion(){if(!(process.env.CATUI_SKIP_VERSION_CHECK||process.env.CATUI_OFFLINE))try{const e=await fetch(`https://registry.npmjs.org/${encodeURIComponent(l)}`,{signal:AbortSignal.timeout(1e4)});if(!e.ok)return;const n=await e.json(),s=n["dist-tags"]?.latest??n.version;return s&&this.compareVersion(s,f)>0?s:void 0}catch{return}}showNewVersionNotification(e){const n=t.fg("accent",k(l)),s=t.fg("muted",`New version ${e} is available. `)+n;this.chat.addChild(new c(1)),this.chat.addChild(new y(r=>t.fg("warning",r))),this.chat.addChild(new i(`${t.bold(t.fg("warning","Update Available"))}
+${s}`,1,0)),this.chat.addChild(new y(r=>t.fg("warning",r))),this.render()}async handleUpdateCommand(){this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("accent","\u{1F50D} Checking for updates..."),1,0)),this.render();try{const e=await fetch(`https://registry.npmjs.org/${encodeURIComponent(l)}`,{signal:AbortSignal.timeout(1e4)});if(!e.ok)throw new Error(`Failed to check for updates: ${e.status}`);const s=(await e.json())["dist-tags"]?.latest??"unknown",r=f,a=s!=="unknown"?this.compareVersion(s,r):0,d=[];if(d.push(t.fg("accent","\u{1F4E6} Catui Update Checker")),d.push(""),d.push(`Current version: ${t.fg("dim",r)}`),d.push(`Latest version:  ${t.fg(a>0?"success":"dim",s)}`),d.push(""),s!=="unknown"&&a>0){d.push(t.fg("success",`\u2728 New version ${s} available!`)),d.push(""),this.chat.addChild(new c(1)),this.chat.addChild(new i(d.join(`
+`),1,0)),this.render(),await this.showUpdateOptions(s);return}else s!=="unknown"&&a<0?(d.push(t.fg("success","\u2728 You're ahead!")),d.push(""),d.push(t.fg("dim","You're running a pre-release or newer version than published on npm."))):(d.push(t.fg("success","\u2728 Up to date!")),d.push(""),d.push(t.fg("dim","You're running the latest version of Catui.")));this.chat.addChild(new c(1)),this.chat.addChild(new i(d.join(`
+`),1,0))}catch(e){this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Failed to check for updates: ${e instanceof Error?e.message:"Unknown error"}`),1,0)),this.chat.addChild(new i(t.fg("dim",`Visit https://www.npmjs.com/package/${l} to check manually`),1,0))}this.render()}handleReinstallCommand(){this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("accent","\u{1F504} Force Reinstalling Catui..."),1,0)),this.chat.addChild(new i(t.fg("dim","This will uninstall and reinstall with cache cleared."),1,0)),this.render();const e=m(["uninstall","-g",l]);e.on("close",n=>{n!==0&&(this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Uninstall failed (exit code ${n}), continuing anyway...`),1,0)),this.render()),this.chat.addChild(new i(t.fg("dim","\u{1F9F9} Clearing npm cache..."),1,0)),this.render(),m(["cache","clean","--force"]).on("close",()=>{this.chat.addChild(new i(t.fg("dim","\u{1F4E6} Installing latest version..."),1,0)),this.render();const r=m(["install","-g","--force",`${l}@latest`]);r.on("close",a=>{a===0?(this.chat.addChild(new i(t.fg("success","\u2705 Catui reinstalled successfully!"),1,0)),this.chat.addChild(new i(t.fg("accent","Press 'R' to restart Catui"),1,0)),this.render(),u(async()=>{const o=await this.waitForKeyPress(["r","R","q","Q",""]);o==="r"||o==="R"?this.restartCatui():process.exit(0)},"waitForRestart")()):(this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Reinstall failed (exit code ${a})`),1,0)),this.chat.addChild(new i(t.fg("dim",`Try running manually: npm uninstall -g ${l} && npm install -g ${l}`),1,0)),this.render())}),r.on("error",a=>{this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Install failed: ${a.message}`),1,0)),this.render()})})}),e.on("error",n=>{this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Uninstall failed: ${n.message}`),1,0)),this.render()})}async checkAutoUpdateOnStartup(){if(this.ctx.getAutoUpdate()==="always")try{const n=await fetch(`https://registry.npmjs.org/${encodeURIComponent(l)}`,{signal:AbortSignal.timeout(5e3)});if(!n.ok)return;const r=(await n.json())["dist-tags"]?.latest;if(!r)return;const a=f;if(this.ctx.getSkippedVersion()===r)return;if(this.compareVersion(r,a)>0){const o=`${t.fg("accent","\u{1F4E6} Update Available")}
+
+${t.fg("dim",`Current: ${a}`)}
+${t.fg("success",`Latest:  ${r}`)}
+
+${t.fg("dim","A new version is available. Would you like to update now?")}`,h=["1. Update now and restart","2. Skip this version","3. Continue without updating"],p=await this.ctx.showSelector(o,h);if(!p)return;p.includes("Update now")?await this.performUpdate(r):p.includes("Skip")?(this.ctx.setSkippedVersion(r),this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("dim",`\u23ED\uFE0F  Skipped version ${r}. You won't be prompted again.`),1,0)),this.render()):p.includes("Continue")&&(this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("dim","Continuing without update..."),1,0)),this.render())}}catch{}}async showUpdateOptions(e){const n=this.ctx.getAutoUpdate();if(this.ctx.getSkippedVersion()===e){const h=`${t.fg("accent","Update Skipped")}
+
+${t.fg("dim",`You previously chose to skip version ${e}.`)}
+${t.fg("dim",`Current: ${f}`)}
+${t.fg("success",`Latest:  ${e}`)}
+
+${t.fg("dim","What would you like to do?")}`,p=["1. Update now","2. Clear skip and enable auto-update","3. Continue without updating"],C=await this.ctx.showSelector(h,p);if(!C){this.chat.addChild(new i(t.fg("dim","Returning to chat..."),1,0)),this.render();return}if(C.includes("Update now")){await this.performUpdate(e);return}else if(C.includes("Clear skip")){this.ctx.setSkippedVersion(void 0),this.ctx.setAutoUpdate("always"),this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("success","\u2705 Skip cleared! Auto-update enabled. Catui will check for updates on startup."),1,0)),this.render(),await this.performUpdate(e);return}this.chat.addChild(new i(t.fg("dim","Continuing without update..."),1,0)),this.render();return}const r=`${t.fg("accent","Update Available")}
+
+${t.fg("dim",`Current: ${f}`)}
+${t.fg("success",`Latest:  ${e}`)}`,a=[];a.push("1. Update now and restart"),a.push("2. Exit and I'll update manually"),a.push("3. Skip this version"),n!=="always"?a.push("4. Enable auto-update"):a.push("4. Disable auto-update");const d=n==="always"?`
+
+${t.fg("success","\u25CF Auto-update is enabled")}`:`
+
+${t.fg("dim","\u25CB Auto-update is disabled")}`,o=await this.ctx.showSelector(r+d,a);if(!o){this.chat.addChild(new i(t.fg("dim","Returning to chat..."),1,0)),this.render();return}o.includes("Update now")?await this.performUpdate(e):o.includes("Exit")?(this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("accent","\u{1F44B} Exiting. Run this command to update:"),1,0)),this.chat.addChild(new i(t.fg("dim",`  npm install -g ${l}@latest`),1,0)),this.render(),await new Promise(h=>setTimeout(h,2e3)),process.exit(0)):o.includes("Skip")?(this.ctx.setSkippedVersion(e),this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("dim",`\u23ED\uFE0F  Skipped version ${e}. You won't be prompted for this version again.`),1,0)),this.chat.addChild(new i(t.fg("dim","   You can clear this skip later from settings."),1,0)),this.render()):o.includes("Enable auto-update")?(this.ctx.setAutoUpdate("always"),this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("success","\u2705 Auto-update enabled! Catui will check for updates on startup."),1,0)),this.render(),await this.performUpdate(e)):o.includes("Disable auto-update")&&(this.ctx.setAutoUpdate("prompt"),this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("dim","\u2705 Auto-update disabled. You'll be prompted when updates are available."),1,0)),this.render())}async performUpdate(e,n=0){return this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("accent","\u{1F504} Updating Catui..."),1,0)),this.render(),new Promise(s=>{const r=m(["install","-g","--force",`${l}@latest`]);let a="";r.stderr?.on("data",d=>{a+=d.toString()}),r.on("close",async d=>{d===0?(this.chat.addChild(new i(t.fg("success",`\u2705 Successfully updated to version ${e}!`),1,0)),this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("accent","Press 'R' to restart or Ctrl+C to exit manually"),1,0)),this.render(),u(async()=>{const h=await this.waitForKeyPress(["r","R","q","Q",""]);h==="r"||h==="R"?(this.chat.addChild(new i(t.fg("dim","\u{1F504} Restarting Catui..."),1,0)),this.render(),this.restartCatui()):process.exit(0)},"waitForRestart")().then(()=>s())):(this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Update failed (exit code ${d})`),1,0)),this.chat.addChild(new i(t.fg("dim","This may be a network issue or permissions problem."),1,0)),this.render(),s(),this.showRetryOptions(e,n))}),r.on("error",async d=>{this.chat.addChild(new i(t.fg("warning",`\u26A0\uFE0F  Failed to run npm: ${d.message}`),1,0)),this.chat.addChild(new i(t.fg("dim","Make sure npm is installed and in your PATH."),1,0)),this.render(),s(),this.showRetryOptions(e,n)})})}async showRetryOptions(e,n){await new Promise(a=>setTimeout(a,500));const s=["1. Try again","2. Exit and update manually"];(await this.ctx.showSelector(`${t.fg("accent","Update Failed")}
+
+${t.fg("dim","What would you like to do?")}`,s))?.includes("Try again")?n<3?await this.performUpdate(e,n+1):(this.chat.addChild(new i(t.fg("dim","Multiple retry attempts failed. Please try updating manually."),1,0)),this.chat.addChild(new i(t.fg("dim",`  npm install -g ${l}@latest`),1,0)),this.render()):(this.chat.addChild(new c(1)),this.chat.addChild(new i(t.fg("accent","\u{1F44B} Exiting. Run this command to update:"),1,0)),this.chat.addChild(new i(t.fg("dim",`  npm install -g ${l}@latest`),1,0)),this.render(),await new Promise(a=>setTimeout(a,2e3)),process.exit(0))}async waitForKeyPress(e){if(!process.stdin.isTTY){const n=e.filter(a=>a!=="").map(a=>`Press '${a}'`);n.push("Cancel");const s=await this.ctx.showSelector(t.fg("accent","Restart Options"),n);return!s||s.includes("Cancel")?"":e.find(a=>s.includes(a))??""}return new Promise(n=>{const s=process.stdin,r=s.isRaw,a=u(()=>{try{s.isTTY&&s.setRawMode(r)}catch{}s.pause(),s.removeListener("data",d)},"cleanup"),d=u(o=>{const h=o.toString();(h===""||e.includes(h))&&(a(),n(h===""?"":h))},"onData");try{s.setRawMode(!0),s.resume(),s.on("data",d)}catch{a(),n(null)}})}restartCatui(){const e=process.argv,n=e[0],s=e.slice(1);n.includes("catui")||n.includes("catui")?g(n,s,{detached:!0,stdio:"ignore"}).unref():g(process.execPath,e.slice(1),{detached:!0,stdio:"ignore"}).unref(),process.exit(0)}compareVersion(e,n){const s=e.split(".").map(Number),r=n.split(".").map(Number);for(let a=0;a<Math.max(s.length,r.length);a++){const d=s[a]??0,o=r[a]??0;if(d>o)return 1;if(d<o)return-1}return 0}}export{A as SelfUpdateController};

package/dist/modes/interactive/controllers/settings-overlay-controller.d.ts

@@ -0,0 +1,56 @@
+/**
+ * [WHO]: Provides SettingsOverlayController + SettingsOverlayContext — interactive /settings overlay orchestration
+ * [FROM]: Depends on AgentSession, SettingsManager, SettingsSelectorComponent, interactive theme/render/editor ports
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts for the /settings command
+ * [HERE]: modes/interactive/controllers/settings-overlay-controller.ts — P5 settings-overlay slice (UI07, hybrid)
+ *
+ * Owns the interactive settings overlay wiring only. Settings persistence remains in SettingsManager,
+ * session behavior remains in AgentSession, and render/editor/buddy effects are delegated through ports.
+ */
+import type { Component } from "@catui/tui";
+import type { AgentSession } from "../../../core/runtime/agent-session.js";
+import type { SettingsManager } from "../../../core/platform/config/settings-manager.js";
+export interface SettingsOverlaySurface {
+    showSelector(create: (done: () => void) => {
+        component: Component;
+        focus: Component;
+    }): void;
+    showStatus(message: string): void;
+    showError(message: string): void;
+    invalidateUi(): void;
+    requestRender(): void;
+    setShowHardwareCursor(enabled: boolean): void;
+    setClearOnShrink(enabled: boolean): void;
+}
+export interface SettingsOverlayFooterPort {
+    setAutoCompactEnabled(enabled: boolean): void;
+    setShowTokenStats(enabled: boolean): void;
+    invalidate(): void;
+}
+export interface SettingsOverlayEditorPort {
+    setPaddingX(padding: number): void;
+    setAutocompleteMaxVisible(maxVisible: number): void;
+    updateBorderColor(): void;
+}
+export interface SettingsOverlayRenderPort {
+    setToolImagesEnabled(enabled: boolean): void;
+    setAssistantThinkingHidden(hidden: boolean): void;
+    rebuildChatFromMessages(): void;
+}
+export interface SettingsOverlayContext {
+    session: AgentSession;
+    settingsManager: SettingsManager;
+    surface: SettingsOverlaySurface;
+    footer: SettingsOverlayFooterPort;
+    editor: SettingsOverlayEditorPort;
+    render: SettingsOverlayRenderPort;
+    getHideThinkingBlock(): boolean;
+    setHideThinkingBlock(hidden: boolean): void;
+    rebuildAutocomplete(): void;
+    syncBuddyPet(): void;
+}
+export declare class SettingsOverlayController {
+    private readonly ctx;
+    constructor(ctx: SettingsOverlayContext);
+    showSettingsSelector(): void;
+}

package/dist/modes/interactive/controllers/settings-overlay-controller.js

@@ -0,0 +1,2 @@
+var g=Object.defineProperty;var o=(a,s)=>g(a,"name",{value:s,configurable:!0});import{getAvailableThemes as c,setTheme as i}from"../theme/theme.js";import{SettingsSelectorComponent as h}from"../components/settings-selector.js";class C{static{o(this,"SettingsOverlayController")}ctx;constructor(s){this.ctx=s}showSettingsSelector(){const{session:s,settingsManager:t}=this.ctx;this.ctx.surface.showSelector(l=>{const r=new h({autoCompact:s.autoCompactionEnabled,showImages:t.getShowImages(),autoResizeImages:t.getImageAutoResize(),blockImages:t.getBlockImages(),enableSkillCommands:t.getEnableSkillCommands(),steeringMode:s.steeringMode,followUpMode:s.followUpMode,transport:t.getTransport(),agentLoopFramework:t.getAgentLoopFramework()??"model-default",thinkingLevel:s.thinkingLevel,availableThinkingLevels:s.getAvailableThinkingLevels(),currentTheme:t.getTheme()||"dark",availableThemes:c(),hideThinkingBlock:this.ctx.getHideThinkingBlock(),collapseChangelog:t.getCollapseChangelog(),doubleEscapeAction:t.getDoubleEscapeAction(),showHardwareCursor:t.getShowHardwareCursor(),editorPaddingX:t.getEditorPaddingX(),autocompleteMaxVisible:t.getAutocompleteMaxVisible(),quietStartup:t.getQuietStartup(),clearOnShrink:t.getClearOnShrink(),showTokenStats:t.getShowTokenStats(),buddyEnabled:t.getBuddyEnabled(),buddySpecies:t.getBuddySpecies(),showWorkingTrace:t.getShowWorkingTrace(),showMemoryTrace:t.getShowMemoryTrace(),presenceEnabled:t.getPresenceEnabled()},{onAutoCompactChange:o(e=>{s.setAutoCompactionEnabled(e),this.ctx.footer.setAutoCompactEnabled(e)},"onAutoCompactChange"),onShowImagesChange:o(e=>{t.setShowImages(e),this.ctx.render.setToolImagesEnabled(e)},"onShowImagesChange"),onAutoResizeImagesChange:o(e=>{t.setImageAutoResize(e)},"onAutoResizeImagesChange"),onBlockImagesChange:o(e=>{t.setBlockImages(e)},"onBlockImagesChange"),onEnableSkillCommandsChange:o(e=>{t.setEnableSkillCommands(e),this.ctx.rebuildAutocomplete()},"onEnableSkillCommandsChange"),onSteeringModeChange:o(e=>{s.setSteeringMode(e)},"onSteeringModeChange"),onFollowUpModeChange:o(e=>{s.setFollowUpMode(e)},"onFollowUpModeChange"),onTransportChange:o(e=>{t.setTransport(e),s.agent.setTransport(e)},"onTransportChange"),onAgentLoopFrameworkChange:o(e=>{const n=e==="model-default"?void 0:e;t.setAgentLoopFramework(n),s.setAgentLoopFramework(n),this.ctx.footer.invalidate(),this.ctx.surface.showStatus(`Agent loop: ${s.agentLoopFramework}`)},"onAgentLoopFrameworkChange"),onThinkingLevelChange:o(e=>{s.setThinkingLevel(e),this.ctx.footer.invalidate(),this.ctx.editor.updateBorderColor()},"onThinkingLevelChange"),onThemeChange:o(e=>{const n=i(e,!0);t.setTheme(e),this.ctx.surface.invalidateUi(),n.success||this.ctx.surface.showError(`Failed to load theme "${e}": ${n.error}
+Fell back to dark theme.`)},"onThemeChange"),onThemePreview:o(e=>{i(e,!0).success&&(this.ctx.surface.invalidateUi(),this.ctx.surface.requestRender())},"onThemePreview"),onHideThinkingBlockChange:o(e=>{this.ctx.setHideThinkingBlock(e),t.setHideThinkingBlock(e),this.ctx.render.setAssistantThinkingHidden(e),this.ctx.render.rebuildChatFromMessages()},"onHideThinkingBlockChange"),onCollapseChangelogChange:o(e=>{t.setCollapseChangelog(e)},"onCollapseChangelogChange"),onQuietStartupChange:o(e=>{t.setQuietStartup(e)},"onQuietStartupChange"),onShowWorkingTraceChange:o(e=>{t.setShowWorkingTrace(e)},"onShowWorkingTraceChange"),onShowMemoryTraceChange:o(e=>{t.setShowMemoryTrace(e)},"onShowMemoryTraceChange"),onDoubleEscapeActionChange:o(e=>{t.setDoubleEscapeAction(e)},"onDoubleEscapeActionChange"),onShowHardwareCursorChange:o(e=>{t.setShowHardwareCursor(e),this.ctx.surface.setShowHardwareCursor(e)},"onShowHardwareCursorChange"),onEditorPaddingXChange:o(e=>{t.setEditorPaddingX(e),this.ctx.editor.setPaddingX(e)},"onEditorPaddingXChange"),onAutocompleteMaxVisibleChange:o(e=>{t.setAutocompleteMaxVisible(e),this.ctx.editor.setAutocompleteMaxVisible(e)},"onAutocompleteMaxVisibleChange"),onClearOnShrinkChange:o(e=>{t.setClearOnShrink(e),this.ctx.surface.setClearOnShrink(e)},"onClearOnShrinkChange"),onShowTokenStatsChange:o(e=>{t.setShowTokenStats(e),this.ctx.footer.setShowTokenStats(e),this.ctx.surface.requestRender()},"onShowTokenStatsChange"),onBuddyEnabledChange:o(e=>{t.setBuddyEnabled(e),this.ctx.syncBuddyPet()},"onBuddyEnabledChange"),onBuddySpeciesChange:o(e=>{t.setBuddySpecies(e),this.ctx.syncBuddyPet()},"onBuddySpeciesChange"),onPresenceEnabledChange:o(e=>{t.setPresenceEnabled(e)},"onPresenceEnabledChange"),onCancel:o(()=>{l(),this.ctx.surface.requestRender()},"onCancel")});return{component:r,focus:r.getSettingsList()}})}}export{C as SettingsOverlayController};

package/dist/modes/interactive/controllers/slash-dispatcher-controller.d.ts

@@ -0,0 +1,74 @@
+/**
+ * [WHO]: Provides SlashDispatcherController + SlashDispatcherContext — built-in slash command dispatch
+ * [FROM]: Depends on injected interactive command owner callbacks; no direct TUI/session/model owner imports
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts for built-in slash execution
+ * [HERE]: modes/interactive/controllers/slash-dispatcher-controller.ts — P5 slash-dispatcher slice (UI02, dispatch-table rewrite)
+ *
+ * Owns command-token dispatch only. Input submission rules, extension command execution, persona-in-text
+ * handling, bash mode, attachments, and streaming steer remain outside this controller.
+ */
+export type SlashCommandHandler = (text: string, clear: () => void) => void | Promise<void>;
+export interface SlashDispatcherModelPort {
+    showScopedModelsSelector(): Promise<void>;
+    handleModelCommand(searchTerm?: string): Promise<void>;
+    handleThinkingCommand(text: string): void;
+}
+export interface SlashDispatcherAuthPort {
+    handleApiKeyCommand(): Promise<void>;
+    handleLoginCommand(text: string): Promise<void>;
+    showLogoutSelector(): void;
+}
+export interface SlashDispatcherTreePort {
+    showForkSelector(): void;
+    showTreeSelector(): void;
+    showSessionSelector(): void;
+}
+export interface SlashDispatcherSelfUpdatePort {
+    handleUpdateCommand(): void;
+    handleReinstallCommand(): void;
+}
+export interface SlashDispatcherCommandHandlers {
+    isExtensionCommand(text: string): boolean;
+    handleAgentLoopCommand(text: string): void | Promise<void>;
+    handleMcpCommand(text: string): Promise<void>;
+    handleExportCommand(text: string): Promise<void>;
+    handleShareCommand(): Promise<void>;
+    handleCopyCommand(): void;
+    handleStatusCommand(): Promise<void>;
+    handleUsageCommand(): Promise<void>;
+    handleNameCommand(text: string): void;
+    handleSessionCommand(): void;
+    handleChangelogCommand(): void;
+    handleHotkeysCommand(): void;
+    handleShowResourcesCommand(): void;
+    handleClearCommand(): Promise<void>;
+    handleCompactCommand(customInstructions?: string): Promise<void>;
+    handleReloadCommand(): Promise<void>;
+    handleLanguageCommand(text: string): Promise<void>;
+    handleSoulCommand(): void;
+    handlePersonaCommand(text: string): Promise<void>;
+    handleMemoryCommand(): void;
+    handleArminSaysHi(): void;
+    handleBrowserOptInCommand(): void;
+    shutdown(): Promise<void>;
+}
+export interface SlashDispatcherContext {
+    clearEditor(): void;
+    settings: {
+        showSettingsSelector(): void;
+    };
+    model: SlashDispatcherModelPort;
+    auth: SlashDispatcherAuthPort;
+    tree: SlashDispatcherTreePort;
+    selfUpdate: SlashDispatcherSelfUpdatePort;
+    commands: SlashDispatcherCommandHandlers;
+}
+export declare class SlashDispatcherController {
+    private readonly ctx;
+    private readonly builtinSlashCommands;
+    constructor(ctx: SlashDispatcherContext);
+    execute(text: string, options?: {
+        clearEditor?: boolean;
+    }): Promise<boolean>;
+    private createBuiltinSlashCommands;
+}

package/dist/modes/interactive/controllers/slash-dispatcher-controller.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var s=(e,a)=>i(e,"name",{value:a,configurable:!0});class l{static{s(this,"SlashDispatcherController")}ctx;builtinSlashCommands;constructor(a){this.ctx=a,this.builtinSlashCommands=this.createBuiltinSlashCommands()}async execute(a,t){if(!a.startsWith("/"))return!1;const n=t?.clearEditor??!0,d=s(()=>{n&&this.ctx.clearEditor()},"clear"),o=a.indexOf(" "),m=o===-1?a:a.slice(0,o);if(m==="/browser"&&this.ctx.commands.isExtensionCommand(a))return!1;const c=this.builtinSlashCommands[m];return c?(await c(a,d),!0):!1}createBuiltinSlashCommands(){return{"/settings":s((a,t)=>{this.ctx.settings.showSettingsSelector(),t()},"/settings"),"/apikey":s(async(a,t)=>{await this.ctx.auth.handleApiKeyCommand(),t()},"/apikey"),"/scoped-models":s(async(a,t)=>{t(),await this.ctx.model.showScopedModelsSelector()},"/scoped-models"),"/model":s(async(a,t)=>{const n=a.startsWith("/model ")?a.slice(7).trim():void 0;t(),await this.ctx.model.handleModelCommand(n)},"/model"),"/thinking":s((a,t)=>{this.ctx.model.handleThinkingCommand(a),t()},"/thinking"),"/agent-loop":s(async(a,t)=>{await this.ctx.commands.handleAgentLoopCommand(a),t()},"/agent-loop"),"/mcp":s(async(a,t)=>{await this.ctx.commands.handleMcpCommand(a),t()},"/mcp"),"/export":s(async(a,t)=>{await this.ctx.commands.handleExportCommand(a),t()},"/export"),"/share":s(async(a,t)=>{await this.ctx.commands.handleShareCommand(),t()},"/share"),"/copy":s((a,t)=>{this.ctx.commands.handleCopyCommand(),t()},"/copy"),"/status":s(async(a,t)=>{await this.ctx.commands.handleStatusCommand(),t()},"/status"),"/usage":s(async(a,t)=>{await this.ctx.commands.handleUsageCommand(),t()},"/usage"),"/name":s((a,t)=>{this.ctx.commands.handleNameCommand(a),t()},"/name"),"/session":s((a,t)=>{this.ctx.commands.handleSessionCommand(),t()},"/session"),"/changelog":s((a,t)=>{this.ctx.commands.handleChangelogCommand(),t()},"/changelog"),"/hotkeys":s((a,t)=>{this.ctx.commands.handleHotkeysCommand(),t()},"/hotkeys"),"/resources":s((a,t)=>{this.ctx.commands.handleShowResourcesCommand(),t()},"/resources"),"/fork":s((a,t)=>{this.ctx.tree.showForkSelector(),t()},"/fork"),"/tree":s((a,t)=>{this.ctx.tree.showTreeSelector(),t()},"/tree"),"/login":s(async(a,t)=>{await this.ctx.auth.handleLoginCommand(a),t()},"/login"),"/logout":s((a,t)=>{this.ctx.auth.showLogoutSelector(),t()},"/logout"),"/new":s(async(a,t)=>{t(),await this.ctx.commands.handleClearCommand()},"/new"),"/update":s((a,t)=>{this.ctx.selfUpdate.handleUpdateCommand(),t()},"/update"),"/reinstall":s((a,t)=>{this.ctx.selfUpdate.handleReinstallCommand(),t()},"/reinstall"),"/compact":s(async(a,t)=>{const n=a.startsWith("/compact ")?a.slice(9).trim():void 0;t(),await this.ctx.commands.handleCompactCommand(n)},"/compact"),"/reload":s(async(a,t)=>{t(),await this.ctx.commands.handleReloadCommand()},"/reload"),"/language":s(async(a,t)=>{await this.ctx.commands.handleLanguageCommand(a),t()},"/language"),"/soul":s((a,t)=>{this.ctx.commands.handleSoulCommand(),t()},"/soul"),"/persona":s(async(a,t)=>{t(),await this.ctx.commands.handlePersonaCommand(a)},"/persona"),"/memory":s((a,t)=>{this.ctx.commands.handleMemoryCommand(),t()},"/memory"),"/browser":s((a,t)=>{this.ctx.commands.handleBrowserOptInCommand(),t()},"/browser"),"/arminsayshi":s((a,t)=>{this.ctx.commands.handleArminSaysHi(),t()},"/arminsayshi"),"/resume":s((a,t)=>{this.ctx.tree.showSessionSelector(),t()},"/resume"),"/quit":s(async(a,t)=>{t(),await this.ctx.commands.shutdown()},"/quit")}}}export{l as SlashDispatcherController};

package/dist/modes/interactive/controllers/stream-render-controller.d.ts

@@ -0,0 +1,110 @@
+/**
+ * [WHO]: Provides StreamRenderController + StreamRenderContext (state/layout/loaders/toolTrace/runtime/
+ *        escape/surface ports) — the interactive streaming render layer (handleEvent)
+ * [FROM]: Depends on interactive-state (shared render fields), tui (Container/Text/Spacer/TUI/MarkdownTheme),
+ *         components (Assistant/Tool/CatuiLoader), theme, agent-session (AgentSessionEvent), ai (Message),
+ *         agent-core (AgentMessage), extensions-host (ToolDefinition), buddy pet-sprites (BuddyState)
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts (held as `this.streamRender`; subscribeToAgent's
+ *       handleEvent forwards here)
+ * [HERE]: modes/interactive/controllers/stream-render-controller.ts — P5 UI04 render-layer slice (scope A)
+ *
+ * Owns the AgentSession event → TUI render orchestration: run lifecycle/loader, assistant streaming,
+ * user/custom echo, tool-execution display, and the auto-compaction / auto-retry overlays. It is a render
+ * layer: it reads session events and writes components, and NEVER submits any message to AgentSession
+ * (token-neutral). Shared render state stays in the consolidated `interactive-state` holder (accessed via
+ * the `state` port — that holder's stated purpose); the auto-compaction / auto-retry loader+escape state
+ * (zero external readers) is owned privately here. The escape override during compaction/retry goes through
+ * the `escape` port — the single controlled channel onto `defaultEditor.onEscape` shared with
+ * InterruptController (whose dispatchEscape closure is what gets saved and restored).
+ * See ../../../.dev-docs/architecture-review/interactive-ui-review/handle-event-analysis.md
+ */
+import type { AgentMessage } from "@catui/agent-core";
+import type { Message } from "@catui/ai/types";
+import { type CachedContainer, type Container, type MarkdownTheme, type TUI } from "@catui/tui";
+import type { ToolDefinition } from "../../../core/extensions-host/types.js";
+import type { AgentSessionEvent } from "../../../core/runtime/agent-session.js";
+import type { BuddyState } from "../components/buddy/pet-sprites.js";
+import type { InteractiveState } from "../state/interactive-state.js";
+export interface StreamRenderStatePort {
+    get(): InteractiveState;
+}
+export interface StreamRenderLayoutPort {
+    getUi(): TUI;
+    getChatContainer(): CachedContainer;
+    getStatusContainer(): Container;
+    addMessageToChat(message: AgentMessage): void;
+    updatePendingMessagesDisplay(): void;
+    rebuildChatFromMessages(): void;
+    requestRender(): void;
+    invalidateFooter(): void;
+}
+export interface StreamRenderLoadersPort {
+    getSessionId(): string;
+    getDefaultWorkingMessage(): string;
+    /** Localized "<key> to cancel" hint key for the interrupt action. */
+    getInterruptKeyHint(): string;
+    setBuddyPetState(state: BuddyState, speechBubble?: string, options?: {
+        resetTo?: BuddyState;
+        afterMs?: number;
+    }): void;
+    startAgentRunTimer(): void;
+    stopAgentRunTimer(): void;
+    updateWorkingMessage(options?: {
+        resetStallTimer?: boolean;
+    }): void;
+    formatElapsedSeconds(ms: number): string;
+    isInPlanMode(): boolean;
+}
+export interface StreamRenderToolTracePort {
+    shouldRenderToolTrace(toolName: string): boolean;
+    getRegisteredToolDefinition(toolName: string): ToolDefinition | undefined;
+    getShowImages(): boolean;
+}
+export interface StreamRenderRuntimePort {
+    getRetryAttempt(): number;
+    abortCompaction(): void;
+    abortRetry(): void;
+    flushCompactionQueue(options: {
+        willRetry: boolean;
+    }): void;
+    checkShutdownRequested(): Promise<void>;
+    clearAttachments(): void;
+    getAgentDir(): string;
+}
+/** The single controlled channel onto defaultEditor.onEscape, shared with InterruptController. */
+export interface StreamRenderEscapePort {
+    getHandler(): (() => void) | undefined;
+    setHandler(handler: (() => void) | undefined): void;
+}
+export interface StreamRenderSurfacePort {
+    ensureInitialized(): Promise<void>;
+    restoreEditorFocusIfPossible(): void;
+    getUserMessageText(message: Message): string;
+    getMarkdownThemeWithSettings(): MarkdownTheme;
+    showStatus(message: string): void;
+    showError(message: string): void;
+}
+export interface StreamRenderContext {
+    state: StreamRenderStatePort;
+    layout: StreamRenderLayoutPort;
+    loaders: StreamRenderLoadersPort;
+    toolTrace: StreamRenderToolTracePort;
+    runtime: StreamRenderRuntimePort;
+    escape: StreamRenderEscapePort;
+    surface: StreamRenderSurfacePort;
+}
+export declare class StreamRenderController {
+    private readonly ctx;
+    private autoCompactionLoader;
+    private autoCompactionEscapeHandler;
+    private retryLoader;
+    private retryEscapeHandler;
+    private taskUpdateUnsubscribe;
+    private taskAutoHideTimer;
+    constructor(ctx: StreamRenderContext);
+    handle(event: AgentSessionEvent): Promise<void>;
+    /** Task tool names that should trigger a panel refresh. */
+    private static readonly TASK_TOOL_NAMES;
+    /** Refresh the task status panel from disk. */
+    private refreshTaskPanel;
+}

package/dist/modes/interactive/controllers/stream-render-controller.js

@@ -0,0 +1,2 @@
+var A=Object.defineProperty;var u=(i,t)=>A(i,"name",{value:t,configurable:!0});import*as h from"node:fs";import*as P from"node:os";import*as f from"node:path";import{Spacer as b,Text as y}from"@catui/tui";import{AssistantMessageComponent as S}from"../components/assistant-message.js";import{CatuiLoader as g}from"../components/catui-loader.js";import{ToolExecutionComponent as x}from"../components/tool-execution.js";import{SubAgentPanelComponent as M}from"../components/sub-agent-panel.js";import{PlanProgressPanelComponent as R}from"../components/plan-progress-panel.js";import{TaskStatusPanelComponent as _}from"../components/task-status-panel.js";import{theme as l}from"../theme/theme.js";import{listTasks as T,onTasksUpdated as w,resetTaskList as E}from"../../../extensions/builtin/task/task-store.js";import{DEFAULT_TASK_LIST_ID as m}from"../../../extensions/builtin/task/task-types.js";const z=new Set(["TaskCreate","TaskUpdate","TaskList","TaskGet","TaskStop","TaskDelete"]),H=process.env.CATUI_DEBUG==="1",k=f.join(P.homedir(),".catui","agent","catui-debug.log");function C(i){if(H)try{h.mkdirSync(f.dirname(k),{recursive:!0}),h.appendFileSync(k,`[${new Date().toISOString()}] [render] ${i}
+`)}catch{}}u(C,"dbg");const I=5e3;class Y{static{u(this,"StreamRenderController")}ctx;autoCompactionLoader=void 0;autoCompactionEscapeHandler=void 0;retryLoader=void 0;retryEscapeHandler=void 0;taskUpdateUnsubscribe=void 0;taskAutoHideTimer=void 0;constructor(t){this.ctx=t}async handle(t){C(`handle event: ${t.type}`),await this.ctx.surface.ensureInitialized(),this.ctx.layout.invalidateFooter();const e=this.ctx.state.get(),n=this.ctx.layout.getUi(),a=this.ctx.layout.getChatContainer(),o=this.ctx.layout.getStatusContainer();switch(t.type){case"agent_start":this.retryEscapeHandler&&(this.ctx.escape.setHandler(this.retryEscapeHandler),this.retryEscapeHandler=void 0),this.retryLoader&&(this.retryLoader.stop(),this.retryLoader=void 0),e.loadingAnimation&&e.loadingAnimation.stop(),o.clear(),e.loadingAnimation=new g(n,l,this.ctx.loaders.getDefaultWorkingMessage(),this.ctx.loaders.getSessionId()),o.addChild(e.loadingAnimation),this.ctx.loaders.setBuddyPetState("working","Working..."),e.pendingWorkingMessage!==void 0&&(e.workingMessageOverride=e.pendingWorkingMessage||void 0,e.pendingWorkingMessage=void 0),this.ctx.loaders.startAgentRunTimer(),this.ctx.loaders.updateWorkingMessage({resetStallTimer:!1}),this.ctx.loaders.isInPlanMode()&&(e.planProgress=L(),e.planProgressPanel=new R(n,l),o.addChild(e.planProgressPanel),e.planProgressPanel.update(e.planProgress)),this.refreshTaskPanel(e,n,o).catch(()=>{}),this.taskUpdateUnsubscribe?.(),this.taskUpdateUnsubscribe=w(()=>{this.refreshTaskPanel(e,n,o).catch(()=>{})}),this.ctx.surface.restoreEditorFocusIfPossible(),this.ctx.layout.requestRender();break;case"message_start":if(t.message.role==="custom")this.ctx.layout.addMessageToChat(t.message),this.ctx.layout.requestRender();else if(t.message.role==="user"){const s=this.ctx.surface.getUserMessageText(t.message);if(e.optimisticUserMessages.length>0&&e.optimisticUserMessages[0]?.text===s){e.optimisticUserMessages.shift(),this.ctx.layout.updatePendingMessagesDisplay(),this.ctx.layout.requestRender();break}this.ctx.layout.addMessageToChat(t.message),this.ctx.layout.updatePendingMessagesDisplay(),this.ctx.layout.requestRender()}else t.message.role==="assistant"&&(e.streamingComponent=new S(void 0,e.hideThinkingBlock,this.ctx.surface.getMarkdownThemeWithSettings()),e.streamingMessage=t.message,a.addChild(e.streamingComponent),e.streamingComponent.updateContent(e.streamingMessage),this.ctx.layout.requestRender());break;case"message_update":if(e.streamingComponent&&t.message.role==="assistant"){e.loadingAnimation&&e.loadingAnimation.resetStallTimer(),e.streamingMessage=t.message,e.streamingComponent.updateContent(e.streamingMessage),a.markDirty(e.streamingComponent);for(const s of e.streamingMessage.content)if(s.type==="toolCall"){if(!this.ctx.toolTrace.shouldRenderToolTrace(s.name))continue;if(e.pendingTools.has(s.id)){const r=e.pendingTools.get(s.id);r&&(r.updateArgs(s.arguments),a.markDirty(r))}else{a.addChild(new y("",0,0));const r=new x(s.name,s.arguments,{showImages:this.ctx.toolTrace.getShowImages()},this.ctx.toolTrace.getRegisteredToolDefinition(s.name),n);r.setExpanded(e.toolOutputExpanded),a.addChild(r),e.pendingTools.set(s.id,r)}}this.ctx.layout.requestRender()}break;case"message_end":if(t.message.role==="user")break;if(e.streamingComponent&&t.message.role==="assistant"){e.streamingMessage=t.message;let s;if(e.streamingMessage.stopReason==="aborted"){const r=this.ctx.runtime.getRetryAttempt();s=r>0?`Aborted after ${r} retry attempt${r>1?"s":""}`:"Operation aborted",e.streamingMessage.errorMessage=s}if(e.streamingComponent.updateContent(e.streamingMessage),a.markDirty(e.streamingComponent),e.streamingMessage.stopReason==="aborted"||e.streamingMessage.stopReason==="error"){s||(s=e.streamingMessage.errorMessage||"Error");for(const[,r]of e.pendingTools.entries())r.updateResult({content:[{type:"text",text:s}],isError:!0}),a.markDirty(r);e.pendingTools.clear()}else for(const[,r]of e.pendingTools.entries())r.setArgsComplete(),a.markDirty(r);e.streamingComponent=void 0,e.streamingMessage=void 0,this.ctx.layout.invalidateFooter()}this.ctx.layout.requestRender();break;case"tool_execution_start":{if(e.planProgress&&e.planProgressPanel&&(U(e.planProgress,t.toolName,t.args),e.planProgressPanel.update(e.planProgress),this.ctx.layout.requestRender()),!this.ctx.toolTrace.shouldRenderToolTrace(t.toolName))break;if(!e.pendingTools.has(t.toolCallId)){const s=new x(t.toolName,t.args,{showImages:this.ctx.toolTrace.getShowImages()},this.ctx.toolTrace.getRegisteredToolDefinition(t.toolName),n);s.setExpanded(e.toolOutputExpanded),a.addChild(s),e.pendingTools.set(t.toolCallId,s),this.ctx.layout.requestRender()}break}case"tool_execution_update":{const s=e.pendingTools.get(t.toolCallId);s&&(s.updateResult({...t.partialResult,isError:!1},!0),a.markDirty(s),this.ctx.layout.requestRender());break}case"tool_execution_end":{const s=e.pendingTools.get(t.toolCallId);s&&(s.updateResult({...t.result,isError:t.isError}),a.markDirty(s),e.pendingTools.delete(t.toolCallId),this.ctx.layout.requestRender());break}case"agent_end":{C("agent_end received");const s=e.agentRunStartMs!==void 0?this.ctx.loaders.formatElapsedSeconds(Date.now()-e.agentRunStartMs):void 0;this.ctx.loaders.stopAgentRunTimer(),e.agentRunStartMs=void 0,e.workingMessageOverride=void 0,e.loadingAnimation&&(e.loadingAnimation.stop(),e.loadingAnimation=void 0,o.clear()),e.streamingComponent&&(a.removeChild(e.streamingComponent),e.streamingComponent=void 0,e.streamingMessage=void 0),e.pendingTools.clear(),e.subAgentPanelComponent&&(o.removeChild(e.subAgentPanelComponent),e.subAgentPanelComponent=void 0),e.subAgentStates.clear(),e.planProgressPanel&&(o.removeChild(e.planProgressPanel),e.planProgressPanel=void 0),e.planProgress=void 0,e.taskStatusPanel&&(o.removeChild(e.taskStatusPanel),e.taskStatusPanel=void 0),this.taskAutoHideTimer&&(clearTimeout(this.taskAutoHideTimer),this.taskAutoHideTimer=void 0),this.ctx.runtime.clearAttachments(),this.ctx.loaders.setBuddyPetState("happy","Done!",{resetTo:"idle",afterMs:1800}),s&&this.ctx.surface.showStatus(`Completed in ${s}`),await this.ctx.runtime.checkShutdownRequested(),this.ctx.surface.restoreEditorFocusIfPossible(),this.ctx.layout.requestRender();break}case"sub_agent_start":{const s={id:t.subAgentId,agentType:t.agentType,description:t.description,isAsync:t.isAsync,isResolved:!1,isError:!1,toolUseCount:0,lastToolName:null,startTime:Date.now()};e.subAgentStates.set(t.subAgentId,s),e.subAgentPanelComponent||(e.subAgentPanelComponent=new M(n,l),o.addChild(e.subAgentPanelComponent)),e.subAgentPanelComponent.update(e.subAgentStates),this.ctx.layout.requestRender();break}case"sub_agent_tool_start":{const s=e.subAgentStates.get(t.subAgentId);s&&(s.lastToolName=t.toolName,e.subAgentPanelComponent&&e.subAgentPanelComponent.update(e.subAgentStates),this.ctx.layout.requestRender());break}case"sub_agent_tool_end":{const s=e.subAgentStates.get(t.subAgentId);s&&(s.toolUseCount+=1,s.lastToolName=null,e.subAgentPanelComponent&&e.subAgentPanelComponent.update(e.subAgentStates),this.ctx.layout.requestRender());break}case"sub_agent_end":{const s=e.subAgentStates.get(t.subAgentId);s&&(s.isResolved=!0,s.isError=!t.success,s.lastToolName=null,e.subAgentPanelComponent&&e.subAgentPanelComponent.update(e.subAgentStates),this.ctx.layout.requestRender());break}case"auto_compaction_start":{this.autoCompactionEscapeHandler=this.ctx.escape.getHandler(),this.ctx.escape.setHandler(()=>{this.ctx.runtime.abortCompaction()}),o.clear();const s=t.reason==="overflow"?"Context overflow detected, ":"";this.autoCompactionLoader=new g(n,l,`${s}Auto-compacting... (${this.ctx.loaders.getInterruptKeyHint()} to cancel)`),o.addChild(this.autoCompactionLoader),this.ctx.layout.requestRender();break}case"auto_compaction_end":{this.autoCompactionEscapeHandler&&(this.ctx.escape.setHandler(this.autoCompactionEscapeHandler),this.autoCompactionEscapeHandler=void 0),this.autoCompactionLoader&&(this.autoCompactionLoader.stop(),this.autoCompactionLoader=void 0,o.clear()),t.aborted?this.ctx.surface.showStatus("Auto-compaction cancelled"):t.result?(a.clear(),this.ctx.layout.rebuildChatFromMessages(),this.ctx.layout.addMessageToChat({role:"compactionSummary",tokensBefore:t.result.tokensBefore,summary:t.result.summary,timestamp:Date.now()}),this.ctx.layout.invalidateFooter()):t.errorMessage&&(a.addChild(new b(1)),a.addChild(new y(l.fg("error",t.errorMessage),1,0))),this.ctx.runtime.flushCompactionQueue({willRetry:t.willRetry}),this.ctx.layout.requestRender();break}case"auto_retry_start":{this.retryEscapeHandler=this.ctx.escape.getHandler(),this.ctx.escape.setHandler(()=>{this.ctx.runtime.abortRetry()}),o.clear();const s=Math.round(t.delayMs/1e3);this.retryLoader=new g(n,l,`Retrying (${t.attempt}/${t.maxAttempts}) in ${s}s... (${this.ctx.loaders.getInterruptKeyHint()} to cancel)`),o.addChild(this.retryLoader),this.ctx.layout.requestRender();break}case"auto_retry_end":{this.retryEscapeHandler&&(this.ctx.escape.setHandler(this.retryEscapeHandler),this.retryEscapeHandler=void 0),this.retryLoader&&(this.retryLoader.stop(),this.retryLoader=void 0,o.clear()),t.success||this.ctx.surface.showError(`Retry failed after ${t.attempt} attempts: ${t.finalError||"Unknown error"}`),this.ctx.layout.requestRender();break}}}static TASK_TOOL_NAMES=new Set(["TaskCreate","TaskUpdate","TaskList","TaskGet","TaskStop","TaskDelete"]);async refreshTaskPanel(t,e,n){const a=this.ctx.runtime.getAgentDir();if(a)try{const o=await T(a,m),s=o.filter(d=>!d.metadata?._internal).map(d=>({id:d.id,subject:d.subject,status:d.status,activeForm:d.activeForm,blockedBy:d.blockedBy.filter(p=>o.some(c=>c.id===p&&c.status!=="completed"))}));if(s.length===0){t.taskStatusPanel&&(n.removeChild(t.taskStatusPanel),t.taskStatusPanel=void 0),this.taskAutoHideTimer&&(clearTimeout(this.taskAutoHideTimer),this.taskAutoHideTimer=void 0);return}t.taskStatusPanel||(t.taskStatusPanel=new _(e,l),n.addChild(t.taskStatusPanel)),t.taskStatusPanel.update(s),this.ctx.layout.requestRender(),s.every(d=>d.status==="completed")?this.taskAutoHideTimer||(this.taskAutoHideTimer=setTimeout(async()=>{this.taskAutoHideTimer=void 0;const d=await T(a,m).catch(()=>[]);d.length>0&&d.every(c=>c.status==="completed")&&await E(a,m).catch(()=>{})},I)):this.taskAutoHideTimer&&(clearTimeout(this.taskAutoHideTimer),this.taskAutoHideTimer=void 0)}catch{}}}const D=["Phase 1: Initial Understanding","Phase 2: Design","Phase 3: Review","Phase 4: Final Plan","Phase 5: Call ExitPlanMode"];function L(){return{phases:D.map((i,t)=>({label:i,status:t===0?"in_progress":"pending"})),currentPhaseIndex:0,startTime:Date.now()}}u(L,"createInitialPlanProgress");function U(i,t,e){let n;if(t==="ExitPlanMode"){for(const a of i.phases)a.status="completed";i.currentPhaseIndex=i.phases.length;return}if(t==="Agent")(e.subagent_type??"").toLowerCase()==="plan"?n=1:n=0;else if(t==="Read"||t==="Grep"||t==="Find")n=2;else if(t==="Write"||t==="Edit")n=3;else return void 0;if(n>i.currentPhaseIndex){for(let a=i.currentPhaseIndex;a<n;a++)i.phases[a].status="completed";i.currentPhaseIndex=n,i.phases[n].status="in_progress"}}u(U,"detectPlanPhaseTransition");export{Y as StreamRenderController};

package/dist/modes/interactive/controllers/tree-overlay-controller.d.ts

@@ -0,0 +1,55 @@
+/**
+ * [WHO]: Provides TreeOverlayController + TreeOverlayContext — interactive session tree/fork/resume overlays
+ * [FROM]: Depends on AgentSession/SessionManager for session lifecycle, TUI containers/components, PromptHost-like prompts
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts for /tree, /fork, /resume, keybindings, extension session switch
+ * [HERE]: modes/interactive/controllers/tree-overlay-controller.ts — P5 tree-overlay slice (UI05, pure move + rename)
+ *
+ * Owns interactive session selection overlays only. It delegates reusable session lifecycle behavior to
+ * AgentSession and SessionManager; it does not parse or mutate session files directly except the existing
+ * rename-session callback through SessionManager.open().
+ */
+import type { Component, Container, TUI } from "@catui/tui";
+import type { AgentSession } from "../../../core/runtime/agent-session.js";
+import { SessionManager } from "../../../core/session/session-manager.js";
+import type { KeybindingsManager } from "../../../core/platform/keybindings.js";
+export interface TreeOverlaySurface {
+    showSelector(create: (done: () => void) => {
+        component: Component;
+        focus: Component;
+    }): void;
+    showStatus(message: string): void;
+    showError(message: string): void;
+    requestRender(): void;
+    getUi(): TUI;
+    getChatContainer(): Container;
+    getStatusContainer(): Container;
+    clearChat(): void;
+    clearTransientSessionUi(): void;
+    addSessionNavigationBanner(message: string): void;
+    renderInitialMessages(): void;
+    getEditorText(): string;
+    setEditorText(text: string): void;
+    getEscapeHandler(): (() => void) | undefined;
+    setEscapeHandler(handler: (() => void) | undefined): void;
+}
+export interface TreeOverlayPromptHost {
+    selector(title: string, options: string[]): Promise<string | undefined>;
+    editor(title: string, prefill?: string): Promise<string | undefined>;
+}
+export interface TreeOverlayContext {
+    session: AgentSession;
+    getSessionManager(): SessionManager;
+    surface: TreeOverlaySurface;
+    promptHost: TreeOverlayPromptHost;
+    keybindings: KeybindingsManager;
+    shutdown(): Promise<void>;
+}
+export declare class TreeOverlayController {
+    private readonly ctx;
+    constructor(ctx: TreeOverlayContext);
+    private get sessionManager();
+    showForkSelector(): void;
+    showTreeSelector(initialSelectedId?: string): void;
+    showSessionSelector(): void;
+    resumeSession(sessionPath: string): Promise<void>;
+}

package/dist/modes/interactive/controllers/tree-overlay-controller.js

@@ -0,0 +1 @@
+var x=Object.defineProperty;var h=(m,e)=>x(m,"name",{value:e,configurable:!0});import{Spacer as d}from"@catui/tui";import{SessionManager as f}from"../../../core/session/session-manager.js";import{SessionSelectorComponent as g}from"../components/session-selector.js";import{TreeSelectorComponent as S}from"../components/tree-selector.js";import{UserMessageSelectorComponent as p}from"../components/user-message-selector.js";import{CatuiLoader as w}from"../components/catui-loader.js";import{appKey as C}from"../components/keybinding-hints.js";import{theme as y}from"../theme/theme.js";class q{static{h(this,"TreeOverlayController")}ctx;constructor(e){this.ctx=e}get sessionManager(){return this.ctx.getSessionManager()}showForkSelector(){const e=this.ctx.session.getUserMessagesForForking();if(e.length===0){this.ctx.surface.showStatus("No messages to fork from");return}this.ctx.surface.showSelector(i=>{const t=new p(e.map(r=>({id:r.entryId,text:r.text})),async r=>{const a=await this.ctx.session.fork(r);if(a.cancelled){i(),this.ctx.surface.requestRender();return}this.ctx.surface.clearChat(),this.ctx.surface.addSessionNavigationBanner("Branched session"),this.ctx.surface.renderInitialMessages(),this.ctx.surface.setEditorText(a.selectedText),i(),this.ctx.surface.showStatus("Branched to new session")},()=>{i(),this.ctx.surface.requestRender()});return{component:t,focus:t.getMessageList()}})}showTreeSelector(e){const i=this.sessionManager.getTree(),t=this.sessionManager.getLeafId();if(i.length===0){this.ctx.surface.showStatus("No entries in session");return}this.ctx.surface.showSelector(r=>{const a=new S(i,t,this.ctx.surface.getUi().terminal.rows,async n=>{if(n===t){r(),this.ctx.surface.showStatus("Already at this point");return}r();let c=!1,u;for(;;){const s=await this.ctx.promptHost.selector("Summarize branch?",["No summary","Summarize","Summarize with custom prompt"]);if(s===void 0){this.showTreeSelector(n);return}if(c=s!=="No summary",!(s==="Summarize with custom prompt"&&(u=await this.ctx.promptHost.editor("Custom summarization instructions"),u===void 0)))break}let o;const l=this.ctx.surface.getEscapeHandler();c&&(this.ctx.surface.setEscapeHandler(()=>{this.ctx.session.abortBranchSummary()}),this.ctx.surface.getChatContainer().addChild(new d(1)),o=new w(this.ctx.surface.getUi(),y,`Summarizing branch... (${C(this.ctx.keybindings,"interrupt")} to cancel)`),this.ctx.surface.getStatusContainer().addChild(o),this.ctx.surface.requestRender());try{const s=await this.ctx.session.navigateTree(n,{summarize:c,customInstructions:u});if(s.aborted){this.ctx.surface.showStatus("Branch summarization cancelled"),this.showTreeSelector(n);return}if(s.cancelled){this.ctx.surface.showStatus("Navigation cancelled");return}this.ctx.surface.clearChat(),this.ctx.surface.addSessionNavigationBanner("Navigated session tree"),this.ctx.surface.renderInitialMessages(),s.editorText&&!this.ctx.surface.getEditorText().trim()&&this.ctx.surface.setEditorText(s.editorText),this.ctx.surface.showStatus("Navigated to selected point")}catch(s){this.ctx.surface.showError(s instanceof Error?s.message:String(s))}finally{o&&(o.stop(),this.ctx.surface.getStatusContainer().clear()),this.ctx.surface.setEscapeHandler(l)}},()=>{r(),this.ctx.surface.requestRender()},(n,c)=>{this.sessionManager.appendLabelChange(n,c),this.ctx.surface.requestRender()},e);return{component:a,focus:a}})}showSessionSelector(){this.ctx.surface.showSelector(e=>{const i=new g(t=>f.list(this.sessionManager.getCwd(),this.sessionManager.getSessionDir(),t),f.listAll,async t=>{e(),await this.resumeSession(t)},()=>{e(),this.ctx.surface.requestRender()},()=>{this.ctx.shutdown()},()=>this.ctx.surface.requestRender(),{renameSession:h(async(t,r)=>{const a=(r??"").trim();if(!a)return;f.open(t).appendSessionInfo(a)},"renameSession"),showRenameHint:!0,keybindings:this.ctx.keybindings},this.sessionManager.getSessionFile());return{component:i,focus:i}})}async resumeSession(e){this.ctx.surface.clearTransientSessionUi(),await this.ctx.session.switchSession(e),this.ctx.surface.clearChat(),this.ctx.surface.addSessionNavigationBanner("Resumed session"),this.ctx.surface.renderInitialMessages(),this.ctx.surface.showStatus("Resumed session")}}export{q as TreeOverlayController};