catui-agent 1.0.0-beta.0

package/dist/extensions/builtin/token-save/recovery.d.ts

@@ -0,0 +1 @@
+export declare function writeRawRecovery(projectPath: string, raw: string): Promise<string | undefined>;

package/dist/extensions/builtin/token-save/recovery.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var i=(t,r)=>a(t,"name",{value:r,configurable:!0});import{randomBytes as c}from"node:crypto";import{mkdir as m,writeFile as u}from"node:fs/promises";import{join as n}from"node:path";async function p(t,r){try{const e=n(t,".catui","token-save","raw");await m(e,{recursive:!0});const o=n(e,`${Date.now()}-${c(4).toString("hex")}.log`);return await u(o,r,"utf8"),o}catch{return}}i(p,"writeRawRecovery");export{p as writeRawRecovery};

package/dist/extensions/builtin/token-save/rewrite.d.ts

@@ -0,0 +1,19 @@
+import type { TokenSaveCategory } from "./filters.js";
+export interface RewriteRule {
+    id: string;
+    category: TokenSaveCategory;
+    pattern: RegExp;
+    target: string;
+    estimatedSavingsPct: number;
+    streaming: boolean;
+}
+export interface RewriteDecision {
+    original: string;
+    target: string;
+    category: TokenSaveCategory;
+    mode: "capture" | "stream" | "passthrough";
+    estimatedSavingsPct: number;
+    reason?: string;
+}
+export declare const rewriteRules: RewriteRule[];
+export declare function planCommand(command: string): RewriteDecision;

package/dist/extensions/builtin/token-save/rewrite.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var e=(t,s)=>g(t,"name",{value:s,configurable:!0});import{splitShellSegments as c}from"./lexer.js";const o=[{id:"git-status",category:"git-status",pattern:/\bgit\s+status\b/,target:"tokensave git status",estimatedSavingsPct:65,streaming:!1},{id:"git-diff",category:"git-diff",pattern:/\bgit\s+(?:diff|show)\b/,target:"tokensave git diff",estimatedSavingsPct:70,streaming:!1},{id:"git-log",category:"git-log",pattern:/\bgit\s+(?:log|show)\b/,target:"tokensave git log",estimatedSavingsPct:45,streaming:!1},{id:"read-file",category:"read-file",pattern:/^(?:cat|head|tail|less|sed\s+-n)\b/,target:"tokensave read",estimatedSavingsPct:55,streaming:!1},{id:"search",category:"search",pattern:/^(?:rg|grep|find|fd|ls|tree)\b/,target:"tokensave search",estimatedSavingsPct:40,streaming:!1},{id:"typescript",category:"typescript",pattern:/\b(?:tsc|vue-tsc)\b/,target:"tokensave tsc",estimatedSavingsPct:75,streaming:!0},{id:"lint",category:"lint",pattern:/\b(?:eslint|biome)\b/,target:"tokensave lint",estimatedSavingsPct:70,streaming:!0},{id:"pytest",category:"pytest",pattern:/\bpytest\b/,target:"tokensave pytest",estimatedSavingsPct:75,streaming:!0},{id:"test",category:"test",pattern:/\b(?:npm|pnpm|yarn|bun)\s+(?:test|run\s+(?:test|build|lint|typecheck)|exec\s+(?:tsc|vue-tsc|vitest|jest|playwright|eslint|biome))\b|\b(?:vitest|jest|playwright|mocha)\b/,target:"tokensave test",estimatedSavingsPct:70,streaming:!0},{id:"package-manager",category:"package-manager",pattern:/\b(?:npm|pnpm|yarn|bun)\s+(?:install|add|remove|update)\b/,target:"tokensave packages",estimatedSavingsPct:45,streaming:!0},{id:"json",category:"json",pattern:/\b(?:jq|curl)\b/,target:"tokensave json",estimatedSavingsPct:65,streaming:!1}];function d(t){return t.replace(/^\s*(?:env\s+)?(?:[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S+)\s+)*/,"").trim()}e(d,"stripEnvPrefix");function p(t){return/<<-?\s*\w+/.test(t)}e(p,"hasHeredoc");function l(t){return/(^|\s)(?:>>?|2>|&>)/.test(t)||/\bcat\s*>/.test(t)}e(l,"hasWriteRedirection");function u(t){return/\b(?:TOKEN_SAVE_DISABLED|TOKENSAVE_DISABLED)=1\b/.test(t)}e(u,"disabled");function f(t){const r=c(t)[0]?.text??t,n=d(r);if(!n)return i(t,"empty command");if(u(r))return i(t,"disabled by env");if(p(r))return i(t,"heredoc");if(l(r))return i(t,"write redirection");for(const a of o)if(a.pattern.test(n))return{original:t,target:a.target,category:a.category,mode:a.streaming?"stream":"capture",estimatedSavingsPct:a.estimatedSavingsPct};return{original:t,target:"tokensave generic",category:"generic",mode:"capture",estimatedSavingsPct:25}}e(f,"planCommand");function i(t,s){return{original:t,target:t,category:"generic",mode:"passthrough",estimatedSavingsPct:0,reason:s}}e(i,"passthrough");export{f as planCommand,o as rewriteRules};

package/dist/extensions/builtin/token-save/runner.d.ts

@@ -0,0 +1,14 @@
+import { type RewriteDecision } from "./rewrite.js";
+export interface TokenSaveRunResult {
+    plan: RewriteDecision;
+    rawText: string;
+    filteredText: string;
+    inputTokens: number;
+    outputTokens: number;
+    savedTokens: number;
+    savingsPct: number;
+    shouldReplace: boolean;
+    rawRecoveryPath?: string;
+}
+export declare function applyTokenSavePlan(command: string, rawText: string, projectPath: string): Promise<TokenSaveRunResult>;
+export declare function applyTokenSaveStream(command: string, chunks: Iterable<string>, projectPath: string): Promise<TokenSaveRunResult>;

package/dist/extensions/builtin/token-save/runner.js

@@ -0,0 +1,3 @@
+var f=Object.defineProperty;var c=(o,t)=>f(o,"name",{value:t,configurable:!0});import{estimateTokens as p,filterTokenSaveOutput as m}from"./filters.js";import{writeRawRecovery as h}from"./recovery.js";import{planCommand as d}from"./rewrite.js";import{TokenSaveStreamAccumulator as S}from"./stream.js";const v=32,k=12;async function y(o,t,r){const s=d(o);if(s.mode==="passthrough")return l(s,t,t,void 0,!1);const e=m(o,t),a=await h(r,t),n=l(s,t,e.text,a,!0);return{...n,shouldReplace:n.savedTokens>=v&&n.savingsPct>=k&&n.filteredText!==n.rawText}}c(y,"applyTokenSavePlan");async function x(o,t,r){const s=new S;for(const n of t)s.push(n);const e=s.snapshot(),a=e.truncated?`${e.text}
+
+[TokenSave raw capture capped at ${e.text.length} chars from ${e.totalBytes} bytes]`:e.text;return y(o,a,r)}c(x,"applyTokenSaveStream");function l(o,t,r,s,e){const a=e?p(t):0,n=e?p(r):0,u=Math.max(0,a-n),i=a>0?Math.round(u/a*100):0;return{plan:o,rawText:t,filteredText:r,inputTokens:a,outputTokens:n,savedTokens:u,savingsPct:i,shouldReplace:!1,rawRecoveryPath:s}}c(l,"buildResult");export{y as applyTokenSavePlan,x as applyTokenSaveStream};

package/dist/extensions/builtin/token-save/stream.d.ts

@@ -0,0 +1,20 @@
+/**
+ * [WHO]: TokenSaveStreamAccumulator for bounded streaming-mode output collection
+ * [FROM]: No runtime dependencies
+ * [TO]: Consumed by extensions/builtin/token-save/runner.ts and tests
+ * [HERE]: extensions/builtin/token-save/stream.ts - stream-mode raw capture guardrail
+ */
+export interface TokenSaveStreamSnapshot {
+    text: string;
+    totalBytes: number;
+    truncated: boolean;
+}
+export declare class TokenSaveStreamAccumulator {
+    private readonly maxBytes;
+    private chunks;
+    private bytes;
+    private truncated;
+    constructor(maxBytes?: number);
+    push(chunk: string): void;
+    snapshot(): TokenSaveStreamSnapshot;
+}

package/dist/extensions/builtin/token-save/stream.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var n=(s,t)=>a(s,"name",{value:t,configurable:!0});class i{static{n(this,"TokenSaveStreamAccumulator")}maxBytes;chunks=[];bytes=0;truncated=!1;constructor(t=10*1024*1024){this.maxBytes=t}push(t){const e=Buffer.byteLength(t,"utf8");if(this.bytes+=e,this.truncated)return;const h=this.chunks.join(""),r=Buffer.byteLength(h,"utf8");if(r+e<=this.maxBytes){this.chunks.push(t);return}const u=Math.max(0,this.maxBytes-r);u>0&&this.chunks.push(Buffer.from(t,"utf8").subarray(0,u).toString("utf8")),this.truncated=!0}snapshot(){return{text:this.chunks.join(""),totalBytes:this.bytes,truncated:this.truncated}}}export{i as TokenSaveStreamAccumulator};

package/dist/extensions/builtin/token-save/toml-dsl.d.ts

@@ -0,0 +1,25 @@
+/**
+ * [WHO]: applyTomlStyleFilter() configuration-driven line filter pipeline
+ * [FROM]: No runtime dependencies
+ * [TO]: Consumed by TokenSave filters/tests and future project/user filter loading
+ * [HERE]: extensions/builtin/token-save/toml-dsl.ts - TokenSave configuration filter DSL core
+ */
+export interface TomlStyleFilter {
+    stripAnsi?: boolean;
+    replace?: Array<{
+        pattern: string;
+        with: string;
+    }>;
+    matchMessage?: Array<{
+        pattern: string;
+        message: string;
+    }>;
+    stripLines?: string[];
+    keepLines?: string[];
+    truncateLine?: number;
+    head?: number;
+    tail?: number;
+    maxLines?: number;
+    emptyMessage?: string;
+}
+export declare function applyTomlStyleFilter(filter: TomlStyleFilter, raw: string): string;

package/dist/extensions/builtin/token-save/toml-dsl.js

@@ -0,0 +1,3 @@
+var i=Object.defineProperty;var c=(e,a)=>i(e,"name",{value:a,configurable:!0});function x(e,a){let p=e.stripAnsi===!1?a:a.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g,"");for(const s of e.replace??[])p=p.replace(new RegExp(s.pattern,"g"),s.with);for(const s of e.matchMessage??[])if(new RegExp(s.pattern,"m").test(p))return s.message;let n=p.split(`
+`);for(const s of e.stripLines??[]){const t=new RegExp(s);n=n.filter(o=>!t.test(o))}if(e.keepLines&&e.keepLines.length>0){const s=e.keepLines.map(t=>new RegExp(t));n=n.filter(t=>s.some(o=>o.test(t)))}if(e.truncateLine&&e.truncateLine>0){const s=e.truncateLine;n=n.map(t=>t.length>s?`${t.slice(0,s-3)}...`:t)}return e.head&&e.head>0&&(n=n.slice(0,e.head)),e.tail&&e.tail>0&&(n=n.slice(-e.tail)),e.maxLines&&e.maxLines>0&&(n=n.slice(0,e.maxLines)),n.join(`
+`).trimEnd()||e.emptyMessage||""}c(x,"applyTomlStyleFilter");export{x as applyTomlStyleFilter};

package/dist/extensions/builtin/token-save/tracking.d.ts

@@ -0,0 +1,24 @@
+import type { TokenSaveCategory } from "./filters.js";
+export interface TokenSaveRecord {
+    timestamp: string;
+    projectPath: string;
+    command: string;
+    category: TokenSaveCategory;
+    mode: "filtered" | "passthrough";
+    inputTokens: number;
+    outputTokens: number;
+    savedTokens: number;
+    savingsPct: number;
+    elapsedMs?: number;
+    isError: boolean;
+    rawRecoveryPath?: string;
+}
+export declare class TokenSaveTracker {
+    private readonly projectPath;
+    private records;
+    constructor(projectPath: string);
+    add(record: Omit<TokenSaveRecord, "timestamp" | "projectPath">): TokenSaveRecord;
+    formatSummary(limit?: number): string;
+    formatHistory(limit?: number): string;
+    private persist;
+}

package/dist/extensions/builtin/token-save/tracking.js

@@ -0,0 +1,8 @@
+var u=Object.defineProperty;var r=(i,s)=>u(i,"name",{value:s,configurable:!0});import{mkdir as d,appendFile as h}from"node:fs/promises";import{join as c}from"node:path";class f{static{r(this,"TokenSaveTracker")}projectPath;records=[];constructor(s){this.projectPath=s}add(s){const e={...s,timestamp:new Date().toISOString(),projectPath:this.projectPath};return this.records.push(e),this.records.length>500&&this.records.shift(),this.persist(e),e}formatSummary(s=8){const e=this.records.filter(n=>n.mode==="filtered"),t=e.reduce((n,o)=>(n.input+=o.inputTokens,n.output+=o.outputTokens,n.saved+=o.savedTokens,n),{input:0,output:0,saved:0}),p=t.input>0?Math.round(t.saved/t.input*100):0,a=e.slice(-s).map(n=>`${n.category}: saved ${n.savedTokens} tokens (${n.savingsPct}%)`);return["TokenSave stats",`Filtered commands: ${e.length}`,`Estimated tokens: ${t.input} -> ${t.output}`,`Saved: ${t.saved} (${p}%)`,a.length?`
+Recent:
+`+a.join(`
+`):`
+No filtered commands recorded yet.`].join(`
+`)}formatHistory(s=20){const e=this.records.slice(-s);return e.length===0?"TokenSave history is empty.":["TokenSave history",...e.map(t=>[t.timestamp,t.mode,t.category,`saved=${t.savedTokens}`,`pct=${t.savingsPct}`,t.rawRecoveryPath?`raw=${t.rawRecoveryPath}`:void 0,`cmd=${t.command}`].filter(Boolean).join(" | "))].join(`
+`)}async persist(s){const e=c(this.projectPath,".catui","token-save");try{await d(e,{recursive:!0}),await h(c(e,"history.jsonl"),`${JSON.stringify(s)}
+`,"utf8")}catch{}}}export{f as TokenSaveTracker};

package/dist/extensions/optional/AGENT.md

@@ -0,0 +1,11 @@
+# extensions/optional/
+
+> P2 | Parent: ../AGENT.md
+
+Member List
+export-html/index.ts: HTML export extension, exportSessionToHtml/exportFromFile, /export command
+simplify/index.ts: Simplification extension, /simplify style refactoring tool
+
+Rule: Members complete, one item per line, parent links valid, precise terms first
+
+[COVENANT]: Update this file header on changes and verify against parent AGENT.md

package/dist/extensions/optional/export-html/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * export-html Extension
+ *
+ * Provides HTML export functionality for sessions.
+ * This extension registers the /export command.
+ */
+/**
+ * [WHO]: exportSessionToHtml, exportFromFile, type ToolHtmlRenderer, type ExportOptions, ExtExportOptions
+ * [FROM]: Depends on node:path, node:url, ../../../core/session/session-manager.js, ../../../config.js, ../../../modes/interactive/theme/theme.js
+ * [TO]: Loaded by core/extensions-host/loader.ts as extension entry point
+ * [HERE]: extensions/optional/export-html/index.ts -
+ */
+import type { AgentState } from "@catui/agent-core";
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+import { SessionManager } from "../../../core/session/session-manager.js";
+export { exportSessionToHtml, exportFromFile, type ToolHtmlRenderer, type ExportOptions } from "../../../core/export-html/index.js";
+export interface ExtExportOptions {
+    outputPath?: string;
+    themeName?: string;
+    toolRenderer?: {
+        renderCall(toolName: string, args: unknown): string | undefined;
+        renderResult(toolName: string, result: Array<{
+            type: string;
+            text?: string;
+            data?: string;
+            mimeType?: string;
+        }>, details: unknown, isError: boolean): string | undefined;
+    };
+}
+/**
+ * Export session to HTML.
+ */
+export declare function extExportSessionToHtml(sm: SessionManager, state?: AgentState, options?: ExtExportOptions | string): Promise<string>;
+/**
+ * Export session file to HTML (standalone).
+ */
+export declare function extExportFromFile(inputPath: string, options?: ExtExportOptions | string): Promise<string>;
+/**
+ * Extension factory function
+ */
+export default function exportHtmlExtension(api: ExtensionAPI): Promise<void>;

package/dist/extensions/optional/export-html/index.js

@@ -0,0 +1,2 @@
+var A=Object.defineProperty;var i=(n,e)=>A(n,"name",{value:e,configurable:!0});import{dirname as H,join as u}from"node:path";import{fileURLToPath as L}from"node:url";import{SessionManager as P}from"../../../core/session/session-manager.js";import{APP_NAME as d,getExportTemplateDir as w}from"../../../config.js";import{getResolvedThemeColors as h,getThemeExportColors as F}from"../../../modes/interactive/theme/theme.js";const W=H(L(import.meta.url)),O=[{value:"./catui-session.html",label:"./catui-session.html",description:"Choose the output file for this session export"}];import{exportSessionToHtml as Z,exportFromFile as ee}from"../../../core/export-html/index.js";function B(n){const e=n.match(/^#([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/);if(e)return{r:Number.parseInt(e[1],16),g:Number.parseInt(e[2],16),b:Number.parseInt(e[3],16)};const t=n.match(/^rgb\s*\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/);if(t)return{r:Number.parseInt(t[1],10),g:Number.parseInt(t[2],10),b:Number.parseInt(t[3],10)}}i(B,"parseColor");function _(n,e,t){const o=i(r=>{const s=r/255;return s<=.03928?s/12.92:((s+.055)/1.055)**2.4},"toLinear");return .2126*o(n)+.7152*o(e)+.0722*o(t)}i(_,"getLuminance");function p(n,e){const t=B(n);if(!t)return n;const o=i(r=>Math.min(255,Math.max(0,Math.round(r*e))),"adjust");return`rgb(${o(t.r)}, ${o(t.g)}, ${o(t.b)})`}i(p,"adjustBrightness");function x(n){const e=B(n);return e?_(e.r,e.g,e.b)>.5?{pageBg:p(n,.96),cardBg:n,infoBg:`rgb(${Math.min(255,e.r+10)}, ${Math.min(255,e.g+5)}, ${Math.max(0,e.b-20)})`}:{pageBg:p(n,.7),cardBg:p(n,.85),infoBg:`rgb(${Math.min(255,e.r+20)}, ${Math.min(255,e.g+15)}, ${e.b})`}:{pageBg:"rgb(24, 24, 30)",cardBg:"rgb(30, 30, 36)",infoBg:"rgb(60, 55, 40)"}}i(x,"deriveExportColors");import{existsSync as b,readFileSync as f,writeFileSync as M}from"node:fs";import{basename as S}from"node:path";function j(n){const e=h(n),t=[];for(const[a,c]of Object.entries(e))t.push(`--${a}: ${c};`);const o=F(n),r=e.userMessageBg||"#343541",s=x(r);return t.push(`--exportPageBg: ${o.pageBg??s.pageBg};`),t.push(`--exportCardBg: ${o.cardBg??s.cardBg};`),t.push(`--exportInfoBg: ${o.infoBg??s.infoBg};`),t.join(`
+      `)}i(j,"generateThemeVars");function y(n,e){const t=w(),o=f(u(t,"template.html"),"utf-8"),r=f(u(t,"template.css"),"utf-8"),s=f(u(t,"template.js"),"utf-8"),a=f(u(t,"vendor","marked.min.js"),"utf-8"),c=f(u(t,"vendor","highlight.min.js"),"utf-8"),g=j(e),m=h(e),l=x(m.userMessageBg||"#343541"),E=l.pageBg,$=l.cardBg,T=l.infoBg,C=Buffer.from(JSON.stringify(n)).toString("base64"),N=r.replace("{{THEME_VARS}}",g).replace("{{BODY_BG}}",E).replace("{{CONTAINER_BG}}",$).replace("{{INFO_BG}}",T);return o.replace("{{CSS}}",N).replace("{{JS}}",s).replace("{{SESSION_DATA}}",C).replace("{{MARKED_JS}}",a).replace("{{HIGHLIGHT_JS}}",c)}i(y,"generateHtml");const I=new Set(["bash","read","write","edit","ls","find","grep"]);function v(n,e){const t={};for(const o of n){if(o.type!=="message")continue;const r=o.message;if(r.role==="assistant"&&Array.isArray(r.content)){for(const s of r.content)if(s.type==="toolCall"&&!I.has(s.name)){const a=e.renderCall(s.name,s.arguments);a&&(t[s.id]={callHtml:a})}}if(r.role==="toolResult"&&r.toolCallId){const s=r.toolName||"",a=t[r.toolCallId];if(a||!I.has(s)){const c=e.renderResult(s,r.content,r.details,r.isError||!1);c&&(t[r.toolCallId]={...a,resultHtml:c})}}}return t}i(v,"preRenderCustomTools");async function R(n,e,t){const o=typeof t=="string"?{outputPath:t}:t||{},r=n.getSessionFile();if(!r)throw new Error("Cannot export in-memory session to HTML");if(!b(r))throw new Error("Nothing to export yet - start a conversation first");const s=n.getEntries();let a;o.toolRenderer&&(a=v(s,o.toolRenderer),Object.keys(a).length===0&&(a=void 0));const c={header:n.getHeader(),entries:s,leafId:n.getLeafId(),systemPrompt:e?.systemPrompt,tools:e?.tools?.map(l=>({name:l.name,description:l.description,parameters:l.parameters})),renderedTools:a},g=y(c,o.themeName);let m=o.outputPath;if(!m){const l=S(r,".jsonl");m=`${d}-session-${l}.html`}return M(m,g,"utf8"),m}i(R,"extExportSessionToHtml");async function q(n,e){const t=typeof e=="string"?{outputPath:e}:e||{};if(!b(n))throw new Error(`File not found: ${n}`);const o=P.open(n),r={header:o.getHeader(),entries:o.getEntries(),leafId:o.getLeafId(),systemPrompt:void 0,tools:void 0},s=y(r,t.themeName);let a=t.outputPath;if(!a){const c=S(n,".jsonl");a=`${d}-session-${c}.html`}return M(a,s,"utf8"),a}i(q,"extExportFromFile");async function D(n){n.registerCommand("export",{description:"Save this session as a shareable HTML file",getArgumentCompletions:i((e,t)=>{if(t&&t.tokenIndex>0)return null;const o=e.trim().toLowerCase(),r=O.filter(s=>s.value.startsWith(o));return r.length>0?r:null},"getArgumentCompletions"),handler:i(async(e,t)=>{const o=t.sessionManager;if(!o)throw new Error("Session manager not available");const r=e.trim()||void 0,s=await R(o,void 0,r);console.error(`Session exported to: ${s}`)},"handler")})}i(D,"exportHtmlExtension");export{D as default,ee as exportFromFile,Z as exportSessionToHtml,q as extExportFromFile,R as extExportSessionToHtml};

package/dist/extensions/optional/simplify/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * [WHO]: Simplify extension - Claude Code style code simplification tool
+ * [FROM]: Depends on @catui/ai, @catui/tui, child_process, fs, path, core/extensions-host/types, modes/interactive/components/dynamic-border, modes/interactive/theme/theme
+ * [TO]: Consumed by builtin-extensions.ts as optional extension
+ * [HERE]: extensions/optional/simplify/index.ts - code simplification for Catui
+ *
+ * Features:
+ * 1. Perception layer: Scan Git Diff + read project rules + analyze code
+ * 2. Decision layer: Apply refactoring patterns (guard clauses, expression folding, redundancy removal)
+ * 3. Execution layer: Generate Diff and apply to files
+ * 4. Validation layer: Run tests to verify, rollback on failure
+ */
+import type { ExtensionAPI } from "../../../core/extensions-host/types.js";
+declare function getGitDiff(cwd: string): string;
+declare function getFileDiff(cwd: string, file: string): string;
+declare function resolveWorkspaceFile(cwd: string, filePath: string): string | undefined;
+interface TestCommand {
+    command: string;
+    args: string[];
+    label: string;
+}
+declare function detectTestCommand(cwd: string): TestCommand | null;
+declare function runTests(cwd: string): {
+    success: boolean;
+    output: string;
+};
+export default function simplifyExtension(api: ExtensionAPI): void;
+export declare const __testUtils: {
+    getGitDiff: typeof getGitDiff;
+    getFileDiff: typeof getFileDiff;
+    resolveWorkspaceFile: typeof resolveWorkspaceFile;
+    detectTestCommand: typeof detectTestCommand;
+    runTests: typeof runTests;
+};
+export {};

package/dist/extensions/optional/simplify/index.js

@@ -0,0 +1,77 @@
+var O=Object.defineProperty;var f=(t,e)=>O(t,"name",{value:e,configurable:!0});import{complete as F}from"@catui/ai/stream";import{getModel as w}from"@catui/ai/models";import{Container as P,Markdown as N,matchesKey as y,Text as E}from"@catui/tui";import{execFileSync as g}from"child_process";import{existsSync as h,readFileSync as S,writeFileSync as v}from"fs";import{isAbsolute as M,join as T,relative as I,resolve as L}from"path";import{DynamicBorder as D}from"../../../modes/interactive/components/dynamic-border.js";import{getMarkdownTheme as j}from"../../../modes/interactive/theme/theme.js";const x=[{value:"--dry-run",label:"--dry-run",description:"Preview changes without writing files"},{value:"--no-test",label:"--no-test",description:"Skip the verification command after applying changes"}];function b(t){try{const e=g("git",["diff","--cached","--name-only"],{cwd:t,encoding:"utf-8"}),n=g("git",["diff","--name-only"],{cwd:t,encoding:"utf-8"});return[...new Set([...e.split(`
+`),...n.split(`
+`)])].filter(i=>i.trim()).join(`
+`)}catch{return""}}f(b,"getGitDiff");function C(t,e){try{return g("git",["diff","HEAD","--",e],{cwd:t,encoding:"utf-8"})||""}catch{return""}}f(C,"getFileDiff");function d(t,e){const n=L(t,e),o=I(t,n);if(!(!o||o.startsWith("..")||M(o)))return n}f(d,"resolveWorkspaceFile");function U(t){const e=["AGENT.md","CLAUDE.md","AGENTS.md",".cursor/rules",".github/copilot-instructions.md"],n=[];for(const o of e){const i=T(t,o);if(h(i))try{const r=S(i,"utf-8");n.push(`=== ${o} ===
+${r.slice(0,2e3)}`)}catch{}}return n.join(`
+
+`)}f(U,"loadProjectRules");function $(t){const e=T(t,"package.json");if(h(e))try{if(JSON.parse(S(e,"utf-8")).scripts?.test)return{command:"npm",args:["test"],label:"npm test"}}catch{}const n=[{pattern:"pytest.ini",command:"pytest",args:[],label:"pytest"},{pattern:"setup.py",command:"python",args:["-m","pytest"],label:"python -m pytest"},{pattern:"Cargo.toml",command:"cargo",args:["test"],label:"cargo test"},{pattern:"go.mod",command:"go",args:["test","./..."],label:"go test ./..."}];for(const{pattern:o,command:i,args:r,label:p}of n)if(h(T(t,o)))return{command:i,args:r,label:p};return null}f($,"detectTestCommand");function k(t){const e=$(t);if(!e)return{success:!0,output:"No test command detected, skipping tests"};try{return{success:!0,output:g(e.command,e.args,{cwd:t,encoding:"utf-8",timeout:12e4})}}catch(n){const o=n;return{success:!1,output:`${o.stdout||""}
+${o.stderr||""}`.trim()}}}f(k,"runTests");const _=`You are a code simplification expert. Your task is to refactor code to reduce cognitive load while preserving exact functionality.
+
+CONSTRAINTS:
+1. DO NOT change function signatures or external behavior
+2. DO NOT add or remove functionality
+3. DO NOT change the public API
+4. Preserve all side effects exactly
+
+REFACTORING PATTERNS (apply in order of priority):
+1. Guard Clauses: Convert nested if-else to early returns
+   - Before: if (x) { if (y) { ...long code... } }
+   - After: if (!x) return; if (!y) return; ...long code...
+
+2. Expression Folding: Simplify boolean logic
+   - Before: if (x === true) -> After: if (x)
+   - Before: if (!(a && b)) -> After: if (!a || !b)
+
+3. Redundancy Removal:
+   - Remove unnecessary intermediate variables
+   - Remove unused private methods
+   - Remove outdated comments
+
+4. Loop Simplification:
+   - Convert forEach + push to map/filter
+   - Use array methods over manual iteration
+
+OUTPUT FORMAT:
+Return a JSON object with:
+{
+  "simplified": "the simplified code",
+  "explanation": "brief explanation of changes made",
+  "equivalent": true/false // whether the refactored code is functionally equivalent
+}
+
+If no simplification is needed, return:
+{
+  "simplified": null,
+  "explanation": "Code is already simple and clean",
+  "equivalent": true
+}`;function q(t,e,n){let o=`Simplify the following code according to the constraints above.
+
+`;return e&&(o+=`PROJECT RULES (must follow):
+${e}
+
+`),n&&(o+=`FOCUS AREA (prioritize changes in this diff):
+\`\`\`diff
+${n}
+\`\`\`
+
+`),o+=`CODE TO SIMPLIFY:
+\`\`\`
+${t}
+\`\`\``,o}f(q,"buildSimplifyUserPrompt");async function K(t,e,n,o){let i=o.model,r=i?await o.modelRegistry.getApiKey(i):void 0;if(!i||!r){const u=w("anthropic","claude-sonnet-4-5");if(u){const s=await o.modelRegistry.getApiKey(u);s&&(i=u,r=s)}if(!i||!r){const s=w("openai","gpt-4o");if(s){const l=await o.modelRegistry.getApiKey(s);l&&(i=s,r=l)}}if(!i||!r){const s=w("google","gemini-2.5-flash");if(s){const l=await o.modelRegistry.getApiKey(s);l&&(i=s,r=l)}}}if(!i||!r)throw new Error("No model available for simplification");const a=(await F(i,{systemPrompt:_,messages:[{role:"user",content:[{type:"text",text:q(t,e,n)}],timestamp:Date.now()}]},{apiKey:r,maxTokens:4096,temperature:.2})).content.filter(u=>u.type==="text").map(u=>u.text).join("");try{const u=a.replace(/```json?\n?/g,"").replace(/```/g,"").trim();return JSON.parse(u)}catch{return{simplified:null,explanation:"Failed to parse LLM response",equivalent:!1}}}f(K,"simplifyWithLLM");async function W(t,e){return e.hasUI?new Promise(n=>{e.ui.custom((o,i,r,p)=>{const a=new P,u=new D(c=>i.fg("accent",c)),s=j(),l=`## Simplify: ${t.file}
+
+### Explanation
+${t.explanation}
+
+### Changes
+\`\`\`diff
+- Original (${t.original.split(`
+`).length} lines)
++ Simplified (${t.simplified.split(`
+`).length} lines)
+\`\`\`
+
+Press **y** to apply, **n** to skip, **q** to cancel all`;return a.addChild(u),a.addChild(new E(i.fg("accent",i.bold("Code Simplification Preview")),1,0)),a.addChild(new N(l,1,1,s)),a.addChild(u),{render:f(c=>a.render(c),"render"),invalidate:f(()=>a.invalidate(),"invalidate"),handleInput:f(c=>{y(c,"y")?(p("apply"),n("apply")):y(c,"n")?(p("skip"),n("skip")):(y(c,"q")||y(c,"escape"))&&(p("cancel"),n("cancel"))},"handleInput")}})}):"apply"}f(W,"showSimplifyPreview");async function Y(t,e,n,o){const i=d(e,t);if(!i)return o.ui.notify(`Refusing to simplify file outside workspace: ${t}`,"warning"),null;if(!h(i))return o.ui.notify(`File not found: ${t}`,"warning"),null;const r=S(i,"utf-8"),p=C(e,t);o.ui.notify(`Analyzing: ${t}...`,"info");try{const a=await K(r,n,p,o);return!a.simplified||!a.equivalent?(o.ui.notify(`Skipping ${t}: ${a.explanation}`,"info"),null):{file:t,original:r,simplified:a.simplified,explanation:a.explanation}}catch(a){return o.ui.notify(`Error simplifying ${t}: ${a}`,"error"),null}}f(Y,"simplifyFile");async function A(t,e){const n=e.cwd,o=U(n);let i=t.files||[];if(i.length===0&&(i=b(n).split(`
+`).filter(l=>l.trim()).filter(l=>/\.(ts|tsx|js|jsx|py|go|rs|java|c|cpp|cs)$/.test(l)),i.length===0)){e.ui.notify("No changed files found. Use /simplify <file> to simplify a specific file.","info");return}e.ui.notify(`Found ${i.length} file(s) to analyze`,"info");const r=[],p=new Map;for(const s of i){const l=await Y(s,n,o,e);l&&r.push(l)}if(r.length===0){e.ui.notify("No simplifications needed. Code is already clean!","info");return}e.ui.notify(`Found ${r.length} simplification(s)`,"info");const a=[];for(const s of r){if(t.dryRun){e.ui.notify(`[Dry Run] Would simplify: ${s.file}`,"info");continue}const l=await W(s,e);if(l==="cancel"){e.ui.notify("Simplification cancelled","info");for(const[c,m]of p){const R=d(n,c);R&&v(R,m,"utf-8")}return}if(l==="apply"){p.set(s.file,s.original);const c=d(n,s.file);if(!c){e.ui.notify(`Refusing to write outside workspace: ${s.file}`,"error");continue}v(c,s.simplified,"utf-8"),a.push(s),e.ui.notify(`Applied: ${s.file}`,"info")}}if(a.length===0){e.ui.notify("No changes applied","info");return}if(t.runTests){e.ui.notify("Running tests to verify changes...","info");const s=k(n);if(!s.success){e.ui.notify("Tests failed! Rolling back changes...","error");for(const[l,c]of p){const m=d(n,l);m&&v(m,c,"utf-8")}e.ui.notify(`Rolled back ${p.size} file(s). Test output:
+${s.output.slice(0,500)}`,"error");return}e.ui.notify("Tests passed!","info")}const u=a.reduce((s,l)=>s+(l.original.split(`
+`).length-l.simplified.split(`
+`).length),0);e.ui.notify(`Simplification complete! Applied ${a.length} change(s), saved ~${u} lines.`,"info")}f(A,"executeSimplify");function z(t){t.registerCommand("simplify",{description:"Suggest smaller code changes for files you choose",getArgumentCompletions:f((e,n)=>{if(n&&n.tokenIndex>0)return null;const o=e.trim().toLowerCase(),i=x.filter(r=>r.value.startsWith(o));return i.length>0?i:null},"getArgumentCompletions"),handler:f(async(e,n)=>{const o=e.trim().split(/\s+/).filter(Boolean),i={files:[],runTests:!0,dryRun:!1};for(const r of o)r==="--dry-run"?i.dryRun=!0:r==="--no-test"?i.runTests=!1:r.startsWith("--")||i.files.push(r);await A(i,n)},"handler")}),t.registerShortcut("ctrl+shift+s",{description:"Simplify changed files",handler:f(async e=>{await A({runTests:!0},e)},"handler")})}f(z,"simplifyExtension");const te={getGitDiff:b,getFileDiff:C,resolveWorkspaceFile:d,detectTestCommand:$,runTests:k};export{te as __testUtils,z as default};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [WHO]: Stable root SDK exports for @catui/agent
+ * [FROM]: Depends on config, core/runtime/sdk, core/runtime/catui-agent
+ * [TO]: Consumed by external SDK embedders via the package root
+ * [HERE]: index.ts - intentionally narrow root package entry; advanced APIs live in subpaths
+ */
+export { getAgentDir, VERSION } from "./config.js";
+export { CatuiAgent, quickAgent, type CatuiAgentOptions, } from "./core/runtime/catui-agent.js";
+export { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession, createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLsTool, createReadOnlyTools, createReadTool, createWriteTool, defaultLogger, type PromptTemplate, readOnlyTools, type SDKLogger, silentLogger, } from "./core/runtime/sdk.js";

package/dist/index.js

@@ -0,0 +1 @@
+import{getAgentDir as t,VERSION as r}from"./config.js";import{CatuiAgent as l,quickAgent as c}from"./core/runtime/catui-agent.js";import{createAgentSession as n,createBashTool as T,createCodingTools as i,createEditTool as s,createFindTool as d,createGrepTool as f,createLsTool as p,createReadOnlyTools as A,createReadTool as m,createWriteTool as u,defaultLogger as x,readOnlyTools as L,silentLogger as O}from"./core/runtime/sdk.js";export{l as CatuiAgent,r as VERSION,n as createAgentSession,T as createBashTool,i as createCodingTools,s as createEditTool,d as createFindTool,f as createGrepTool,p as createLsTool,A as createReadOnlyTools,m as createReadTool,u as createWriteTool,x as defaultLogger,t as getAgentDir,c as quickAgent,L as readOnlyTools,O as silentLogger};

package/dist/main.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Main CLI handler, orchestrates SDK initialization and mode dispatch
+ * [FROM]: Depends on cli/*, core/*, modes/*, packages/*, config.ts
+ * [TO]: Consumed by cli.ts
+ * [HERE]: CLI layer; parses args → CreateAgentSessionOptions → mode selection
+ */
+export declare function main(args: string[]): Promise<void>;

package/dist/main.js

@@ -0,0 +1,41 @@
+var ge=Object.defineProperty;var f=(e,s)=>ge(e,"name",{value:s,configurable:!0});import{modelsAreEqual as fe,supportsXhigh as pe}from"@catui/ai/models";import a from"chalk";import{join as N,resolve as ue}from"path";import{homedir as he}from"node:os";import{createInterface as we}from"readline";import{parseArgs as Q,printHelp as Pe}from"./cli/args.js";import{selectConfig as ye}from"./cli/config-selector.js";import{processFileArguments as ve}from"./cli/file-processor.js";import{listModels as _e}from"./cli/list-models.js";import{selectSession as ke}from"./cli/session-picker.js";import{APP_NAME as P,PACKAGE_NAME as Me,resolveAgentDirContext as Ee,VERSION as Ce}from"./config.js";import{ensureAgentMetadata as Ie}from"./core/agent-dir/agent-metadata.js";import{MigrationManager as X}from"./core/agent-dir/migration-tool.js";import{AuthStorage as Se}from"./core/platform/config/auth-storage.js";import{DEFAULT_THINKING_LEVEL as xe}from"./core/platform/config/defaults.js";import{KeybindingsManager as Ae}from"./core/platform/keybindings.js";import{ModelRegistry as $e}from"./core/model-registry.js";import{resolveCliModel as Te,resolveModelScope as B}from"./core/model-resolver.js";import{DefaultPackageManager as Z}from"./core/package-manager.js";import{DefaultResourceLoader as J}from"./core/platform/config/resource-loader.js";import{createAgentSession as ee}from"./core/runtime/sdk.js";import{SessionManager as k}from"./core/session/session-manager.js";import{SettingsManager as F}from"./core/platform/config/settings-manager.js";import{time as Re}from"./core/platform/timings.js";import{allTools as oe}from"./core/tools/index.js";import{runMigrations as Oe,showDeprecationWarnings as De}from"./migrations.js";import{initTheme as Le,stopThemeWatcher as te,theme as be}from"./modes/interactive/theme/theme.js";import{exportFromFile as Ne}from"./core/export-html/index.js";import{profileCheckpoint as y}from"./utils/startup-profiler.js";import{isDevRuntime as ne,reportDiagnostic as se}from"./utils/diagnostics.js";import{CUSTOM_ANTHROPIC_PROVIDER as Fe,CUSTOM_OPENAI_PROVIDER as Ue}from"./core/model/custom-providers.js";import{ensureCatuiCodingPlanAuth as We,ensureCatuiDefaultConfig as je,CATUI_ALI_TOKEN_PLAN_ANTHROPIC_PROVIDER as Ve,CATUI_ALI_TOKEN_PLAN_OPENAI_PROVIDER as Ke,CATUI_ARK_CODING_PROVIDER as He,CATUI_DEFAULT_PROVIDER as Ge,CATUI_MINIMAX_CODING_PROVIDER as Ye,CATUI_QIANFAN_CODING_PROVIDER as qe,CATUI_ZHIPU_CODING_PROVIDER as ze,CATUI_ANTHROPIC_CUSTOM_PROVIDER as Qe,CATUI_OLLAMA_PROVIDER as Xe}from"./catui-defaults.js";import{getBuiltinExtensionPaths as Be}from"./builtin-extensions.js";const re=process.env.NODE_ENV!=="production",x=P==="catui"||P==="catui";{const e=process.emitWarning.bind(process),s=f((...i)=>e(...i),"callOriginalEmitWarning"),o=f((i,r)=>typeof i=="object"&&i!==null?i:{type:typeof i=="string"?i:void 0,code:typeof r=="string"?r:void 0},"normalizeWarningOptions"),t=f((i,r,d)=>{if((i?.name??d?.name??"")==="MaxListenersExceededWarning")return!0;const g=String(i?.message??r??"");return g.startsWith("Possible EventTarget memory leak detected")||g.startsWith("Possible EventEmitter memory leak detected")},"isMaxListenersWarning"),c=f(i=>(i?.type??"")==="DeprecationWarning"&&(i?.code??"")==="DEP0190","isDep0190");if(process.emitWarning=((i,r,d,m)=>{const g=o(r,d),h=i instanceof Error?i:null;if(!(!re&&c(g))){if(t(h,i,g)&&!ne()){const p=h?.message??String(i??"");se({source:"node.warning",severity:"warning",category:"fallback",message:p.slice(0,240),detail:{code:g.code,type:g.type,name:g.name},fingerprint:"node.warning:max-listeners-exceeded"});return}return typeof r=="function"?s(i,r):typeof d=="function"?s(i,typeof r=="string"?r:void 0,d):typeof m=="function"?s(i,typeof r=="string"?r:void 0,d,m):typeof r=="object"&&r!==null?s(i,r):s(i,r,d)}}),!ne()){for(const i of process.listeners("warning"))process.off("warning",i);process.on("warning",i=>{if(t(i)){se({source:"node.warning",severity:"warning",category:"fallback",message:i.message.slice(0,240),detail:{code:i.code,name:i.name},fingerprint:"node.warning:max-listeners-exceeded"});return}c({type:"DeprecationWarning",code:i.code})||process.stderr.write(`(node:${process.pid}) ${i.stack??i.message}
+`)})}}async function Ze(){if(!process.stdin.isTTY)return new Promise(e=>{let s="";process.stdin.setEncoding("utf8"),process.stdin.on("data",o=>{s+=o}),process.stdin.on("end",()=>{e(s.trim()||void 0)}),process.stdin.resume()})}f(Ze,"readPipedStdin");function U(e,s){const o=e.drainErrors();for(const{scope:t,error:c}of o)console.error(a.yellow(`Warning (${s}, ${t} settings): ${c.message}`)),c.stack&&console.error(a.dim(c.stack))}f(U,"reportSettingsErrors");function Je(e){return e?e==="1"||e.toLowerCase()==="true"||e.toLowerCase()==="yes":!1}f(Je,"isTruthyEnvFlag");function H(e){const s=process.env[`${P.toUpperCase()}_CWD`],o=e||s;return o?ue(o):process.cwd()}f(H,"resolveWorkingDirectory");function R(e){switch(e){case"install":return`${P} install <source> [-l]`;case"remove":return`${P} remove <source> [-l]`;case"update":return`${P} update [source]`;case"list":return`${P} list`}}f(R,"getPackageCommandUsage");function eo(e){switch(e){case"install":console.log(`${a.bold("Usage:")}
+  ${R("install")}
+
+Install a package and add it to settings.
+
+Options:
+  -l, --local    Install project-locally (.catui/settings.json)
+
+Examples:
+  ${P} install npm:@foo/bar
+  ${P} install git:github.com/user/repo
+  ${P} install git:git@github.com:user/repo
+  ${P} install https://github.com/user/repo
+  ${P} install ssh://git@github.com/user/repo
+  ${P} install ./local/path
+`);return;case"remove":console.log(`${a.bold("Usage:")}
+  ${R("remove")}
+
+Remove a package and its source from settings.
+
+Options:
+  -l, --local    Remove from project settings (.catui/settings.json)
+
+Example:
+  ${P} remove npm:@foo/bar
+`);return;case"update":console.log(`${a.bold("Usage:")}
+  ${R("update")}
+
+Update installed packages.
+If <source> is provided, only that package is updated.
+`);return;case"list":console.log(`${a.bold("Usage:")}
+  ${R("list")}
+
+List installed packages from user and project settings.
+`);return}}f(eo,"printPackageCommandHelp");function oo(e){const[s,...o]=e;if(s!=="install"&&s!=="remove"&&s!=="update"&&s!=="list")return;let t=!1,c=!1,i,r;for(const d of o){if(d==="-h"||d==="--help"){c=!0;continue}if(d==="-l"||d==="--local"){s==="install"||s==="remove"?t=!0:i=i??d;continue}if(d.startsWith("-")){i=i??d;continue}r||(r=d)}return{command:s,source:r,local:t,help:c,invalidOption:i}}f(oo,"parsePackageCommand");async function to(e,s){const o=oo(e);if(!o)return!1;if(o.help)return eo(o.command),!0;if(o.invalidOption)return console.error(a.red(`Unknown option ${o.invalidOption} for "${o.command}".`)),console.error(a.dim(`Use "${P} --help" or "${R(o.command)}".`)),process.exitCode=1,!0;const t=o.source;if((o.command==="install"||o.command==="remove")&&!t)return console.error(a.red(`Missing ${o.command} source.`)),console.error(a.dim(`Usage: ${R(o.command)}`)),process.exitCode=1,!0;const c=process.cwd(),i=s.path,r=F.create(c,s);U(r,"package command");const d=new Z({cwd:c,agentDir:i,settingsManager:r});d.setProgressCallback(m=>{m.type==="start"&&process.stdout.write(a.dim(`${m.message}
+`))});try{switch(o.command){case"install":return await d.install(t,{local:o.local}),d.addSourceToSettings(t,{local:o.local}),console.log(a.green(`Installed ${t}`)),!0;case"remove":return await d.remove(t,{local:o.local}),d.removeSourceFromSettings(t,{local:o.local})?(console.log(a.green(`Removed ${t}`)),!0):(console.error(a.red(`No matching package found for ${t}`)),process.exitCode=1,!0);case"list":{const m=r.getGlobalSettings(),g=r.getProjectSettings(),h=m.packages??[],p=g.packages??[];if(h.length===0&&p.length===0)return console.log(a.dim("No packages installed.")),!0;const I=f((_,C)=>{const A=typeof _=="string"?_:_.source,O=typeof _=="object"?`${A} (filtered)`:A;console.log(`  ${O}`);const D=d.getInstalledPath(A,C);D&&console.log(a.dim(`    ${D}`))},"formatPackage");if(h.length>0){console.log(a.bold("User packages:"));for(const _ of h)I(_,"user")}if(p.length>0){h.length>0&&console.log(),console.log(a.bold("Project packages:"));for(const _ of p)I(_,"project")}return!0}case"update":return await d.update(t),console.log(t?a.green(`Updated ${t}`):a.green("Updated packages")),!0}}catch(m){const g=m instanceof Error?m.message:"Unknown package command error";return console.error(a.red(`Error: ${g}`)),process.exitCode=1,!0}}f(to,"handlePackageCommand");async function no(e,s){if(e.fileArgs.length===0)return{};const{text:o,images:t}=await ve(e.fileArgs,{autoResizeImages:s});let c;return e.messages.length>0?(c=o+e.messages[0],e.messages.shift()):c=o,{initialMessage:c,initialImages:t.length>0?t:void 0}}f(no,"prepareInitialMessage");async function so(e,s,o){if(e.includes("/")||e.includes("\\")||e.endsWith(".jsonl"))return{type:"path",path:e};const c=(await k.list(s,o)).filter(d=>d.id.startsWith(e));if(c.length>=1)return{type:"local",path:c[0].path};const r=(await k.listAll()).filter(d=>d.id.startsWith(e));if(r.length>=1){const d=r[0];return{type:"global",path:d.path,cwd:d.cwd}}return{type:"not_found",arg:e}}f(so,"resolveSessionPath");async function ro(e){return new Promise(s=>{const o=we({input:process.stdin,output:process.stdout});o.question(`${e} [y/N] `,t=>{o.close(),s(t.toLowerCase()==="y"||t.toLowerCase()==="yes")})})}f(ro,"promptConfirm");async function io(e,s,o){if(e.noSession)return k.inMemory(s,o);if(e.session){const t=await so(e.session,s,e.sessionDir);switch(t.type){case"path":case"local":return k.open(t.path,e.sessionDir,o);case"global":return console.log(a.yellow(`Session found in different project: ${t.cwd}`)),await ro("Fork this session into current directory?")||(console.log(a.dim("Aborted.")),process.exit(0)),k.forkFrom(t.path,s,e.sessionDir,o);case"not_found":console.error(a.red(`No session found matching '${t.arg}'`)),process.exit(1)}}if(e.continue)return k.continueRecent(s,e.sessionDir,o);if(e.sessionDir)return k.create(s,e.sessionDir,o)}f(io,"createSessionManager");function ie(e,s,o,t,c,i){const r={agentDir:i.path,agentCtx:i};let d=!1;if(o&&(r.sessionManager=o),e.model){const m=Te({cliProvider:e.provider,cliModel:e.model,modelRegistry:t});m.warning&&console.warn(a.yellow(`Warning: ${m.warning}`)),m.error&&(console.error(a.red(m.error)),process.exit(1)),m.model&&(r.model=m.model,!e.thinking&&m.thinkingLevel&&(r.thinkingLevel=m.thinkingLevel,d=!0))}if(!r.model&&s.length>0&&!e.continue&&!e.resume){const m=c.getDefaultProvider(),g=c.getDefaultModel(),h=m&&g?t.find(m,g):void 0,p=h?s.find(I=>fe(I.model,h)):void 0;p?(r.model=p.model,!e.thinking&&p.thinkingLevel&&(r.thinkingLevel=p.thinkingLevel)):(r.model=s[0].model,!e.thinking&&s[0].thinkingLevel&&(r.thinkingLevel=s[0].thinkingLevel))}if(e.thinking&&(r.thinkingLevel=e.thinking),e.agentLoopFramework&&(r.agentLoopFramework=e.agentLoopFramework),e.loopPolicy&&(r.loopPolicy=e.loopPolicy),s.length>0){const m=c.getDefaultThinkingLevel()??xe;r.scopedModels=s.map(g=>({model:g.model,thinkingLevel:g.thinkingLevel??m}))}return e.noTools?e.tools&&e.tools.length>0?r.tools=e.tools.map(m=>oe[m]):r.tools=[]:e.tools&&(r.tools=e.tools.map(m=>oe[m])),r.enableSoul=e.disableSoul!==!0,{options:r,cliThinkingFromModel:d}}f(ie,"buildSessionOptions");async function ao(e,s){if(e[0]!=="config")return!1;const o=process.cwd(),t=s.path,c=F.create(o,s);U(c,"config command");const r=await new Z({cwd:o,agentDir:t,settingsManager:c}).resolve();await ye({resolvedPaths:r,settingsManager:c,cwd:o,agentDir:t}),process.exit(0)}f(ao,"handleConfigCommand");async function lo(e){if(e[0]!=="migrate")return!1;const s={dryRun:!e.includes("--apply"),apply:e.includes("--apply"),copy:!e.includes("--move")};return await new X().run(s),!0}f(lo,"handleMigrateCommand");async function Ho(e){y("main_entry");const s=new X;if(s.isMigrationNeeded()){console.log(a.blue(`
+\u{1F680} Initializing Catui ecosystem...`));const l=s.runSilent();l.length>0&&(console.log(a.green(`\u2705 Successfully migrated legacy data: ${l.join(", ")}`)),console.log(a.dim(`New home: ${N(he(),".catui/")}
+`)))}const o=Q(e),t=Ee(o.agent),c=t.path;Ie(t);const i=e.includes("--offline")||Je(process.env.CATUI_OFFLINE);if(i&&(process.env.CATUI_OFFLINE="1",process.env.CATUI_SKIP_VERSION_CHECK="1"),await lo(e)||await to(e,t)||await ao(e,t))return;const r=H(o.cwd),{migratedAuthProviders:d,deprecationWarnings:m}=Oe(r,t);y("after_migrations"),y("before_settings_manager");const g=F.create(r,t);y("settings_manager_ready"),y("auth_storage_created","settings_manager_ready"),U(g,"startup");const h=Se.create(t);x&&(je(c),process.env.NANOMEM_MEMORY_DIR||(process.env.NANOMEM_MEMORY_DIR=N(c,"memory"))),y("catui_defaults_ensured","auth_storage_created");const p=new $e(h,N(c,"models.json"),x?{useOnlyCustomModels:!0,allowOptionalApiKeyForProvider:[Ge,qe,He,Ye,ze,Ke,Ve,Qe,Xe,"openrouter",Fe,Ue]}:{});y("model_registry_created");const I=x?Be():[];y("before_resource_loader_create");const _=new J({cwd:r,agentDir:c,settingsManager:g,additionalExtensionPaths:[...I,...o.extensions??[]],additionalSkillPaths:o.skills,additionalPromptTemplatePaths:o.promptTemplates,additionalThemePaths:o.themes,noExtensions:o.noExtensions,noSkills:o.noSkills,noPromptTemplates:o.noPromptTemplates,noThemes:o.noThemes,systemPrompt:o.systemPrompt,appendSystemPrompt:o.appendSystemPrompt});await _.reload(),Re("resourceLoader.reload"),y("resource_loader_reload","settings_manager_ready");const C=_.getExtensions();y("extensions_loaded","resource_loader_reload");for(const{path:l,error:u}of C.errors)console.error(a.red(`Failed to load extension "${l}": ${u}`));if(x){const l=C.extensions.some(w=>w.path.includes("nano-mem")),u=C.errors.some(w=>w.path.includes("nano-mem"));if(re){if(!l&&(I.length===0||u))console.error(a.dim(`NanoMem (persistent memory) not loaded. Reinstall: npm install -g ${Me}`));else if(l){const w=C.extensions.find(E=>E.path.includes("nano-mem"));console.error(a.dim(`NanoMem extension loaded: ${w?.path??"nano-mem"}`))}}}for(const{name:l,config:u}of C.runtime.pendingProviderRegistrations)p.registerProvider(l,u);C.runtime.pendingProviderRegistrations=[],x&&await We(h,p),p.refreshWithDiscovery().catch(()=>{});const A=new Map;for(const l of C.extensions)for(const[u,w]of l.flags)A.set(u,{type:w.type});y("before_args_parse_2");const n=Q(e,A);y("args_parsed_2");const O=H(n.cwd);y("cwd_resolved","args_parsed_2");for(const[l,u]of n.unknownFlags)C.runtime.flagValues.set(l,u);if(n.version&&(console.log(Ce),process.exit(0)),n.help&&(Pe(),process.exit(0)),n.listModels!==void 0){const l=typeof n.listModels=="string"?n.listModels:void 0;await _e(p,l,{refresh:n.refreshModels}),process.exit(0)}if(n.mode!=="rpc"&&!n.acp){const l=await Ze();l!==void 0&&(n.print=!0,n.messages.unshift(l))}if(n.export){let l;try{const u=n.messages.length>0?n.messages[0]:void 0;l=await Ne(n.export,u)}catch(u){const w=u instanceof Error?u.message:"Failed to export session";console.error(a.red(`Error: ${w}`)),process.exit(1)}console.log(`Exported to: ${l}`),process.exit(0)}n.mode==="rpc"&&n.fileArgs.length>0&&(console.error(a.red("Error: @file arguments are not supported in RPC mode")),process.exit(1));const{initialMessage:D,initialImages:G}=await no(n,g.getImageAutoResize()),L=!n.print&&n.mode===void 0,Y=n.mode||"text";x&&g.getTheme()===void 0&&g.setTheme("warm"),Le(g.getTheme()??(x?"warm":void 0),L),L&&m.length>0&&await De(m);let b=[];const $=n.models??g.getEnabledModels();$&&$.length>0&&(b=await B($,p));let q=await io(n,O,t);if(n.resume){Ae.create(t);const l=await ke(u=>k.list(O,n.sessionDir,u,t),u=>k.listAll(u,t));l||(console.log(a.dim("No session selected")),te(),process.exit(0)),q=k.open(l,void 0,t)}const{options:v,cliThinkingFromModel:ae}=ie(n,b,q,p,g,t);v.agentDir=c,v.enableMCP=x&&!i&&!n.noMcp,v.deferMcpInit=L&&!n.acp,v.cwd=O,v.authStorage=h,v.modelRegistry=p,v.resourceLoader=_,v.theme=be,n.apiKey&&(v.model||(console.error(a.red("--api-key requires a model to be specified via --model, --provider/--model, or --models")),process.exit(1)),h.setRuntimeApiKey(v.model.provider,n.apiKey)),y("before_create_agent_session");const{session:M,modelFallbackMessage:le}=await ee(v);y("agent_session_created"),!L&&!M.model&&(console.error(a.red("No models available.")),console.error(a.yellow(`
+Set an API key environment variable:`)),console.error("  ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, etc."),console.error(a.yellow(`
+Or create ${N(c,"models.json")}`)),process.exit(1));const ce=n.thinking!==void 0||ae;if(M.model&&ce){let l=M.thinkingLevel;M.model.reasoning?l==="xhigh"&&!pe(M.model)&&(l="high"):l="off",l!==M.thinkingLevel&&M.setThinkingLevel(l)}if(n.acp){const{runAcpMode:l}=await import("./modes/acp/acp-mode.js");await l(M,{createSessionForCwd:f(async w=>{const E=H(w),T=F.create(E,t);U(T,"acp startup");const W=new J({cwd:E,agentDir:c,settingsManager:T,agentCtx:t,additionalExtensionPaths:[...I,...n.extensions??[]],additionalSkillPaths:n.skills,additionalPromptTemplatePaths:n.promptTemplates,additionalThemePaths:n.themes,noExtensions:n.noExtensions,noSkills:n.noSkills,noPromptTemplates:n.noPromptTemplates,noThemes:n.noThemes,systemPrompt:n.systemPrompt,appendSystemPrompt:n.appendSystemPrompt});await W.reload();const j=W.getExtensions();for(const{path:V,error:K}of j.errors)console.error(a.red(`Failed to load extension "${V}": ${K}`));for(const{name:V,config:K}of j.runtime.pendingProviderRegistrations)p.registerProvider(V,K);j.runtime.pendingProviderRegistrations=[];let z=[];$&&$.length>0&&(z=await B($,p));const de=n.noSession?k.inMemory(E,t):k.create(E,n.sessionDir,t),{options:S}=ie(n,z,de,p,T,t);S.cwd=E,S.authStorage=h,S.modelRegistry=p,S.resourceLoader=W,S.settingsManager=T,S.enableMCP=v.enableMCP,S.enableSoul=v.enableSoul;const{session:me}=await ee(S);return me},"createAcpSessionForCwd")})}else if(Y==="rpc"){const{runRpcMode:l}=await import("./modes/rpc/rpc-mode.js");await l(M)}else if(L){if(b.length>0&&(n.verbose||!g.getQuietStartup())){const w=b.map(E=>{const T=E.thinkingLevel?`:${E.thinkingLevel}`:"";return`${E.model.id}${T}`}).join(", ");console.log(a.dim(`Model scope: ${w} ${a.gray("(Ctrl+P to cycle)")}`))}const{InteractiveMode:l}=await import("./modes/interactive/interactive-mode.js");await new l(M,{migratedProviders:d,modelFallbackMessage:le,initialMessage:D,initialImages:G,initialMessages:n.messages,verbose:n.verbose}).run()}else{const{runPrintMode:l}=await import("./modes/print-mode.js"),u=await l(M,{mode:Y,messages:n.messages,initialMessage:D,initialImages:G,printLoopResult:n.printLoopResult,failOnAgentError:n.failOnAgentError,failOnToolDenial:n.failOnToolDenial});te(),process.stdout.writableLength>0&&await new Promise(w=>process.stdout.once("drain",w)),process.exit(u.exitCode)}}f(Ho,"main");export{Ho as main};

package/dist/migrations.d.ts

@@ -0,0 +1,30 @@
+import { type AgentDirContext } from "./core/agent-dir/agent-dir-context.js";
+/**
+ * Migrate legacy oauth.json and settings.json apiKeys to auth.json.
+ *
+ * @returns Array of provider names that were migrated
+ */
+export declare function migrateAuthToAuthJson(agentDir?: string): string[];
+/**
+ * Migrate sessions from ~/.catui/agent/*.jsonl to proper session directories.
+ *
+ * Bug in v0.30.0: Sessions were saved to ~/.catui/agent/ instead of
+ * ~/.catui/agent/sessions/<encoded-cwd>/. This migration moves them
+ * to the correct location based on the cwd in their session header.
+ *
+ * See: https://github.com/O-Catui/Catui/issues/320
+ */
+export declare function migrateSessionsFromAgentRoot(agentDir?: string): void;
+/**
+ * Print deprecation warnings and wait for keypress.
+ */
+export declare function showDeprecationWarnings(warnings: string[]): Promise<void>;
+/**
+ * Run all migrations. Called once on startup.
+ *
+ * @returns Object with migration results and deprecation warnings
+ */
+export declare function runMigrations(cwd?: string, ctx?: AgentDirContext): {
+    migratedAuthProviders: string[];
+    deprecationWarnings: string[];
+};

package/dist/migrations.js

@@ -0,0 +1,4 @@
+var k=Object.defineProperty;var f=(e,t)=>k(e,"name",{value:t,configurable:!0});import m from"chalk";import{existsSync as a,mkdirSync as h,readdirSync as x,readFileSync as y,renameSync as d,rmSync as C,writeFileSync as b}from"fs";import{dirname as P,join as i}from"path";import{CONFIG_DIR_NAME as j,getAgentDir as g}from"./config.js";import{defaultAgentDirContext as N}from"./core/agent-dir/agent-dir-context.js";const v="https://github.com/O-Catui/Catui/blob/main/packages/coding-agent/CHANGELOG.md#extensions-migration",A="https://github.com/O-Catui/Catui/blob/main/packages/coding-agent/docs/extensions.md";function D(e=g()){const t=i(e,"auth.json"),o=i(e,"oauth.json"),s=i(e,"settings.json");if(a(t))return[];const n={},l=[];if(a(o))try{const u=JSON.parse(y(o,"utf-8"));for(const[r,c]of Object.entries(u))n[r]={type:"oauth",...c},l.push(r);d(o,`${o}.migrated`)}catch{}if(a(s))try{const u=y(s,"utf-8"),r=JSON.parse(u);if(r.apiKeys&&typeof r.apiKeys=="object"){for(const[c,p]of Object.entries(r.apiKeys))!n[c]&&typeof p=="string"&&(n[c]={type:"api_key",key:p},l.push(c));delete r.apiKeys,b(s,JSON.stringify(r,null,2))}}catch{}return Object.keys(n).length>0&&(h(P(t),{recursive:!0}),b(t,JSON.stringify(n,null,2),{mode:384})),l}f(D,"migrateAuthToAuthJson");function $(e=g()){let t;try{t=x(e).filter(o=>o.endsWith(".jsonl")).map(o=>i(e,o))}catch{return}if(t.length!==0)for(const o of t)try{const n=y(o,"utf8").split(`
+`)[0];if(!n?.trim())continue;const l=JSON.parse(n);if(l.type!=="session"||!l.cwd)continue;const r=`--${l.cwd.replace(/^[/\\]/,"").replace(/[/\\:]/g,"-")}--`,c=i(e,"sessions",r);a(c)||h(c,{recursive:!0});const p=o.split("/").pop()||o.split("\\").pop(),w=i(c,p);if(a(w))continue;d(o,w)}catch(s){console.warn("Warning: Could not migrate session file:",o,s instanceof Error?s.message:s)}}f($,"migrateSessionsFromAgentRoot");function S(e,t){const o=i(e,"commands"),s=i(e,"prompts");if(a(o)&&!a(s))try{return d(o,s),console.log(m.green(`Migrated ${t} commands/ \u2192 prompts/`)),!0}catch(n){console.log(m.yellow(`Warning: Could not migrate ${t} commands/ to prompts/: ${n instanceof Error?n.message:n}`))}return!1}f(S,"migrateCommandsToPrompts");function E(e=g()){const t=i(e,"tools"),o=i(e,"bin");if(!a(t))return;const s=["fd","rg","fd.exe","rg.exe"];let n=!1;for(const l of s){const u=i(t,l),r=i(o,l);if(a(u))if(a(o)||h(o,{recursive:!0}),a(r))try{C?.(u,{force:!0})}catch{}else try{d(u,r),n=!0}catch{}}n&&console.log(m.green("Migrated managed binaries tools/ \u2192 bin/"))}f(E,"migrateToolsToBin");function O(e,t){const o=i(e,"hooks"),s=i(e,"tools"),n=[];if(a(o)&&n.push(`${t} hooks/ directory found. Hooks have been renamed to extensions.`),a(s))try{x(s).filter(r=>{const c=r.toLowerCase();return c!=="fd"&&c!=="rg"&&c!=="fd.exe"&&c!=="rg.exe"&&!r.startsWith(".")}).length>0&&n.push(`${t} tools/ directory contains custom tools. Custom tools have been merged into extensions.`)}catch{}return n}f(O,"checkDeprecatedExtensionDirs");function M(e,t=g()){const o=i(e,j);return S(t,"Global"),S(o,"Project"),[...O(t,"Global"),...O(o,"Project")]}f(M,"migrateExtensionSystem");async function J(e){if(e.length!==0){for(const t of e)console.log(m.yellow(`Warning: ${t}`));console.log(m.yellow(`
+Move your extensions to the extensions/ directory.`)),console.log(m.yellow(`Migration guide: ${v}`)),console.log(m.yellow(`Documentation: ${A}`)),console.log(m.dim(`
+Press any key to continue...`)),await new Promise(t=>{process.stdin.setRawMode?.(!0),process.stdin.resume(),process.stdin.once("data",()=>{process.stdin.setRawMode?.(!1),process.stdin.pause(),t()})}),console.log()}}f(J,"showDeprecationWarnings");function L(e=process.cwd(),t=N()){const o=t.path,s=D(o);$(o),E(o);const n=M(e,o);return{migratedAuthProviders:s,deprecationWarnings:n}}f(L,"runMigrations");export{D as migrateAuthToAuthJson,$ as migrateSessionsFromAgentRoot,L as runMigrations,J as showDeprecationWarnings};

package/dist/models.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Public models subpath exports for model registry APIs
+ * [FROM]: Re-exports core/model-registry.js
+ * [TO]: Consumed by advanced SDK users importing @catui/agent/models
+ * [HERE]: models.ts - package subpath entry for model APIs
+ */
+export { ModelRegistry } from "./core/model-registry.js";

package/dist/models.js

@@ -0,0 +1 @@
+import{ModelRegistry as r}from"./core/model-registry.js";export{r as ModelRegistry};

package/dist/modes/acp/acp-mode.d.ts

@@ -0,0 +1,30 @@
+import type { AgentRunResult } from "@catui/agent-core";
+import type { AvailableCommand } from "@agentclientprotocol/sdk";
+import type { AgentSession } from "../../core/runtime/agent-session.js";
+interface AcpModeOptions {
+    createSessionForCwd?: (cwd: string) => Promise<AgentSession>;
+}
+type AcpSlashCommandDescriptor = {
+    name: string;
+    description?: string | null;
+};
+declare function normalizeAcpCommandName(name: string): string;
+declare function isAdvertisableAcpCommand(name: string): boolean;
+declare function createAvailableCommandInput(name: string): AvailableCommand["input"] | undefined;
+declare function buildAcpAvailableCommands(commands: ReadonlyArray<AcpSlashCommandDescriptor>): AvailableCommand[];
+declare function deferAcpNotification(task: () => Promise<void> | void): void;
+declare function formatAcpLoopResultLines(result: AgentRunResult | undefined): string[];
+/**
+ * Run in ACP mode.
+ * Listens for JSON-RPC 2.0 messages on stdin, outputs JSON-RPC responses/events on stdout.
+ */
+export declare function runAcpMode(session: AgentSession, options?: AcpModeOptions): Promise<never>;
+export declare const __testUtils: {
+    buildAcpAvailableCommands: typeof buildAcpAvailableCommands;
+    createAvailableCommandInput: typeof createAvailableCommandInput;
+    deferAcpNotification: typeof deferAcpNotification;
+    formatAcpLoopResultLines: typeof formatAcpLoopResultLines;
+    isAdvertisableAcpCommand: typeof isAdvertisableAcpCommand;
+    normalizeAcpCommandName: typeof normalizeAcpCommandName;
+};
+export {};