catui-agent 1.0.0-beta.0

package/dist/extensions/builtin/loop/loop-skill.d.ts

@@ -0,0 +1,18 @@
+/**
+ * [WHO]: buildLoopPrompt, getLoopUsageMessage
+ * [FROM]: Depends on ./cron-tools/prompt
+ * [TO]: Consumed by ./index
+ * [HERE]: extensions/builtin/loop/loop-skill.ts - /loop skill: prompt builder and usage message
+ *
+ * /loop skill — translates user input into a CronCreate tool call.
+ *
+ * 1:1 port of Claude Code src/skills/bundled/loop.ts
+ *
+ * This module builds the prompt that instructs the model to:
+ * 1. Parse [interval] <prompt> from user input
+ * 2. Convert interval to cron expression
+ * 3. Call CronCreate
+ * 4. Confirm and execute immediately
+ */
+export declare function buildLoopPrompt(args: string): string;
+export declare function getLoopUsageMessage(): string;

package/dist/extensions/builtin/loop/loop-skill.js

@@ -0,0 +1,58 @@
+var i=Object.defineProperty;var r=(t,n)=>i(t,"name",{value:n,configurable:!0});import{CRON_CREATE_TOOL_NAME as o,CRON_DELETE_TOOL_NAME as s,DEFAULT_MAX_AGE_DAYS as a}from"./cron-tools/prompt.js";const e="10m",h=`Usage: /loop [interval] <prompt>
+
+Run a prompt or slash command on a recurring interval.
+
+Intervals: Ns, Nm, Nh, Nd (e.g. 5m, 30m, 2h, 1d). Minimum granularity is 1 minute.
+If no interval is specified, defaults to ${e}.
+
+Examples:
+  /loop 5m /babysit-prs
+  /loop 30m check the deploy
+  /loop 1h /standup 1
+  /loop check the deploy          (defaults to ${e})
+  /loop check the deploy every 20m`;function m(t){return`# /loop \u2014 schedule a recurring prompt
+
+Parse the input below into \`[interval] <prompt\u2026>\` and schedule it with ${o}.
+
+## Parsing (in priority order)
+
+1. **Leading token**: if the first whitespace-delimited token matches \`^\\d+[smhd]$\` (e.g. \`5m\`, \`2h\`), that's the interval; the rest is the prompt.
+2. **Trailing "every" clause**: otherwise, if the input ends with \`every <N><unit>\` or \`every <N> <unit-word>\` (e.g. \`every 20m\`, \`every 5 minutes\`, \`every 2 hours\`), extract that as the interval and strip it from the prompt. Only match when what follows "every" is a time expression \u2014 \`check every PR\` has no interval.
+3. **Default**: otherwise, interval is \`${e}\` and the entire input is the prompt.
+
+If the resulting prompt is empty, show usage \`/loop [interval] <prompt>\` and stop \u2014 do not call ${o}.
+
+Examples:
+- \`5m /babysit-prs\` \u2192 interval \`5m\`, prompt \`/babysit-prs\` (rule 1)
+- \`check the deploy every 20m\` \u2192 interval \`20m\`, prompt \`check the deploy\` (rule 2)
+- \`run tests every 5 minutes\` \u2192 interval \`5m\`, prompt \`run tests\` (rule 2)
+- \`check the deploy\` \u2192 interval \`${e}\`, prompt \`check the deploy\` (rule 3)
+- \`check every PR\` \u2192 interval \`${e}\`, prompt \`check every PR\` (rule 3 \u2014 "every" not followed by time)
+- \`5m\` \u2192 empty prompt \u2192 show usage
+
+## Interval \u2192 cron
+
+Supported suffixes: \`s\` (seconds, rounded up to nearest minute, min 1), \`m\` (minutes), \`h\` (hours), \`d\` (days). Convert:
+
+| Interval pattern      | Cron expression     | Notes                                    |
+|-----------------------|---------------------|------------------------------------------|
+| \`Nm\` where N \u2264 59   | \`*/N * * * *\`     | every N minutes                          |
+| \`Nm\` where N \u2265 60   | \`0 */H * * *\`     | round to hours (H = N/60, must divide 24)|
+| \`Nh\` where N \u2264 23   | \`0 */N * * *\`     | every N hours                            |
+| \`Nd\`                | \`0 0 */N * *\`     | every N days at midnight local           |
+| \`Ns\`                | treat as \`ceil(N/60)m\` | cron minimum granularity is 1 minute  |
+
+**If the interval doesn't cleanly divide its unit** (e.g. \`7m\` \u2192 \`*/7 * * * *\` gives uneven gaps at :56\u2192:00; \`90m\` \u2192 1.5h which cron can't express), pick the nearest clean interval and tell the user what you rounded to before scheduling.
+
+## Action
+
+1. Call ${o} with:
+   - \`cron\`: the expression from the table above
+   - \`prompt\`: the parsed prompt from above, verbatim (slash commands are passed through unchanged)
+   - \`recurring\`: \`true\`
+2. Briefly confirm: what's scheduled, the cron expression, the human-readable cadence, that recurring tasks auto-expire after ${a} days, and that they can cancel sooner with ${s} (include the job ID).
+3. **Then immediately execute the parsed prompt now** \u2014 don't wait for the first cron fire. If it's a slash command, invoke it via the Skill tool; otherwise act on it directly.
+
+## Input
+
+${t}`}r(m,"buildLoopPrompt");function c(){return h}r(c,"getLoopUsageMessage");export{m as buildLoopPrompt,c as getLoopUsageMessage};

package/dist/extensions/builtin/lsp/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: lspExtension - registers LSP tool, manages server lifecycle, cleanup on shutdown
+ * [FROM]: Depends on core/extensions-host/types, ./lsp-server-manager, ./lsp-tool
+ * [TO]: Auto-loaded by builtin-extensions.ts as a default extension
+ * [HERE]: extensions/builtin/lsp/index.ts - main LSP extension entry point
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function lspExtension(api: ExtensionAPI): Promise<void>;

package/dist/extensions/builtin/lsp/index.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var e=(o,t)=>r(o,"name",{value:t,configurable:!0});import{createLSPServerManager as s}from"./lsp-server-manager.js";import{createLSPTool as a}from"./lsp-tool.js";async function c(o){const t=s();t.initialize().catch(()=>{});const n=a(t,o.cwd);o.registerTool(n),o.on("session_shutdown",async()=>{await t.shutdown()})}e(c,"lspExtension");export{c as default};

package/dist/extensions/builtin/lsp/lsp-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * [WHO]: Provides createLSPClient(), LSPClient type
+ * [FROM]: Depends on node:child_process, vscode-jsonrpc/node.js
+ * [TO]: Consumed by ./lsp-server-instance.ts
+ * [HERE]: extensions/builtin/lsp/lsp-client.ts - stdio JSON-RPC client for LSP servers
+ */
+import type { InitializeParams, InitializeResult, ServerCapabilities } from "vscode-languageserver-protocol";
+export interface LSPClient {
+    readonly capabilities: ServerCapabilities | undefined;
+    readonly isInitialized: boolean;
+    start(command: string, args: string[], options?: {
+        env?: Record<string, string>;
+        cwd?: string;
+    }): Promise<void>;
+    initialize(params: InitializeParams): Promise<InitializeResult>;
+    sendRequest<TResult>(method: string, params: unknown): Promise<TResult>;
+    sendNotification(method: string, params: unknown): Promise<void>;
+    onNotification(method: string, handler: (params: unknown) => void): void;
+    onRequest<TParams, TResult>(method: string, handler: (params: TParams) => TResult | Promise<TResult>): void;
+    stop(): Promise<void>;
+}
+export declare function createLSPClient(serverName: string, onCrash?: (error: Error) => void): LSPClient;

package/dist/extensions/builtin/lsp/lsp-client.js

@@ -0,0 +1 @@
+var q=Object.defineProperty;var P=(r,d)=>q(r,"name",{value:d,configurable:!0});import{spawn as $}from"node:child_process";import{createMessageConnection as z,StreamMessageReader as x,StreamMessageWriter as C}from"vscode-jsonrpc/node.js";function M(r,d){let a,e,S,s=!1,l=!1,u=!1,c;const p=[],w=[];function E(){if(e){for(const{method:i,handler:t}of p)e.onNotification(i,t);p.length=0;for(const{method:i,handler:t}of w)e.onRequest(i,t);w.length=0}}return P(E,"flushPendingHandlers"),{get capabilities(){return S},get isInitialized(){return s},async start(i,t,y){if(u)throw c??new Error(`LSP server ${r} previously failed to start`);return new Promise((L,h)=>{try{const n=$(i,t,{stdio:["pipe","pipe","pipe"],env:{...process.env,...y?.env},cwd:y?.cwd});let g=!1;n.on("spawn",()=>{g=!0,a=n;const o=new x(n.stdout),f=new C(n.stdin);e=z(o,f),e.onError(R=>{l||console.error(`[LSP:${r}] Connection error:`,R)}),e.onClose(()=>{l||(s=!1,d?.(new Error(`LSP server ${r} connection closed unexpectedly`)))}),e.listen(),E(),L()}),n.on("error",o=>{g?l||console.error(`[LSP:${r}] Process error:`,o):(u=!0,c=o,h(o))}),n.on("exit",o=>{if(!l&&o!==0){s=!1;const f=new Error(`LSP server ${r} exited with code ${o}`);g?d?.(f):(u=!0,c=f,h(f))}}),n.stderr?.on("data",()=>{})}catch(n){u=!0,c=n instanceof Error?n:new Error(String(n)),h(c)}})},async initialize(i){if(!e)throw new Error(`LSP client ${r} not started`);const t=await e.sendRequest("initialize",i);return S=t.capabilities,await e.sendNotification("initialized",{}),s=!0,t},async sendRequest(i,t){if(!e||!s)throw new Error(`LSP client ${r} not initialized`);return e.sendRequest(i,t)},async sendNotification(i,t){if(e)try{await e.sendNotification(i,t)}catch{}},onNotification(i,t){e?e.onNotification(i,t):p.push({method:i,handler:t})},onRequest(i,t){e?e.onRequest(i,t):w.push({method:i,handler:t})},async stop(){l=!0;try{e&&s&&(await e.sendRequest("shutdown"),await e.sendNotification("exit"))}catch{}finally{e?.dispose(),e=void 0,s=!1,a&&(a.removeAllListeners(),a.killed||a.kill(),a=void 0)}}}}P(M,"createLSPClient");export{M as createLSPClient};

package/dist/extensions/builtin/lsp/lsp-config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: Provides discoverLspServers()
+ * [FROM]: Depends on node:child_process (which probing)
+ * [TO]: Consumed by ./lsp-server-manager.ts
+ * [HERE]: extensions/builtin/lsp/lsp-config.ts - built-in LSP server discovery via which probing
+ */
+import type { LspServerConfig } from "./types.js";
+export declare function discoverLspServers(): Promise<Map<string, LspServerConfig>>;

package/dist/extensions/builtin/lsp/lsp-config.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var e=(a,s)=>o(a,"name",{value:s,configurable:!0});import{execFile as r}from"node:child_process";const i=[{name:"typescript",config:{command:"typescript-language-server",args:["--stdio"],extensionToLanguage:{".ts":"typescript",".tsx":"typescriptreact",".js":"javascript",".jsx":"javascriptreact",".mts":"typescript",".mjs":"javascript",".cts":"typescript",".cjs":"javascript"},startupTimeout:3e4,maxRestarts:3}},{name:"python",config:{command:"pyright-langserver",args:["--stdio"],extensionToLanguage:{".py":"python",".pyi":"python"},startupTimeout:3e4,maxRestarts:3}},{name:"rust",config:{command:"rust-analyzer",extensionToLanguage:{".rs":"rust"},startupTimeout:6e4,maxRestarts:3}},{name:"go",config:{command:"gopls",extensionToLanguage:{".go":"go"},startupTimeout:3e4,maxRestarts:3}}];function c(a){return new Promise(s=>{r("which",[a],t=>{s(!t)})})}e(c,"which");async function g(){const a=new Map,s=await Promise.all(i.map(async t=>({entry:t,available:await c(t.config.command)})));for(const{entry:t,available:n}of s)n&&a.set(t.name,t.config);return a}e(g,"discoverLspServers");export{g as discoverLspServers};

package/dist/extensions/builtin/lsp/lsp-formatters.d.ts

@@ -0,0 +1,15 @@
+/**
+ * [WHO]: 8 formatter functions for LSP operation results
+ * [FROM]: Depends on vscode-languageserver-types for Location, Hover, DocumentSymbol, etc.
+ * [TO]: Consumed by ./lsp-tool.ts
+ * [HERE]: extensions/builtin/lsp/lsp-formatters.ts - human-readable result formatting for 9 LSP operations
+ */
+import type { CallHierarchyIncomingCall, CallHierarchyItem, CallHierarchyOutgoingCall, DocumentSymbol, Hover, Location, LocationLink, SymbolInformation } from "vscode-languageserver-types";
+export declare function formatGoToDefinitionResult(result: Location | Location[] | LocationLink | LocationLink[] | null, cwd: string): string;
+export declare function formatFindReferencesResult(result: Location[] | null, cwd: string): string;
+export declare function formatHoverResult(result: Hover | null): string;
+export declare function formatDocumentSymbolResult(result: DocumentSymbol[] | SymbolInformation[] | null, cwd: string): string;
+export declare function formatWorkspaceSymbolResult(result: SymbolInformation[] | null, cwd: string): string;
+export declare function formatPrepareCallHierarchyResult(result: CallHierarchyItem[] | null, cwd: string): string;
+export declare function formatIncomingCallsResult(result: CallHierarchyIncomingCall[] | null, cwd: string): string;
+export declare function formatOutgoingCallsResult(result: CallHierarchyOutgoingCall[] | null, cwd: string): string;

package/dist/extensions/builtin/lsp/lsp-formatters.js

@@ -0,0 +1,18 @@
+var m=Object.defineProperty;var s=(n,e)=>m(n,"name",{value:e,configurable:!0});function u(n,e){let o=n;if(o.startsWith("file://")&&(o=decodeURIComponent(o.slice(7)),/^\/[A-Z]:/i.test(o)&&(o=o.slice(1))),o.startsWith(e+"/")){const r=o.slice(e.length+1);if(!r.startsWith(".."))return r}return o}s(u,"formatUri");function $(n,e){const o=u(n.uri,e),r=n.range.start.line+1,t=n.range.start.character+1;return`${o}:${r}:${t}`}s($,"formatLocation");function g(n,e,o){const r=new Map;for(const t of n){const a=e(t);if(!a)continue;const i=u(a,o),l=r.get(i);l?l.push(t):r.set(i,[t])}return r}s(g,"groupByFile");function p(n){return{uri:n.targetUri,range:n.targetSelectionRange??n.targetRange}}s(p,"locationLinkToLocation");function d(n){return n?typeof n=="string"?n:Array.isArray(n)?n.map(e=>typeof e=="string"?e:e.value).join(`
+
+`):"kind"in n?n.value:"language"in n?`\`\`\`${n.language}
+${n.value}
+\`\`\``:String(n):""}s(d,"extractMarkupText");function f(n){return{1:"File",2:"Module",3:"Namespace",4:"Package",5:"Class",6:"Method",7:"Property",8:"Field",9:"Constructor",10:"Enum",11:"Interface",12:"Function",13:"Variable",14:"Constant",15:"String",16:"Number",17:"Boolean",18:"Array",19:"Object",20:"Key",21:"Null",22:"EnumMember",23:"Struct",24:"Event",25:"Operator",26:"TypeParameter"}[n]??`Kind(${n})`}s(f,"symbolKindToString");function R(n,e){if(!n)return"No definition found.";const o=Array.isArray(n)?n:[n];if(o.length===0)return"No definition found.";const r=o.map(a=>"targetUri"in a?p(a):a);if(r.length===1)return`Definition: ${$(r[0],e)}`;const t=r.map(a=>`- ${$(a,e)}`);return`Found ${r.length} definitions:
+${t.join(`
+`)}`}s(R,"formatGoToDefinitionResult");function k(n,e){if(!n||n.length===0)return"No references found.";const o=g(n,t=>t.uri,e),r=[];for(const[t,a]of o){r.push(`${t}:`);for(const i of a){const l=i.range.start.line+1,c=i.range.start.character+1;r.push(`  ${l}:${c}`)}}return`Found ${n.length} reference(s) in ${o.size} file(s):
+${r.join(`
+`)}`}s(k,"formatFindReferencesResult");function N(n){return n?.contents?d(n.contents):"No hover information available."}s(N,"formatHoverResult");function b(n,e){if(!n||n.length===0)return"No symbols found.";if(n.length>0&&"children"in n[0]){let a=function(i,l){for(const c of i){const h=c.range.start.line+1;t.push(`${"  ".repeat(l)}${f(c.kind)} ${c.name} (line ${h})`),c.children?.length&&a(c.children,l+1)}};s(a,"walk");const t=[];return a(n,0),t.join(`
+`)}return n.map(t=>{const a=u(t.location.uri,e),i=t.location.range.start.line+1;return`${f(t.kind)} ${t.name} \u2014 ${a}:${i}`}).join(`
+`)}s(b,"formatDocumentSymbolResult");function j(n,e){if(!n||n.length===0)return"No workspace symbols found.";const o=g(n,t=>t.location?.uri??"",e),r=[];for(const[t,a]of o){r.push(`${t}:`);for(const i of a){const l=i.location.range.start.line+1;r.push(`  ${f(i.kind)} ${i.name} (line ${l})`)}}return`Found ${n.length} symbol(s) in ${o.size} file(s):
+${r.join(`
+`)}`}s(j,"formatWorkspaceSymbolResult");function x(n,e){return!n||n.length===0?"No call hierarchy item found.":n.map(o=>{const r=u(o.uri,e),t=o.range.start.line+1;return`${f(o.kind)} ${o.name} \u2014 ${r}:${t}`}).join(`
+`)}s(x,"formatPrepareCallHierarchyResult");function F(n,e){if(!n||n.length===0)return"No incoming calls found.";const o=g(n,t=>t.from.uri,e),r=[];for(const[t,a]of o){r.push(`${t}:`);for(const i of a){const l=i.from.range.start.line+1;r.push(`  ${f(i.from.kind)} ${i.from.name} (line ${l})`);for(const c of i.fromRanges)r.push(`    call at line ${c.start.line+1}:${c.start.character+1}`)}}return`Found ${n.length} incoming call(s) from ${o.size} file(s):
+${r.join(`
+`)}`}s(F,"formatIncomingCallsResult");function v(n,e){if(!n||n.length===0)return"No outgoing calls found.";const o=g(n,t=>t.to.uri,e),r=[];for(const[t,a]of o){r.push(`${t}:`);for(const i of a){const l=i.to.range.start.line+1;r.push(`  ${f(i.to.kind)} ${i.to.name} (line ${l})`);for(const c of i.fromRanges)r.push(`    call at line ${c.start.line+1}:${c.start.character+1}`)}}return`Found ${n.length} outgoing call(s) to ${o.size} file(s):
+${r.join(`
+`)}`}s(v,"formatOutgoingCallsResult");export{b as formatDocumentSymbolResult,k as formatFindReferencesResult,R as formatGoToDefinitionResult,N as formatHoverResult,F as formatIncomingCallsResult,v as formatOutgoingCallsResult,x as formatPrepareCallHierarchyResult,j as formatWorkspaceSymbolResult};

package/dist/extensions/builtin/lsp/lsp-server-instance.d.ts

@@ -0,0 +1,24 @@
+/**
+ * [WHO]: Provides createLSPServerInstance(), LSPServerInstance type
+ * [FROM]: Depends on ./lsp-client, vscode-languageserver-protocol
+ * [TO]: Consumed by ./lsp-server-manager.ts
+ * [HERE]: extensions/builtin/lsp/lsp-server-instance.ts - single LSP server lifecycle with crash recovery
+ */
+import type { LspServerConfig, LspServerState } from "./types.js";
+export interface LSPServerInstance {
+    readonly name: string;
+    readonly config: LspServerConfig;
+    readonly state: LspServerState;
+    readonly startTime: Date | undefined;
+    readonly lastError: Error | undefined;
+    readonly restartCount: number;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+    isHealthy(): boolean;
+    sendRequest<T>(method: string, params: unknown): Promise<T>;
+    sendNotification(method: string, params: unknown): Promise<void>;
+    onNotification(method: string, handler: (params: unknown) => void): void;
+    onRequest<TParams, TResult>(method: string, handler: (params: TParams) => TResult | Promise<TResult>): void;
+}
+export declare function createLSPServerInstance(name: string, config: LspServerConfig): LSPServerInstance;

package/dist/extensions/builtin/lsp/lsp-server-instance.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var d=(i,r)=>y(i,"name",{value:r,configurable:!0});import{createLSPClient as E}from"./lsp-client.js";const S=-32801,w=3,g=500;function h(i,r,t){return new Promise((f,s)=>{const l=setTimeout(()=>s(new Error(`Timeout: ${t} (${r}ms)`)),r);i.then(o=>{clearTimeout(l),f(o)},o=>{clearTimeout(l),s(o)})})}d(h,"withTimeout");function T(i){return new Promise(r=>setTimeout(r,i))}d(T,"sleep");function _(i,r){let t="stopped",f,s,l=0,o=0,n;const m=r.maxRestarts??3;function R(e){t="error",s=e,o++}return d(R,"onCrash"),{get name(){return i},get config(){return r},get state(){return t},get startTime(){return f},get lastError(){return s},get restartCount(){return l},async start(){if(!(t==="running"||t==="starting")){if(t==="error"&&o>m)throw new Error(`LSP server ${i} exceeded max restart attempts (${m})`);t="starting",s=void 0;try{n=E(i,R);const e=n.start(r.command,r.args??[],{env:r.env}),a=r.startupTimeout??3e4;await h(e,a,`${i} start`);const p=process.cwd(),u={processId:process.pid,rootUri:`file://${p}`,capabilities:{textDocument:{synchronization:{dynamicRegistration:!1,willSave:!1,didSave:!0,willSaveWaitUntil:!1},publishDiagnostics:{relatedInformation:!1},hover:{dynamicRegistration:!1,contentFormat:["markdown","plaintext"]},definition:{dynamicRegistration:!1,linkSupport:!1},references:{dynamicRegistration:!1},documentSymbol:{dynamicRegistration:!1,symbolKind:{valueSet:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26]},hierarchicalDocumentSymbolSupport:!0},callHierarchy:{dynamicRegistration:!1}},workspace:{configuration:!1,workspaceFolders:!1}},initializationOptions:r.initializationOptions},c=n.initialize(u);await h(c,a,`${i} initialize`),t="running",f=new Date,o=0}catch(e){throw t="error",s=e instanceof Error?e:new Error(String(e)),s}}},async stop(){if(!(t==="stopped"||t==="stopping")){t="stopping";try{await n?.stop()}finally{n=void 0,t="stopped"}}},async restart(){if(await this.stop(),l++,l>m)throw new Error(`LSP server ${i} exceeded max restarts (${m})`);await this.start()},isHealthy(){return t==="running"&&(n?.isInitialized??!1)},async sendRequest(e,a){if(!this.isHealthy())throw new Error(`LSP server ${i} is not healthy (state: ${t})`);let p;for(let u=0;u<=w;u++)try{return await n.sendRequest(e,a)}catch(c){if(c.code===S&&u<w){await T(g*Math.pow(2,u)),p=c instanceof Error?c:new Error(String(c));continue}throw c}throw p??new Error(`Request failed after retries: ${e}`)},async sendNotification(e,a){this.isHealthy()&&await n.sendNotification(e,a)},onNotification(e,a){n?.onNotification(e,a)},onRequest(e,a){n?.onRequest(e,a)}}}d(_,"createLSPServerInstance");export{_ as createLSPServerInstance};

package/dist/extensions/builtin/lsp/lsp-server-manager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * [WHO]: Provides createLSPServerManager(), LSPServerManager type
+ * [FROM]: Depends on ./lsp-server-instance, ./lsp-config, node:path
+ * [TO]: Consumed by ./index.ts
+ * [HERE]: extensions/builtin/lsp/lsp-server-manager.ts - multi-server router with file extension mapping
+ */
+import { type LSPServerInstance } from "./lsp-server-instance.js";
+export interface LSPServerManager {
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    getServerForFile(filePath: string): LSPServerInstance | undefined;
+    ensureServerStarted(filePath: string): Promise<LSPServerInstance | undefined>;
+    sendRequest<T>(filePath: string, method: string, params: unknown): Promise<T | undefined>;
+    getAllServers(): Map<string, LSPServerInstance>;
+    openFile(filePath: string, content: string): Promise<void>;
+    changeFile(filePath: string, content: string): Promise<void>;
+    saveFile(filePath: string): Promise<void>;
+    closeFile(filePath: string): Promise<void>;
+    isFileOpen(filePath: string): boolean;
+}
+export declare function createLSPServerManager(): LSPServerManager;

package/dist/extensions/builtin/lsp/lsp-server-manager.js

@@ -0,0 +1 @@
+var v=Object.defineProperty;var f=(n,i)=>v(n,"name",{value:i,configurable:!0});import{extname as m}from"node:path";import{discoverLspServers as g}from"./lsp-config.js";import{createLSPServerInstance as l}from"./lsp-server-instance.js";function u(n){return n.startsWith("file://")?n:`file://${n.startsWith("/")?n:`/${n}`}`}f(u,"pathToUri");function F(){const n=new Map,i=new Map,c=new Map;return{async initialize(){const t=await g();for(const[e,r]of t){for(const o of Object.keys(r.extensionToLanguage)){const a=o.toLowerCase(),d=i.get(a);d?d.push(e):i.set(a,[e])}const s=l(e,r);n.set(e,s),s.onRequest("workspace/configuration",o=>{const a=o?.items;return Array.isArray(a)?a.map(()=>null):[]})}},async shutdown(){const t=Array.from(n.values()).filter(e=>e.state==="running"||e.state==="error").map(e=>e.stop().catch(()=>{}));await Promise.allSettled(t),n.clear(),i.clear(),c.clear()},getServerForFile(t){const e=m(t).toLowerCase(),r=i.get(e);if(!(!r||r.length===0))return n.get(r[0])},async ensureServerStarted(t){const e=this.getServerForFile(t);if(e){if(e.state==="stopped"||e.state==="error")try{await e.start()}catch{return}return e}},async sendRequest(t,e,r){const s=await this.ensureServerStarted(t);if(s)return s.sendRequest(e,r)},getAllServers(){return new Map(n)},async openFile(t,e){const r=await this.ensureServerStarted(t);if(!r)return;const s=u(t),o=`${s}:${r.name}`;if(c.has(o))return;const a=m(t).toLowerCase(),d=r.config.extensionToLanguage[a]??"unknown";await r.sendNotification("textDocument/didOpen",{textDocument:{uri:s,languageId:d,version:1,text:e}}),c.set(o,r.name)},async changeFile(t,e){const r=this.getServerForFile(t);if(!r)return;const s=u(t),o=`${s}:${r.name}`;if(!c.has(o)){await this.openFile(t,e);return}await r.sendNotification("textDocument/didChange",{textDocument:{uri:s,version:Date.now()},contentChanges:[{text:e}]})},async saveFile(t){const e=this.getServerForFile(t);e&&await e.sendNotification("textDocument/didSave",{textDocument:{uri:u(t)}})},async closeFile(t){const e=this.getServerForFile(t);if(!e)return;const r=u(t),s=`${r}:${e.name}`;await e.sendNotification("textDocument/didClose",{textDocument:{uri:r}}),c.delete(s)},isFileOpen(t){const e=this.getServerForFile(t);if(!e)return!1;const r=u(t);return c.has(`${r}:${e.name}`)}}}f(F,"createLSPServerManager");export{F as createLSPServerManager};

package/dist/extensions/builtin/lsp/lsp-tool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * [WHO]: Provides createLSPTool()
+ * [FROM]: Depends on @sinclair/typebox, ./lsp-server-manager, ./lsp-formatters, ./types, node:fs, node:path
+ * [TO]: Consumed by ./index.ts
+ * [HERE]: extensions/builtin/lsp/lsp-tool.ts - LSP tool definition with TypeBox schema for 9 operations
+ */
+import { type Static } from "@sinclair/typebox";
+import type { LSPServerManager } from "./lsp-server-manager.js";
+import { type LSPToolOutput } from "./types.js";
+declare const lspSchema: import("@sinclair/typebox").TObject<{
+    operation: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls">[]>;
+    filePath: import("@sinclair/typebox").TString;
+    line: import("@sinclair/typebox").TInteger;
+    character: import("@sinclair/typebox").TInteger;
+}>;
+export type LSPInput = Static<typeof lspSchema>;
+export declare function createLSPTool(manager: LSPServerManager, cwd: string): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: typeof lspSchema;
+    isConcurrencySafe: true;
+    isReadOnly: true;
+    guidance: string;
+    execute: (toolCallId: string, params: LSPInput, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        details: LSPToolOutput | undefined;
+    }>;
+};
+export {};

package/dist/extensions/builtin/lsp/lsp-tool.js

@@ -0,0 +1,2 @@
+var w=Object.defineProperty;var b=(r,t)=>w(r,"name",{value:t,configurable:!0});import{Type as g}from"@sinclair/typebox";import{readFileSync as P,statSync as I}from"node:fs";import{resolve as R}from"node:path";import{formatDocumentSymbolResult as L,formatFindReferencesResult as T,formatGoToDefinitionResult as A,formatHoverResult as F,formatIncomingCallsResult as H,formatOutgoingCallsResult as E,formatPrepareCallHierarchyResult as O,formatWorkspaceSymbolResult as $}from"./lsp-formatters.js";import{LSP_OPERATIONS as z}from"./types.js";const W=10*1024*1024,q=g.Object({operation:g.Union(z.map(r=>g.Literal(r)),{description:"The LSP operation to perform"}),filePath:g.String({description:"Absolute path to the file"}),line:g.Integer({minimum:1,description:"Line number (1-based)"}),character:g.Integer({minimum:1,description:"Character offset (1-based)"})});function _(r,t,x,a,c){const y=x-1,p=a-1;let l=t;l.startsWith("/")||(l=R(c,t));const n={uri:`file://${l}`},i={line:y,character:p};switch(r){case"goToDefinition":return{method:"textDocument/definition",params:{textDocument:n,position:i}};case"findReferences":return{method:"textDocument/references",params:{textDocument:n,position:i,context:{includeDeclaration:!0}}};case"hover":return{method:"textDocument/hover",params:{textDocument:n,position:i}};case"documentSymbol":return{method:"textDocument/documentSymbol",params:{textDocument:n}};case"workspaceSymbol":return{method:"workspace/symbol",params:{query:""}};case"goToImplementation":return{method:"textDocument/implementation",params:{textDocument:n,position:i}};case"prepareCallHierarchy":return{method:"textDocument/prepareCallHierarchy",params:{textDocument:n,position:i}};case"incomingCalls":return{method:"textDocument/prepareCallHierarchy",params:{textDocument:n,position:i}};case"outgoingCalls":return{method:"textDocument/prepareCallHierarchy",params:{textDocument:n,position:i}}}}b(_,"getMethodAndParams");async function v(r,t,x){if(r.length===0)return r;const{execFile:a}=await import("node:child_process"),{promisify:c}=await import("node:util"),y=c(a),p=new Set;for(const n of r){const i=t(n);if(i?.startsWith("file://")){const m=decodeURIComponent(i.slice(7));m.startsWith(x)&&p.add(m)}}if(p.size===0)return r;const l=new Set,o=Array.from(p);for(let n=0;n<o.length;n+=50){const i=o.slice(n,n+50);try{const{stdout:m}=await y("git",["check-ignore",...i],{cwd:x});for(const u of m.split(`
+`))u.trim()&&l.add(u.trim())}catch{}}return l.size===0?r:r.filter(n=>{const i=t(n);if(!i?.startsWith("file://"))return!0;const m=decodeURIComponent(i.slice(7));return!l.has(m)})}b(v,"filterGitignored");function X(r,t){return{name:"LSP",label:"LSP",description:"Interact with Language Server Protocol (LSP) servers to get code intelligence features. Supported operations: goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls, outgoingCalls. All operations require filePath, line (1-based), and character (1-based).",parameters:q,isConcurrencySafe:!0,isReadOnly:!0,guidance:"Use LSP for code navigation: goToDefinition to find where a symbol is defined, findReferences to find all uses, hover for documentation, documentSymbol for file outline, workspaceSymbol to search across workspace, goToImplementation for interface implementations, and incomingCalls/outgoingCalls for call hierarchy.",async execute(x,{operation:a,filePath:c,line:y,character:p},l){if(l?.aborted)throw new Error("Operation aborted");let o=c;o.startsWith("/")||(o=R(t,c));try{const e=I(o);if(!e.isFile())return{content:[{type:"text",text:`Error: ${c} is not a regular file.`}],details:void 0};if(e.size>W)return{content:[{type:"text",text:`Error: ${c} exceeds 10MB limit for LSP operations.`}],details:void 0}}catch{return{content:[{type:"text",text:`Error: File not found: ${c}`}],details:void 0}}if(!await r.ensureServerStarted(o))return{content:[{type:"text",text:`No LSP server available for file type: ${c}`}],details:void 0};if(!r.isFileOpen(o)){const e=P(o,"utf-8");await r.openFile(o,e)}if(l?.aborted)throw new Error("Operation aborted");const{method:i,params:m}=_(a,o,y,p,t);if(a==="incomingCalls"||a==="outgoingCalls"){const e=await r.sendRequest(o,i,m);if(!e||e.length===0)return{content:[{type:"text",text:`No call hierarchy item at ${c}:${y}:${p}`}],details:{operation:a,result:"No call hierarchy item found.",filePath:o}};const d=Array.isArray(e)?e[0]:e,k=a==="incomingCalls"?"callHierarchy/incomingCalls":"callHierarchy/outgoingCalls",C=await r.sendRequest(o,k,{item:d}),D=a==="incomingCalls"?H(C,t):E(C,t);return{content:[{type:"text",text:D}],details:{operation:a,result:D,filePath:o}}}const u=await r.sendRequest(o,i,m);let s=u;if(Array.isArray(u)&&u.length>0){const e=u[0];typeof e.uri=="string"?s=await v(u,d=>d.uri,t):e.location&&typeof e.location.uri=="string"&&(s=await v(u,d=>d.location?.uri,t))}let f,h,S;switch(a){case"goToDefinition":{const e=s;f=A(e,t),h=(e?Array.isArray(e)?e:[e]:[]).length;break}case"findReferences":{const e=s;f=T(e,t),h=e?.length,e&&e.length>0&&(S=new Set(e.map(d=>d.uri)).size);break}case"hover":{f=F(s);break}case"documentSymbol":{f=L(s,t),h=Array.isArray(s)?s.length:0;break}case"workspaceSymbol":{const e=s;f=$(e,t),h=e?.length;break}case"goToImplementation":{const e=s;f=A(e,t),h=(e?Array.isArray(e)?e:[e]:[]).length;break}case"prepareCallHierarchy":{f=O(s,t),h=Array.isArray(s)?s.length:0;break}}return{content:[{type:"text",text:f}],details:{operation:a,result:f,filePath:o,resultCount:h,fileCount:S}}}}}b(X,"createLSPTool");export{X as createLSPTool};

package/dist/extensions/builtin/lsp/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * [WHO]: LspServerState, LspServerConfig, LSPOperation, LSPToolInput, LSPToolOutput
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by all other lsp/ modules
+ * [HERE]: extensions/builtin/lsp/types.ts - type definitions for the LSP extension
+ */
+export type LspServerState = "stopped" | "starting" | "running" | "stopping" | "error";
+export interface LspServerConfig {
+    command: string;
+    args?: string[];
+    extensionToLanguage: Record<string, string>;
+    env?: Record<string, string>;
+    initializationOptions?: unknown;
+    startupTimeout?: number;
+    maxRestarts?: number;
+}
+export declare const LSP_OPERATIONS: readonly ["goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol", "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls"];
+export type LSPOperation = (typeof LSP_OPERATIONS)[number];
+export interface LSPToolInput {
+    operation: LSPOperation;
+    filePath: string;
+    line: number;
+    character: number;
+}
+export interface LSPToolOutput {
+    operation: LSPOperation;
+    result: string;
+    filePath: string;
+    resultCount?: number;
+    fileCount?: number;
+}

package/dist/extensions/builtin/lsp/types.js

@@ -0,0 +1 @@
+const o=["goToDefinition","findReferences","hover","documentSymbol","workspaceSymbol","goToImplementation","prepareCallHierarchy","incomingCalls","outgoingCalls"];export{o as LSP_OPERATIONS};

package/dist/extensions/builtin/mcp/figma-design.md

@@ -0,0 +1,68 @@
+---
+name: figma-design
+description: Use this skill when the user wants Catui to inspect, create, or edit designs in Figma through MCP.
+---
+
+# Figma Design
+
+Use this skill when the user asks Catui to:
+
+- Generate a design in Figma
+- Edit an existing Figma file
+- Turn requirements into Figma frames, components, or styles
+- Read design context from Figma before implementing UI
+
+## Preferred integration path
+
+Prefer the official Figma Remote MCP server first. Use the desktop server as a fallback or as an additional local-context path.
+
+Catui includes two built-in disabled MCP presets:
+
+- Server ID: `figma-remote`
+- URL: `https://mcp.figma.com/mcp`
+- Auth: `/figma auth` tries a standalone browser OAuth flow first. If Figma blocks first-time client registration on this machine, Catui can fall back to importing an existing official local session.
+
+- Server ID: `figma-desktop`
+- URL: `http://127.0.0.1:3845/mcp`
+
+## First-time setup flow
+
+If the Figma MCP tools are not available yet:
+
+1. Prefer the remote setup first:
+
+```text
+/figma auth
+/figma remote
+```
+
+If the user already has dedicated Figma OAuth credentials for Catui, they can also set:
+
+```text
+CATUI_FIGMA_CLIENT_ID
+CATUI_FIGMA_CLIENT_SECRET
+```
+
+2. If the user wants the local desktop route instead, ask them to open the Figma desktop app and enable the desktop MCP server in Figma Dev Mode.
+3. Then tell them to run:
+
+```text
+/figma setup
+```
+
+4. After reload, check whether MCP tools from a Figma server are available.
+
+## How to work once Figma tools are available
+
+- First inspect the available Figma MCP tools in the current session.
+- Prefer reading the current file or selection context before writing.
+- Then create or update frames, components, text, styles, or variables as needed.
+- When the user wants generated UI, write the result into Figma instead of only describing it in chat.
+
+## Important guidance
+
+- Prefer the remote path when possible because it is closer to the Codex/Claude-style setup.
+- If the remote path is not authenticated yet, guide the user through `/figma auth` before falling back to desktop.
+- The official write-capable path is MCP, not the read-heavy REST API.
+- If tools are missing after enabling either server, remind the user to run `/reload`.
+- If the remote path fails but the user already has a valid local desktop MCP server, use the desktop route so the design task can still move forward.

package/dist/extensions/builtin/mcp/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Extension
+ *
+ * Provides MCP (Model Context Protocol) guidance resources.
+ * Runtime MCP tool loading is handled by the AgentSession SDK.
+ */
+/**
+ * [WHO]: Extension interface
+ * [FROM]: Depends on node:fs, node:path, node:url, ../../../config.js, ../../../core/platform/config/auth-storage.js
+ * [TO]: Loaded by core/extensions-host/loader.ts as extension entry point
+ * [HERE]: extensions/builtin/mcp/index.ts -
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+export default function mcpExtension(api: ExtensionAPI): Promise<void>;

package/dist/extensions/builtin/mcp/index.js

@@ -0,0 +1,25 @@
+var I=Object.defineProperty;var o=(e,i)=>I(e,"name",{value:i,configurable:!0});import{existsSync as w}from"node:fs";import{dirname as S,join as F}from"node:path";import{fileURLToPath as E}from"node:url";import{getAuthPath as _}from"../../../config.js";import{AuthStorage as O}from"../../../core/platform/config/auth-storage.js";import{findImportableFigmaOAuthSession as b,refreshFigmaOAuthCredentials as R}from"../../../core/mcp/figma-auth.js";import{getMCPServer as k,setMCPServerEnabled as g}from"../../../core/mcp/mcp-config.js";const P=S(E(import.meta.url)),A=F(P,"mcp-management.md"),$=F(P,"figma-design.md"),v="http://127.0.0.1:3845/mcp",L="https://mcp.figma.com/mcp",D=[{value:"help",label:"help",description:"Show setup steps"},{value:"auth",label:"auth",description:"Sign in to Figma"},{value:"remote",label:"remote",description:"Enable the remote MCP path"},{value:"setup",label:"setup",description:"Probe and enable the best Figma path"},{value:"status",label:"status",description:"Inspect the current connection"},{value:"logout",label:"logout",description:"Remove saved Figma credentials"},{value:"enable",label:"enable",description:"Enable the desktop MCP preset"},{value:"disable",label:"disable",description:"Disable the desktop MCP preset"}];function p(){return O.create(_())}o(p,"getFigmaAuthStorage");function j(e,i){if(i&&i.tokenIndex>0)return null;const a=e.trim().toLowerCase(),h=D.filter(f=>f.value.startsWith(a));return h.length>0?h.map(f=>({...f})):null}o(j,"getFigmaArgumentCompletions");async function y(){return p().getApiKey("figma")}o(y,"getFigmaAccessToken");async function M(){const e=p(),i=e.get("figma");if(!i||i.type!=="oauth")return;const a=await R(i);return e.set("figma",{type:"oauth",...a}),a.access}o(M,"refreshStoredFigmaCredentials");async function x(){try{const e=await fetch(v,{method:"POST",headers:{"Content-Type":"application/json",Accept:"application/json, text/event-stream","MCP-Protocol-Version":"2025-03-26"},body:JSON.stringify({jsonrpc:"2.0",id:1,method:"initialize",params:{protocolVersion:"2024-11-05",capabilities:{},clientInfo:{name:"catui-agent",version:"1.11.12"}}}),signal:AbortSignal.timeout(4e3)});return e.ok||e.status===400||e.status===401||e.status===405?{reachable:!0,detail:`${e.status} ${e.statusText}`}:{reachable:!1,detail:`${e.status} ${e.statusText}`}}catch(e){return{reachable:!1,detail:e instanceof Error?e.message:String(e)}}}o(x,"probeFigmaDesktopEndpoint");async function l(e){try{const i={"Content-Type":"application/json",Accept:"application/json, text/event-stream","MCP-Protocol-Version":"2025-03-26"};e&&(i.Authorization=`Bearer ${e}`);const a=await fetch(L,{method:"POST",headers:i,body:JSON.stringify({jsonrpc:"2.0",id:1,method:"initialize",params:{protocolVersion:"2024-11-05",capabilities:{},clientInfo:{name:"catui-agent",version:"1.11.12"}}}),signal:AbortSignal.timeout(5e3)});return a.ok?{reachable:!0,authenticated:!0,detail:`${a.status} ${a.statusText}`}:a.status===401?{reachable:!0,authenticated:!1,detail:e?"401 Unauthorized (token rejected or expired)":"401 Unauthorized (authentication required)"}:{reachable:a.status<500,authenticated:!1,detail:`${a.status} ${a.statusText}`}}catch(i){return{reachable:!1,authenticated:!1,detail:i instanceof Error?i.message:String(i)}}}o(l,"probeFigmaRemoteEndpoint");async function U(e){e.registerCommand("figma",{description:"Connect Catui to Figma for generative design",getArgumentCompletions:j,handler:o(async(i,a)=>{const[h,...f]=i.trim().split(/\s+/).filter(Boolean),r=(h||"help").toLowerCase();if(r==="help"){const t=b();e.sendMessage({customType:"text",content:`Figma setup:
+1. Run \`/figma auth\`. Catui will try a standalone browser OAuth flow first.${t?` If Figma refuses first-time client registration, it can fall back to the existing ${t.source} session on this machine.`:""}
+2. Run \`/figma remote\` to enable the built-in remote MCP preset and reload the session.
+3. If you prefer the local desktop route, open the Figma desktop app, enable its MCP server in Dev Mode, and run \`/figma setup\`.
+4. Then ask me to generate or edit a design in Figma.
+
+Advanced: you can also set \`CATUI_FIGMA_CLIENT_ID\` and \`CATUI_FIGMA_CLIENT_SECRET\` before running Catui.
+
+Use \`/figma status\` to inspect the current connection.`,display:!0});return}if(r==="setup"||r==="connect"){let t=await y();if(!t&&b())try{await p().login("figma",{onAuth:o(n=>{e.sendMessage({customType:"text",content:`${n.instructions??"Figma authentication requires additional setup."}
+
+${n.url}`,display:!0})},"onAuth"),onPrompt:o(async n=>await a.ui.input("Figma Auth",n.message,{initialValue:n.placeholder??""})??"","onPrompt"),onProgress:o(n=>{e.sendMessage({customType:"text",content:n,display:!0})},"onProgress")}),t=await y()}catch{}if(t){let n=await l(t);if(!n.authenticated){const u=await M().catch(()=>{});u&&(t=u,n=await l(t))}if(n.reachable&&n.authenticated){g("figma-remote",!0),e.sendMessage({customType:"text",content:`The remote Figma MCP endpoint is reachable (${n.detail??"ok"}). Enabled the built-in \`figma-remote\` preset and reloading now so Catui can pick up the Figma tools.`,display:!0}),await a.reload();return}}const s=await x();if(!s.reachable){const n=b();e.sendMessage({customType:"text",content:`I could not reach the local Figma Desktop MCP endpoint at ${v}.
+
+Next steps:
+1. For the remote path, run \`/figma auth\`${n?` to try Catui OAuth first and then fall back to the existing ${n.source} session if needed`:""}.
+2. Then run \`/figma remote\`.
+3. Or open the Figma desktop app, turn on the Figma MCP server in Dev Mode, and run \`/figma setup\` again.
+
+Probe detail: ${s.detail??"connection failed"}`,display:!0});return}g("figma-desktop",!0),e.sendMessage({customType:"text",content:`The local Figma MCP endpoint is reachable (${s.detail??"ok"}). Enabled the built-in \`figma-desktop\` MCP preset and reloading now so Catui can pick up the Figma tools.`,display:!0}),await a.reload();return}if(r==="login"||r==="auth"){try{await p().login("figma",{onAuth:o(t=>{e.sendMessage({customType:"text",content:`${t.instructions??"Figma authentication needs another official client session."}
+
+${t.url}`,display:!0})},"onAuth"),onPrompt:o(async t=>await a.ui.input("Figma Auth",t.message,{initialValue:t.placeholder??""})??"","onPrompt"),onProgress:o(t=>{e.sendMessage({customType:"text",content:t,display:!0})},"onProgress")}),e.sendMessage({customType:"text",content:"Saved Figma OAuth credentials in auth storage. Run `/figma remote` to enable the remote MCP preset and connect Catui to Figma.",display:!0})}catch(t){e.sendMessage({customType:"text",content:t instanceof Error?t.message:String(t),display:!0})}return}if(r==="logout"){p().logout("figma"),e.sendMessage({customType:"text",content:"Removed the saved Figma OAuth credentials from auth storage. Run `/reload` if you want the current session to drop remote Figma access immediately.",display:!0});return}if(r==="enable"){g("figma-desktop",!0),e.sendMessage({customType:"text",content:"Enabled the built-in `figma-desktop` MCP preset. Reloading now so Catui can pick up the Figma tools.",display:!0}),await a.reload();return}if(r==="disable"){g("figma-desktop",!1),e.sendMessage({customType:"text",content:"Disabled the built-in `figma-desktop` MCP preset. Run `/reload` if you want the current session to drop the Figma tools immediately.",display:!0});return}if(r==="remote"){const t=await y();if(!t){e.sendMessage({customType:"text",content:"No Figma OAuth session is configured yet. Run `/figma auth` first, then run `/figma remote` again.",display:!0});return}let s=await l(t);if(!s.authenticated){const n=await M().catch(()=>{});n&&(s=await l(n))}if(!s.reachable||!s.authenticated){e.sendMessage({customType:"text",content:`I could reach the remote Figma MCP endpoint, but authentication is not working yet.
+
+Detail: ${s.detail??"authentication failed"}
+
+Run \`/figma auth\` again and retry. If standalone registration is blocked by Figma, Catui will fall back to any existing official local session it can import.`,display:!0});return}g("figma-remote",!0),e.sendMessage({customType:"text",content:"Enabled the built-in `figma-remote` MCP preset. Reloading now so Catui can pick up the authenticated remote Figma tools.",display:!0}),await a.reload();return}if(r==="status"){const t=k("figma-desktop"),s=k("figma-remote"),n=await x();let u=await y();const C=b();let c=await l(u);if(!c.authenticated){const m=await M().catch(()=>{});m&&(u=m,c=await l(u))}const T=e.getAllTools().filter(m=>m.name.includes("figma")||m.description.toLowerCase().includes("figma")),d=["Figma MCP status","",`figma-desktop: ${t?.enabled===!1?"disabled":"enabled"}`,`desktop endpoint: ${n.reachable?"reachable":"unreachable"}`,`desktop detail: ${n.detail??"unknown"}`,`figma-remote: ${s?.enabled===!1?"disabled":"enabled"}`,`importable local OAuth session: ${C?`yes (${C.source})`:"no"}`,`remote OAuth configured: ${u?"yes":"no"}`,`remote endpoint: ${c.reachable?"reachable":"unreachable"}`,`remote auth: ${c.authenticated?"ok":"not authenticated"}`,`remote detail: ${c.detail??"unknown"}`,`registered figma tools in this session: ${T.length}`];T.length===0&&(d.push(""),d.push("If you want the remote path, run `/figma auth` and then `/figma remote`."),d.push("If the desktop app is ready, run `/figma setup`."),d.push("If either route is already enabled, run `/reload` and try again.")),e.sendMessage({customType:"text",content:d.join(`
+`),display:!0});return}e.sendMessage({customType:"text",content:"Usage: /figma [help|setup|connect|login|auth|logout|enable|disable|status|remote]",display:!0})},"handler")}),e.on("resources_discover",async i=>{const a=[];return w(A)&&a.push(A),w($)&&a.push($),a.length===0?{}:{skillPaths:a}})}o(U,"mcpExtension");export{U as default};

package/dist/extensions/builtin/mcp/mcp-management.md

@@ -0,0 +1,85 @@
+---
+name: mcp-management
+description: Use this skill when the user asks to install, configure, debug, enable, or disable MCP servers or MCP tools in Catui.
+---
+
+# MCP Management
+
+Use this skill when the user asks for any of the following:
+
+- Install a new MCP server
+- Configure an existing MCP server
+- Enable or disable MCP servers in Catui
+- Debug why MCP tools are missing
+- Add API keys or environment variables for an MCP server
+
+## What Catui already does
+
+- MCP is enabled by default in Catui unless the user launched it with `--no-mcp` or in offline mode.
+- Catui reads MCP server definitions from `~/.catui/agent/mcp.json`.
+- MCP tools are loaded into the current session at startup and on `/reload`.
+
+Important:
+
+- Editing `mcp.json` alone does not make new MCP tools appear immediately in the current session.
+- After changing MCP config, tell the user to run `/reload`, or explain that a restart/reload is needed before the new tools can be used.
+
+## How to inspect the current MCP setup
+
+1. Read `~/.catui/agent/mcp.json` if it exists.
+2. Check whether the target server already exists in `mcpServers`.
+3. Check whether it is enabled.
+4. Check whether required environment variables are present.
+
+If the file does not exist, Catui will create a default one when MCP config is first loaded.
+
+## How to add a new MCP server
+
+1. Find the official install/start command from the server's documentation.
+2. Prefer stable commands such as:
+   - `npx -y <package>`
+   - `uvx <package>`
+   - `python -m <module>`
+   - `node /absolute/path/to/server.js`
+3. Add a server entry to `~/.catui/agent/mcp.json`.
+4. Set `enabled: true` only if the command and required credentials are ready.
+5. Tell the user that `/reload` is required to apply the change.
+
+## Config shape reminder
+
+Use this structure:
+
+```json
+{
+  "mcpServers": [
+    {
+      "id": "example",
+      "name": "Example",
+      "command": "npx",
+      "args": ["-y", "@example/server"],
+      "enabled": true,
+      "transport": "stdio",
+      "toolTimeout": 30000
+    }
+  ]
+}
+```
+
+For remote HTTP/SSE MCP servers, use the server's documented transport and URL fields supported by Catui's MCP config.
+
+## Safe operating rules
+
+- Do not invent MCP package names. Check the server's official docs first.
+- Do not claim the new MCP tools are ready until the config is written and the user has reloaded.
+- If credentials are required, ask the user for the missing values instead of guessing.
+- If an install command modifies global system state, tell the user what will be installed.
+
+## Good response pattern
+
+When the user asks you to install an MCP server:
+
+1. Inspect `mcp.json`
+2. Install or configure the server
+3. Update `mcp.json`
+4. Tell the user exactly what changed
+5. Ask them to run `/reload` if the current session needs to pick up the new tools

package/dist/extensions/builtin/plan/clear-context-state.d.ts

@@ -0,0 +1,8 @@
+/**
+ * [WHO]: setPendingClearContextPlan(), getAndClearPendingPlan()
+ * [FROM]: No dependencies
+ * [TO]: Consumed by ./exit-plan-mode-tool.ts and ./index.ts
+ * [HERE]: extensions/builtin/plan/clear-context-state.ts - module-level state for clear-context plan injection
+ */
+export declare function setPendingClearContextPlan(plan: string): void;
+export declare function getAndClearPendingPlan(): string | null;

package/dist/extensions/builtin/plan/clear-context-state.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var e=(n,t)=>a(n,"name",{value:t,configurable:!0});let l=null;function r(n){l=n}e(r,"setPendingClearContextPlan");function i(){const n=l;return l=null,n}e(i,"getAndClearPendingPlan");export{i as getAndClearPendingPlan,r as setPendingClearContextPlan};

package/dist/extensions/builtin/plan/enter-plan-mode-tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * [WHO]: createEnterPlanModeTool()
+ * [FROM]: Depends on @sinclair/typebox, core/extensions-host/types, ./types, ./plan-permissions, ./plan-workflow-prompt
+ * [TO]: Consumed by plan extension index.ts
+ * [HERE]: extensions/builtin/plan/enter-plan-mode-tool.ts - EnterPlanMode tool for model-initiated plan mode entry
+ */
+import type { ExtensionAPI, ToolDefinition } from "../../../core/extensions-host/types.js";
+import { type PlanSessionState } from "./types.js";
+declare const EnterPlanModeInputSchema: import("@sinclair/typebox").TObject<{}>;
+export declare function createEnterPlanModeTool(api: ExtensionAPI, getSessionState: () => PlanSessionState, isChannelsEnabled: () => boolean): ToolDefinition<typeof EnterPlanModeInputSchema, null>;
+export {};

package/dist/extensions/builtin/plan/enter-plan-mode-tool.js

@@ -0,0 +1,2 @@
+var u=Object.defineProperty;var l=(n,e)=>u(n,"name",{value:e,configurable:!0});import{Type as m}from"@sinclair/typebox";import{Container as p,Text as d}from"@catui/tui";import{PLAN_CUSTOM_TYPE as P}from"./types.js";import{handlePlanModeTransition as f}from"./plan-permissions.js";import{getEnterPlanModeToolResult as g}from"./plan-workflow-prompt.js";import{getPlanFilePath as M,getPlansDirectory as h,serializePlanSessionState as E}from"./plan-file-manager.js";const x=m.Object({},{additionalProperties:!1});function y(n,e){const t=new p;return t.addChild(new d(e.fg("toolTitle",e.bold("EnterPlanMode")),0,0)),t.addChild(new d(e.fg("muted","  Switching to plan mode (read-only except plan file)"),0,0)),t}l(y,"renderCallForEnterPlanMode");function w(n,e,t){const r=new p,s=n.content?.filter(o=>o.type==="text").map(o=>o.type==="text"?o.text:"").join(`
+`);return s&&(r.addChild(new d(t.fg("success","Plan mode active"),0,0)),r.addChild(new d(t.fg("toolOutput",s),0,0))),r}l(w,"renderResultForEnterPlanMode");function U(n,e,t){return{name:"EnterPlanMode",label:"Enter Plan Mode",description:"Switch to plan mode to design an approach before coding. Use this when the task is complex and requires planning before implementation.",parameters:x,renderCall:y,renderResult:w,execute:l(async(r,s,o,C,i)=>{h(i.getSettings().plansDirectory,i.cwd);const a=e();if(t())return{content:[{type:"text",text:"EnterPlanMode is not available in channels mode. The user may not be present to approve the plan."}],details:null};const c=a.state.mode;return f(a),a.state.prePlanMode=c,a.state.mode="plan",n.appendEntry(P,E(a)),i.ui.setStatus("plan","Plan mode"),i.ui.setWidget("plan-mode",["PLAN MODE",`Plan: ${M(n.events)}`,"Read-only except the plan file","Use /plan open to edit; ExitPlanMode requests approval"],{placement:"aboveEditor"}),{content:[{type:"text",text:g()}],details:null}},"execute")}}l(U,"createEnterPlanModeTool");export{U as createEnterPlanModeTool};

package/dist/extensions/builtin/plan/exit-plan-mode-tool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * [WHO]: createExitPlanModeTool()
+ * [FROM]: Depends on @sinclair/typebox, core/extensions-host/types, ./types, ./plan-permissions, ./plan-workflow-prompt, ./plan-file-manager, ./plan-validation, ./teammate-approval
+ * [TO]: Consumed by plan extension index.ts
+ * [HERE]: extensions/builtin/plan/exit-plan-mode-tool.ts - ExitPlanMode tool for model-requested plan approval
+ */
+import type { ExtensionAPI, ToolDefinition } from "../../../core/extensions-host/types.js";
+import { type PlanSessionState } from "./types.js";
+declare const ExitPlanModeInputSchema: import("@sinclair/typebox").TObject<{
+    plan: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    forceExit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    allowedPrompts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        tool: import("@sinclair/typebox").TString;
+        prompt: import("@sinclair/typebox").TString;
+    }>>>;
+}>;
+export declare function createExitPlanModeTool(api: ExtensionAPI, getSessionState: () => PlanSessionState, hasAgentTool: () => boolean): ToolDefinition<typeof ExitPlanModeInputSchema, null>;
+export {};