cliskill 1.0.0 → 1.0.2

package/README.md

@@ -6,9 +6,8 @@
 
 **Независимый AI-ассистент для терминала с поддержкой любых LLM провайдеров**
 
-[![Tests](https://img.shields.io/badge/tests-844%20passed-brightgreen)]()
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.1.0-orange)]()
+[![Version](https://img.shields.io/badge/version-1.0.0-orange)]()
 [![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-green)]()
 
 [Бесплатный](#) · [Без подписок](#) · [Без vendor lock-in](#) · [Универсальный](#)
@@ -21,10 +20,13 @@
 
 - [О проекте](#-о-проекте)
 - [Возможности](#-возможности)
-- [Установка](#-установка)
+- [Быстрый старт](#-быстрый-старт)
 - [Использование](#-использование)
 - [Конфигурация](#-конфигурация)
+- [Инструменты](#-инструменты)
+- [Агентская система](#-агентская-система)
 - [Архитектура](#-архитектура)
+- [API провайдеры](#-api-провайдеры)
 - [Разработка](#-разработка)
 - [Технологии](#-технологии)
 - [Лицензия](#-лицензия)
@@ -58,37 +60,6 @@
 - **Автоматический fallback** — переключение на резервные модели при ошибках
 - **Rate Limit Handler** — корректная обработка лимитов без upsell
 
-### 🔧 Инструменты (15 штук)
-
-| Инструмент | Описание |
-|------------|----------|
-| 🖥️ **Bash Tool** | Выполнение shell команд с инспекцией безопасности |
-| 📄 **File Read** | Чтение файлов с поддержкой изображений |
-| ✏️ **File Write** | Создание и перезапись файлов |
-| 📝 **File Edit** | Точечное редактирование файлов (search/replace) |
-| 🔍 **Glob** | Поиск файлов по паттернам |
-| 🔎 **Grep** | Поиск текста с поддержкой regex |
-| 🌐 **Web Search** | Веб-поиск через поисковые системы |
-| 🌍 **Web Fetch** | Загрузка и парсинг веб-страниц |
-| 🤖 **Agent Tool** | Порождение суб-агентов для подзадач |
-| 📡 **LSP Tool** | Интеграция с Language Server Protocol |
-| ✅ **Todo Write** | Управление списками задач |
-| 🖱️ **Computer Use** | Управление мышью и клавиатурой |
-| 🔗 **Remote Tool** | Выполнение команд на удалённых серверах через SSH |
-| 🌳 **Worktree Tool** | Управление git worktree для параллельной работы |
-| 📋 **Plan Mode** | Планирование с 3 параллельными агентами |
-
-### 🤖 Агентская система
-
-- **Auto Mode** — 3 уровня автономности:
-  - `full-auto` — полная автономия, все действия без подтверждения
-  - `safe-auto` — автоматическое выполнение безопасных операций
-  - `ask` — подтверждение каждого действия (по умолчанию)
-- **Fast Mode** — оптимизации скорости ответов
-- **Multi-Agent Plan Mode V2** — 3 параллельных агента для планирования
-- **Swarm Coordinator** — мульти-агентная координация сложных задач
-- **Task System** — фоновые задачи с отслеживанием статуса
-
 ### 🏗️ Инфраструктура
 
 | Система | Описание |
@@ -105,7 +76,7 @@
 ### 🛠️ Утилиты
 
 - 🎬 **Asciicast Recording** — запись сессий в формате asciicast v2
-- 🎨 **ANSI→SVG** — ренддеринг терминального вывода в SVG
+- 🎨 **ANSI→SVG** — рендеринг терминального вывода в SVG
 - 🔄 **Conversation Recovery** — умное восстановление сессий с ремонтом
 - 🔗 **Deep Links** — протокол `cliskill://` для интеграции с ОС
 - 🧹 **Background Housekeeping** — автоматическая очистка и обслуживание
@@ -116,13 +87,13 @@
 
 ---
 
-## 📦 Установка
+## 📦 Быстрый старт
 
-### Из исходников
+### Установка из исходников
 
 ```bash
 # Клонирование репозитория
-git clone <repo-url> cliskill
+git clone https://github.com/nic11/cliskill.git
 cd cliskill
 
 # Установка зависимостей
@@ -135,11 +106,27 @@ npm run build
 npm link
 ```
 
+### Установка из npm
+
+```bash
+npm install -g cliskill
+```
+
 ### Требования
 
 - **Node.js** >= 20.0.0
 - **npm** >= 9.0.0
 
+### Первый запуск
+
+```bash
+# Интерактивный мастер настройки
+cliskill
+
+# Или с явным указанием провайдера
+cliskill --base-url https://api.example.com/v1 --api-key your-key
+```
+
 ---
 
 ## 🚀 Использование
@@ -289,8 +276,8 @@ cliskill open-uri "cliskill://prompt?text=hello" # обработать URI
 ### Переменные окружения
 
 ```bash
-export CLISKILL_API_KEY="b0157800fd274691a6ba19a29ca11885.Ar0TPbB9buuhh8wJ"
-export CLISKILL_BASE_URL="https://api.z.ai/api/coding/paas/v4"
+export CLISKILL_API_KEY="your-api-key"
+export CLISKILL_BASE_URL="https://api.example.com/v1"
 ```
 
 ### Форматы провайдеров
@@ -326,6 +313,68 @@ description: Описание навыка
 
 ---
 
+## 🔧 Инструменты
+
+cliskill включает 15 встроенных инструментов для полноценной работы:
+
+| # | Инструмент | Описание | Категория |
+|---|------------|----------|-----------|
+| 1 | 🖥️ **Bash** | Выполнение shell команд с инспекцией безопасности | Выполнение |
+| 2 | 📄 **File Read** | Чтение файлов с поддержкой изображений | Файлы |
+| 3 | ✏️ **File Write** | Создание и перезапись файлов | Файлы |
+| 4 | 📝 **File Edit** | Точечное редактирование файлов (search/replace) | Файлы |
+| 5 | 🔍 **Glob** | Поиск файлов по паттернам | Поиск |
+| 6 | 🔎 **Grep** | Поиск текста с поддержкой regex | Поиск |
+| 7 | 🌐 **Web Search** | Веб-поиск через поисковые системы | Веб |
+| 8 | 🌍 **Web Fetch** | Загрузка и парсинг веб-страниц | Веб |
+| 9 | 🤖 **Agent** | Порождение суб-агентов для подзадач | Агенты |
+| 10 | 📡 **LSP** | Интеграция с Language Server Protocol | IDE |
+| 11 | ✅ **Todo Write** | Управление списками задач | Планирование |
+| 12 | 🖱️ **Computer Use** | Управление мышью и клавиатурой | Автоматизация |
+| 13 | 🔗 **Remote** | Выполнение команд на удалённых серверах через SSH | Удалённый доступ |
+| 14 | 🌳 **Worktree** | Управление git worktree для параллельной работы | Git |
+| 15 | 📋 **Plan Mode** | Планирование с 3 параллельными агентами | Планирование |
+
+### Безопасность инструментов
+
+Инструменты классифицируются по уровню безопасности:
+
+- **readOnly** (Glob, Grep, File Read, LSP) — могут выполняться параллельно
+- **write** (File Write, File Edit, Bash) — выполняются эксклюзивно
+- **network** (Web Search, Web Fetch) — контролируемые сетевые операции
+
+---
+
+## 🤖 Агентская система
+
+### Auto Mode
+
+3 уровня автономности для автоматического выполнения задач:
+
+| Уровень | Описание | Подтверждение |
+|---------|----------|---------------|
+| `full-auto` | Полная автономия | Все действия без подтверждения |
+| `safe-auto` | Безопасная автономия | Только потенциально опасные операции |
+| `ask` | Ручное управление | Каждое действие (по умолчанию) |
+
+### Multi-Agent система
+
+- **Fast Mode** — оптимизации скорости ответов
+- **Multi-Agent Plan Mode V2** — 3 параллельных агента для планирования
+- **Swarm Coordinator** — мульти-агентная координация сложных задач
+- **Task System** — фоновые задачи с отслеживанием статуса
+
+### Agent Loop
+
+Ядро системы — агентский цикл с поддержкой:
+
+- **Streaming** — потоковая обработка ответов LLM
+- **Tool calling** — параллельный вызов инструментов
+- **Error recovery** — 3-уровневая стратегия восстановления при `max_tokens`
+- **Context management** — автоматическое сжатие при переполнении контекста
+
+---
+
 ## 🏛️ Архитектура
 
 ```
@@ -344,7 +393,7 @@ src/
 ├── 🐝 swarm/         — Мульти-агентная координация
 ├── 📋 tasks/         — Фоновые задачи
 ├── 🔗 remote/        — SSH сессии
-├── 🧩 extensions/    — Расширения
+├── 🧩 extensions/    — Расширения и навыки
 ├── 🏗️ infra/         — Инфраструктурные модули
 └── 🔀 utils/         — Общие утилиты
 ```
@@ -372,6 +421,60 @@ graph TB
     Swarm --> Tasks[Task System]
 ```
 
+### Поток данных
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant R as REPL/TUI
+    participant L as Agent Loop
+    participant P as Provider Adapter
+    participant T as Tool System
+
+    U->>R: Ввод запроса
+    R->>L: Передача сообщения
+    L->>P: API запрос (streaming)
+    P-->>L: Потоковый ответ
+    L->>T: Вызов инструментов
+    T-->>L: Результат выполнения
+    L->>P: Продолжение диалога
+    P-->>L: Финальный ответ
+    L-->>R: Событие результата
+    R-->>U: Отображение ответа
+```
+
+---
+
+## 🌐 API провайдеры
+
+### Поддерживаемые форматы
+
+cliskill работает с **любым** API, совместимым с OpenAI `/chat/completions`:
+
+| Провайдер | Base URL | Формат |
+|-----------|----------|--------|
+| OpenAI | `https://api.openai.com/v1` | `openai-compatible` |
+| GLM / Z.AI | `https://api.z.ai/api/coding/paas/v4` | `openai-compatible` |
+| DeepSeek | `https://api.deepseek.com/v1` | `openai-compatible` |
+| LocalAI | `http://localhost:8080/v1` | `openai-compatible` |
+| Ollama | `http://localhost:11434/v1` | `openai-compatible` |
+| LM Studio | `http://localhost:1234/v1` | `openai-compatible` |
+| Любой другой | `<your-endpoint>/v1` | `openai-compatible` |
+
+### Модель алиасов
+
+Предустановленные алиасы для быстрого переключения моделей:
+
+| Алиас | Описание | Модель по умолчанию |
+|-------|----------|---------------------|
+| `smart` | Максимальное качество | `gpt-4o` |
+| `fast` | Быстрые ответы | `gpt-4o-mini` |
+| `balanced` | Баланс качества/скорости | `gpt-4o` |
+| `reasoning` | Логические задачи | `o1` |
+| `code` | Код-специфичные задачи | `gpt-4o` |
+
+Алиасы настраиваются в `.cliskillrc.json` → `models.aliases`.
+
 ---
 
 ## 👨‍💻 Разработка
@@ -382,7 +485,7 @@ graph TB
 npm install          # Установить зависимости
 npm run build        # Сборка проекта (tsup)
 npm run dev          # Разработка с watch-режимом
-npm test             # Запустить тесты (844 теста, Vitest)
+npm test             # Запустить тесты (Vitest)
 npm run test:watch   # Тесты в watch-режиме
 npm run typecheck    # Проверка типов TypeScript
 npm run lint         # Линтинг (= typecheck)
@@ -423,6 +526,19 @@ src/
     └── bash-parser.ts / .test.ts
 ```
 
+### Добавление нового инструмента
+
+1. Создайте файл в `src/tools/builtins/your-tool.ts`
+2. Реализуйте интерфейс `Tool` из `src/tools/types.ts`
+3. Зарегистрируйте в `src/tools/builtins/index.ts`
+4. Добавьте тесты `your-tool.test.ts`
+
+### Добавление нового провайдера
+
+1. Создайте адаптер в `src/connect/your-adapter.ts`
+2. Реализуйте интерфейс `ProviderAdapter` из `src/connect/types.ts`
+3. Зарегистрируйте в `src/connect/registry.ts`
+
 ---
 
 ## 🧪 Технологии
@@ -445,14 +561,13 @@ src/
 | [Ink](https://github.com/vadimdemedes/ink) / [React](https://react.dev) | Terminal UI |
 | [Ora](https://github.com/sindresorhus/ora) | Спиннеры загрузки |
 | [ssh2](https://github.com/mscdex/ssh2) | SSH подключения |
-| [dotenv](https://github.com/motdotla/dotenv) | Переменные окружения |
 
 ### Dev-зависимости
 
 | Библиотека | Назначение |
 |------------|------------|
 | [tsup](https://tsup.egoist.dev) | Сборка (esbuild-based) |
-| [Vitest](https://vitest.dev) | Тестирование (844 теста) |
+| [Vitest](https://vitest.dev) | Тестирование |
 | [TypeScript](https://www.typescriptlang.org) | Компилятор и проверка типов |
 
 ---

package/dist/bootstrap/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "../chunk-ULZHJVWD.js";
+} from "../chunk-GCXQJ2SV.js";
 import "../chunk-AJENHWD3.js";
 export {
   runCli

package/dist/{chunk-ULZHJVWD.js → chunk-GCXQJ2SV.js}

@@ -388,6 +388,19 @@ var BaseAdapter = class {
     }
     return timeoutSignal;
   }
+  /**
+   * Build an AbortSignal for streaming requests with extended timeout.
+   * Streaming responses can take much longer than regular requests,
+   * so we use 3x the configured timeout to avoid premature aborts.
+   */
+  buildStreamingSignal(external) {
+    const streamTimeout = Math.max(this.config.timeout * 3, 6e5);
+    const timeoutSignal = AbortSignal.timeout(streamTimeout);
+    if (external) {
+      return AbortSignal.any([timeoutSignal, external]);
+    }
+    return timeoutSignal;
+  }
   /**
    * Fetch with automatic retry for rate-limit (429), server errors (5xx),
    * and network failures (TypeError: fetch failed).
@@ -461,7 +474,7 @@ var GenericCompatAdapter = class extends BaseAdapter {
       method: "POST",
       headers: this.buildHeaders(),
       body: JSON.stringify(body),
-      signal: this.buildSignal(request.signal)
+      signal: this.buildStreamingSignal(request.signal)
     }));
     if (!response.ok) {
       const text = await response.text().catch(() => "unknown error");
@@ -670,7 +683,7 @@ var GLMAdapter = class extends BaseAdapter {
       method: "POST",
       headers: this.buildHeaders(),
       body: JSON.stringify(body),
-      signal: this.buildSignal(request.signal)
+      signal: this.buildStreamingSignal(request.signal)
     }));
     if (!response.ok) {
       const text = await response.text().catch(() => "unknown error");
@@ -2061,14 +2074,16 @@ import { z as z13 } from "zod";
 var webSearchInputSchema = z13.object({
   query: z13.string().describe("Search query"),
   max_results: z13.number().default(5).describe("Maximum number of results"),
-  search_engine: z13.enum(["duckduckgo", "google"]).default("duckduckgo").describe("Search engine to use")
+  search_engine: z13.enum(["duckduckgo", "wikipedia"]).default("duckduckgo").describe("Search engine to use")
 });
 var SEARCH_TIMEOUT_MS = 15e3;
 var DDG_HTML_URL = "https://html.duckduckgo.com/html/?q=";
 var DDG_LITE_URL = "https://lite.duckduckgo.com/lite/?q=";
+var WIKI_API_URL = "https://en.wikipedia.org/w/api.php";
 var COMMON_HEADERS = {
-  "User-Agent": "Mozilla/5.0 (compatible; cliskill/1.0)",
-  Accept: "text/html"
+  "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+  Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+  "Accept-Language": "en-US,en;q=0.5"
 };
 function parseDuckDuckGoHtml(html, maxResults) {
   const results = [];
@@ -2120,6 +2135,15 @@ function parseDuckDuckGoLite(html, maxResults) {
   }
   return results;
 }
+function parseWikipediaResults(data, maxResults) {
+  const search = data.query?.search;
+  if (!search) return [];
+  return search.slice(0, maxResults).map((item) => ({
+    title: item.title,
+    url: `https://en.wikipedia.org/wiki/${encodeURIComponent(item.title.replace(/ /g, "_"))}`,
+    snippet: stripTags(item.snippet)
+  }));
+}
 function stripTags(html) {
   return html.replace(/<[^>]+>/g, "").replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/"/g, '"').replace(/'/g, "'").replace(/&nbsp;/g, " ").trim();
 }
@@ -2141,13 +2165,13 @@ No results found. Try rephrasing your query or use web_fetch for specific URLs.`
   }
   return lines.join("\n").trim();
 }
-async function fetchWithTimeout(url) {
+async function fetchWithTimeout(url, headers) {
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), SEARCH_TIMEOUT_MS);
   try {
     const response = await fetch(url, {
       signal: controller.signal,
-      headers: COMMON_HEADERS,
+      headers: headers ?? COMMON_HEADERS,
       redirect: "follow"
     });
     return response;
@@ -2157,32 +2181,58 @@ async function fetchWithTimeout(url) {
 }
 var WebSearchTool = class extends BaseTool {
   name = "web_search";
-  description = "Search the web for information";
+  description = "Search the web for information using DuckDuckGo or Wikipedia";
   inputSchema = webSearchInputSchema;
   riskLevel = "safe";
   concurrencySafe = true;
   readOnly = true;
   async execute(input, _context) {
-    if (input.search_engine !== "duckduckgo") {
-      return `Error: Only DuckDuckGo search engine is currently supported. Use web_fetch for other sources.`;
-    }
     const encodedQuery = encodeURIComponent(input.query);
+    if (input.search_engine === "wikipedia") {
+      return this.searchWikipedia(input.query, encodedQuery, input.max_results);
+    }
+    return this.searchDuckDuckGo(input.query, encodedQuery, input.max_results);
+  }
+  async searchDuckDuckGo(query, encodedQuery, maxResults) {
     try {
       const response = await fetchWithTimeout(`${DDG_HTML_URL}${encodedQuery}`);
       if (!response.ok) {
-        return `Error: Search request failed with HTTP ${response.status}. Try using web_fetch instead.`;
+        return this.fallbackToWikipedia(
+          query,
+          encodedQuery,
+          maxResults,
+          `DuckDuckGo returned HTTP ${response.status}`
+        );
       }
       const html = await response.text();
-      let results = parseDuckDuckGoHtml(html, input.max_results);
+      let results = parseDuckDuckGoHtml(html, maxResults);
       if (results.length === 0) {
-        results = await this.fallbackLiteSearch(encodedQuery, input.max_results);
+        results = await this.fallbackLiteSearch(encodedQuery, maxResults);
       }
-      return formatResults(input.query, results);
+      if (results.length === 0) {
+        return this.fallbackToWikipedia(
+          query,
+          encodedQuery,
+          maxResults,
+          "DuckDuckGo returned no results"
+        );
+      }
+      return formatResults(query, results);
     } catch (err) {
       if (err.name === "AbortError") {
-        return "Error: Search request timed out after 15 seconds. Try using web_fetch instead.";
+        return this.fallbackToWikipedia(
+          query,
+          encodedQuery,
+          maxResults,
+          "DuckDuckGo request timed out"
+        );
       }
-      return `Error searching: ${err.message}. Try using web_fetch instead.`;
+      return this.fallbackToWikipedia(
+        query,
+        encodedQuery,
+        maxResults,
+        err.message
+      );
     }
   }
   async fallbackLiteSearch(encodedQuery, maxResults) {
@@ -2195,6 +2245,48 @@ var WebSearchTool = class extends BaseTool {
       return [];
     }
   }
+  async searchWikipedia(query, encodedQuery, maxResults) {
+    try {
+      const url = `${WIKI_API_URL}?action=query&list=search&srsearch=${encodedQuery}&srlimit=${maxResults}&format=json&origin=*`;
+      const response = await fetchWithTimeout(url, {
+        "User-Agent": "cliskill/1.0 (https://github.com/nic11/cliskill)"
+      });
+      if (!response.ok) {
+        return `Error: Wikipedia search failed with HTTP ${response.status}. Try web_fetch instead.`;
+      }
+      const data = await response.json();
+      const results = parseWikipediaResults(data, maxResults);
+      return formatResults(query, results);
+    } catch (err) {
+      if (err.name === "AbortError") {
+        return "Error: Wikipedia search timed out after 15 seconds. Try web_fetch instead.";
+      }
+      return `Error searching Wikipedia: ${err.message}. Try web_fetch instead.`;
+    }
+  }
+  async fallbackToWikipedia(query, encodedQuery, maxResults, reason) {
+    const wikiResults = await this.searchWikipediaRaw(encodedQuery, maxResults);
+    if (wikiResults.length > 0) {
+      const header = `\u26A0\uFE0F DuckDuckGo unavailable (${reason}). Showing Wikipedia results:
+
+`;
+      return header + formatResults(query, wikiResults);
+    }
+    return `Error: Search failed (${reason}) and Wikipedia fallback returned no results. Try web_fetch for specific URLs.`;
+  }
+  async searchWikipediaRaw(encodedQuery, maxResults) {
+    try {
+      const url = `${WIKI_API_URL}?action=query&list=search&srsearch=${encodedQuery}&srlimit=${maxResults}&format=json&origin=*`;
+      const response = await fetchWithTimeout(url, {
+        "User-Agent": "cliskill/1.0 (https://github.com/nic11/cliskill)"
+      });
+      if (!response.ok) return [];
+      const data = await response.json();
+      return parseWikipediaResults(data, maxResults);
+    } catch {
+      return [];
+    }
+  }
 };
 
 // src/tools/builtins/lsp-tool.ts
@@ -9942,4 +10034,4 @@ export {
   MessageList,
   runCli
 };
-//# sourceMappingURL=chunk-ULZHJVWD.js.map
+//# sourceMappingURL=chunk-GCXQJ2SV.js.map