catui-agent 1.0.0-beta.0

package/README.md

@@ -0,0 +1,267 @@
+<div align="center">
+
+<pre>
+                .-~~~~~~~~~-._       _.-~~~~~~~~~-.
+            __.'              ~.   .~              `.__
+          .'//                  \./                  \\`.
+        .'//                     |                     \\`.
+      .'// .-~""""""""""""""-._     |     _,-""""""""""""""~-. \\`.
+    .'//.-"                 `-.  |  .-'                 "-.\\`.
+  .'//______.============-..   \ | /   ..-============.______\\`.
+.'______________________________\|/______________________________`.
+</pre>
+
+<h1>✎ Catui</h1>
+
+<p><strong>The AI Coding Agent That Remembers & Evolves</strong></p>
+
+<p>
+  <a href="https://www.npmjs.com/package/catui-agent">
+    <img src="https://img.shields.io/npm/v/catui-agent.svg?style=flat-square&color=cb3837" alt="npm version">
+  </a>
+  <a href="https://nodejs.org">
+    <img src="https://img.shields.io/node/v/catui-agent.svg?style=flat-square&color=339933" alt="Node.js">
+  </a>
+  <a href="https://www.npmjs.com/package/catui-agent">
+    <img src="https://img.shields.io/npm/dm/catui-agent.svg?style=flat-square&color=cb3837" alt="Downloads">
+  </a>
+  <img src="https://img.shields.io/badge/TypeScript-5.0+-blue?style=flat-square&color=3178C6" alt="TypeScript">
+  <img src="https://img.shields.io/badge/License-GPL--3.0-green?style=flat-square&color=brightgreen" alt="License">
+</p>
+
+<p>
+  <a href="#-why-catui">Why Catui?</a> •
+  <a href="#-features">Features</a> •
+  <a href="#-quick-start">Quick Start</a> •
+  <a href="#-documentation">Docs</a>
+</p>
+
+<p>
+  <a href="./README.md"><img src="https://img.shields.io/badge/English-Active-blue?style=flat-square" alt="English"></a>
+  <a href="./README_CN.md"><img src="https://img.shields.io/badge/中文-切换-orange?style=flat-square" alt="中文"></a>
+</p>
+
+</div>
+
+---
+
+## 🌟 Why Catui?
+
+> **"The only AI coding assistant that truly learns from you"**
+
+Catui isn't just another AI coding tool. It's a **terminal-native AI agent** with **persistent memory** and **evolving personality** — designed for developers who live in the terminal.
+
+### What Makes It Different?
+
+| | Other Tools | Catui |
+|---|---|---|
+| **Memory** | ❌ Starts fresh every session | ✅ Remembers your projects, preferences, and coding style |
+| **Personality** | ❌ Generic responses | ✅ Evolves a unique personality based on your interactions |
+| **Terminal Native** | ❌ GUI wrappers or plugins | ✅ Pure TUI built for terminal workflows |
+| **Model Freedom** | ❌ Vendor lock-in | ✅ 10+ providers, switch instantly |
+| **Offline Ready** | ❌ Cloud dependent | ✅ Local models via Ollama |
+
+---
+
+## ✨ Features
+
+### 🧠 Persistent Memory (NanoMem)
+Your projects have context. So should your AI.
+
+- **Project Knowledge** — API endpoints, database schemas, architecture decisions
+- **Error Patterns** — Remembers bugs and their solutions  
+- **User Preferences** — Coding style, naming conventions, framework choices
+- **Smart Retrieval** — Automatically recalls relevant context when needed
+
+### 💫 AI Personality Evolution (NanoSoul)
+Your AI assistant develops its own character.
+
+- **Big Five Traits** — Openness, Conscientiousness, Extraversion, Agreeableness, Neuroticism
+- **Coding Style** — Verbosity, abstraction level, safety margins
+- **Domain Expertise** — Frontend, Backend, DevOps, AI/ML specializations
+- **Emotional States** — Confidence, curiosity, flow state
+
+> *After 50 sessions, your Catui will code differently than anyone else's.*
+
+### 🎨 Beautiful TUI
+A terminal interface that feels alive.
+
+- **Three Themes** — Dark, Light, and Warm (eye-friendly)
+- **Smooth Animations** — Breathing catui loader
+- **Intuitive Navigation** — Vim-like keybindings, fuzzy search
+- **Real-time Streaming** — Watch the AI think in real-time
+
+### 🔌 MCP Protocol Support
+Extend with the Model Context Protocol.
+
+Built-in tools include:
+- 📁 Filesystem operations
+- 🌐 HTTP requests (Fetch)
+- 🎭 Browser automation (Puppeteer)
+- 🗄️ Database queries (SQLite)
+- 🔧 Git operations
+
+### 🌐 Multi-Model Support
+Use the best model for each task.
+
+- 🇨🇳 **Alibaba DashScope / Token Plan** — Qwen, GLM, MiniMax, DeepSeek text models
+- 🤖 **OpenAI** — GPT-4, GPT-3.5
+- 💬 **Anthropic** — Claude 3 Opus/Sonnet/Haiku
+- 🔍 **Google** — Gemini Pro/Ultra
+- 🏠 **Local** — Ollama (Qwen, Llama, Mistral, etc.)
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install -g catui-agent
+```
+
+### First Run
+
+```bash
+catui
+```
+
+1. **Select your model** — Choose from available providers
+2. **Enter API key** — Securely stored in `~/.catui/agents/default/auth.json`
+3. **Start coding** — Just type what you want to build
+
+### Example Session
+
+```
+You: Create a JWT authentication middleware for Express
+
+AI: [Analyzing project structure...]
+    [Creating auth.middleware.ts...]
+    [Adding TypeScript types...]
+    [Writing tests...]
+    
+    ✅ Done! Created:
+    - src/middleware/auth.middleware.ts
+    - src/types/auth.d.ts
+    - tests/auth.middleware.test.ts
+    
+    Features:
+    • JWT verification with RS256
+    • Refresh token rotation
+    • Role-based access control
+    • Rate limiting integration
+```
+
+---
+
+## 🎮 Usage
+
+### Interactive Mode
+
+```bash
+catui                    # Start new session
+catui -c                 # Continue last session
+catui -r                 # Resume from history
+catui -m qwen-max        # Use specific model
+```
+
+### Print Mode (Scripts)
+
+```bash
+# Single query
+catui -p "Refactor this to use async/await"
+
+# Pipe input
+cat bug-report.md | catui -p "Analyze this bug"
+
+# Chain commands
+catui -p "Generate API" | catui -p "Write tests for it"
+```
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/model` | Switch AI model |
+| `/thinking` | Adjust reasoning depth |
+| `/fork` | Branch conversation |
+| `/tree` | Browse session history |
+| `/memory` | View project memories |
+| `/soul` | Check AI personality |
+| `/settings` | Configure preferences |
+| `/export` | Save as HTML |
+
+---
+
+## 📊 Comparison
+
+| Feature | Catui | Cursor | Claude Code | Aider |
+|---------|:----------:|:------:|:-----------:|:-----:|
+| Terminal Native | ✅ | ❌ | ✅ | ✅ |
+| Persistent Memory | ✅ | ❌ | ❌ | ❌ |
+| AI Personality | ✅ | ❌ | ❌ | ❌ |
+| Session Branching | ✅ | ✅ | ✅ | ❌ |
+| Multi-Model | ✅ | ✅ | ❌ | ✅ |
+| MCP Support | ✅ | ❌ | ✅ | ❌ |
+| Offline Mode | ✅ | ❌ | ❌ | ✅ |
+| Chinese Optimized | ✅ | ❌ | ❌ | ❌ |
+
+---
+
+## 🏗️ Architecture Philosophy
+
+Catui is built on three pillars:
+
+```
+┌─────────────────────────────────────────┐
+│           🧠 COGNITIVE LAYER            │
+│    (Memory + Personality + Context)     │
+├─────────────────────────────────────────┤
+│           🔧 TOOL LAYER                 │
+│  (File Ops + Bash + Search + MCP)       │
+├─────────────────────────────────────────┤
+│           🎨 INTERFACE LAYER            │
+│       (TUI + Themes + Keybindings)      │
+└─────────────────────────────────────────┘
+```
+
+**Design Principles:**
+- **Terminal First** — No Electron, no browser, pure terminal
+- **Privacy First** — Local storage by default; opt-in diagnostics/eval telemetry only when explicitly configured
+- **Extensible** — Plugin system for tools, themes, and behaviors
+- **Fast** — Sub-second startup, instant response
+
+---
+
+## 📚 Documentation
+
+- [Installation Guide](docs/INSTALL.md)
+- [Configuration](docs/CONFIG.md)
+- [Memory System](docs/记忆系统.md)
+- [MCP Guide](docs/MCP集成指南.md)
+- [Keybindings](docs/KEYBINDINGS.md)
+- [Extensions](docs/EXTENSIONS.md)
+
+---
+
+## 🌍 Community
+
+- 💬 [Discussions](https://github.com/catui-agent/catui-agent/discussions)
+- 🐛 [Issues](https://github.com/catui-agent/catui-agent/issues)
+- 📝 [Changelog](CHANGELOG.md)
+
+---
+
+## 📄 License
+
+MIT © [Catui Agent](https://github.com/catui-agent)
+
+---
+
+<div align="center">
+
+**[⬆ Back to Top](#-catui)**
+
+<sub>Built with ❤️ for terminal dwellers everywhere</sub>
+
+</div>

package/dist/build-meta.json

@@ -0,0 +1,6 @@
+{
+  "version": "1.0.0-beta.0",
+  "commitHash": "7e64df8",
+  "branch": "main",
+  "builtAt": "2026-06-13T07:59:56.421Z"
+}

package/dist/builtin-extensions.d.ts

@@ -0,0 +1,47 @@
+/**
+ * [WHO]: BuiltinExtension, getBuiltinExtensionPaths(), builtInExtensions
+ * [FROM]: Depends on node:fs, node:path, config
+ * [TO]: Consumed by main.ts, test files
+ * [HERE]: builtin-extensions.ts - built-in extension registry for Catui
+ */
+export type BuiltinExtensionRiskLevel = "passive" | "command" | "tool" | "background" | "write-capable";
+export type BuiltinExtensionTestContract = "lifecycle" | "external-process" | "resource-discovery" | "write-guard";
+export interface BuiltinExtension {
+    id: string;
+    category: "default" | "optional" | "package";
+    defaultEnabled: boolean;
+    riskLevel: BuiltinExtensionRiskLevel;
+    requiresUI: boolean;
+    startsTimers: boolean;
+    writesWorkspace: boolean;
+    externalProcess: boolean;
+    resourceDiscovery?: boolean;
+    testContracts?: readonly BuiltinExtensionTestContract[];
+    testFiles?: readonly string[];
+}
+export declare const builtInExtensions: readonly BuiltinExtension[];
+/**
+ * Get the list of built-in extension paths that Catui loads by default
+ *
+ * Returns all default-enabled extension paths (builtin/):
+ * - NanoMem (persistent memory)
+ * - Soul (AI personality evolution)
+ * - LinkWorld (internet search)
+ * - SecurityAudit (security audit)
+ * - MCP (MCP protocol adapter)
+ *
+ * Optional extensions need to be enabled via configuration or --extension:
+ * - Simplify (code simplification) - extensions/optional/simplify/
+ * - export-html (HTML export) - extensions/optional/export-html/
+ * - Browser harness (CDP automation) - extensions/builtin/browser/ (opt-in since P6/EV03; source stays
+ *   under builtin/ until the Q2 physical/package opt-in decision moves it to extensions/optional/ or a package)
+ */
+export declare function getBuiltinExtensionPaths(): string[];
+/**
+ * @deprecated Use getBuiltinExtensionPaths() instead
+ */
+export declare function getNanopencilDefaultExtensionPaths(): string[];
+/**
+ * @deprecated Use getBuiltinExtensionPaths() instead
+ */
+export declare function getCatuiDefaultExtensionPaths(): string[];

package/dist/builtin-extensions.js

@@ -0,0 +1 @@
+var C=Object.defineProperty;var l=(s,e)=>C(s,"name",{value:e,configurable:!0});import{existsSync as t,readFileSync as X}from"node:fs";import{createRequire as F}from"node:module";import{dirname as c,join as i}from"node:path";import{fileURLToPath as A}from"node:url";const r=c(A(import.meta.url)),R=F(import.meta.url),f=i(r,"packages","mem-core","extension.js"),d=i(r,"extensions","builtin","link-world","index.js"),x=i(r,"extensions","builtin","security-audit","index.js"),p=i(r,"extensions","builtin","soul","index.js"),E=i(r,"extensions","builtin","presence","index.js"),b=i(r,"extensions","builtin","ask-user-question","index.js"),k=i(r,"extensions","builtin","teach","index.js"),T=i(r,"extensions","builtin","loop","index.js"),m=i(r,"extensions","builtin","plan","index.js"),N=i(r,"extensions","builtin","discipline","index.js"),g=i(r,"extensions","builtin","diagnostics","index.js"),h=i(r,"extensions","builtin","sal","index.js"),I=i(r,"extensions","builtin","token-save","index.js"),L=i(r,"extensions","builtin","grub","index.js"),U=i(r,"extensions","builtin","goal","index.js"),D=i(r,"extensions","builtin","subagent","index.js"),_=i(r,"extensions","builtin","team","index.js"),y=i(r,"extensions","builtin","idle-think","index.js"),S=i(r,"extensions","builtin","btw","index.js"),v=i(r,"extensions","builtin","recap","index.js"),w=i(r,"extensions","builtin","debug","index.js"),P=i(r,"extensions","builtin","mcp","index.js"),O=i(r,"extensions","builtin","task","index.js"),q=i(r,"extensions","builtin","lsp","index.js"),W=i(r,"extensions","builtin","insights","index.js"),V=[{id:"diagnostics",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!0,writesWorkspace:!1,externalProcess:!1,testContracts:["lifecycle"],testFiles:["test/diagnostic-buffer-throttle.test.ts","test/diagnostics-runtime.test.ts"]},{id:"sal",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1,testContracts:["lifecycle"],testFiles:["test/sal-lifecycle.test.ts"]},{id:"token-save",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"nanomem",category:"package",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1,testContracts:["lifecycle"],testFiles:["packages/mem-core/test/extension-commands.test.ts"]},{id:"link-world",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0,resourceDiscovery:!0,testContracts:["external-process","resource-discovery"],testFiles:["test/link-world-extension-registration.test.ts"]},{id:"browser",category:"optional",defaultEnabled:!1,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0,resourceDiscovery:!0,testContracts:["external-process","resource-discovery"],testFiles:["test/browser-extension-registration.test.ts"]},{id:"security-audit",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"soul",category:"default",defaultEnabled:!0,riskLevel:"passive",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"presence",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!0,startsTimers:!0,writesWorkspace:!1,externalProcess:!1,testContracts:["lifecycle"],testFiles:["test/presence-opening.test.ts","test/presence-locale.test.ts"]},{id:"ask-user-question",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!0,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"teach",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!0,externalProcess:!1},{id:"grub",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0,testContracts:["lifecycle","external-process"],testFiles:["test/grub-controller.test.ts"]},{id:"goal",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1,testContracts:["lifecycle"],testFiles:["test/goal-controller.test.ts"]},{id:"loop",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!0,writesWorkspace:!1,externalProcess:!1,testContracts:["lifecycle"],testFiles:["test/loop-lifecycle.test.ts"]},{id:"plan",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"discipline",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1,resourceDiscovery:!0,testContracts:["resource-discovery"],testFiles:["test/discipline-extension.test.ts","test/extension-smoke.test.ts"]},{id:"subagent",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0,testContracts:["external-process"],testFiles:["test/subagent-parser.test.ts","test/worktree-manager.test.ts"]},{id:"team",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0,testContracts:["lifecycle","external-process"],testFiles:["test/team-runtime.test.ts"]},{id:"idle-think",category:"default",defaultEnabled:!0,riskLevel:"background",requiresUI:!0,startsTimers:!0,writesWorkspace:!1,externalProcess:!0,testContracts:["lifecycle","external-process"],testFiles:["test/idle-think-runtime.test.ts","test/extension-smoke.test.ts"]},{id:"btw",category:"default",defaultEnabled:!0,riskLevel:"command",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"recap",category:"default",defaultEnabled:!0,riskLevel:"command",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"debug",category:"default",defaultEnabled:!0,riskLevel:"command",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!1},{id:"mcp",category:"default",defaultEnabled:!0,riskLevel:"command",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0,resourceDiscovery:!0,testContracts:["external-process","resource-discovery"],testFiles:["test/resource-discovery-contract.test.ts"]},{id:"task",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!0,externalProcess:!1},{id:"lsp",category:"default",defaultEnabled:!0,riskLevel:"tool",requiresUI:!1,startsTimers:!1,writesWorkspace:!1,externalProcess:!0},{id:"insights",category:"default",defaultEnabled:!0,riskLevel:"command",requiresUI:!1,startsTimers:!1,writesWorkspace:!0,externalProcess:!1},{id:"simplify",category:"optional",defaultEnabled:!1,riskLevel:"write-capable",requiresUI:!1,startsTimers:!1,writesWorkspace:!0,externalProcess:!0,testContracts:["external-process","write-guard"],testFiles:["test/simplify-extension.test.ts"]},{id:"export-html",category:"optional",defaultEnabled:!1,riskLevel:"write-capable",requiresUI:!1,startsTimers:!1,writesWorkspace:!0,externalProcess:!1,testContracts:["write-guard"],testFiles:["test/extension-smoke.test.ts","test/export-html-branch-navigation.test.ts"]}];function G(s){let e=s;for(let n=0;n<20;n++){try{const o=i(e,"package.json");if(t(o)){const j=X(o,"utf-8"),u=JSON.parse(j);if(u.name==="@catui/agent"||u.name==="catui-agent")return e}}catch{}const a=c(e);if(a===e)break;e=a}return null}l(G,"findPackageRoot");function B(){const s=[];if(t(g))s.push(g);else{const e=i(r,"extensions","builtin","diagnostics","index.ts");t(e)&&s.push(e)}if(t(h))s.push(h);else{const e=i(r,"extensions","builtin","sal","index.ts");t(e)&&s.push(e)}if(t(I))s.push(I);else{const e=i(r,"extensions","builtin","token-save","index.ts");t(e)&&s.push(e)}if(t(f))s.push(f);else{const e=i(r,"packages","mem-core","src","extension.ts");if(t(e))s.push(e);else try{const n=R.resolve("catui-mem/extension.js");t(n)&&s.push(n)}catch{const n=G(r);if(n){const a=i(n,"node_modules","catui-mem","dist","extension.js");t(a)&&s.push(a)}}}if(t(d))s.push(d);else{const e=i(r,"extensions","builtin","link-world","index.ts");t(e)&&s.push(e)}if(t(x))s.push(x);else{const e=i(r,"extensions","builtin","security-audit","index.ts");t(e)&&s.push(e)}if(t(p))s.push(p);else{const e=i(r,"extensions","builtin","soul","index.ts");t(e)&&s.push(e)}if(t(E))s.push(E);else{const e=i(r,"extensions","builtin","presence","index.ts");t(e)&&s.push(e)}if(t(b))s.push(b);else{const e=i(r,"extensions","builtin","ask-user-question","index.ts");t(e)&&s.push(e)}if(t(k))s.push(k);else{const e=i(r,"extensions","builtin","teach","index.ts");t(e)&&s.push(e)}if(t(L))s.push(L);else{const e=i(r,"extensions","builtin","grub","index.ts");t(e)&&s.push(e)}if(t(U))s.push(U);else{const e=i(r,"extensions","builtin","goal","index.ts");t(e)&&s.push(e)}if(t(T))s.push(T);else{const e=i(r,"extensions","builtin","loop","index.ts");t(e)&&s.push(e)}if(t(m))s.push(m);else{const e=i(r,"extensions","builtin","plan","index.ts");t(e)&&s.push(e)}if(t(N))s.push(N);else{const e=i(r,"extensions","builtin","discipline","index.ts");t(e)&&s.push(e)}if(t(D))s.push(D);else{const e=i(r,"extensions","builtin","subagent","index.ts");t(e)&&s.push(e)}if(t(_))s.push(_);else{const e=i(r,"extensions","builtin","team","index.ts");t(e)&&s.push(e)}if(t(y))s.push(y);else{const e=i(r,"extensions","builtin","idle-think","index.ts");t(e)&&s.push(e)}if(t(S))s.push(S);else{const e=i(r,"extensions","builtin","btw","index.ts");t(e)&&s.push(e)}if(t(v))s.push(v);else{const e=i(r,"extensions","builtin","recap","index.ts");t(e)&&s.push(e)}if(t(w))s.push(w);else{const e=i(r,"extensions","builtin","debug","index.ts");t(e)&&s.push(e)}if(t(P))s.push(P);else{const e=i(r,"extensions","builtin","mcp","index.ts");t(e)&&s.push(e)}if(t(O))s.push(O);else{const e=i(r,"extensions","builtin","task","index.ts");t(e)&&s.push(e)}if(t(q))s.push(q);else{const e=i(r,"extensions","builtin","lsp","index.ts");t(e)&&s.push(e)}if(t(W))s.push(W);else{const e=i(r,"extensions","builtin","insights","index.ts");t(e)&&s.push(e)}return s}l(B,"getBuiltinExtensionPaths");function Y(){return B()}l(Y,"getNanopencilDefaultExtensionPaths");function z(){return B()}l(z,"getCatuiDefaultExtensionPaths");export{V as builtInExtensions,B as getBuiltinExtensionPaths,z as getCatuiDefaultExtensionPaths,Y as getNanopencilDefaultExtensionPaths};