codegrunt 0.1.0

package/README.md

@@ -0,0 +1,351 @@
+# CodeGrunt <small>（代码民工）</small>
+
+<p align="center">
+  <img src="./assets/logo.png" alt="CodeGrunt Logo" width="50%" />
+</p>
+
+> **代码民工** — 终端原生的 AI 命令行编程助手，基于 DeepSeek 构建。
+
+[![npm version](https://img.shields.io/npm/v/codegrunt.svg)](https://www.npmjs.com/package/codegrunt)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
+
+CodeGrunt 是一个开源的终端原生 AI 编程助手。它能读懂你的代码库、理解上下文，帮助你在命令行中编写、重构、调试和交付代码。
+
+```bash
+# 交互式 REPL
+codegrunt
+
+# 单次任务
+codegrunt "把 auth 模块重构为 async/await"
+```
+
+---
+
+## 特性
+
+- **🤖 智能代理** — 使用 ReAct（推理 + 行动）循环，自主执行多步骤任务：读取文件、编辑代码、运行 Shell、搜索代码库
+- **📂 理解代码库** — 通过 `@` 文件引用和项目指南文件（`CODEGRUNT.md` / `CLAUDE.md`）理解你的项目结构、模块导入和编码约定
+- **🔌 DeepSeek 驱动** — 内置支持 DeepSeek Chat、V4 Flash、V4 Pro 和 R1 推理模型
+- **🛠️ 工具调用** — 6 个内置工具：文件读写/编辑、Shell 执行、目录列表、代码搜索，破坏性操作会显示 diff 预览并请求用户确认
+- **⚡ 流式输出** — 实时 Token 流式传输，支持 Markdown 渲染和推理过程可见，终端体验流畅
+- **📎 @-引用** — 使用 `@file.ts`、`@src/` 或 `@https://example.com` 将文件内容、目录列表或网页内容直接注入提示词
+- **🎯 斜杠命令** — `/init` 自动生成项目指南、`/model` 切换模型、`/compact` 压缩对话历史、`/review` 审查变更、`/skills` 管理技能等
+- **🔒 默认安全** — 破坏性操作（写入/编辑/Shell）显示 diff 预览并要求用户确认后执行
+- **🔧 技能系统** — 从 `.zip` 文件安装可复用的提示词模板，作为斜杠命令运行
+- **💲 费用追踪** — 使用 `/cost` 和 `/balance` 命令实时查看会话 Token 用量和费用
+
+---
+
+## 快速开始
+
+```bash
+# 全局安装
+npm install -g codegrunt
+
+# 设置 API 密钥
+export DEEPSEEK_API_KEY=your_key_here
+
+# 启动交互式会话
+codegrunt
+
+# 单次任务
+codegrunt "解释这个项目的架构"
+```
+
+首次运行且未配置 API 密钥时，CodeGrunt 会启动交互式设置向导引导你完成配置。
+
+---
+
+## 安装
+
+**环境要求：** Node.js 18+
+
+### npm（推荐）
+
+```bash
+npm install -g codegrunt
+```
+
+### pnpm
+
+```bash
+pnpm add -g codegrunt
+```
+
+### 从源码构建
+
+```bash
+git clone https://github.com/your-org/codegrunt.git
+cd codegrunt
+npm install
+npm run build
+npm link
+```
+
+---
+
+## 使用方法
+
+### 交互式 REPL
+
+```bash
+codegrunt
+```
+
+启动交互式会话，提供：
+
+- 显示当前模型的 ASCII 艺术横幅
+- `>` 提示符用于输入任务
+- 文件路径（`@`）和斜杠命令（`/`）的 Tab 补全
+- 多行输入支持
+- 方向键历史记录导航
+
+### 单次任务模式
+
+```bash
+codegrunt "你的任务描述"
+```
+
+执行单个任务后退出。适用于脚本编写和快速查询。
+
+### 斜杠命令
+
+| 命令 | 描述 |
+|---|---|
+| `/help` | 显示帮助信息和所有可用命令 |
+| `/model` | 交互式切换模型（方向键选择器） |
+| `/model <id>` | 切换到指定模型（例如 `/model deepseek-v4-pro`） |
+| `/init` | 分析代码库并生成 `CODEGRUNT.md` 项目指南 |
+| `/clear` | 清除对话上下文 |
+| `/compact` | 总结并压缩对话历史以节省 Token |
+| `/review` | 审查本次会话的变更是否有逻辑问题 |
+| `/cost` | 显示会话 Token 使用量和预估费用 |
+| `/balance` | 显示账户余额和用量（今日 / 本月） |
+| `/config` | 显示或修改配置设置 |
+| `/reasoning` / `/effort` | 设置 R1 模型的推理强度（low/medium/high） |
+| `/token` | 更新 DeepSeek API 密钥 |
+| `/skills` | 列出和管理技能（创建、列表） |
+| `/exit` | 退出 CodeGrunt |
+
+### @-引用
+
+在提示词中直接引用文件、目录或 URL：
+
+| 语法 | 描述 | 示例 |
+|---|---|---|
+| `@<文件>` | 注入文件内容 | `@src/index.ts` |
+| `@<目录>` | 注入目录列表（最多 20 条） | `@src/components/` |
+| `@<网址>` | 获取并注入网页内容 | `@https://example.com` |
+
+支持文件和目录路径的 Tab 补全。
+
+---
+
+## 配置
+
+CodeGrunt 通过环境变量或 `~/.codegrunt/config.json` 文件配置。
+
+### 环境变量
+
+| 变量 | 描述 | 默认值 |
+|---|---|---|
+| `DEEPSEEK_API_KEY` | DeepSeek API 密钥 | — |
+| `CODEGRUNT_MODEL` | 使用的模型 ID | `deepseek-v4-pro` |
+| `CODEGRUNT_PROVIDER` | LLM 提供商 | `deepseek` |
+| `CODEGRUNT_MAX_TOKENS` | 每次响应的最大 Token 数 | `8192` |
+| `CODEGRUNT_TEMPERATURE` | 响应温度 (0-2) | `0.2` |
+| `CODEGRUNT_BASE_URL` | 自定义 API 基础 URL | `https://api.deepseek.com` |
+| `CODEGRUNT_REASONING_EFFORT` | R1 推理强度：`low` \| `medium` \| `high` | `medium` |
+| `CODEGRUNT_TOP_P` | 核采样 (0-1) | `1` |
+| `CODEGRUNT_FREQUENCY_PENALTY` | 重复惩罚 (-2 到 2) | `0` |
+| `CODEGRUNT_PRESENCE_PENALTY` | 主题多样性惩罚 (-2 到 2) | `0` |
+
+### 配置文件 (`~/.codegrunt/config.json`)
+
+```json
+{
+  "apiKey": "sk-xxxxxxxx",
+  "model": "deepseek-v4-pro",
+  "maxTokens": 8192,
+  "temperature": 0.2,
+  "reasoningEffort": "medium",
+  "topP": 1,
+  "frequencyPenalty": 0,
+  "presencePenalty": 0
+}
+```
+
+配置文件在首次运行时通过设置向导自动生成。环境变量优先级高于配置文件。
+
+---
+
+## 支持的模型
+
+| 提供商 | 模型 | 状态 |
+|---|---|---|
+| [DeepSeek](https://platform.deepseek.com/) | `deepseek-chat`、`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-reasoner` | ✅ 支持 |
+
+---
+
+## 架构
+
+```
+codegrunt/
+├── src/
+│   ├── cli/                      # CLI 入口、REPL、参数解析
+│   │   ├── index.ts              # 入口（commander 驱动）
+│   │   ├── repl.ts               # 交互式 REPL 循环
+│   │   ├── input.ts              # 多行输入、Tab 补全、列表选择器
+│   │   ├── commands.ts           # 斜杠命令（/help, /model, /init 等）
+│   │   ├── setup.ts              # 首次运行设置向导
+│   │   ├── skills.ts             # 技能加载和管理
+│   │   ├── update.ts             # 版本检查和升级
+│   │   ├── banner.ts             # ASCII 艺术横幅
+│   │   └── at-resolver.ts        # @文件/@URL 引用展开
+│   ├── core/
+│   │   ├── agent/
+│   │   │   └── loop.ts           # 代理循环 — 核心 ReAct 推理/行动循环
+│   │   ├── tools/
+│   │   │   ├── registry.ts       # 工具注册和查找
+│   │   │   ├── executor.ts       # 工具执行（含用户确认）
+│   │   │   ├── read_file.ts      # 读取文件内容
+│   │   │   ├── write_file.ts     # 写入内容到文件
+│   │   │   ├── edit_file.ts      # 替换文件中的精确字符串
+│   │   │   ├── execute_shell.ts  # 运行 Shell 命令
+│   │   │   ├── list_directory.ts # 列出目录树
+│   │   │   └── search_files.ts   # 在文件中搜索文本
+│   │   └── context/
+│   │       ├── manager.ts        # 上下文窗口管理（Token 预算、裁剪）
+│   │       └── project-guide.ts  # 加载 CODEGRUNT.md / CLAUDE.md 项目指南
+│   ├── providers/
+│   │   └── deepseek/
+│   │       ├── provider.ts       # DeepSeek LLM 提供商实现
+│   │       └── client.ts         # OpenAI 兼容客户端工厂
+│   ├── utils/
+│   │   ├── display.ts            # 终端输出格式化
+│   │   ├── confirm.ts            # Diff 预览和用户确认
+│   │   ├── billing.ts            # 余额/用量查询和费用展示
+│   │   ├── markdown.ts           # 流式 Markdown 转终端渲染器
+│   │   └── interrupt.ts          # SIGINT 处理
+│   ├── config.ts                 # 配置加载（环境变量、配置文件）
+│   └── types.ts                  # 共享 TypeScript 类型和接口
+├── tests/
+│   ├── tools/
+│   │   ├── read_file.test.ts
+│   │   ├── write_file.test.ts
+│   │   └── execute_shell.test.ts
+├── docs/
+│   ├── development-guide.md      # 开发指南（英文）
+│   ├── development-guide.zh-CN.md # 开发者指南（中文）
+│   └── VERSION.md                # 发版流程指南
+├── package.json
+├── tsconfig.json
+├── vitest.config.ts
+├── CODEGRUNT.md                   # CodeGrunt 项目指南
+├── CLAUDE.md                     # AI 编码助手项目指南
+└── README.md                     # 本文件
+```
+
+### 整体流程
+
+```
+用户输入 (CLI / REPL)
+       │
+       ▼
+  ┌─────────────┐
+  │  代理循环    │ ◄──── LLM 提供商（流式）
+  │  (loop.ts)  │ ────► 工具执行
+  └──────┬──────┘
+         │
+    ┌────┴────┐
+    │  工具    │
+    │ (6 个)   │
+    └─────────┘
+```
+
+### 代理循环 (`src/core/agent/loop.ts`)
+
+代理循环是 CodeGrunt 的核心，遵循 ReAct（推理 + 行动）模式：
+
+1. **系统提示**在每次会话中构建一次（保持稳定以最大化提示缓存命中率）
+2. **用户消息**附加 `[cwd]` 和 `[date]` 前缀以提供上下文
+3. **流式响应**来自 LLM — 处理文本增量、推理增量和工具调用增量
+4. **如果收到工具调用**，执行每个工具并将结果反馈给 LLM
+5. **如果是文本响应**（finish_reason = "stop"），输出给用户并结束
+6. **循环**最多 30 次迭代以处理多步骤任务
+
+关键设计决策：
+
+- **系统提示稳定性**：系统提示只构建一次，会话期间不会更改。这最大化 DeepSeek 的提示缓存命中率。
+- **上下文管理**：`ContextManager` 跟踪 Token 使用情况，超出预算时裁剪旧消息。
+- **流式优先**：所有 LLM 通信通过 `AsyncIterable` 流式传输，实现实时终端输出。
+
+### 工具系统
+
+工具是 LLM 与用户环境交互的方式。每个工具实现 `Tool` 接口。
+
+| 工具 | 描述 |
+|---|---|
+| `read_file` | 读取文件内容（截断至 30,000 字符） |
+| `write_file` | 写入内容到文件（自动创建目录） |
+| `edit_file` | 替换文件中的精确字符串 |
+| `execute_shell` | 运行 Shell 命令（带超时） |
+| `list_directory` | 列出目录树（可配置深度） |
+| `search_files` | 在文件中搜索文本模式 |
+
+**安全机制**：在执行破坏性操作（`write_file`、`edit_file`、`execute_shell`）之前，执行器会显示 diff 预览并请求用户确认，提供三个选项：是、本次会话全部允许、否。
+
+### 上下文管理 (`src/core/context/manager.ts`)
+
+`ContextManager` 维护对话历史：
+
+- **Token 估算**：使用简单的 4:1 字符与 Token 比率
+- **裁剪**：当估算 Token 数超过预算时，移除最旧的非系统消息
+- **预算**：聊天模型默认 90,000 Token，推理模型 100,000 Token（1M 上下文窗口）
+
+### 提供商系统
+
+DeepSeek 提供商实现 `LLMProvider` 接口。`StreamChunk` 判别联合类型支持：
+
+- `text_delta` — 增量文本输出
+- `reasoning_delta` — 思维链推理（显示为 "Thinking..."）
+- `tool_call_delta` — 流式工具调用参数
+- `finish` — 流结束，包含结束原因
+
+---
+
+## 开发
+
+### 命令
+
+```bash
+npm run dev        # 开发模式，热重载 (tsx)
+npm run build      # 编译 TypeScript 到 dist/
+npm run typecheck  # 仅类型检查，不输出文件
+npm test           # 运行 vitest 测试套件
+npm start          # 运行编译后的 dist/cli/index.js
+
+# 运行单个测试文件
+npx vitest run tests/tools/read_file.test.ts
+```
+
+### 项目结构
+
+- `src/cli/` — 入口、REPL 循环、参数解析、技能、更新
+- `src/core/agent/` — 代理循环和任务规划
+- `src/core/tools/` — 文件读写、Shell 执行、搜索工具实现
+- `src/core/context/` — 上下文窗口管理和项目指南加载
+- `src/providers/` — LLM 提供商适配器，实现共享的 `LLMProvider` 接口
+- `src/utils/` — 共享工具（显示、确认、计费、Markdown、中断）
+
+详细开发说明请参阅：
+- [开发指南（英文）](docs/development-guide.md)
+- [开发者指南（中文）](docs/development-guide.zh-CN.md)
+
+---
+
+## 许可证
+
+MIT

package/dist/cli/at-resolver.d.ts

@@ -0,0 +1,10 @@
+export interface AtReference {
+    raw: string;
+    type: 'file' | 'directory' | 'url';
+    target: string;
+    content: string;
+}
+export declare function resolveAtReferences(input: string, cwd: string): Promise<{
+    expanded: string;
+    refs: AtReference[];
+}>;

package/dist/cli/at-resolver.js

@@ -0,0 +1,138 @@
+import { readFile, readdir, stat } from 'fs/promises';
+import { resolve, relative, join } from 'path';
+import chalk from 'chalk';
+const MAX_FILE_CHARS = 8000;
+const MAX_DIR_FILES = 20;
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', '.next', '__pycache__', '.cache']);
+// Match @something — file path, directory, or URL
+// Stops at whitespace. Supports quoted paths: @"path with spaces"
+const AT_PATTERN = /@(?:"([^"]+)"|(\S+))/g;
+export async function resolveAtReferences(input, cwd) {
+    const matches = [...input.matchAll(AT_PATTERN)];
+    if (matches.length === 0)
+        return { expanded: input, refs: [] };
+    const refs = [];
+    for (const match of matches) {
+        const raw = match[0];
+        const target = match[1] ?? match[2]; // quoted or unquoted
+        const ref = await resolveOne(raw, target, cwd);
+        if (ref)
+            refs.push(ref);
+    }
+    // Replace @tokens with a placeholder; append expanded content at the end
+    let expanded = input;
+    const attachments = [];
+    for (const ref of refs) {
+        expanded = expanded.replace(ref.raw, chalk.cyan(ref.raw));
+        attachments.push(formatAttachment(ref));
+    }
+    // Strip chalk codes for the actual message sent to the model
+    const plainExpanded = stripAnsi(expanded);
+    const fullMessage = attachments.length > 0
+        ? plainExpanded + '\n\n' + attachments.join('\n\n')
+        : plainExpanded;
+    return { expanded: fullMessage, refs };
+}
+async function resolveOne(raw, target, cwd) {
+    // URL
+    if (target.startsWith('http://') || target.startsWith('https://')) {
+        const content = await fetchUrl(target);
+        return { raw, type: 'url', target, content };
+    }
+    const absPath = resolve(cwd, target);
+    try {
+        const info = await stat(absPath);
+        if (info.isDirectory()) {
+            const content = await readDirContents(absPath, cwd);
+            return { raw, type: 'directory', target: absPath, content };
+        }
+        else {
+            const content = await readFileContents(absPath);
+            return { raw, type: 'file', target: absPath, content };
+        }
+    }
+    catch {
+        // path doesn't exist — leave as-is, don't inject
+        process.stderr.write(chalk.yellow(`  @ warning: "${target}" not found, skipping\n`));
+        return null;
+    }
+}
+async function readFileContents(filePath) {
+    const raw = await readFile(filePath, 'utf-8');
+    if (raw.length > MAX_FILE_CHARS) {
+        return raw.slice(0, MAX_FILE_CHARS) + `\n\n[truncated — ${raw.length} total chars]`;
+    }
+    return raw;
+}
+async function readDirContents(dirPath, cwd) {
+    const lines = [];
+    await collectFiles(dirPath, dirPath, lines);
+    const rel = relative(cwd, dirPath) || '.';
+    return `Directory: ${rel}\n` + lines.join('\n');
+}
+async function collectFiles(root, dir, lines, depth = 0) {
+    if (lines.length >= MAX_DIR_FILES)
+        return;
+    const entries = await readdir(dir, { withFileTypes: true });
+    entries.sort((a, b) => {
+        if (a.isDirectory() !== b.isDirectory())
+            return a.isDirectory() ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+    for (const entry of entries) {
+        if (lines.length >= MAX_DIR_FILES)
+            break;
+        if (entry.name.startsWith('.'))
+            continue;
+        const full = join(dir, entry.name);
+        const rel = relative(root, full);
+        const indent = '  '.repeat(depth);
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            lines.push(`${indent}${entry.name}/`);
+            await collectFiles(root, full, lines, depth + 1);
+        }
+        else {
+            lines.push(`${indent}${entry.name}`);
+        }
+    }
+}
+async function fetchUrl(url) {
+    try {
+        const res = await fetch(url, { signal: AbortSignal.timeout(10_000) });
+        if (!res.ok)
+            return `[HTTP ${res.status} fetching ${url}]`;
+        const text = await res.text();
+        // Strip HTML tags for readability
+        const stripped = text.replace(/<[^>]+>/g, ' ').replace(/\s{2,}/g, ' ').trim();
+        return stripped.length > MAX_FILE_CHARS
+            ? stripped.slice(0, MAX_FILE_CHARS) + '\n[truncated]'
+            : stripped;
+    }
+    catch (err) {
+        return `[Failed to fetch ${url}: ${err instanceof Error ? err.message : String(err)}]`;
+    }
+}
+function formatAttachment(ref) {
+    const label = ref.type === 'url' ? `URL: ${ref.target}` :
+        ref.type === 'directory' ? `Directory: ${ref.target}` :
+            `File: ${ref.target}`;
+    const fence = ref.type === 'url' ? '' : detectLanguage(ref.target);
+    return `<attachment ${label}>\n\`\`\`${fence}\n${ref.content}\n\`\`\`\n</attachment>`;
+}
+function detectLanguage(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    const map = {
+        ts: 'typescript', tsx: 'tsx', js: 'javascript', jsx: 'jsx',
+        py: 'python', rs: 'rust', go: 'go', java: 'java',
+        json: 'json', md: 'markdown', yaml: 'yaml', yml: 'yaml',
+        sh: 'bash', css: 'css', html: 'html', sql: 'sql',
+    };
+    return map[ext] ?? '';
+}
+function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1B\[[0-9;]*m/g, '');
+}
+//# sourceMappingURL=at-resolver.js.map

package/dist/cli/at-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"at-resolver.js","sourceRoot":"","sources":["../../src/cli/at-resolver.ts"],"names":[],"mappings":"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"}

package/dist/cli/banner.d.ts

@@ -0,0 +1 @@
+export declare function printBanner(model: string): void;

package/dist/cli/banner.js

@@ -0,0 +1,111 @@
+import chalk from 'chalk';
+// ── CODEGRUNT wordmark — pixel art ──────────────────────────────────────────
+const GLYPHS = {
+    C: [
+        ' ▄███▄ ',
+        ' ██    ',
+        ' ██    ',
+        ' ██    ',
+        ' ▀███▀ ',
+    ],
+    O: [
+        ' ▄███▄ ',
+        ' ██  █ ',
+        ' ██  █ ',
+        ' ██  █ ',
+        ' ▀███▀ ',
+    ],
+    D: [
+        ' ████▄ ',
+        ' ██  █ ',
+        ' ██  █ ',
+        ' ██  █ ',
+        ' ████▀ ',
+    ],
+    E: [
+        ' █████ ',
+        ' ██    ',
+        ' ████  ',
+        ' ██    ',
+        ' █████ ',
+    ],
+    G: [
+        ' ▄███▄ ',
+        ' ██    ',
+        ' ██ ██ ',
+        ' ██  █ ',
+        ' ▀███▀ ',
+    ],
+    R: [
+        ' ████▄ ',
+        ' ██  █ ',
+        ' ████▀ ',
+        ' ██▄   ',
+        ' ██  █ ',
+    ],
+    U: [
+        ' █   █ ',
+        ' █   █ ',
+        ' █   █ ',
+        ' █   █ ',
+        ' ▀███▀ ',
+    ],
+    N: [
+        ' █   █ ',
+        ' ██  █ ',
+        ' █ █ █ ',
+        ' █  ██ ',
+        ' █   █ ',
+    ],
+    T: [
+        ' █████ ',
+        '   █   ',
+        '   █   ',
+        '   █   ',
+        '   █   ',
+    ],
+    ' ': [
+        '   ',
+        '   ',
+        '   ',
+        '   ',
+        '   ',
+    ],
+};
+const WORD = 'CODEGRUNT';
+export function printBanner(model) {
+    const cols = process.stdout.columns || 80;
+    const termH = process.stdout.rows || 24;
+    // Blue accent
+    const blue = (s) => chalk.hex('#4A90D9')(s);
+    const dim = chalk.gray;
+    const bold = chalk.bold;
+    // Skip glyphs when terminal is too short
+    const skipGlyphs = termH < 14;
+    if (!skipGlyphs) {
+        // Build the wordmark row by row
+        const rows = Array.from({ length: 5 }, () => '');
+        for (let i = 0; i < WORD.length; i++) {
+            const ch = WORD[i];
+            const glyph = GLYPHS[ch] ?? GLYPHS[' '];
+            for (let r = 0; r < 5; r++) {
+                rows[r] += (i > 0 ? ' ' : '') + glyph[r];
+            }
+        }
+        // Centre the wordmark
+        process.stdout.write('\n');
+        for (const row of rows) {
+            const pad = Math.max(0, Math.floor((cols - row.length) / 2));
+            process.stdout.write(' '.repeat(pad) + blue(row) + '\n');
+        }
+        process.stdout.write('\n');
+    }
+    // ── Version/model info line ────────────────────────────────────────────
+    process.stdout.write('  ' +
+        bold.white('CodeGrunt') +
+        dim('  v0.1.0  ·  model: ') +
+        blue(model) +
+        dim('  ·  /help for commands') +
+        '\n\n');
+}
+//# sourceMappingURL=banner.js.map

package/dist/cli/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/cli/banner.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,25 @@
+import type { LLMProvider, CodeGruntConfig } from '../types.js';
+import type { ContextManager } from '../core/context/manager.js';
+import type { Skill } from './skills.js';
+export type SlashCommandResult = {
+    type: 'handled';
+} | {
+    type: 'clear';
+} | {
+    type: 'config_changed';
+    config: CodeGruntConfig;
+} | {
+    type: 'model_changed';
+    config: CodeGruntConfig;
+} | {
+    type: 'exit';
+} | {
+    type: 'skill_run';
+    prompt: string;
+    system?: string;
+} | {
+    type: 'skills_reload';
+} | {
+    type: 'not_a_command';
+};
+export declare function handleSlashCommand(input: string, cwd: string, config: CodeGruntConfig, provider: LLMProvider, context: ContextManager, skills?: Skill[]): Promise<SlashCommandResult>;