@serjm/deepseek-code 0.3.1

package/CONTRIBUTING.md

@@ -0,0 +1,73 @@
+# Contributing to DeepSeek Code
+
+Thank you for your interest in contributing! 🎉
+
+## Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/deepseek-ai/deepseek-code.git
+cd deepseek-code
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Run in development mode
+node dist/cli.js
+```
+
+## Project Structure
+
+```
+src/
+├── api/          # DeepSeek API client
+├── cli/          # CLI entry points (interactive, headless)
+├── config/       # Configuration loading and defaults
+├── core/         # Core logic (AgentLoop, memory, MCP, etc.)
+├── tools/        # Tool definitions (read, write, edit, bash, etc.)
+├── ui/           # TUI components (Ink/React)
+└── utils/        # Utilities (logger, ignore)
+```
+
+## Coding Standards
+
+- **TypeScript** with strict mode
+- **ES modules** (`import`/`export`)
+- Follow existing code style (naming, formatting, patterns)
+- No `any` types — use proper generics or `unknown`
+- Async/await for asynchronous code
+
+## Before Submitting a PR
+
+1. **Build**: `npm run build` — must compile without errors
+2. **Lint**: `npm run lint` — must pass
+3. **Typecheck**: `npm run typecheck` — must pass
+4. **Tests**: Add tests for new functionality
+5. **Commit**: Use clear, descriptive commit messages
+
+## Commit Messages
+
+Follow conventional commits:
+
+```
+feat: add context-aware system prompt
+fix: approval dialog now shows confirmation prompt
+refactor: rename tools to snake_case
+docs: add CONTRIBUTING.md
+test: add unit tests for tool types
+```
+
+## Code Review
+
+All PRs require review. Focus on:
+- Correctness
+- Security (no dangerous defaults)
+- Performance (no unnecessary I/O or polling)
+- Consistency with existing patterns
+
+## Questions?
+
+Open an issue or discussion on GitHub.

package/README.md

@@ -0,0 +1,194 @@
+<div align="center">
+  <br/>
+  <h1>DeepSeek Code</h1>
+  <p><strong>Open-source AI coding agent for developers who want a fast terminal workflow without Copilot pricing.</strong></p>
+
+  <p>
+    <a href="https://github.com/SerjMihashin/deepseek-code/blob/master/LICENSE">
+      <img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"/>
+    </a>
+    <img src="https://img.shields.io/badge/TypeScript-5.7-blue" alt="TypeScript"/>
+    <img src="https://img.shields.io/badge/DeepSeek-API-orange" alt="DeepSeek"/>
+    <img src="https://img.shields.io/badge/status-alpha-yellow" alt="Status"/>
+  </p>
+
+  <p>
+    <b>English</b> · <a href="README.ru.md">Русский</a>
+  </p>
+  <br/>
+</div>
+
+---
+
+## The Short Version
+
+DeepSeek Code is a terminal-first AI coding agent. It reads your project, edits files, runs commands, reviews code, remembers context, and can automate Chrome when a task needs a browser.
+
+It is built for developers who want a practical local workflow:
+
+- **Lower cost**: use DeepSeek API directly instead of a fixed monthly coding subscription.
+- **Real project work**: inspect files, patch code, run tests, and continue from previous sessions.
+- **Terminal-native**: no IDE lock-in, no heavy desktop app, no cloud workspace requirement.
+- **User-controlled automation**: choose read-only planning, manual approvals, auto-edit, or full turbo mode.
+
+---
+
+## Install
+
+```bash
+npm install -g @serjm/deepseek-code
+```
+
+Run it:
+
+```bash
+deepseek-code
+```
+
+Or run without installing:
+
+```bash
+npx @serjm/deepseek-code
+```
+
+Short alias:
+
+```bash
+dsc
+dsc -p "Find the bug in auth.ts and patch it"
+dsc --headless --json -p "Review this repository"
+```
+
+---
+
+## Why Use It
+
+| Need | DeepSeek Code |
+|---|---|
+| Fix code from the terminal | Reads files, proposes patches, and runs verification commands |
+| Keep costs predictable | Uses your DeepSeek API key directly |
+| Work inside existing repos | Runs where your code already lives |
+| Avoid blind automation | Approval modes keep edits and shell commands under your control |
+| Debug browser flows | Built-in Chrome automation for pages, forms, console, screenshots, and network state |
+| Keep context over time | Project memory and resumable sessions help with longer work |
+
+---
+
+## What It Can Do
+
+```text
+You: "Find why checkout fails after login and fix it"
+
+DeepSeek Code:
+  1. Searches the relevant files
+  2. Reads the auth and checkout code
+  3. Applies a focused patch
+  4. Runs tests or the command you approve
+  5. Summarizes the change
+```
+
+Core features:
+
+- **Autonomous coding agent**: plans, reads, edits, searches, and runs commands.
+- **Full terminal UI**: streaming output, tool activity, status, costs, and context usage.
+- **Approval modes**: Plan, Default, Auto-Edit, and Turbo.
+- **Browser automation**: open pages, click, fill forms, inspect console/network, take screenshots.
+- **MCP support**: connect external tool servers for custom workflows.
+- **Persistent memory**: save project facts with `/remember`.
+- **AI code review**: use `/review` to inspect bugs, risks, and security issues.
+- **Headless mode**: CI-friendly JSON output with `--headless --json`.
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `/help` | Show available commands |
+| `/setup` | Configure API key, language, and approval mode |
+| `/remember <text>` | Save project context |
+| `/memory` | Show saved memories |
+| `/review` | Run AI code review |
+| `/checkpoint` | Save a git checkpoint |
+| `/restore` | Restore a checkpoint |
+| `/theme` | Switch terminal theme |
+| `/lang` | Switch language |
+| `/git <cmd>` | Run git operations |
+| `/loop <interval> <task>` | Schedule recurring work |
+| `/sandbox` | Run commands in Docker isolation |
+| `/mcp` | Manage MCP servers |
+| `/stats` | Show session statistics |
+| `/clear` | Clear chat |
+
+---
+
+## Configuration
+
+Use environment variables:
+
+```bash
+export DEEPSEEK_API_KEY="sk-..."
+export DEEPSEEK_MODEL="deepseek-chat"
+```
+
+Or create `.deepseek-code/settings.json` in your project:
+
+```json
+{
+  "apiKey": "sk-...",
+  "model": "deepseek-chat",
+  "approvalMode": "default",
+  "temperature": 0.7
+}
+```
+
+---
+
+## Safety Model
+
+DeepSeek Code is designed around explicit control:
+
+- **Plan**: read-only analysis.
+- **Default**: asks before edits and commands.
+- **Auto-Edit**: file edits are automatic, shell commands still need approval.
+- **Turbo**: full automation for trusted local work.
+
+It also supports command sanitization, file size limits, `.deepseekignore`, checkpoints, and optional Docker sandboxing.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/SerjMihashin/deepseek-code.git
+cd deepseek-code
+npm install
+npm run build
+npm test
+```
+
+Package check:
+
+```bash
+npm pack --dry-run
+npm publish --dry-run --access public
+```
+
+Publish to npm:
+
+```bash
+npm login
+npm publish --access public
+```
+
+If npm asks for two-factor authentication:
+
+```bash
+npm publish --access public --otp=123456
+```
+
+---
+
+## License
+
+Apache-2.0 © 2026 Serj Mikhashin

package/README.ru.md

@@ -0,0 +1,194 @@
+<div align="center">
+  <br/>
+  <h1>DeepSeek Code</h1>
+  <p><strong>Open-source AI-агент для разработки в терминале: дешевле подписок, ближе к вашему коду, без привязки к IDE.</strong></p>
+
+  <p>
+    <a href="https://github.com/SerjMihashin/deepseek-code/blob/master/LICENSE">
+      <img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"/>
+    </a>
+    <img src="https://img.shields.io/badge/TypeScript-5.7-blue" alt="TypeScript"/>
+    <img src="https://img.shields.io/badge/DeepSeek-API-orange" alt="DeepSeek"/>
+    <img src="https://img.shields.io/badge/status-alpha-yellow" alt="Status"/>
+  </p>
+
+  <p>
+    <a href="README.md">English</a> · <b>Русский</b>
+  </p>
+  <br/>
+</div>
+
+---
+
+## Коротко
+
+DeepSeek Code — это AI-агент для разработки прямо в терминале. Он читает проект, редактирует файлы, запускает команды, делает code review, запоминает контекст и умеет управлять Chrome, когда задача выходит за пределы кода.
+
+Он подходит, если нужен практичный локальный workflow:
+
+- **Ниже стоимость**: используется ваш DeepSeek API key, без дорогой фиксированной подписки.
+- **Реальная работа с проектом**: поиск по коду, патчи, тесты, продолжение прошлых сессий.
+- **Терминальный подход**: без привязки к конкретной IDE и без отдельного облачного workspace.
+- **Контроль над автоматизацией**: режимы от read-only анализа до полного turbo.
+
+---
+
+## Установка
+
+```bash
+npm install -g @serjm/deepseek-code
+```
+
+Запуск:
+
+```bash
+deepseek-code
+```
+
+Запуск без установки:
+
+```bash
+npx @serjm/deepseek-code
+```
+
+Короткий алиас:
+
+```bash
+dsc
+dsc -p "Найди баг в auth.ts и исправь"
+dsc --headless --json -p "Сделай review репозитория"
+```
+
+---
+
+## Зачем он нужен
+
+| Задача | Что делает DeepSeek Code |
+|---|---|
+| Исправить код из терминала | Читает файлы, предлагает патчи и запускает проверочные команды |
+| Держать расходы под контролем | Работает напрямую через ваш DeepSeek API key |
+| Работать в существующих репозиториях | Запускается там, где уже лежит код |
+| Не отдавать все на автопилот | Режимы подтверждений контролируют правки и shell-команды |
+| Отлаживать browser flow | Встроенный Chrome: страницы, формы, консоль, network, скриншоты |
+| Не терять контекст | Память проекта и продолжение сессий помогают на длинных задачах |
+
+---
+
+## Что он умеет
+
+```text
+Вы: "Найди, почему checkout падает после логина, и исправь"
+
+DeepSeek Code:
+  1. Ищет релевантные файлы
+  2. Читает auth и checkout код
+  3. Вносит точечный патч
+  4. Запускает тесты или команду после подтверждения
+  5. Кратко объясняет результат
+```
+
+Основные возможности:
+
+- **Автономный coding agent**: планирует, читает, редактирует, ищет и запускает команды.
+- **Полноценный terminal UI**: streaming output, цепочка инструментов, статус, стоимость и контекст.
+- **Режимы подтверждений**: Plan, Default, Auto-Edit и Turbo.
+- **Автоматизация браузера**: открыть страницу, кликнуть, заполнить форму, проверить console/network, сделать screenshot.
+- **MCP support**: подключение внешних tool-серверов для своих workflows.
+- **Постоянная память**: сохраняйте факты проекта через `/remember`.
+- **AI code review**: команда `/review` ищет баги, риски и проблемы безопасности.
+- **Headless mode**: JSON-вывод для CI и скриптов через `--headless --json`.
+
+---
+
+## Команды
+
+| Команда | Описание |
+|---|---|
+| `/help` | Показать команды |
+| `/setup` | Настроить API key, язык и режим подтверждений |
+| `/remember <text>` | Сохранить контекст проекта |
+| `/memory` | Показать сохраненную память |
+| `/review` | Запустить AI code review |
+| `/checkpoint` | Сохранить git checkpoint |
+| `/restore` | Восстановить checkpoint |
+| `/theme` | Сменить тему |
+| `/lang` | Сменить язык |
+| `/git <cmd>` | Git-операции |
+| `/loop <interval> <task>` | Запланировать повторяющуюся задачу |
+| `/sandbox` | Запуск через Docker isolation |
+| `/mcp` | Управление MCP-серверами |
+| `/stats` | Статистика сессии |
+| `/clear` | Очистить чат |
+
+---
+
+## Конфигурация
+
+Через переменные окружения:
+
+```bash
+export DEEPSEEK_API_KEY="sk-..."
+export DEEPSEEK_MODEL="deepseek-chat"
+```
+
+Или через `.deepseek-code/settings.json` в корне проекта:
+
+```json
+{
+  "apiKey": "sk-...",
+  "model": "deepseek-chat",
+  "approvalMode": "default",
+  "temperature": 0.7
+}
+```
+
+---
+
+## Контроль и безопасность
+
+DeepSeek Code построен вокруг явного контроля:
+
+- **Plan**: только read-only анализ.
+- **Default**: спрашивает перед правками и командами.
+- **Auto-Edit**: правки файлов автоматические, shell-команды требуют подтверждения.
+- **Turbo**: полная автоматизация для доверенной локальной работы.
+
+Также есть санитизация команд, лимиты размера файлов, `.deepseekignore`, checkpoints и опциональный Docker sandbox.
+
+---
+
+## Разработка
+
+```bash
+git clone https://github.com/SerjMihashin/deepseek-code.git
+cd deepseek-code
+npm install
+npm run build
+npm test
+```
+
+Проверить пакет:
+
+```bash
+npm pack --dry-run
+npm publish --dry-run --access public
+```
+
+Опубликовать в npm:
+
+```bash
+npm login
+npm publish --access public
+```
+
+Если npm просит двухфакторный код:
+
+```bash
+npm publish --access public --otp=123456
+```
+
+---
+
+## Лицензия
+
+Apache-2.0 © 2026 Serj Mikhashin

package/dist/api/index.d.ts

@@ -0,0 +1,77 @@
+import { type DeepSeekConfig } from '../config/defaults.js';
+import type { OpenAITool } from '../tools/types.js';
+export type { OpenAITool };
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+};
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | ContentBlock[];
+    tool_call_id?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface StreamChunk {
+    type: 'text' | 'tool_use' | 'tool_result' | 'reasoning' | 'usage';
+    content: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    toolResult?: string;
+    toolCallId?: string;
+    usage?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+export interface ToolCallResult {
+    role: 'tool';
+    content: string;
+    tool_call_id: string;
+}
+export interface ToolCallMessage {
+    role: 'assistant';
+    content: string | null;
+    tool_calls: NonNullable<ChatMessage['tool_calls']>;
+}
+export declare class DeepSeekAPI {
+    private client;
+    private model;
+    private systemPrompt;
+    constructor(config: DeepSeekConfig);
+    streamChat(messages: ChatMessage[], tools?: OpenAITool[]): AsyncGenerator<StreamChunk>;
+    /**
+     * Non-streaming chat with optional tools support.
+     * Returns either text content or tool_calls.
+     */
+    chat(messages: ChatMessage[], tools?: OpenAITool[]): Promise<{
+        content: string;
+        toolCalls?: ToolCallMessage['tool_calls'];
+        usage?: {
+            input: number;
+            output: number;
+        };
+    }>;
+    /** Validate API key by making a minimal models list request */
+    validateKey(): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get embedding vector for a text string using DeepSeek's embeddings API.
+     */
+    getEmbedding(text: string): Promise<number[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,YAAY,EAAE,UAAU,EAAE,CAAA;AAE1B,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAA;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;CACpD;AA8BD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,YAAY,CAAQ;gBAEf,MAAM,EAAE,cAAc;IAS3B,UAAU,CAChB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,UAAU,EAAE,GACnB,cAAc,CAAC,WAAW,CAAC;IAmI9B;;;OAGG;IACG,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,CAAC,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAsCrH,+DAA+D;IACzD,WAAW,IAAK,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBjE;;OAEG;IACG,YAAY,CAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAOrD"}