openvibe 0.58.3 → 0.60.0

package/README.md

@@ -1,159 +1,328 @@
 # OpenVibe
 
-OpenVibe 是一个专业的 AI 编程助手，为开发者提供智能的代码编辑、文件管理和项目协作功能。
+[**中文文档**](./README_CN.md) | English
 
-## 安装
+OpenVibe is a professional AI coding assistant that provides intelligent code editing, file management, and project collaboration features for developers.
+
+## Installation
 
 ```bash
 npm install -g openvibe
 ```
 
-## 快速开始
+## Quick Start
 
-### 首次配置
+### Initial Configuration
 
-运行 OpenVibe 后，系统将引导你完成初始配置：
+After running OpenVibe, the system will guide you through the initial setup:
 
 ```bash
 openvibe
 ```
 
-你需要提供：
-- **API 地址**: 你的 AI 服务接口地址
-- **API 密钥**: 访问 AI 服务的密钥
-- **模型名称**: 使用的 AI 模型名称
+You will need to provide:
+- **API URL**: Your AI service endpoint address
+- **API Key**: The key to access the AI service
+- **Model Name**: The AI model name to use
 
-### 基本用法
+### Basic Usage
 
 ```bash
-# 启动交互式会话
+# Start an interactive session
 openvibe
 
-# 直接执行指令
-openvibe "分析当前项目的代码结构"
+# Execute a command directly
+openvibe "Analyze the code structure of the current project"
 
-# 处理文件
-openvibe -f src/main.ts "优化这段代码"
+# Process files
+openvibe -f src/main.ts "Optimize this code"
 ```
 
-## 核心功能
-
-- **智能代码编辑**: 基于 AI 的代码分析、重构和生成
-- **文件操作工具**: read、write、edit、bash、grep、find 等
-- **会话管理**: 保存和恢复对话历史
-- **扩展系统**: 自定义功能扩展
-- **交互式终端界面**: 直观的 TUI 操作体验
-
-## 配置说明
-
-配置文件位于 `~/.openvibe/config.json`：
-
-```json
-{
-  "apiUrl": "https://api.example.com/v1/chat/completions",
-  "apiKey": "your-api-key",
-  "model": "your-model-name"
-}
-```
-
-## 命令行选项
-
-```
-Usage: openvibe [options] [prompt]
+## Core Features
+
+### Built-in Tools
+
+OpenVibe includes the following built-in tools:
+
+| Tool | Description |
+|------|-------------|
+| `read` | Read file contents (supports text and images) |
+| `write` | Write content to files (creates or overwrites) |
+| `edit` | Edit files with precise text replacement |
+| `bash` | Execute shell commands |
+| `grep` | Search file contents with regex support |
+| `find` | Find files by name pattern |
+| `ls` | List directory contents |
+| `truncate` | Truncate large outputs |
+
+### Slash Commands
+
+OpenVibe provides powerful slash commands for session management:
+
+| Command | Description |
+|---------|-------------|
+| `/settings` | Open settings menu |
+| `/export` | Export session to HTML file |
+| `/share` | Share session as a secret GitHub gist |
+| `/copy` | Copy last agent message to clipboard |
+| `/name` | Set session display name |
+| `/session` | Show session info and stats |
+| `/changelog` | Show changelog entries |
+| `/hotkeys` | Show all keyboard shortcuts |
+| `/fork` | Create a new fork from a previous message |
+| `/tree` | Navigate session tree (switch branches) |
+| `/new` | Start a new session |
+| `/compact` | Manually compact the session context |
+| `/resume` | Resume a different session |
+| `/reload` | Reload extensions, skills, prompts, and themes |
+| `/skills` | Browse and invoke available skills |
+| `/think` | Set thinking level (off/minimal/low/medium/high/xhigh) |
+| `/quit` | Quit OpenVibe |
+
+### Session Management
+
+- **Auto-save**: Sessions are automatically saved in JSONL format
+- **Resume**: Continue previous conversations anytime
+- **Fork**: Create branches from any point in the conversation
+- **Tree Navigation**: Navigate and switch between conversation branches
+- **History**: View and manage all historical sessions
+
+### Context Compaction
+
+Automatically compresses conversation history to save tokens:
+- **Auto-compaction**: Triggers when context overflows
+- **Manual compaction**: Use `/compact` command
+- **Smart summarization**: Preserves important information
+- **Token budget management**: Configurable reserve and keep tokens
+
+### Skills System
+
+Skills are specialized knowledge files that provide expert guidance:
+- Load domain-specific expertise
+- Support for user, project, and path-scoped skills
+- Markdown format with frontmatter
+- Compatible with Claude skills directory
+
+**Supported Skill Directories:**
+
+| Location | Type | Priority |
+|----------|------|----------|
+| `~/.openvibe/skills/` | Global | High |
+| `~/.agents/skills/` | Global (Agent Skills standard) | Medium |
+| `~/.claude/skills/` | Global (Claude compatible) | Medium |
+| `~/.codex/skills/` | Global (Codex compatible) | Medium |
+| `.openvibe/skills/` | Project | High |
+| `.agents/skills/` | Project | Medium |
+| `.claude/skills/` | Project | Medium |
+
+**Usage:**
+```bash
+# List and select skills interactively
+/skills
 
-Options:
-  -f, --file <path>       包含文件路径
-  -c, --context <path>    添加上下文文件/目录
-  --no-onboarding         跳过引导配置
-  -h, --help             显示帮助信息
-  -v, --version          显示版本号
+# Invoke a specific skill directly
+/skill:code-review
 ```
 
-## 工具功能
+### Prompt Templates
 
-OpenVibe 内置以下工具：
+Create reusable prompt templates:
+- User and project-scoped templates
+- Argument substitution support (`$1`, `$2`, `$ARGUMENTS`)
+- Markdown format with description frontmatter
+- Quick access via `/template-name` syntax
 
-| 工具 | 描述 |
-|------|------|
-| `read` | 读取文件内容 |
-| `write` | 写入文件内容 |
-| `edit` | 编辑文件（精确替换） |
-| `bash` | 执行 shell 命令 |
-| `grep` | 搜索文件内容 |
-| `find` | 查找文件 |
-| `ls` | 列出目录内容 |
+### Extension System
 
-## 交互式快捷键
-
-在交互模式下：
-
-| 快捷键 | 功能 |
-|--------|------|
-| `Ctrl+C` | 退出程序 |
-| `Ctrl+D` | 结束输入 |
-| `Ctrl+L` | 清屏 |
-| `Tab` | 自动补全 |
-
-## 扩展开发
-
-OpenVibe 支持 TypeScript 扩展，示例：
+Build powerful TypeScript extensions:
 
 ```typescript
 import { defineExtension } from 'openvibe';
 
 export default defineExtension({
   name: 'my-extension',
-  setup({ onMessage }) {
+  setup({ onMessage, registerTool, registerCommand }) {
+    // Subscribe to messages
     onMessage((message) => {
-      console.log('收到消息:', message);
+      console.log('Received:', message);
+    });
+    
+    // Register custom tools
+    registerTool({
+      name: 'myTool',
+      description: 'A custom tool',
+      parameters: { ... },
+      handler: async (args) => { ... }
+    });
+    
+    // Register commands
+    registerCommand({
+      name: 'myCommand',
+      description: 'A custom command',
+      handler: async (args) => { ... }
     });
   }
 });
 ```
 
-## 历史记录
+Extension capabilities:
+- Register LLM-callable tools
+- Register slash commands and keyboard shortcuts
+- Create custom UI components
+- Subscribe to agent lifecycle events
+- Access session and model information
+
+### Theme System
+
+Customize the appearance:
+- Built-in dark and light themes
+- Custom theme support via JSON files
+- Export colors for HTML generation
+- Dynamic theme switching
+
+### Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Esc` | Interrupt current operation |
+| `Ctrl+C` | Clear input / Cancel |
+| `Ctrl+D` | Exit |
+| `Ctrl+Z` | Suspend |
+| `Shift+Tab` | Cycle thinking level |
+| `Ctrl+P` | Cycle model forward |
+| `Ctrl+L` | Model selector |
+| `Ctrl+O` | Expand/collapse tools |
+| `Ctrl+T` | Toggle thinking block |
+| `Ctrl+G` | Open external editor |
+| `Alt+Enter` | Queue follow-up message |
+| `Ctrl+V` | Paste image from clipboard |
+
+### HTML Export
+
+Export sessions to standalone HTML files:
+- Full conversation history with syntax highlighting
+- Tool execution details
+- Customizable themes
+- Share via GitHub Gist
+
+### Additional Features
+
+- **1M Context Window**: Full support for 1 million token context window via provider configuration
+- **Multi-GPU Support**: Distribute workloads across GPUs
+- **Auto Retry**: Automatic retry on API failures with configurable delays
+- **Image Support**: Paste and process images from clipboard
+- **Git Integration**: Display current branch in status bar
+- **RPC Mode**: Remote procedure call support for integration
+- **Onboarding Wizard**: Guided initial setup
+- **Response Acceleration**: Streaming optimizations for faster responses
+
+## Configuration
+
+Configuration file located at `~/.openvibe/config.json`:
 
-OpenVibe 自动保存所有会话历史，方便你随时回顾和继续之前的对话。
+```json
+{
+  "apiUrl": "https://api.example.com/v1/chat/completions",
+  "apiKey": "your-api-key",
+  "model": "your-model-name"
+}
+```
 
-### 查看历史
+### Settings
 
-```bash
-# 列出所有历史会话
-openvibe --history
+Global and project-level settings in `~/.openvibe/settings.json`:
 
-# 查看特定会话
-openvibe --session <session-id>
+```json
+{
+  "theme": "dark",
+  "defaultThinkingLevel": "medium",
+  "compaction": {
+    "enabled": true,
+    "reserveTokens": 16384,
+    "keepRecentTokens": 20000
+  },
+  "retry": {
+    "enabled": true,
+    "maxRetries": 3
+  },
+  "enableSkillCommands": true
+}
 ```
 
-### 历史文件位置
+### 1M Context Window Configuration
 
-历史记录保存在 `~/.openvibe/sessions/` 目录下，每个会话以 JSONL 格式存储。
+OpenVibe supports models with 1 million token context window through an independent **Context Architecture**:
 
-### 快捷键
+```typescript
+// Using the Context Architecture API
+import { 
+  getContextProviderRegistry, 
+  enhanceModelContext,
+  LargeContextProvider 
+} from 'openvibe';
+
+// Enhance any model with large context
+const enhancedModel = enhanceModelContext(model);
+
+// Or register a custom model with 1M context
+const provider = new LargeContextProvider();
+provider.registerCustomModel('my-custom-model', {
+  contextWindow: 1000000,
+  maxTokens: 65536,
+  supportsVision: true
+});
+```
+
+**Supported Models with 1M Context:**
+- Google Gemini 1.5 Pro/Flash
+- Google Gemini 2.0 Flash/Pro
+- Alibaba Qwen-Max
+- Moonshot Kimi (128K)
+
+**Architecture Components:**
+- `IContextProvider` - Interface for custom context providers
+- `LargeContextProvider` - Built-in provider with 50+ model definitions
+- `ContextProviderRegistry` - Central registry for managing providers
+- `ContextManager` - Configuration-based alternative API
+```
+
+## Command Line Options
 
-在交互模式下管理历史：
+```
+Usage: openvibe [options] [prompt]
+
+Options:
+  -f, --file <path>       Include file path
+  -c, --context <path>    Add context file/directory
+  --no-onboarding         Skip onboarding configuration
+  -h, --help              Display help information
+  -v, --version           Display version number
+```
 
-| 快捷键 | 功能 |
-|--------|------|
-| `Ctrl+R` | 打开历史会话选择器 |
-| `Ctrl+S` | 保存当前会话 |
-| `Ctrl+Shift+S` | 重命名当前会话 |
+## Documentation
 
-- [扩展开发指南](docs/extensions.md)
-- [SDK 文档](docs/sdk.md)
-- [主题定制](docs/themes.md)
-- [快捷键配置](docs/keybindings.md)
+- [Extension Development Guide](docs/extensions.md)
+- [SDK Documentation](docs/sdk.md)
+- [Theme Customization](docs/themes.md)
+- [Keybinding Configuration](docs/keybindings.md)
+- [Skills System](docs/skills.md)
+- [Prompt Templates](docs/prompt-templates.md)
+- [Session Management](docs/session.md)
+- [Context Compaction](docs/compaction.md)
+- [Custom Providers](docs/custom-provider.md)
+- [TUI Components](docs/tui.md)
+- [RPC Integration](docs/rpc.md)
 
-## 系统要求
+## System Requirements
 
 - Node.js >= 18.0.0
 - npm >= 9.0.0
 
-## 许可证
+## License
 
 MIT
 
-## 相关链接
+## Links
 
-- [npm 包](https://www.npmjs.com/package/openvibe)
-- [问题反馈](https://github.com/boxiaolanya2008/openvibe/issues)
+- [npm Package](https://www.npmjs.com/package/openvibe)
+- [Issue Tracker](https://github.com/boxiaolanya2008/openvibe/issues)

package/dist/core/agent-modes.d.ts

@@ -0,0 +1,16 @@
+export type AgentMode = "default" | "plan" | "spec";
+export interface AgentModeConfig {
+    name: string;
+    description: string;
+    systemPromptAddition: string;
+    tools: string[];
+    thinkingLevel: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+}
+export declare const AGENT_MODES: Record<AgentMode, AgentModeConfig>;
+export declare function getAgentModeConfig(mode: AgentMode): AgentModeConfig;
+export declare function getModePromptAddition(mode: AgentMode): string;
+export declare function getModeTools(mode: AgentMode): string[];
+export declare function getModeThinkingLevel(mode: AgentMode): "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export declare function getAllModes(): AgentMode[];
+export declare function getClaudeSkillsPath(): string;
+//# sourceMappingURL=agent-modes.d.ts.map

package/dist/core/agent-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-modes.d.ts","sourceRoot":"","sources":["../../src/core/agent-modes.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACvE;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,eAAe,CAkE1D,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAEtD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAE7G;AAED,wBAAgB,WAAW,IAAI,SAAS,EAAE,CAEzC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C","sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport type AgentMode = \"default\" | \"plan\" | \"spec\";\n\nexport interface AgentModeConfig {\n\tname: string;\n\tdescription: string;\n\tsystemPromptAddition: string;\n\ttools: string[];\n\tthinkingLevel: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\";\n}\n\nexport const AGENT_MODES: Record<AgentMode, AgentModeConfig> = {\n\tdefault: {\n\t\tname: \"Default\",\n\t\tdescription: \"Standard coding assistant mode with full tool access\",\n\t\tsystemPromptAddition: ``,\n\t\ttools: [\"read\", \"bash\", \"edit\", \"write\", \"grep\", \"find\", \"ls\"],\n\t\tthinkingLevel: \"off\",\n\t},\n\tplan: {\n\t\tname: \"Plan\",\n\t\tdescription: \"Planning mode focused on analysis and design. Read-only tools, high reasoning.\",\n\t\tsystemPromptAddition: `\nYou are in **Planning Mode**. Your role is to analyze, design, and create detailed plans.\n\n**Guidelines for Planning Mode:**\n1. Focus on understanding the problem thoroughly before proposing solutions\n2. Break down complex tasks into manageable steps\n3. Consider edge cases, error handling, and potential issues\n4. Provide clear, actionable implementation plans\n5. Use high-level reasoning to explore multiple approaches\n6. Document dependencies and prerequisites\n7. Identify risks and mitigation strategies\n8. Create clear milestones and deliverables\n\n**Output Format:**\n- Start with a brief problem analysis\n- Present the approach with rationale\n- Provide step-by-step implementation plan\n- Include consideration of alternatives\n- End with a summary of key decisions\n\nYou have read-only access to tools. You cannot modify files directly.\n`,\n\t\ttools: [\"read\", \"bash\", \"grep\", \"find\", \"ls\"],\n\t\tthinkingLevel: \"high\",\n\t},\n\tspec: {\n\t\tname: \"Specification\",\n\t\tdescription: \"Specification mode for creating detailed technical specs. Read-only tools, maximum reasoning.\",\n\t\tsystemPromptAddition: `\nYou are in **Specification Mode**. Your role is to create detailed technical specifications.\n\n**Guidelines for Specification Mode:**\n1. Produce comprehensive technical documentation\n2. Define clear interfaces, data structures, and contracts\n3. Specify behavior, constraints, and invariants\n4. Include error conditions and recovery procedures\n5. Define testing requirements and acceptance criteria\n6. Document performance requirements and constraints\n7. Specify security considerations\n8. Create API contracts and data models\n\n**Output Format:**\n- Overview and objectives\n- Detailed specifications with types and constraints\n- Interface definitions\n- Behavior specifications\n- Error handling specifications\n- Testing requirements\n- Implementation notes\n\nYou have read-only access to tools. You cannot modify files directly.\n`,\n\t\ttools: [\"read\", \"bash\", \"grep\", \"find\", \"ls\"],\n\t\tthinkingLevel: \"xhigh\",\n\t},\n};\n\nexport function getAgentModeConfig(mode: AgentMode): AgentModeConfig {\n\treturn AGENT_MODES[mode];\n}\n\nexport function getModePromptAddition(mode: AgentMode): string {\n\treturn AGENT_MODES[mode].systemPromptAddition;\n}\n\nexport function getModeTools(mode: AgentMode): string[] {\n\treturn AGENT_MODES[mode].tools;\n}\n\nexport function getModeThinkingLevel(mode: AgentMode): \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" {\n\treturn AGENT_MODES[mode].thinkingLevel;\n}\n\nexport function getAllModes(): AgentMode[] {\n\treturn [\"default\", \"plan\", \"spec\"];\n}\n\nexport function getClaudeSkillsPath(): string {\n\treturn join(homedir(), \".claude\", \"skills\");\n}\n"]}

package/dist/core/agent-modes.js

@@ -0,0 +1,88 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const AGENT_MODES = {
+    default: {
+        name: "Default",
+        description: "Standard coding assistant mode with full tool access",
+        systemPromptAddition: ``,
+        tools: ["read", "bash", "edit", "write", "grep", "find", "ls"],
+        thinkingLevel: "off",
+    },
+    plan: {
+        name: "Plan",
+        description: "Planning mode focused on analysis and design. Read-only tools, high reasoning.",
+        systemPromptAddition: `
+You are in **Planning Mode**. Your role is to analyze, design, and create detailed plans.
+
+**Guidelines for Planning Mode:**
+1. Focus on understanding the problem thoroughly before proposing solutions
+2. Break down complex tasks into manageable steps
+3. Consider edge cases, error handling, and potential issues
+4. Provide clear, actionable implementation plans
+5. Use high-level reasoning to explore multiple approaches
+6. Document dependencies and prerequisites
+7. Identify risks and mitigation strategies
+8. Create clear milestones and deliverables
+
+**Output Format:**
+- Start with a brief problem analysis
+- Present the approach with rationale
+- Provide step-by-step implementation plan
+- Include consideration of alternatives
+- End with a summary of key decisions
+
+You have read-only access to tools. You cannot modify files directly.
+`,
+        tools: ["read", "bash", "grep", "find", "ls"],
+        thinkingLevel: "high",
+    },
+    spec: {
+        name: "Specification",
+        description: "Specification mode for creating detailed technical specs. Read-only tools, maximum reasoning.",
+        systemPromptAddition: `
+You are in **Specification Mode**. Your role is to create detailed technical specifications.
+
+**Guidelines for Specification Mode:**
+1. Produce comprehensive technical documentation
+2. Define clear interfaces, data structures, and contracts
+3. Specify behavior, constraints, and invariants
+4. Include error conditions and recovery procedures
+5. Define testing requirements and acceptance criteria
+6. Document performance requirements and constraints
+7. Specify security considerations
+8. Create API contracts and data models
+
+**Output Format:**
+- Overview and objectives
+- Detailed specifications with types and constraints
+- Interface definitions
+- Behavior specifications
+- Error handling specifications
+- Testing requirements
+- Implementation notes
+
+You have read-only access to tools. You cannot modify files directly.
+`,
+        tools: ["read", "bash", "grep", "find", "ls"],
+        thinkingLevel: "xhigh",
+    },
+};
+export function getAgentModeConfig(mode) {
+    return AGENT_MODES[mode];
+}
+export function getModePromptAddition(mode) {
+    return AGENT_MODES[mode].systemPromptAddition;
+}
+export function getModeTools(mode) {
+    return AGENT_MODES[mode].tools;
+}
+export function getModeThinkingLevel(mode) {
+    return AGENT_MODES[mode].thinkingLevel;
+}
+export function getAllModes() {
+    return ["default", "plan", "spec"];
+}
+export function getClaudeSkillsPath() {
+    return join(homedir(), ".claude", "skills");
+}
+//# sourceMappingURL=agent-modes.js.map

package/dist/core/agent-modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-modes.js","sourceRoot":"","sources":["../../src/core/agent-modes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC,MAAM,CAAC,MAAM,WAAW,GAAuC;IAC9D,OAAO,EAAE;QACR,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sDAAsD;QACnE,oBAAoB,EAAE,EAAE;QACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC9D,aAAa,EAAE,KAAK;KACpB;IACD,IAAI,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gFAAgF;QAC7F,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBvB;QACC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC7C,aAAa,EAAE,MAAM;KACrB;IACD,IAAI,EAAE;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,+FAA+F;QAC5G,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBvB;QACC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC7C,aAAa,EAAE,OAAO;KACtB;CACD,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAAe,EAAmB;IACpE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAAA,CACzB;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAe,EAAU;IAC9D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC;AAAA,CAC9C;AAED,MAAM,UAAU,YAAY,CAAC,IAAe,EAAY;IACvD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;AAAA,CAC/B;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAA2D;IAC9G,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC;AAAA,CACvC;AAED,MAAM,UAAU,WAAW,GAAgB;IAC1C,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAAA,CACnC;AAED,MAAM,UAAU,mBAAmB,GAAW;IAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAAA,CAC5C","sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport type AgentMode = \"default\" | \"plan\" | \"spec\";\n\nexport interface AgentModeConfig {\n\tname: string;\n\tdescription: string;\n\tsystemPromptAddition: string;\n\ttools: string[];\n\tthinkingLevel: \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\";\n}\n\nexport const AGENT_MODES: Record<AgentMode, AgentModeConfig> = {\n\tdefault: {\n\t\tname: \"Default\",\n\t\tdescription: \"Standard coding assistant mode with full tool access\",\n\t\tsystemPromptAddition: ``,\n\t\ttools: [\"read\", \"bash\", \"edit\", \"write\", \"grep\", \"find\", \"ls\"],\n\t\tthinkingLevel: \"off\",\n\t},\n\tplan: {\n\t\tname: \"Plan\",\n\t\tdescription: \"Planning mode focused on analysis and design. Read-only tools, high reasoning.\",\n\t\tsystemPromptAddition: `\nYou are in **Planning Mode**. Your role is to analyze, design, and create detailed plans.\n\n**Guidelines for Planning Mode:**\n1. Focus on understanding the problem thoroughly before proposing solutions\n2. Break down complex tasks into manageable steps\n3. Consider edge cases, error handling, and potential issues\n4. Provide clear, actionable implementation plans\n5. Use high-level reasoning to explore multiple approaches\n6. Document dependencies and prerequisites\n7. Identify risks and mitigation strategies\n8. Create clear milestones and deliverables\n\n**Output Format:**\n- Start with a brief problem analysis\n- Present the approach with rationale\n- Provide step-by-step implementation plan\n- Include consideration of alternatives\n- End with a summary of key decisions\n\nYou have read-only access to tools. You cannot modify files directly.\n`,\n\t\ttools: [\"read\", \"bash\", \"grep\", \"find\", \"ls\"],\n\t\tthinkingLevel: \"high\",\n\t},\n\tspec: {\n\t\tname: \"Specification\",\n\t\tdescription: \"Specification mode for creating detailed technical specs. Read-only tools, maximum reasoning.\",\n\t\tsystemPromptAddition: `\nYou are in **Specification Mode**. Your role is to create detailed technical specifications.\n\n**Guidelines for Specification Mode:**\n1. Produce comprehensive technical documentation\n2. Define clear interfaces, data structures, and contracts\n3. Specify behavior, constraints, and invariants\n4. Include error conditions and recovery procedures\n5. Define testing requirements and acceptance criteria\n6. Document performance requirements and constraints\n7. Specify security considerations\n8. Create API contracts and data models\n\n**Output Format:**\n- Overview and objectives\n- Detailed specifications with types and constraints\n- Interface definitions\n- Behavior specifications\n- Error handling specifications\n- Testing requirements\n- Implementation notes\n\nYou have read-only access to tools. You cannot modify files directly.\n`,\n\t\ttools: [\"read\", \"bash\", \"grep\", \"find\", \"ls\"],\n\t\tthinkingLevel: \"xhigh\",\n\t},\n};\n\nexport function getAgentModeConfig(mode: AgentMode): AgentModeConfig {\n\treturn AGENT_MODES[mode];\n}\n\nexport function getModePromptAddition(mode: AgentMode): string {\n\treturn AGENT_MODES[mode].systemPromptAddition;\n}\n\nexport function getModeTools(mode: AgentMode): string[] {\n\treturn AGENT_MODES[mode].tools;\n}\n\nexport function getModeThinkingLevel(mode: AgentMode): \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" {\n\treturn AGENT_MODES[mode].thinkingLevel;\n}\n\nexport function getAllModes(): AgentMode[] {\n\treturn [\"default\", \"plan\", \"spec\"];\n}\n\nexport function getClaudeSkillsPath(): string {\n\treturn join(homedir(), \".claude\", \"skills\");\n}\n"]}

package/dist/core/agent-session.d.ts

@@ -24,6 +24,7 @@ import type { ResourceLoader } from "./resource-loader.js";
 import type { BranchSummaryEntry, SessionManager } from "./session-manager.js";
 import type { SettingsManager } from "./settings-manager.js";
 import type { BashOperations } from "./tools/bash.js";
+import type { AgentMode } from "./agent-modes.js";
 /** Parsed skill block from a user message */
 export interface ParsedSkillBlock {
     name: string;
@@ -84,6 +85,8 @@ export interface AgentSessionConfig {
     extensionRunnerRef?: {
         current?: ExtensionRunner;
     };
+    /** Initial agent mode. Default: "default" */
+    initialMode?: AgentMode;
 }
 export interface ExtensionBindings {
     uiContext?: ExtensionUIContext;
@@ -170,6 +173,7 @@ export declare class AgentSession {
     private _toolPromptSnippets;
     private _toolPromptGuidelines;
     private _baseSystemPrompt;
+    private _mode;
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
@@ -216,6 +220,28 @@ export declare class AgentSession {
     get model(): Model<any> | undefined;
     /** Current thinking level */
     get thinkingLevel(): ThinkingLevel;
+    /** Current agent mode */
+    get mode(): AgentMode;
+    /**
+     * Set agent mode.
+     * Updates tools, thinking level, and system prompt based on the mode.
+     */
+    setMode(mode: AgentMode): void;
+    /**
+     * Cycle to next agent mode.
+     * @returns New mode name
+     */
+    cycleMode(): AgentMode;
+    /**
+     * Set the model for the agent.
+     * Updates thinking level based on model capabilities.
+     */
+    setModel(model: Model<any>): Promise<void>;
+    /**
+     * Cycle to next model in scoped models list.
+     * @returns Model cycle result or undefined if no scoped models
+     */
+    cycleModel(): Promise<ModelCycleResult | undefined>;
     /** Whether agent is currently streaming a response */
     get isStreaming(): boolean;
     /** Current effective system prompt (includes any per-turn extension modifications) */