catui-agent 1.0.0-beta.0

package/dist/cli/args.d.ts

@@ -0,0 +1,70 @@
+/**
+ * [WHO]: Args, Mode, parseArgs(), printHelp()
+ * [FROM]: Depends on agent-core, chalk, config.ts, core/tools
+ * [TO]: Consumed by main.ts, core/model-resolver.ts
+ * [HERE]: cli/args.ts - CLI argument parsing and help display
+ */
+import { type AgentLoopFrameworkInput, type AgentLoopPolicyOptions, type ThinkingLevel } from "@catui/agent-core";
+import { type ToolName } from "../core/tools/index.js";
+export type Mode = "text" | "json" | "rpc";
+export interface Args {
+    cwd?: string;
+    provider?: string;
+    model?: string;
+    apiKey?: string;
+    systemPrompt?: string;
+    appendSystemPrompt?: string;
+    thinking?: ThinkingLevel;
+    continue?: boolean;
+    resume?: boolean;
+    help?: boolean;
+    version?: boolean;
+    mode?: Mode;
+    noSession?: boolean;
+    session?: string;
+    sessionDir?: string;
+    models?: string[];
+    tools?: ToolName[];
+    noTools?: boolean;
+    extensions?: string[];
+    noExtensions?: boolean;
+    print?: boolean;
+    /** In text print mode, emit the final agent loop result as stderr JSON. */
+    printLoopResult?: boolean;
+    /** In print mode, exit non-zero when the final agent result is an error. */
+    failOnAgentError?: boolean;
+    /** In print mode, exit non-zero when any tool permission denial occurred. */
+    failOnToolDenial?: boolean;
+    /** Non-persistent agent loop framework override for this process/session. */
+    agentLoopFramework?: AgentLoopFrameworkInput;
+    /** Non-persistent loop policy overrides for this process/session. */
+    loopPolicy?: Pick<AgentLoopPolicyOptions, "maxTurnsPerPrompt" | "maxToolCallsPerPrompt" | "maxToolConcurrency" | "maxToolResultBatchSizeChars" | "outputTokenBudget" | "maxOutputTokenRecoveryAttempts" | "maxModelErrorRecoveryAttempts" | "maxStopHookContinuations">;
+    export?: string;
+    noSkills?: boolean;
+    skills?: string[];
+    promptTemplates?: string[];
+    noPromptTemplates?: boolean;
+    themes?: string[];
+    noThemes?: boolean;
+    listModels?: string | true;
+    refreshModels?: boolean;
+    offline?: boolean;
+    /** Disable MCP (Model Context Protocol). Default: false (MCP enabled) */
+    noMcp?: boolean;
+    verbose?: boolean;
+    /** Disable Soul (AI personality evolution). Default: false (Soul enabled) */
+    disableSoul?: boolean;
+    /** Enable ACP (Agent Client Protocol) mode for editor integration */
+    acp?: boolean;
+    /** Multi-Agent: ID of the agent to use. Default: "default" */
+    agent?: string;
+    messages: string[];
+    fileArgs: string[];
+    /** Unknown flags (potentially extension flags) - map of flag name to value */
+    unknownFlags: Map<string, boolean | string>;
+}
+export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
+export declare function parseArgs(args: string[], extensionFlags?: Map<string, {
+    type: "boolean" | "string";
+}>): Args;
+export declare function printHelp(): void;

package/dist/cli/args.js

@@ -0,0 +1,158 @@
+var v=Object.defineProperty;var p=(e,l)=>v(e,"name",{value:l,configurable:!0});import{normalizeAgentLoopFramework as k}from"@catui/agent-core";import r from"chalk";import{APP_NAME as s,CONFIG_DIR_NAME as h,ENV_AGENT_DIR as g}from"../config.js";import{allTools as A}from"../core/tools/index.js";const I=["off","minimal","low","medium","high","xhigh"];function y(e){return I.includes(e)}p(y,"isValidThinkingLevel");function x(e){const l=k(e);if(l==="standard"||l==="weak-model-compatible")return l}p(x,"parseAgentLoopFramework");function c(e,l){const o=Number(l);if(Number.isInteger(o)&&o>0)return o;console.error(r.yellow(`Warning: Invalid ${e} value "${l}". Expected a positive integer.`))}p(c,"parsePositiveIntegerOption");function f(e,l){const o=Number(l);if(Number.isInteger(o)&&o>=0)return o;console.error(r.yellow(`Warning: Invalid ${e} value "${l}". Expected a non-negative integer.`))}p(f,"parseNonNegativeIntegerOption");function b(e,l){const o=Number(l);if(Number.isFinite(o)&&o>0&&o<=1)return o;console.error(r.yellow(`Warning: Invalid ${e} value "${l}". Expected a number in (0, 1].`))}p(b,"parseUnitIntervalOption");function d(e,l,o){e.loopPolicy=e.loopPolicy??{},e.loopPolicy[l]=o}p(d,"setLoopPolicyOption");function T(e,l){const o={messages:[],fileArgs:[],unknownFlags:new Map},m={};for(let n=0;n<e.length;n++){const t=e[n];if(t==="--help"||t==="-h")o.help=!0;else if(t==="--version"||t==="-v")o.version=!0;else if(t==="--mode"&&n+1<e.length){const i=e[++n];(i==="text"||i==="json"||i==="rpc")&&(o.mode=i)}else if(t==="--continue"||t==="-c")o.continue=!0;else if(t==="--resume"||t==="-r")o.resume=!0;else if(t==="--provider"&&n+1<e.length)o.provider=e[++n];else if(t==="--cwd"&&n+1<e.length)o.cwd=e[++n];else if(t==="--model"&&n+1<e.length)o.model=e[++n];else if(t==="--api-key"&&n+1<e.length)o.apiKey=e[++n];else if(t==="--system-prompt"&&n+1<e.length)o.systemPrompt=e[++n];else if(t==="--append-system-prompt"&&n+1<e.length)o.appendSystemPrompt=e[++n];else if(t==="--no-session")o.noSession=!0;else if(t==="--session"&&n+1<e.length)o.session=e[++n];else if(t==="--session-dir"&&n+1<e.length)o.sessionDir=e[++n];else if(t==="--models"&&n+1<e.length)o.models=e[++n].split(",").map(i=>i.trim());else if(t==="--no-tools")o.noTools=!0;else if(t==="--tools"&&n+1<e.length){const i=e[++n].split(",").map(u=>u.trim()),a=[];for(const u of i)u in A?a.push(u):console.error(r.yellow(`Warning: Unknown tool "${u}". Valid tools: ${Object.keys(A).join(", ")}`));o.tools=a}else if(t==="--thinking"&&n+1<e.length){const i=e[++n];y(i)?o.thinking=i:console.error(r.yellow(`Warning: Invalid thinking level "${i}". Valid values: ${I.join(", ")}`))}else if(t==="--print"||t==="-p")o.print=!0;else if(t==="--print-loop-result")o.printLoopResult=!0;else if(t==="--fail-on-agent-error")o.failOnAgentError=!0;else if(t==="--fail-on-tool-denial")o.failOnToolDenial=!0;else if(t==="--agent-loop"&&n+1<e.length){const i=e[++n],a=x(i);a?o.agentLoopFramework=a:console.error(r.yellow(`Warning: Invalid agent loop framework "${i}". Valid values: standard, weak-model-compatible.`))}else if(t==="--max-turns-per-prompt"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxTurnsPerPrompt",i)}else if(t==="--max-tool-calls-per-prompt"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxToolCallsPerPrompt",i)}else if(t==="--max-tool-concurrency"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxToolConcurrency",i)}else if(t==="--max-tool-result-batch-size-chars"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&d(o,"maxToolResultBatchSizeChars",i)}else if(t==="--output-token-budget"&&n+1<e.length){const i=c(t,e[++n]);i!==void 0&&(m.targetTokens=i)}else if(t==="--output-token-budget-threshold"&&n+1<e.length){const i=b(t,e[++n]);i!==void 0&&(m.thresholdPct=i)}else if(t==="--output-token-budget-continuations"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&(m.maxContinuations=i)}else if(t==="--max-output-token-recovery-attempts"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&d(o,"maxOutputTokenRecoveryAttempts",i)}else if(t==="--max-model-error-recovery-attempts"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&d(o,"maxModelErrorRecoveryAttempts",i)}else if(t==="--max-stop-hook-continuations"&&n+1<e.length){const i=f(t,e[++n]);i!==void 0&&d(o,"maxStopHookContinuations",i)}else if(t==="--export"&&n+1<e.length)o.export=e[++n];else if((t==="--extension"||t==="-e")&&n+1<e.length)o.extensions=o.extensions??[],o.extensions.push(e[++n]);else if(t==="--no-extensions"||t==="-ne")o.noExtensions=!0;else if(t==="--skill"&&n+1<e.length)o.skills=o.skills??[],o.skills.push(e[++n]);else if(t==="--prompt-template"&&n+1<e.length)o.promptTemplates=o.promptTemplates??[],o.promptTemplates.push(e[++n]);else if(t==="--theme"&&n+1<e.length)o.themes=o.themes??[],o.themes.push(e[++n]);else if(t==="--no-skills"||t==="-ns")o.noSkills=!0;else if(t==="--no-prompt-templates"||t==="-np")o.noPromptTemplates=!0;else if(t==="--no-themes")o.noThemes=!0;else if(t==="--list-models")n+1<e.length&&!e[n+1].startsWith("-")&&!e[n+1].startsWith("@")?o.listModels=e[++n]:o.listModels=!0;else if(t==="--refresh-models")o.refreshModels=!0;else if(t==="--verbose")o.verbose=!0;else if(t==="--offline")o.offline=!0;else if(t==="--disable-soul")o.disableSoul=!0;else if(t==="--no-mcp")o.noMcp=!0;else if(t==="--acp")o.acp=!0;else if(t==="--agent"&&n+1<e.length)o.agent=e[++n];else if(t.startsWith("@"))o.fileArgs.push(t.slice(1));else if(t.startsWith("--")&&l){const i=t.slice(2),a=l.get(i);a&&(a.type==="boolean"?o.unknownFlags.set(i,!0):a.type==="string"&&n+1<e.length&&o.unknownFlags.set(i,e[++n]))}else t.startsWith("-")||o.messages.push(t)}return m.targetTokens!==void 0&&d(o,"outputTokenBudget",{targetTokens:m.targetTokens,thresholdPct:m.thresholdPct,maxContinuations:m.maxContinuations}),o}p(T,"parseArgs");function S(){console.log(`${r.bold(s)} - AI coding assistant with read, bash, edit, write tools
+
+${r.bold("Usage:")}
+  ${s} [options] [@files...] [messages...]
+
+${r.bold("Commands:")}
+  ${s} install <source> [-l]    Install extension source and add to settings
+  ${s} remove <source> [-l]     Remove extension source from settings
+  ${s} update [source]          Update installed extensions (skips pinned sources)
+  ${s} list                     List installed extensions from settings
+  ${s} config                   Open TUI to enable/disable package resources
+  ${s} migrate                  Migrate data from legacy ~/.catui/~/.catui to ~/.catui
+  ${s} <command> --help         Show help for commands
+
+${r.bold("Options:")}
+  --provider <name>              Provider name (default: google)
+  --cwd <dir>                    Working directory to use for project-local discovery
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --api-key <key>                API key (defaults to env vars)
+  --system-prompt <text>         System prompt (default: coding assistant prompt)
+  --append-system-prompt <text>  Append text or file contents to the system prompt
+  --mode <mode>                  Output mode: text (default), json, or rpc
+  --print, -p                    Non-interactive mode: process prompt and exit
+  --print-loop-result            In text print mode, write final loop result JSON to stderr
+  --fail-on-agent-error          In print mode, exit non-zero when final loop result is an error
+  --fail-on-tool-denial          In print mode, exit non-zero when tools were denied
+  --agent-loop <framework>       Override loop framework: standard or weak-model-compatible
+  --max-turns-per-prompt <n>     Stop a prompt after n assistant turns
+  --max-tool-calls-per-prompt <n> Stop a prompt after n tool calls
+  --max-tool-concurrency <n>     Max concurrent safe tool calls in compatible loop
+  --max-tool-result-batch-size-chars <n> Max aggregate tool result chars per turn
+  --output-token-budget <n>      Continue when final output is below n tokens
+  --output-token-budget-threshold <n> Continuation threshold ratio in (0,1], default loop policy
+  --output-token-budget-continuations <n> Max output-budget continuations
+  --max-output-token-recovery-attempts <n> Max recovery turns after output-token stops
+  --max-model-error-recovery-attempts <n> Max in-loop model error recoveries
+  --max-stop-hook-continuations <n> Max stop-hook validation continuations
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path>               Use specific session file
+  --session-dir <dir>            Directory for session storage and lookup
+  --no-session                   Don't save session (ephemeral)
+  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
+                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
+  --no-tools                     Disable all built-in tools
+  --tools <tools>                Comma-separated list of tools to enable (default: read,bash,edit,write)
+                                 Available: read, bash, edit, write, grep, find, ls
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh
+  --extension, -e <path>         Load an extension file (can be used multiple times)
+  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)
+  --skill <path>                 Load a skill file or directory (can be used multiple times)
+  --no-skills, -ns               Disable skills discovery and loading
+  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
+  --no-prompt-templates, -np     Disable prompt template discovery and loading
+  --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --no-themes                    Disable theme discovery and loading
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models (with optional fuzzy search)
+  --refresh-models               Refresh remote model lists via discovery (use with --list-models)
+  --verbose                      Force verbose startup (overrides quietStartup setting)
+  --offline                      Disable startup network operations (same as CATUI_OFFLINE=1)
+  --disable-soul                 Disable Soul (AI personality evolution)
+  --no-mcp                       Disable MCP (Model Context Protocol) tools
+  --acp                         Run as ACP Agent (for editor integration)
+  --agent <id>                   Multi-Agent: Select a specific agent by ID (default: "default")
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Extensions can register additional flags (e.g., --plan from plan-mode extension).
+
+${r.bold("Examples:")}
+  # Interactive mode
+  ${s}
+
+  # Interactive mode with initial prompt
+  ${s} "List all .ts files in src/"
+
+  # Include files in initial message
+  ${s} @prompt.md @image.png "What color is the sky?"
+
+  # Non-interactive mode (process and exit)
+  ${s} -p "List all .ts files in src/"
+
+  # Multiple messages (interactive)
+  ${s} "Read package.json" "What dependencies do we have?"
+
+  # Continue previous session
+  ${s} --continue "What did we discuss?"
+
+  # Use different model
+  ${s} --provider openai --model gpt-4o-mini "Help me refactor this code"
+
+  # Use model with provider prefix (no --provider needed)
+  ${s} --model openai/gpt-4o "Help me refactor this code"
+
+  # Use model with thinking level shorthand
+  ${s} --model sonnet:high "Solve this complex problem"
+
+  # Limit model cycling to specific models
+  ${s} --models claude-sonnet,claude-haiku,gpt-4o
+
+  # Limit to a specific provider with glob pattern
+  ${s} --models "github-copilot/*"
+
+  # Cycle models with fixed thinking levels
+  ${s} --models sonnet:high,haiku:low
+
+  # Start with a specific thinking level
+  ${s} --thinking high "Solve this complex problem"
+
+  # Read-only mode (no file modifications possible)
+  ${s} --tools read,grep,find,ls -p "Review the code in src/"
+
+  # Export a session file to HTML
+  ${s} --export ~/${h}/agent/sessions/--path--/session.jsonl
+  ${s} --export session.jsonl output.html
+
+${r.bold("Environment Variables:")}
+  ANTHROPIC_API_KEY                - Anthropic Claude API key
+  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
+  OPENAI_API_KEY                   - OpenAI GPT API key
+  AZURE_OPENAI_API_KEY             - Azure OpenAI API key
+  AZURE_OPENAI_BASE_URL            - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)
+  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
+  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)
+  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
+  GEMINI_API_KEY                   - Google Gemini API key
+  GROQ_API_KEY                     - Groq API key
+  CEREBRAS_API_KEY                 - Cerebras API key
+  XAI_API_KEY                      - xAI Grok API key
+  OPENROUTER_API_KEY               - OpenRouter API key
+  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key
+  ZAI_API_KEY                      - ZAI API key
+  MISTRAL_API_KEY                  - Mistral API key
+  MINIMAX_API_KEY                  - MiniMax API key
+  KIMI_API_KEY                     - Kimi For Coding API key
+  AWS_PROFILE                      - AWS profile for Amazon Bedrock
+  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
+  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
+  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
+  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
+  ${`${s.toUpperCase()}_CWD`.padEnd(32)} - Working directory override for project-local discovery
+  ${g.padEnd(32)} - Session storage directory (default: ~/${h}/agent)
+  CATUI_PACKAGE_DIR                   - Override package directory (for Nix/Guix store paths)
+  CATUI_OFFLINE                       - Disable startup network operations when set to 1/true/yes
+  CATUI_TOOLS_DOWNLOAD_TIMEOUT_MS     - Timeout in ms for downloading fd/ripgrep (default: 60000)
+  CATUI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://catui.dev/session/)
+  CATUI_AI_ANTIGRAVITY_VERSION        - Override Antigravity User-Agent version (e.g., 1.23.0)
+
+${r.bold("Available Tools (default: read, bash, edit, write):")}
+  read   - Read file contents
+  bash   - Execute bash commands
+  edit   - Edit files with find/replace
+  write  - Write files (creates/overwrites)
+  grep   - Search file contents (read-only, off by default)
+  find   - Find files by glob pattern (read-only, off by default)
+  ls     - List directory contents (read-only, off by default)
+`)}p(S,"printHelp");export{y as isValidThinkingLevel,T as parseArgs,S as printHelp};

package/dist/cli/config-selector.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedPaths } from "../core/package-manager.js";
+import type { SettingsManager } from "../core/platform/config/settings-manager.js";
+export interface ConfigSelectorOptions {
+    resolvedPaths: ResolvedPaths;
+    settingsManager: SettingsManager;
+    cwd: string;
+    agentDir: string;
+}
+/** Show TUI config selector and return when closed */
+export declare function selectConfig(options: ConfigSelectorOptions): Promise<void>;

package/dist/cli/config-selector.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var o=(e,r)=>c(e,"name",{value:r,configurable:!0});import{ProcessTerminal as a,TUI as m}from"@catui/tui";import{ConfigSelectorComponent as g}from"../modes/interactive/components/config-selector.js";import{initTheme as l,stopThemeWatcher as i}from"../modes/interactive/theme/theme.js";async function p(e){return l(e.settingsManager.getTheme(),!0),new Promise(r=>{const t=new m(new a);let s=!1;const n=new g(e.resolvedPaths,e.settingsManager,e.cwd,e.agentDir,()=>{s||(s=!0,t.stop(),i(),r())},()=>{t.stop(),i(),process.exit(0)},()=>t.requestRender());t.addChild(n),t.setFocus(n.getResourceList()),t.start()})}o(p,"selectConfig");export{p as selectConfig};

package/dist/cli/file-processor.d.ts

@@ -0,0 +1,11 @@
+import type { ImageContent } from "@catui/ai/types";
+export interface ProcessedFiles {
+    text: string;
+    images: ImageContent[];
+}
+export interface ProcessFileOptions {
+    /** Whether to auto-resize images to 2000x2000 max. Default: true */
+    autoResizeImages?: boolean;
+}
+/** Process @file arguments into text content and image attachments */
+export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;

package/dist/cli/file-processor.js

@@ -0,0 +1,6 @@
+var y=Object.defineProperty;var l=(a,s)=>y(a,"name",{value:s,configurable:!0});import{access as $,readFile as p,stat as h}from"node:fs/promises";import d from"chalk";import{resolve as w}from"path";import{resolveReadPath as z}from"../core/tools/path-utils.js";import{formatDimensionNote as F,resizeImage as x}from"../modes/utils/image-resize.js";import{detectSupportedImageMimeTypeFromFile as I}from"../utils/mime.js";async function N(a,s){const g=s?.autoResizeImages??!0;let o="";const f=[];for(const u of a){const e=w(z(u,process.cwd()));try{await $(e)}catch{console.error(d.red(`Error: File not found: ${e}`)),process.exit(1)}if((await h(e)).size===0)continue;const i=await I(e);if(i){const r=(await p(e)).toString("base64");let n,m;if(g){const c=await x({type:"image",data:r,mimeType:i});m=F(c),n={type:"image",mimeType:c.mimeType,data:c.data}}else n={type:"image",mimeType:i,data:r};f.push(n),m?o+=`<file name="${e}">${m}</file>
+`:o+=`<file name="${e}"></file>
+`}else try{const t=await p(e,"utf-8");o+=`<file name="${e}">
+${t}
+</file>
+`}catch(t){const r=t instanceof Error?t.message:String(t);console.error(d.red(`Error: Could not read file ${e}: ${r}`)),process.exit(1)}}return{text:o,images:f}}l(N,"processFileArguments");export{N as processFileArguments};

package/dist/cli/list-models.d.ts

@@ -0,0 +1,12 @@
+import type { ModelRegistry } from "../core/model-registry.js";
+/**
+ * List available models, optionally filtered by search pattern.
+ *
+ * @param modelRegistry  Model registry to query
+ * @param searchPattern  Optional fuzzy filter pattern
+ * @param options        Optional flags:
+ *   - `refresh`: run discovery before listing (fetches remote /models endpoints)
+ */
+export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string, options?: {
+    refresh?: boolean;
+}): Promise<void>;

package/dist/cli/list-models.js

@@ -0,0 +1,2 @@
+var c=Object.defineProperty;var m=(i,n)=>c(i,"name",{value:n,configurable:!0});import{fuzzyFilter as x}from"@catui/tui";function g(i){if(i>=1e6){const n=i/1e6;return n%1===0?`${n}M`:`${n.toFixed(1)}M`}if(i>=1e3){const n=i/1e3;return n%1===0?`${n}K`:`${n.toFixed(1)}K`}return i.toString()}m(g,"formatTokenCount");async function f(i,n,p){if(p?.refresh){const e=await i.refreshWithDiscovery();e.discovered>0&&console.log(`Discovered ${e.discovered} remote model(s).
+`)}const l=i.getAll();if(l.length===0){console.log("No models available. Set API keys in environment variables.");return}let r=l;if(n&&(r=x(l,n,e=>`${e.provider} ${e.id}`)),r.length===0){console.log(`No models matching "${n}"`);return}r.sort((e,a)=>{const s=e.provider.localeCompare(a.provider);return s!==0?s:e.id.localeCompare(a.id)});const d=r.map(e=>({provider:e.provider,model:e.id,context:g(e.contextWindow),maxOut:g(e.maxTokens),thinking:e.reasoning?"yes":"no",images:e.input.includes("image")?"yes":"no"})),o={provider:"provider",model:"model",context:"context",maxOut:"max-out",thinking:"thinking",images:"images"},t={provider:Math.max(o.provider.length,...d.map(e=>e.provider.length)),model:Math.max(o.model.length,...d.map(e=>e.model.length)),context:Math.max(o.context.length,...d.map(e=>e.context.length)),maxOut:Math.max(o.maxOut.length,...d.map(e=>e.maxOut.length)),thinking:Math.max(o.thinking.length,...d.map(e=>e.thinking.length)),images:Math.max(o.images.length,...d.map(e=>e.images.length))},h=[o.provider.padEnd(t.provider),o.model.padEnd(t.model),o.context.padEnd(t.context),o.maxOut.padEnd(t.maxOut),o.thinking.padEnd(t.thinking),o.images.padEnd(t.images)].join("  ");console.log(h);for(const e of d){const a=[e.provider.padEnd(t.provider),e.model.padEnd(t.model),e.context.padEnd(t.context),e.maxOut.padEnd(t.maxOut),e.thinking.padEnd(t.thinking),e.images.padEnd(t.images)].join("  ");console.log(a)}}m(f,"listModels");export{f as listModels};

package/dist/cli/session-picker.d.ts

@@ -0,0 +1,5 @@
+import type { SessionInfo, SessionListProgress } from "../core/session/session-manager.js";
+type SessionsLoader = (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
+/** Show TUI session selector and return selected session path or null if cancelled */
+export declare function selectSession(currentSessionsLoader: SessionsLoader, allSessionsLoader: SessionsLoader): Promise<string | null>;
+export {};

package/dist/cli/session-picker.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var i=(t,n)=>l(t,"name",{value:n,configurable:!0});import{ProcessTerminal as m,TUI as p}from"@catui/tui";import{KeybindingsManager as f}from"../core/platform/keybindings.js";import{SessionSelectorComponent as u}from"../modes/interactive/components/session-selector.js";async function y(t,n){return new Promise(o=>{const e=new p(new m),c=f.create();let s=!1;const r=new u(t,n,a=>{s||(s=!0,e.stop(),o(a))},()=>{s||(s=!0,e.stop(),o(null))},()=>{e.stop(),process.exit(0)},()=>e.requestRender(),{showRenameHint:!1,keybindings:c});e.addChild(r),e.setFocus(r.getSessionList()),e.start()})}i(y,"selectSession");export{y as selectSession};

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+process.title="catui";import{readFile as c}from"node:fs/promises";import{fileURLToPath as a}from"node:url";import{dirname as l,join as s}from"node:path";const o=process.argv.slice(2);if(o.includes("--version")){const i=a(import.meta.url),e=l(i),n=e.endsWith("dist")?s(e,"..","package.json"):s(e,"package.json"),t=JSON.parse(await c(n,"utf-8"));console.log(t.version),process.exit(0)}(o.includes("--help")||o.includes("-h"))&&(console.log("Catui AI coding agent"),console.log("Usage: catui [options]"),console.log("       catui [command] [options]"),console.log("Options:"),console.log("  --version    Show version"),console.log("  --help, -h   Show this help"),process.exit(0));const{main:r}=await import("./main.js");r(o);

package/dist/config.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Detect if we're running as a Bun compiled binary.
+ * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
+ */
+export declare const isBunBinary: boolean;
+/** Detect if Bun is the runtime (compiled binary or bun run) */
+export declare const isBunRuntime: boolean;
+export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
+export declare function detectInstallMethod(): InstallMethod;
+export declare function getUpdateInstruction(packageName: string): string;
+/**
+ * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
+ * - For Bun binary: returns the directory containing the executable
+ * - For Node.js (dist/): returns __dirname (the dist/ directory)
+ * - For tsx (src/): returns parent directory (the package root)
+ */
+export declare function getPackageDir(): string;
+/**
+ * Get path to built-in themes directory (shipped with package)
+ * - For Bun binary: theme/ next to executable
+ * - For Node.js (dist/): dist/modes/interactive/theme/
+ * - For tsx (src/): src/modes/interactive/theme/
+ * - For flat structure (catui-agent dev): modes/interactive/theme/
+ */
+export declare function getThemesDir(): string;
+/**
+ * Get path to HTML export template directory (shipped with package)
+ * - For Bun binary: export-html/ next to executable
+ * - For Node.js (dist/): dist/core/export-html/
+ * - For tsx (src/): src/core/export-html/
+ * - For flat structure (catui-agent dev): core/export-html/
+ */
+export declare function getExportTemplateDir(): string;
+/** Get path to package.json */
+export declare function getPackageJsonPath(): string;
+/** Get path to README.md */
+export declare function getReadmePath(): string;
+/** Get path to docs directory */
+export declare function getDocsPath(): string;
+/** Get path to examples directory */
+export declare function getExamplesPath(): string;
+/** Get path to CHANGELOG.md */
+export declare function getChangelogPath(): string;
+export declare const APP_NAME: string;
+/** Config dir: ~/.catui for Catui. Fallback remains legacy-compatible when package metadata is absent. */
+export declare const CONFIG_DIR_NAME: string;
+export declare const VERSION: string;
+/** npm package name, used for version checking and update prompts (e.g., @catui/agent) */
+export declare const PACKAGE_NAME: string;
+export declare const ENV_AGENT_DIR: string;
+/** Get the share viewer URL for a gist ID */
+export declare function getShareViewerUrl(gistId: string): string;
+/** Get the agent config directory (e.g., ~/.catui/agents/default/) */
+export declare function getAgentDir(): string;
+/** Get path to user's custom themes directory */
+export declare function getCustomThemesDir(): string;
+/** Get path to models.json */
+export declare function getModelsPath(): string;
+/** Get path to auth.json */
+export declare function getAuthPath(): string;
+/** Get path to settings.json */
+export declare function getSettingsPath(): string;
+/** Get path to tools directory */
+export declare function getToolsDir(): string;
+/** Get path to managed binaries directory (fd, rg) */
+export declare function getBinDir(): string;
+/** Get path to prompt templates directory */
+export declare function getPromptsDir(): string;
+/** Get path to sessions directory */
+export declare function getSessionsDir(): string;
+/** Get path to debug log file */
+export declare function getDebugLogPath(): string;
+/** Get the root Catui config directory (e.g., ~/.catui/) */
+export declare function getConfigRoot(): string;
+/**
+ * Resolve the Catui ecosystem root directory.
+ * Priority: CATUI_HOME > CATUIS_HOME > NANOPENCIL_HOME > ~/.catui
+ *
+ * CATUI_HOME is canonical. CATUIS_HOME and NANOPENCIL_HOME are compatibility aliases.
+ */
+export declare function getCatuiHome(): string;
+/** Catui agents root (e.g., ~/.catui/agents/) */
+export declare function getCatuiAgentsDir(): string;
+/**
+ * Resolve an agent directory context for a given agent id.
+ * If no id is provided, returns the legacy single-agent context.
+ *
+ * Resolution order for per-agent path:
+ * 1. CATUI_CODING_AGENT_DIR env (single-agent override)
+ * 2. NANOPENCIL_CODING_AGENT_DIR env (legacy single-agent override)
+ * 3. CATUI_AGENTS_DIR/<id> env (per-agent root override)
+ * 4. CATUIS_AGENTS_DIR/<id> env (legacy per-agent root override)
+ * 5. PENCILS_AGENTS_DIR/<id> env (legacy per-agent root override)
+ * 6. ~/.catui/agents/<id> (default)
+ */
+export declare function resolveAgentDirContext(agentId?: string): {
+    id: string;
+    path: string;
+};
+/** Get path to global browser-workspace directory (e.g., ~/.catui/workspaces/browser-workspace) */
+export declare function getBrowserWorkspaceDir(): string;
+/** Get path to global link-world-workspace directory (e.g., ~/.catui/workspaces/link-world-workspace) */
+export declare function getLinkWorldWorkspaceDir(): string;

package/dist/config.js

@@ -0,0 +1 @@
+var I=Object.defineProperty;var n=(e,t)=>I(e,"name",{value:t,configurable:!0});import{existsSync as p,readFileSync as C}from"fs";import{homedir as a}from"os";import{dirname as u,join as r,resolve as l}from"path";import{fileURLToPath as P}from"url";const R=P(import.meta.url),d=u(R),m=import.meta.url.includes("$bunfs")||import.meta.url.includes("~BUN")||import.meta.url.includes("%7EBUN"),N=!!process.versions.bun;function T(){if(m)return"bun-binary";const e=`${d}\0${process.execPath||""}`.toLowerCase();return e.includes("/pnpm/")||e.includes("/.pnpm/")||e.includes("\\pnpm\\")?"pnpm":e.includes("/yarn/")||e.includes("/.yarn/")||e.includes("\\yarn\\")?"yarn":N?"bun":e.includes("/npm/")||e.includes("/node_modules/")||e.includes("\\npm\\")?"npm":"unknown"}n(T,"detectInstallMethod");function H(e){switch(T()){case"bun-binary":return"Download from: https://github.com/O-Catui/Catui/releases/latest";case"pnpm":return`Run: pnpm install -g ${e}`;case"yarn":return`Run: yarn global add ${e}`;case"bun":return`Run: bun install -g ${e}`;case"npm":return`Run: npm install -g ${e}`;default:return`Run: npm install -g ${e}`}}n(H,"getUpdateInstruction");function c(){const e=process.env.CATUI_PACKAGE_DIR;if(e)return e==="~"?a():e.startsWith("~/")?a()+e.slice(1):e;if(m)return u(process.execPath);let t=d;for(;t!==u(t);){if(p(r(t,"package.json")))return t;t=u(t)}return d}n(c,"getPackageDir");function M(){if(m)return r(u(process.execPath),"theme");const e=c(),t=r(e,"modes","interactive","theme");if(p(t))return t;const o=p(r(e,"src"))?"src":"dist";return r(e,o,"modes","interactive","theme")}n(M,"getThemesDir");function W(){if(m)return r(u(process.execPath),"export-html");const e=c(),t=r(e,"core","export-html");if(p(t))return t;const o=p(r(e,"src"))?"src":"dist";return r(e,o,"core","export-html")}n(W,"getExportTemplateDir");function S(){return r(c(),"package.json")}n(S,"getPackageJsonPath");function B(){return l(r(c(),"README.md"))}n(B,"getReadmePath");function j(){return l(r(c(),"docs"))}n(j,"getDocsPath");function V(){return l(r(c(),"examples"))}n(V,"getExamplesPath");function F(){return l(r(c(),"CHANGELOG.md"))}n(F,"getChangelogPath");const f=JSON.parse(C(S(),"utf-8")),x=f.catuiConfig?.name||"catui",G=f.catuiConfig?.configDir??(f.name==="@catui/agent",".catui"),z=f.version,J=f.name||"@catui/agent",_=`${x.toUpperCase()}_CODING_AGENT_DIR`,A="NANOPENCIL_CODING_AGENT_DIR",U="https://catui.dev/session/";function K(e){return`${process.env.CATUI_SHARE_VIEWER_URL||U}#${e}`}n(K,"getShareViewerUrl");function s(){return w().path}n(s,"getAgentDir");function Y(){return r(s(),"themes")}n(Y,"getCustomThemesDir");function q(){return r(s(),"models.json")}n(q,"getModelsPath");function Q(){return r(s(),"auth.json")}n(Q,"getAuthPath");function X(){return r(s(),"settings.json")}n(X,"getSettingsPath");function Z(){return r(s(),"tools")}n(Z,"getToolsDir");function ee(){return r(s(),"bin")}n(ee,"getBinDir");function te(){return r(s(),"prompts")}n(te,"getPromptsDir");function ne(){return r(s(),"sessions")}n(ne,"getSessionsDir");function re(){return r(s(),`${x}-debug.log`)}n(re,"getDebugLogPath");function i(e){return e==="~"?a():e.startsWith("~/")?a()+e.slice(1):e}n(i,"expandHomePath");function E(){const e=process.env[_]??process.env[A];if(e){const t=i(e);return t.endsWith("/agent")||t.endsWith("\\agent")?u(t):u(t)}return r(a(),G)}n(E,"getConfigRoot");const D=/^[a-z0-9][a-z0-9._-]{0,63}$/;function b(e){if(!D.test(e))throw new Error(`Invalid agent id "${e}". Must match ${D.source} (lowercase ASCII slug, max 64 chars).`);return e}n(b,"validateAgentId");function v(){const e=process.env.CATUI_HOME;if(e)return i(e);const t=process.env.CATUIS_HOME;if(t)return i(t);const o=process.env.NANOPENCIL_HOME;return o?i(o):r(a(),".catui")}n(v,"getCatuiHome");function oe(){const e=process.env.CATUI_AGENTS_DIR;if(e)return i(e);const t=process.env.CATUIS_AGENTS_DIR;if(t)return i(t);const o=process.env.PENCILS_AGENTS_DIR;return o?i(o):r(v(),"agents")}n(oe,"getCatuiAgentsDir");function w(e){const t=e||"default";b(t);const o=process.env[_]??process.env[A];if(o&&t==="default"){const g=i(o);return{id:t,path:g}}const h=process.env.CATUI_AGENTS_DIR??process.env.CATUIS_AGENTS_DIR??process.env.PENCILS_AGENTS_DIR;if(h){const g=i(h);return{id:t,path:r(g,t)}}return{id:t,path:r(v(),"agents",t)}}n(w,"resolveAgentDirContext");function se(){return r(E(),"workspaces","browser-workspace")}n(se,"getBrowserWorkspaceDir");function ie(){return r(E(),"workspaces","link-world-workspace")}n(ie,"getLinkWorldWorkspaceDir");export{x as APP_NAME,G as CONFIG_DIR_NAME,_ as ENV_AGENT_DIR,J as PACKAGE_NAME,z as VERSION,T as detectInstallMethod,s as getAgentDir,Q as getAuthPath,ee as getBinDir,se as getBrowserWorkspaceDir,oe as getCatuiAgentsDir,v as getCatuiHome,F as getChangelogPath,E as getConfigRoot,Y as getCustomThemesDir,re as getDebugLogPath,j as getDocsPath,V as getExamplesPath,W as getExportTemplateDir,ie as getLinkWorldWorkspaceDir,q as getModelsPath,c as getPackageDir,S as getPackageJsonPath,te as getPromptsDir,B as getReadmePath,ne as getSessionsDir,X as getSettingsPath,K as getShareViewerUrl,M as getThemesDir,Z as getToolsDir,H as getUpdateInstruction,m as isBunBinary,N as isBunRuntime,w as resolveAgentDirContext};

package/dist/core/agent-dir/agent-dir-context.d.ts

@@ -0,0 +1,60 @@
+/**
+ * [WHO]: AgentDirContext interface, defaultAgentDirContext(), agentDirContextOf(), validateAgentId()
+ * [FROM]: Depends on config.ts (getAgentDir)
+ * [TO]: Consumed by core/persona, core/session, core/soul-integration, core/mcp, extensions, future --agent flag
+ * [HERE]: core/agent-dir/agent-dir-context.ts - multi-agent directory abstraction
+ */
+/**
+ * Regex for a valid agent <id>.
+ * ASCII slug: lowercase alphanumeric start, then [a-z0-9._-], max 64 chars.
+ * Design doc §4.1.
+ */
+export declare const AGENT_ID_RE: RegExp;
+/**
+ * Validate an agent id. Returns the id if valid, throws otherwise.
+ */
+export declare function validateAgentId(id: string): string;
+export interface AgentOriginMetadata {
+    type: "local" | "cloud-adopted" | "imported";
+    asgard?: {
+        templateId: string;
+        templateVersion: string;
+        originUrl: string;
+        externalId: string;
+        lastSyncedAt: string;
+    };
+}
+/**
+ * Represents the resolved filesystem context for one agent.
+ *
+ * - `id`  : machine-readable slug (directory name, route key, Asgard externalId)
+ * - `path`: absolute path to the agent's data directory
+ * - `origin`: optional metadata if adopted from cloud (future, §4.2)
+ */
+export interface AgentDirContext {
+    /** Slug id, [a-z0-9._-]{1,64}; matches the directory name. Immutable once created. */
+    readonly id: string;
+    /** Absolute path; trusted to exist or be creatable. */
+    readonly path: string;
+    /** Optional — if the agent was adopted from cloud, the origin metadata. */
+    readonly origin?: AgentOriginMetadata;
+}
+/**
+ * Build the default context for the legacy single-agent path.
+ * This is the fallback when no `--agent` flag is provided.
+ * Resolves to whatever `getAgentDir()` returns today (~/.catui/agents/default).
+ */
+export declare function defaultAgentDirContext(): AgentDirContext;
+/**
+ * Build an AgentDirContext for a specific agent id + resolved path.
+ * Throws if the id fails validation.
+ */
+export declare function agentDirContextOf(id: string, path: string, origin?: AgentOriginMetadata): AgentDirContext;
+/**
+ * Load AgentDirContext from an agent directory (loads agent.json if it exists).
+ */
+export declare function loadAgentDirContext(id: string): AgentDirContext;
+/**
+ * Save AgentDirContext to agent.json.
+ */
+export declare function saveAgentDirContext(ctx: AgentDirContext): void;

package/dist/core/agent-dir/agent-dir-context.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var r=(t,n)=>c(t,"name",{value:n,configurable:!0});import{existsSync as o,readFileSync as g,writeFileSync as f,mkdirSync as p}from"node:fs";import{join as i}from"node:path";import{getAgentDir as l,getCatuiAgentsDir as d}from"../../config.js";const s=/^[a-z0-9][a-z0-9._-]{0,63}$/;function h(t){if(!s.test(t))throw new Error(`Invalid agent id "${t}". Must match ${s.source} (lowercase ASCII slug, max 64 chars).`);return t}r(h,"validateAgentId");function m(){return{id:"default",path:l()}}r(m,"defaultAgentDirContext");function y(t,n,e){return h(t),{id:t,path:n,origin:e}}r(y,"agentDirContextOf");function C(t){const n=i(d(),t),e=i(n,"agent.json");if(o(e))try{const u=g(e,"utf-8"),a=JSON.parse(u);return{id:a.id||t,path:n,origin:a.origin}}catch{}return t!=="default"||o(n)?{id:t,path:n}:m()}r(C,"loadAgentDirContext");function I(t){o(t.path)||p(t.path,{recursive:!0});const n=i(t.path,"agent.json"),e={id:t.id,origin:t.origin};f(n,JSON.stringify(e,null,2),"utf-8")}r(I,"saveAgentDirContext");export{s as AGENT_ID_RE,y as agentDirContextOf,m as defaultAgentDirContext,C as loadAgentDirContext,I as saveAgentDirContext,h as validateAgentId};

package/dist/core/agent-dir/agent-metadata.d.ts

@@ -0,0 +1,48 @@
+/**
+ * [WHO]: AgentMetadata interface, loadAgentMetadata(), saveAgentMetadata(), ensureAgentMetadata()
+ * [FROM]: Depends on agent-dir-context.ts, node:fs, node:path
+ * [TO]: Consumed by main.ts, future Gateway integration
+ * [HERE]: core/agent-dir/agent-metadata.ts - agent.json (machine-readable metadata)
+ *
+ * Design doc: docs/multi-agent-fs-design.md §4.2
+ */
+import type { AgentDirContext } from "./agent-dir-context.js";
+export interface AgentAsgardMetadata {
+    templateId: string;
+    templateVersion: string;
+    originUrl: string;
+    externalId: string;
+    lastSyncedAt: string;
+}
+export interface AgentMetadata {
+    version: string;
+    /** Slug id, [a-z0-9._-]{1,64}; matches the directory name. Immutable. */
+    id: string;
+    /** Human-readable name; can contain Chinese/emoji. */
+    displayName: string;
+    /** Human-readable description. */
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+    origin: {
+        type: "local" | "cloud-adopted" | "imported";
+        asgard?: AgentAsgardMetadata;
+    };
+    tags: string[];
+    engine: string;
+    extensions: Record<string, unknown>;
+}
+export declare const CURRENT_METADATA_VERSION = "1.0.0";
+/**
+ * Load agent.json from the agent directory.
+ * Returns undefined if the file does not exist or is invalid.
+ */
+export declare function loadAgentMetadata(agentDir: string): AgentMetadata | undefined;
+/**
+ * Save agent.json to the agent directory.
+ */
+export declare function saveAgentMetadata(agentDir: string, metadata: AgentMetadata): void;
+/**
+ * Ensure agent.json exists. If not, creates a default one based on context.
+ */
+export declare function ensureAgentMetadata(ctx: AgentDirContext): AgentMetadata;

package/dist/core/agent-dir/agent-metadata.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var i=(t,e)=>s(t,"name",{value:e,configurable:!0});import{existsSync as r,readFileSync as u,writeFileSync as f,mkdirSync as p}from"node:fs";import{join as o}from"node:path";const c="1.0.0";function g(t){const e=o(t,"agent.json");if(r(e))try{const n=u(e,"utf-8");return JSON.parse(n)}catch{return}}i(g,"loadAgentMetadata");function d(t,e){const n=o(t,"agent.json");r(t)||p(t,{recursive:!0}),e.updatedAt=new Date().toISOString(),f(n,JSON.stringify(e,null,2),"utf-8")}i(d,"saveAgentMetadata");function y(t){const e=g(t.path);if(e)return e.id!==t.id&&(e.id=t.id,d(t.path,e)),e;const n=new Date().toISOString(),a={version:c,id:t.id,displayName:t.id==="default"?"Default Agent":t.id,createdAt:n,updatedAt:n,origin:{type:"local"},tags:[],engine:"catui-agent",extensions:{}};return d(t.path,a),a}i(y,"ensureAgentMetadata");export{c as CURRENT_METADATA_VERSION,y as ensureAgentMetadata,g as loadAgentMetadata,d as saveAgentMetadata};

package/dist/core/agent-dir/migration-tool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * [WHO]: MigrationManager class, handleMigration()
+ * [FROM]: Depends on node:fs, node:path, node:os, chalk, config.ts
+ * [TO]: Consumed by main.ts (migrate command)
+ * [HERE]: core/agent-dir/migration-tool.ts - Safe copy-first migration from ~/.nanopencil and ~/.pencils to ~/.catui
+ *
+ * Design doc: docs/multi-agent-fs-design.md §12.2
+ */
+export interface MigrationOptions {
+    dryRun: boolean;
+    apply: boolean;
+    copy: boolean;
+}
+export interface MigrationTask {
+    id: string;
+    source: string;
+    target: string;
+    label: string;
+    description: string;
+}
+export declare class MigrationManager {
+    private readonly legacyNanoRoot;
+    private readonly legacyPencilsRoot;
+    private readonly newRoot;
+    private readonly migrationLogPath;
+    constructor(homeDir?: string);
+    run(options: MigrationOptions): Promise<void>;
+    /**
+     * Check if any migration is currently needed (legacy data exists and hasn't been migrated).
+     */
+    isMigrationNeeded(): boolean;
+    /**
+     * Run migration silently (no preview, direct apply) and return the list of migrated labels.
+     */
+    runSilent(): string[];
+    private plan;
+    private execute;
+    private isAlreadyApplied;
+    private logMigration;
+}

package/dist/core/agent-dir/migration-tool.js

@@ -0,0 +1,7 @@
+var R=Object.defineProperty;var h=(u,e)=>R(u,"name",{value:e,configurable:!0});import{existsSync as r,mkdirSync as p,cpSync as f,readFileSync as $,appendFileSync as b,readdirSync as m}from"node:fs";import{join as a,dirname as w}from"node:path";import{homedir as k}from"node:os";import t from"chalk";class v{static{h(this,"MigrationManager")}legacyNanoRoot;legacyPencilsRoot;newRoot;migrationLogPath;constructor(e=k()){this.legacyNanoRoot=a(e,".nanopencil"),this.legacyPencilsRoot=a(e,".pencils"),this.newRoot=a(e,".catui"),this.migrationLogPath=a(this.newRoot,".migrations","applied.jsonl")}async run(e){console.log(t.bold(`
+\u{1F680} Catui Data Migration Tool`)),console.log(t.dim("---------------------------------")),console.log(`Source: ${t.cyan(this.legacyNanoRoot)} / ${t.cyan(this.legacyPencilsRoot)}`),console.log(`Target: ${t.cyan(this.newRoot)}`),console.log(`Mode:   ${e.dryRun?t.yellow("Dry Run (Preview Only)"):t.green("Apply Changes")}`),console.log(`Method: ${e.copy?"Copy (Safe)":"Move"}
+`);const n=this.plan();if(n.length===0){console.log(t.green("No migration tasks found. Your data is already in the new format or no legacy data was detected."));return}console.log(t.bold("Migration Tasks:"));for(const o of n)console.log(`  ${t.blue("\u2022")} ${o.label}`),console.log(`    ${t.dim("From:")} ${o.source}`),console.log(`    ${t.dim("To:  ")} ${o.target}`);if(e.dryRun){console.log(t.yellow(`
+\u26A0\uFE0F This was a dry run. No files were changed.`)),console.log(`Run with ${t.bold("--apply")} to execute the migration.`);return}console.log(t.bold(`
+Executing migration...`));for(const o of n)try{this.execute(o,e.copy),console.log(`${t.green("\u2713")} Migrated: ${o.label}`),this.logMigration(o)}catch(g){console.error(t.red(`\u2717 Failed to migrate ${o.label}: ${g instanceof Error?g.message:g}`))}console.log(t.green.bold(`
+Migration complete!`)),console.log(`Legacy data is preserved in ${t.cyan(this.legacyNanoRoot)} and ${t.cyan(this.legacyPencilsRoot)} for backup.`),console.log("You can safely delete it after verifying your data in the new environment.")}isMigrationNeeded(){return this.plan().length>0}runSilent(){const e=this.plan(),n=[];for(const o of e)try{this.execute(o,!0),this.logMigration(o),n.push(o.label)}catch{}return n}plan(){const e=[],n=a(this.legacyNanoRoot,"agent"),o=a(this.newRoot,"agents","default");r(n)&&(!this.isAlreadyApplied("nano-agent-to-default")||!r(o))&&e.push({id:"nano-agent-to-default",source:n,target:o,label:"Global Agent Data",description:"Main configuration, sessions, memory, and soul data."});const g=["browser-workspace","link-world-workspace"];for(const c of g){const i=a(this.legacyNanoRoot,c),s=a(this.newRoot,"workspaces",c),l=`nano-ws-${c}`;r(i)&&(!this.isAlreadyApplied(l)||!r(s))&&e.push({id:l,source:i,target:s,label:`Workspace: ${c}`,description:"Global extension workspace data."})}try{if(r(this.legacyNanoRoot)){const c=m(this.legacyNanoRoot,{withFileTypes:!0});for(const i of c)if(i.isDirectory()&&!g.includes(i.name)&&i.name!=="agent"){const s=a(this.legacyNanoRoot,i.name),l=a(this.newRoot,i.name),d=`nano-dir-${i.name}`;(!this.isAlreadyApplied(d)||!r(l))&&e.push({id:d,source:s,target:l,label:`Legacy Directory: ${i.name}`,description:"Additional legacy configuration or data."})}}}catch{}try{const c=a(this.legacyPencilsRoot,"agents");if(r(c)){const i=m(c,{withFileTypes:!0});for(const s of i){if(!s.isDirectory()||s.name.startsWith("."))continue;const l=a(c,s.name),d=a(this.newRoot,"agents",s.name),y=`pencil-agent-${s.name}`;(!this.isAlreadyApplied(y)||!r(d))&&e.push({id:y,source:l,target:d,label:`Catui Agent: ${s.name}`,description:"Previous multi-agent Pencil ecosystem data."})}}}catch{}return e}execute(e,n){const o=w(e.target);r(o)||p(o,{recursive:!0}),n?f(e.source,e.target,{recursive:!0}):f(e.source,e.target,{recursive:!0})}isAlreadyApplied(e){if(!r(this.migrationLogPath))return!1;try{return $(this.migrationLogPath,"utf-8").includes(`"taskId":"${e}"`)}catch{return!1}}logMigration(e){const n=w(this.migrationLogPath);r(n)||p(n,{recursive:!0});const o={timestamp:new Date().toISOString(),taskId:e.id,source:e.source,target:e.target};b(this.migrationLogPath,`${JSON.stringify(o)}
+`)}}export{v as MigrationManager};

package/dist/core/export-html/AGENT.md

@@ -0,0 +1,12 @@
+# core/export-html/
+
+> P2 | Parent: ../AGENT.md
+
+Member List
+tool-renderer.ts: ToolHtmlRendererDeps interface, ToolHtmlRenderer interface, renderToolToHtml(), renders tool calls and results to HTML, consumes ansi-to-html for output formatting
+ansi-to-html.ts: ansiToHtml(), ansiLinesToHtml(), AnsiToHtmlOptions, ANSI to HTML conversion, standard ANSI color palette (0-15), no external dependencies
+index.ts: ToolHtmlRenderer interface, exportSessionToHtml(), HTML export functionality, generates self-contained HTML from session entries, key invariant: produces complete standalone HTML document
+
+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