dave-code 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARDARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# Dave Code
+
+A terminal-based AI coding assistant CLI similar to Claude Code. Dave Code integrates directly with your local workspace, helping you inspect, write, search, and edit files, and answer software engineering questions using state-of-the-art LLMs.
+
+## Features
+
+- ⚡ **Interactive CLI REPL**: Ask questions and run commands in your workspace with animated terminal visual elements.
+- ⚙️ **Effort Presets**: Adjust AI's effort level from `/effort` (choose between `low`, `medium`, `high`, `xhigh`, `max`, and `ultracode`) to control token consumption and task complexity.
+- 📖 **Smart Incremental Reading (精读模式)**: For non-ultra modes, the assistant silently and delicately reads large files in precise range chunks (e.g. lines 40-100) instead of loading the entire file, saving context tokens and prevent terminal warning clutter.
+- 🔄 **Ultracode Digestion Workflow**: In `ultracode` mode, read and digest large files (>1000 lines) concurrently in chunks with live, animated progress indicators.
+- 🧠 **DeepSeek Reasoning Support**: Detects and cleanly renders internal reasoning (`<think>` blocks) in grey, preventing raw HTML tags from polluting your terminal.
+- 📊 **Token Usage Statistics**: Real-time prompt, completion, and total token usage tracked and printed after each request. Run `/stats` or `/tokens` to see session totals.
+- 🌐 **Proxy & Key Configuration**: Interactively configure API keys, models, base URLs, and proxies via `/config`, `/model`, or `/api`.
+
+## Installation
+
+Install globally via npm:
+
+```bash
+npm install -g dave-code
+```
+
+## Getting Started
+
+1. Set up your LLM provider by running the configuration command:
+   ```bash
+   calldave /config
+   ```
+   This will open the configuration file in your default editor. Fill in your model name, API key, and base URL.
+
+2. Start the assistant in your project working directory:
+   ```bash
+   calldave
+   ```
+
+3. Type `/help` to see list of available commands.
+
+## Available Commands
+
+- `/help` - Show help instructions.
+- `/stats` / `/tokens` - Display session and last request token usage statistics.
+- `/effort` - Interactively adjust AI thinking/reading effort level.
+- `/model` - Switch active LLM profile.
+- `/api` - Set or change the API key for the active profile.
+- `/open <path>` - Open a file or folder in your workspace.
+- `/clear` - Clear screen and reset REPL layout.
+- `/reset` - Clear conversation history and reset token counters.
+- `/lang` - Switch terminal interface between Chinese and English.
+- `/exit` - Exit the assistant.
+
+## License
+
+ISC License.

package/bin/aiClient.js

@@ -0,0 +1,243 @@
+/**
+ * ── DESIGN PHILOSOPHY / 视觉设计与交互规范 ──
+ * 为了向用户提供极致、顺滑的交互体验，Dave Code 规定：
+ * 1. 所有耗时的 API 请求、大文件处理和本地工具调用，都必须具有动画化（Animated）或动态（Dynamic）的终端 UI。
+ * 2. 严禁使用静态、刷屏式的连续 Log 输出。对于多步骤操作（如分片消化），应使用单行原地更新（In-place update）的进度条和加载动画。
+ * 3. 使用富文本终端色彩（如精心调配的 HSL/ANSI 颜色）和微型字符动画（如 Spinner）来提供实时的视觉反馈。
+ * 后续维护与功能续写时，必须严格遵守此设计理念。
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { getActiveProfile } from './configManager.js';
+import { ProxyAgent } from 'undici';
+
+const systemPrompt = `You are Dave, a terminal-based AI assistant.
+You help the user with coding, CLI tasks, and software engineering in their workspace.
+
+You have access to local workspace tools to inspect and modify files/directories. If you need to use them, output the tag EXACTLY as specified below. Before outputting any tool call tag, write a brief, one-sentence thought explaining why you need to execute this action (e.g., what you are looking for or why you choose to read these specific lines). Keep it concise, then output the tag.
+
+Tools:
+1. List directory contents:
+<<LIST_DIR: path/to/dir>>
+
+2. Read file content (optionally specify line range as file:startLine-endLine):
+<<READ_FILE: path/to/file>> or <<READ_FILE: path/to/file:startLine-endLine>>
+
+3. Write/overwrite a file:
+<<WRITE_FILE: path/to/file
+[file contents]
+>>
+
+4. Search text inside workspace files (grep):
+<<SEARCH_GREP: query>>
+
+Rules for tools:
+- The paths must be relative to the current working directory.
+- To execute multiple tool calls, output them one by one. You must output a single tool call tag (with your preceding thought), wait for the system response, and then output the next if needed.
+- Once you have all info or have completed the task, answer the user normally without any tool tags.`;
+
+export const sessionTokenUsage = {
+  inputTokens: 0,
+  outputTokens: 0,
+  totalTokens: 0,
+  lastInputTokens: 0,
+  lastOutputTokens: 0,
+  lastTotalTokens: 0
+};
+
+export function resetTokenUsage() {
+  sessionTokenUsage.inputTokens = 0;
+  sessionTokenUsage.outputTokens = 0;
+  sessionTokenUsage.totalTokens = 0;
+  sessionTokenUsage.lastInputTokens = 0;
+  sessionTokenUsage.lastOutputTokens = 0;
+  sessionTokenUsage.lastTotalTokens = 0;
+}
+
+export function updateTokenUsage(input, output) {
+  sessionTokenUsage.lastInputTokens = input;
+  sessionTokenUsage.lastOutputTokens = output;
+  sessionTokenUsage.lastTotalTokens = input + output;
+
+  sessionTokenUsage.inputTokens += input;
+  sessionTokenUsage.outputTokens += output;
+  sessionTokenUsage.totalTokens += (input + output);
+}
+
+export function hasApiKey() {
+  const profile = getActiveProfile();
+  return !!(profile && profile.apiKey && profile.apiKey !== 'YOUR_API_KEY');
+}
+
+export async function getAIResponse(messages, activeOpenFile = null, maxReadLines = 600) {
+  const profile = getActiveProfile();
+  if (!profile) {
+    throw new Error('No active configuration profile found. Run /config to add one.');
+  }
+
+  const { model, apiKey, apiBase, proxyUrl } = profile;
+
+  if (!apiKey) {
+    throw new Error(`No API key configured for model "${model}".`);
+  }
+
+  // Setup proxy agent if proxyUrl is configured
+  let dispatcher;
+  if (proxyUrl) {
+    try {
+      dispatcher = new ProxyAgent(proxyUrl);
+    } catch (e) {
+      throw new Error(`Invalid Proxy URL: ${e.message}`);
+    }
+  }
+
+  // Load project instructions from CLAUDE.md if it exists in current working directory
+  let activeSystemPrompt = systemPrompt;
+  const claudeMdPath = path.join(process.cwd(), 'CLAUDE.md');
+  if (fs.existsSync(claudeMdPath)) {
+    try {
+      const claudeMdContent = fs.readFileSync(claudeMdPath, 'utf8');
+      activeSystemPrompt += `\n\n[Project Instructions from CLAUDE.md]:\n${claudeMdContent}`;
+    } catch (e) {
+      // Ignore
+    }
+  }
+
+  if (activeOpenFile) {
+    const relPath = path.relative(process.cwd(), activeOpenFile);
+    activeSystemPrompt += `\n\n[Currently Active File]: You are currently editing and working on the file "${relPath}" (absolute path: "${activeOpenFile}"). All reading, writing, and modifications should default to this file unless the user explicitly asks you to work on another file.`;
+  }
+
+  activeSystemPrompt += `\n\n[Incremental Reading Guidelines]:
+- If you are analyzing a large file, DO NOT try to read the entire file if you only need specific sections.
+- Use SEARCH_GREP to locate keywords/classes/functions first, find their line numbers, and then use <<READ_FILE: path:startLine-endLine>> to read only the relevant range.
+- Try to understand the file using the MINIMUM amount of reading possible. Keep your read ranges targeted and precise.
+- You can read up to ${maxReadLines} lines at a time if you need to, but optimize your range to read only what is necessary to answer the user's request.`;
+
+  // Smart Type Auto-Detection
+  const isAnthropic = (apiBase && apiBase.includes('anthropic.com')) || (!apiBase && model.startsWith('claude-'));
+  const isGemini = (apiBase && apiBase.includes('generativelanguage.googleapis.com')) || (!apiBase && model.startsWith('gemini-'));
+
+  // 1. Anthropic Claude API Payload
+  if (isAnthropic) {
+    const base = apiBase || 'https://api.anthropic.com';
+    const url = `${base}/v1/messages`;
+
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': '2023-06-01'
+      },
+      body: JSON.stringify({
+        model,
+        max_tokens: 2048,
+        system: activeSystemPrompt,
+        messages: messages
+      }),
+      dispatcher
+    });
+
+    if (!response.ok) {
+      const errText = await response.text();
+      throw new Error(`Anthropic API error (${response.status}): ${errText}`);
+    }
+
+    const data = await response.json();
+    if (!data.content || data.content.length === 0) {
+      throw new Error('Anthropic returned an empty response.');
+    }
+    if (data.usage) {
+      const input = data.usage.input_tokens || 0;
+      const output = data.usage.output_tokens || 0;
+      updateTokenUsage(input, output);
+    }
+    return data.content[0].text;
+  }
+
+  // 2. Google Gemini API Payload
+  if (isGemini) {
+    const base = apiBase || 'https://generativelanguage.googleapis.com';
+    const url = `${base}/v1beta/models/${model}:generateContent?key=${apiKey}`;
+
+    const contents = messages.map(msg => ({
+      role: msg.role === 'assistant' ? 'model' : 'user',
+      parts: [{ text: msg.content }]
+    }));
+
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json'
+      },
+      body: JSON.stringify({
+        contents,
+        systemInstruction: {
+          parts: [{ text: activeSystemPrompt }]
+        }
+      }),
+      dispatcher
+    });
+
+    if (!response.ok) {
+      const errText = await response.text();
+      throw new Error(`Gemini API error (${response.status}): ${errText}`);
+    }
+
+    const data = await response.json();
+    if (!data.candidates || data.candidates.length === 0 || !data.candidates[0].content) {
+      throw new Error('Gemini returned an empty response candidate.');
+    }
+    if (data.usageMetadata) {
+      const input = data.usageMetadata.promptTokenCount || 0;
+      const output = data.usageMetadata.candidatesTokenCount || 0;
+      updateTokenUsage(input, output);
+    }
+    return data.candidates[0].content.parts[0].text;
+  }
+
+  // 3. OpenAI-Compatible API Payload (Default fallback)
+  const base = apiBase || 'https://api.openai.com/v1';
+  const url = `${base}/chat/completions`;
+
+  const formattedMessages = [
+    { role: 'system', content: activeSystemPrompt },
+    ...messages
+  ];
+
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model,
+      messages: formattedMessages
+    }),
+    dispatcher
+  });
+
+  if (!response.ok) {
+    const errText = await response.text();
+    throw new Error(`API error (${response.status}): ${errText}`);
+  }
+
+  const data = await response.json();
+  if (!data.choices || data.choices.length === 0) {
+    throw new Error('API returned an empty completion response.');
+  }
+  if (data.usage) {
+    const input = data.usage.prompt_tokens || 0;
+    const output = data.usage.completion_tokens || 0;
+    updateTokenUsage(input, output);
+  }
+  const message = data.choices[0].message;
+  let text = message.content || '';
+  if (message.reasoning_content) {
+    text = `<think>\n${message.reasoning_content}\n</think>\n` + text;
+  }
+  return text;
+}