micro-models-agent 0.24.2 → 0.24.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +312 -312
  2. package/bin/mma.mjs +8 -8
  3. package/dist/main.js +43 -107
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -1,312 +1,312 @@
1
- # MMA — Micro Models Agent v2
2
-
3
- [![npm version](https://img.shields.io/npm/v/micro-models-agent)](https://www.npmjs.com/package/micro-models-agent)
4
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
-
6
- **MMA** — модульный AI-coding агент, оптимизированный для **небольших локальных языковых моделей** (9B параметров, 32K–64K контекст). Работает на ноутбуке, облачное API не требуется.
7
-
8
- ```bash
9
- npm install -g micro-models-agent
10
- mma "перепиши модуль авторизации на JWT"
11
- ```
12
-
13
- Создан и протестирован с [Qwen3.5-9B](https://qwen.readthedocs.io/) через LM Studio / Ollama / llama.cpp.
14
-
15
- ---
16
-
17
- ## Зачем MMA?
18
-
19
- Большинство AI-агентов для кода (Devin, Cursor, Copilot) завязаны на облачные модели или дорогие API. MMA работает иначе:
20
-
21
- - **Создан для моделей 9B** — оптимизирован под Qwen3.5-9B на обычном железе
22
- - **Не требует облака** — полностью работает офлайн с любым OpenAI-совместимым бэкендом
23
- - **Выживает в узком контексте** — умное sliding-window compaction держит 32K-модели продуктивными
24
- - **Отлавливает галлюцинации** — 3-стадийный пайплайн валидации ловит выдумки, к которым склонны маленькие модели
25
- - **Agent-Level MoE** — иерархическая декомпозиция задач: маленькие модели справляются со сложной многошаговой работой
26
-
27
- ---
28
-
29
- ## Возможности
30
-
31
- - **6-состояний цикл агента** (INIT → THINK → ACT → OBSERVE → OUTPUT → ERROR) — чистый, предсказуемый, отлаживаемый
32
- - **Управление бюджетом контекста** — динамический бюджет под модель, sliding-window compaction с извлечением фактов/решений/ошибок
33
- - **Детекция галлюцинаций** — фактическая (пути файлов), согласованности (откат решений), уверенности (короткие/повторяющиеся ответы)
34
- - **Гарантии выполнения** — авто-планирование через LLM (без keyword-эвристик), stuck-detection, off-track предупреждения, авто-продвижение плана
35
- - **Agent-Level MoE** — Router + экспертные сабагенты с фильтрацией инструментов, изолированным контекстом, файловым скоупом и топологическим параллельным выполнением
36
- - **20+ инструментов** — файловая система, шелл, веб-поиск/fetch, браузер (Playwright), планирование, взаимодействие, сабагенты, MCP, пайплайны
37
- - **13 модулей** — скиллы, плагины, MCP-клиент, пайплайны, indexer проекта, постоянная память, контекст, сессии, браузер, выполнение, детекция галлюцинаций, апдейтер, профиль пользователя
38
- - **MCP-клиент** — подключение к любому MCP-серверу (stdio или SSE)
39
- - **YAML-пайплайны** — DAG-движок с параллельными волнами, зависимостями и повторными попытками
40
- - **Управление сессиями** — постоянные JSONL-сессии с REPL-командами
41
- - **Карта проекта** — автоматический обход файлов + извлечение экспортов + дисковый кэш
42
- - **i18n** — все строки интерфейса через `t()`, включены английский и русский
43
- - **8K–120K контекст** — адаптируется под любое контекстное окно модели
44
- - **Без TUI** — минимальный CLI + REPL с markdown→ANSI форматированием
45
- - **llama.cpp / Jinja proven** — проверено на граничных случаях Jinja-шаблонов (system-first, streaming fallback, явный `stream: false`)
46
-
47
- ---
48
-
49
- ## Установка
50
-
51
- ### Требования
52
-
53
- - **Среда выполнения:** [Bun](https://bun.sh) (рекомендуется) или Node.js ≥ 20
54
- - **LLM-бэкенд:** Любой OpenAI-совместимый сервер (LM Studio, Ollama, vLLM, llama.cpp, Together AI)
55
-
56
- ### Через npm (рекомендуется)
57
-
58
- ```bash
59
- npm install -g micro-models-agent@latest
60
- ```
61
-
62
- После установки команда `mma` будет доступна в терминале. Если после установки `mma` не находится — попробуйте переоткрыть терминал или выполните:
63
-
64
- ```bash
65
- # PowerShell
66
- npm uninstall -g micro-models-agent
67
- npm install -g micro-models-agent@latest
68
-
69
- # Проверка
70
- mma --version
71
- ```
72
-
73
- ### Из исходников
74
-
75
- ```bash
76
- git clone https://github.com/your-org/micro-models-agent
77
- cd micro-models-agent
78
- bun install
79
- bun run build:prod
80
- ```
81
-
82
- ---
83
-
84
- ## Быстрый старт
85
-
86
- ### 1. Запустите LLM-бэкенд
87
-
88
- Направьте MMA на любой OpenAI-совместимый эндпоинт. Пример с LM Studio:
89
-
90
- ```bash
91
- # LM Studio слушает http://localhost:1234 по умолчанию
92
- ```
93
-
94
- ### 2. Запустите мастер настройки
95
-
96
- ```bash
97
- bun run mma init
98
- ```
99
-
100
- Сканирует локальные порты, находит модель, тестирует соединение и записывает конфиг.
101
-
102
- ### 3. Используйте агента
103
-
104
- ```bash
105
- # Одноразовый режим
106
- bun run mma "создай REST API на Express и добавь тесты"
107
-
108
- # Интерактивный REPL
109
- bun run dev
110
- ```
111
-
112
- ---
113
-
114
- ## Использование
115
-
116
- ### CLI
117
-
118
- ```bash
119
- bun run mma "<prompt>"
120
-
121
- # Подкоманды
122
- bun run mma init # Интерактивный мастер настройки
123
- bun run mma config set model qwen3.5-9b
124
- bun run mma config show
125
- bun run mma model list # Список доступных моделей
126
- bun run mma model use qwen3.5-9b # Переключить модель
127
- bun run mma provider list # Список провайдеров
128
- bun run mma session list # Список сессий
129
- bun run mma session show <id> # Детали сессии
130
- bun run mma session delete <id> # Удалить сессию
131
- ```
132
-
133
- ### REPL
134
-
135
- ```bash
136
- bun run dev
137
- ```
138
-
139
- | Команда | Алиасы | Описание |
140
- |---------|--------|----------|
141
- | `/help` | | Показать справку |
142
- | `/sessions` | `/ls` | Список сессий (* = активная) |
143
- | `/new <name>` | `/create` | Создать новую сессию |
144
- | `/resume <id\|name>` | `/switch`, `/use` | Переключиться на сессию |
145
- | `/rename <name>` | | Переименовать текущую сессию |
146
- | `/delete <id>` | `/rm` | Удалить сессию |
147
- | `/config set <key> <value>` | | Установить значение конфига |
148
- | `/exit` | | Выйти из REPL |
149
-
150
- ### Разработка
151
-
152
- ```bash
153
- bun run mma "почини страницу логина" # Запуск агента
154
- bun run dev # Watch-режим (авто-перезапуск при изменениях)
155
- bun run build:prod # Сборка для публикации
156
- bun test # Запуск тестов
157
- bun run typecheck # Проверка типов
158
- ```
159
-
160
- ---
161
-
162
- ## Конфигурация
163
-
164
- 3-слойный конфиг: `defaults.ts` → `~/.mma/config.json` (глобальный) → `.mmrc` (проект) + переменные окружения.
165
-
166
- Ключевые опции (полный список в `src/config/defaults.ts`):
167
-
168
- | Опция | По умолчанию | Описание |
169
- |-------|-------------|----------|
170
- | `model` | `qwen3.5-9b` | Имя модели для бэкенда |
171
- | `provider.baseUrl` | `http://localhost:1234/v1` | URL OpenAI-совместимого API |
172
- | `contextWindow` | `32768` | Контекстное окно модели в токенах |
173
- | `autoPlan` | `true` | Авто-создание планов для многошаговых задач |
174
- | `maxToolIterations` | `25` | Макс. вызовов инструментов за запуск |
175
- | `stuckThreshold` | `8` | Итераций без прогресса до stuck-detection |
176
- | `moe.enabled` | `false` | Включить Agent-Level MoE |
177
- | `locale` | `en` | Язык интерфейса (`en` / `ru`) |
178
- | `logLevel` | `info` | Уровень логирования |
179
-
180
- ### Agent-Level MoE
181
-
182
- ```json
183
- {
184
- "moe": { "enabled": true },
185
- "orchestrator": {
186
- "model": "qwen3-70b-414k",
187
- "provider": { "baseUrl": "http://localhost:1234/v1" }
188
- },
189
- "experts": {
190
- "code": { "model": "qwen3.5-9b", "tool_tags": ["file", "code", "shell"], "max_attempts": 3 },
191
- "research": { "model": "qwen3.5-9b", "tool_tags": ["research"], "max_attempts": 3 },
192
- "browser": { "model": "qwen3.5-9b", "tool_tags": ["browser", "vision"], "max_attempts": 3 }
193
- }
194
- }
195
- ```
196
-
197
- ---
198
-
199
- ## Архитектура
200
-
201
- ```
202
- CLI (main.ts → commands.ts / repl.ts / setup.ts)
203
- → Core (agent.ts state machine → prompt-builder.ts)
204
- → LLM Layer (provider.ts → openai-compat.ts → response.ts → token-counter.ts)
205
- → Tools (registry.ts → executor.ts → 20+ tools)
206
- → Modules (skills, plugins, mcp, pipelines, indexer, memory, context, session,
207
- hallucination, execution, updater, user-profile, browser)
208
- ```
209
-
210
- ### Структура проекта
211
-
212
- ```
213
- src/
214
- ├── core/ # Цикл агента, сборщик промптов, типы
215
- ├── llm/ # Абстракция провайдера, OpenAI-совместимость, стриминг, подсчёт токенов
216
- ├── tools/ # 20+ инструментов с реестром, исполнителем, скоуп-гардами
217
- ├── modules/ # 13 модулей (скиллы, плагины, mcp, пайплайны, indexer, память, контекст, сессии, галлюцинации, выполнение, апдейтер, профиль, браузер)
218
- ├── cli/ # Точка входа, команды, REPL, мастер настройки
219
- ├── config/ # 3-слойный конфиг: defaults → глобальный → проект
220
- ├── i18n/ # en.json + ru.json + t()
221
- ├── ui/ # Markdown→ANSI форматтер
222
- └── logger/ # Структурированный логгер с уровнями и дочерними логгерами
223
- ```
224
-
225
- ---
226
-
227
- ## Инструменты
228
-
229
- | Инструмент | Описание |
230
- |------------|----------|
231
- | `read_file` | Чтение файла с offset/limit |
232
- | `write_file` | Создание/перезапись с созданием директорий |
233
- | `edit_file` | Поиск-и-замена в существующих файлах |
234
- | `glob` | Поиск по glob-паттернам |
235
- | `grep` | Поиск по содержимому через ripgrep |
236
- | `list_dir` | Список содержимого директории |
237
- | `create_dir` | Создание директории (рекурсивно) |
238
- | `delete_file` | Удаление файла или пустой директории |
239
- | `move_file` | Перемещение/переименование файла или директории |
240
- | `file_info` | Метаданные файла/директории |
241
- | `bash` | Выполнение shell-команд |
242
- | `subagent` | Изолированный сабагент со скоупом |
243
- | `web_search` | Поиск в интернете |
244
- | `web_fetch` | Загрузка веб-страницы (15K символов, 15s таймаут) |
245
- | `web_browse` | Браузер на Playwright (клик, ввод, скролл, скриншот) |
246
- | `plan` | Создание/обновление/отмена планов |
247
- | `todo` | Отслеживание задач |
248
- | `question` | Задать вопрос пользователю |
249
- | `approve` | Запросить подтверждение пользователя |
250
- | `load_skill` | Загрузить скилл во время выполнения |
251
- | `pipeline_run` | Выполнить YAML-пайплайн |
252
- | `mcp_call` | Вызвать инструмент MCP-сервера |
253
- | `search_history` | Поиск по истории сессий |
254
- | `project_map` | Запрос карты проекта (summary, refresh, find) |
255
-
256
- ---
257
-
258
- ## Тестирование
259
-
260
- ```bash
261
- bun test # Модульные + компонентные тесты
262
- bun test tests/agent.test.ts # Один файл
263
- bun run test:integration # Интеграционные тесты (требуют LLM-бэкенд)
264
- bun run typecheck # Проверка типов
265
- ```
266
-
267
- ### Тестирование агента из консоли (agent-driven)
268
-
269
- MMA можно тестировать в одноразовом headless-режиме без интерактивного REPL — это удобно для проверки фич и регрессий из терминала или другим агентом:
270
-
271
- ```bash
272
- # Одноразовый прогон: без AGENTS.md, выход сразу после ответа, песочница
273
- bun run mma "<промпт>" --no-agents-md --exit-on-complete -d <путь-к-песочнице>
274
- ```
275
-
276
- - **Песочница** — всегда внутри `_testing/` в корне проекта (например `_testing/<case-name>/`), никогда в корне или в `src/`. Папка `_testing/` добавлена в `.gitignore`.
277
- - **`--no-agents-md`** — не грузить AGENTS.md проекта в системный промпт (чистая среда).
278
- - **`--exit-on-complete`** — выйти сразу после первого финального ответа; интерактивные тулзы (`question`/`approve`) не блокируют stdin, а возвращают ошибку.
279
- - **`-d <dir>`** — рабочая директория агента (туда он создаёт файлы).
280
- - Каждый прогон сохраняется в сессию `~/.mma/sessions/<id>/` — можно посмотреть через `bun run mma session list` / `session show <id>`.
281
-
282
- ---
283
-
284
- ## Принципы дизайна
285
-
286
- 1. **Ни одного файла >300 строк** — разделяй при приближении к лимиту
287
- 2. **Маленькие файлы, одна ответственность** — каждый файл делает одно дело
288
- 3. **KISS state machine** — никаких god-объектов, никакой вложенности if-else в цикле агента
289
- 4. **Изоляция ошибок плагинов** — падение одного плагина не останавливает другие
290
- 5. **Безопасность путей** — все файловые инструменты проверяют `targetPath.startsWith(baseDir)`
291
- 6. **TDD** — сначала тест, потом реализация, потом коммит
292
- 7. **Никаких захардкоженных строк** — весь текст через `t()` i18n
293
- 8. **Никакого keyword matching** — LLM решает когда планировать, не эвристики
294
- 9. **Без TUI** — минимальный CLI + REPL с markdown→ANSI
295
-
296
- ---
297
-
298
- ## Лицензия
299
-
300
- MIT
301
-
302
- ---
303
-
304
- ## Благодарности
305
-
306
- - [Qwen3.5-9B](https://qwen.readthedocs.io/) — основная целевая модель
307
- - [LM Studio](https://lmstudio.ai/) — рекомендуемый локальный инференс-сервер
308
- - [llama.cpp](https://github.com/ggerganov/llama.cpp) — инференс-движок
309
-
310
- ---
311
-
312
- **Сделано для локальных моделей. Работает везде.**
1
+ # MMA — Micro Models Agent v2
2
+
3
+ [![npm version](https://img.shields.io/npm/v/micro-models-agent)](https://www.npmjs.com/package/micro-models-agent)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
5
+
6
+ **MMA** — модульный AI-coding агент, оптимизированный для **небольших локальных языковых моделей** (9B параметров, 32K–64K контекст). Работает на ноутбуке, облачное API не требуется.
7
+
8
+ ```bash
9
+ npm install -g micro-models-agent
10
+ mma "перепиши модуль авторизации на JWT"
11
+ ```
12
+
13
+ Создан и протестирован с [Qwen3.5-9B](https://qwen.readthedocs.io/) через LM Studio / Ollama / llama.cpp.
14
+
15
+ ---
16
+
17
+ ## Зачем MMA?
18
+
19
+ Большинство AI-агентов для кода (Devin, Cursor, Copilot) завязаны на облачные модели или дорогие API. MMA работает иначе:
20
+
21
+ - **Создан для моделей 9B** — оптимизирован под Qwen3.5-9B на обычном железе
22
+ - **Не требует облака** — полностью работает офлайн с любым OpenAI-совместимым бэкендом
23
+ - **Выживает в узком контексте** — умное sliding-window compaction держит 32K-модели продуктивными
24
+ - **Отлавливает галлюцинации** — 3-стадийный пайплайн валидации ловит выдумки, к которым склонны маленькие модели
25
+ - **Agent-Level MoE** — иерархическая декомпозиция задач: маленькие модели справляются со сложной многошаговой работой
26
+
27
+ ---
28
+
29
+ ## Возможности
30
+
31
+ - **6-состояний цикл агента** (INIT → THINK → ACT → OBSERVE → OUTPUT → ERROR) — чистый, предсказуемый, отлаживаемый
32
+ - **Управление бюджетом контекста** — динамический бюджет под модель, sliding-window compaction с извлечением фактов/решений/ошибок
33
+ - **Детекция галлюцинаций** — фактическая (пути файлов), согласованности (откат решений), уверенности (короткие/повторяющиеся ответы)
34
+ - **Гарантии выполнения** — авто-планирование через LLM (без keyword-эвристик), stuck-detection, off-track предупреждения, авто-продвижение плана
35
+ - **Agent-Level MoE** — Router + экспертные сабагенты с фильтрацией инструментов, изолированным контекстом, файловым скоупом и топологическим параллельным выполнением
36
+ - **20+ инструментов** — файловая система, шелл, веб-поиск/fetch, браузер (Playwright), планирование, взаимодействие, сабагенты, MCP, пайплайны
37
+ - **13 модулей** — скиллы, плагины, MCP-клиент, пайплайны, indexer проекта, постоянная память, контекст, сессии, браузер, выполнение, детекция галлюцинаций, апдейтер, профиль пользователя
38
+ - **MCP-клиент** — подключение к любому MCP-серверу (stdio или SSE)
39
+ - **YAML-пайплайны** — DAG-движок с параллельными волнами, зависимостями и повторными попытками
40
+ - **Управление сессиями** — постоянные JSONL-сессии с REPL-командами
41
+ - **Карта проекта** — автоматический обход файлов + извлечение экспортов + дисковый кэш
42
+ - **i18n** — все строки интерфейса через `t()`, включены английский и русский
43
+ - **8K–120K контекст** — адаптируется под любое контекстное окно модели
44
+ - **Без TUI** — минимальный CLI + REPL с markdown→ANSI форматированием
45
+ - **llama.cpp / Jinja proven** — проверено на граничных случаях Jinja-шаблонов (system-first, streaming fallback, явный `stream: false`)
46
+
47
+ ---
48
+
49
+ ## Установка
50
+
51
+ ### Требования
52
+
53
+ - **Среда выполнения:** [Bun](https://bun.sh) (рекомендуется) или Node.js ≥ 20
54
+ - **LLM-бэкенд:** Любой OpenAI-совместимый сервер (LM Studio, Ollama, vLLM, llama.cpp, Together AI)
55
+
56
+ ### Через npm (рекомендуется)
57
+
58
+ ```bash
59
+ npm install -g micro-models-agent@latest
60
+ ```
61
+
62
+ После установки команда `mma` будет доступна в терминале. Если после установки `mma` не находится — попробуйте переоткрыть терминал или выполните:
63
+
64
+ ```bash
65
+ # PowerShell
66
+ npm uninstall -g micro-models-agent
67
+ npm install -g micro-models-agent@latest
68
+
69
+ # Проверка
70
+ mma --version
71
+ ```
72
+
73
+ ### Из исходников
74
+
75
+ ```bash
76
+ git clone https://github.com/your-org/micro-models-agent
77
+ cd micro-models-agent
78
+ bun install
79
+ bun run build:prod
80
+ ```
81
+
82
+ ---
83
+
84
+ ## Быстрый старт
85
+
86
+ ### 1. Запустите LLM-бэкенд
87
+
88
+ Направьте MMA на любой OpenAI-совместимый эндпоинт. Пример с LM Studio:
89
+
90
+ ```bash
91
+ # LM Studio слушает http://localhost:1234 по умолчанию
92
+ ```
93
+
94
+ ### 2. Запустите мастер настройки
95
+
96
+ ```bash
97
+ bun run mma init
98
+ ```
99
+
100
+ Сканирует локальные порты, находит модель, тестирует соединение и записывает конфиг.
101
+
102
+ ### 3. Используйте агента
103
+
104
+ ```bash
105
+ # Одноразовый режим
106
+ bun run mma "создай REST API на Express и добавь тесты"
107
+
108
+ # Интерактивный REPL
109
+ bun run dev
110
+ ```
111
+
112
+ ---
113
+
114
+ ## Использование
115
+
116
+ ### CLI
117
+
118
+ ```bash
119
+ bun run mma "<prompt>"
120
+
121
+ # Подкоманды
122
+ bun run mma init # Интерактивный мастер настройки
123
+ bun run mma config set model qwen3.5-9b
124
+ bun run mma config show
125
+ bun run mma model list # Список доступных моделей
126
+ bun run mma model use qwen3.5-9b # Переключить модель
127
+ bun run mma provider list # Список провайдеров
128
+ bun run mma session list # Список сессий
129
+ bun run mma session show <id> # Детали сессии
130
+ bun run mma session delete <id> # Удалить сессию
131
+ ```
132
+
133
+ ### REPL
134
+
135
+ ```bash
136
+ bun run dev
137
+ ```
138
+
139
+ | Команда | Алиасы | Описание |
140
+ |---------|--------|----------|
141
+ | `/help` | | Показать справку |
142
+ | `/sessions` | `/ls` | Список сессий (* = активная) |
143
+ | `/new <name>` | `/create` | Создать новую сессию |
144
+ | `/resume <id\|name>` | `/switch`, `/use` | Переключиться на сессию |
145
+ | `/rename <name>` | | Переименовать текущую сессию |
146
+ | `/delete <id>` | `/rm` | Удалить сессию |
147
+ | `/config set <key> <value>` | | Установить значение конфига |
148
+ | `/exit` | | Выйти из REPL |
149
+
150
+ ### Разработка
151
+
152
+ ```bash
153
+ bun run mma "почини страницу логина" # Запуск агента
154
+ bun run dev # Watch-режим (авто-перезапуск при изменениях)
155
+ bun run build:prod # Сборка для публикации
156
+ bun test # Запуск тестов
157
+ bun run typecheck # Проверка типов
158
+ ```
159
+
160
+ ---
161
+
162
+ ## Конфигурация
163
+
164
+ 3-слойный конфиг: `defaults.ts` → `~/.mma/config.json` (глобальный) → `.mmrc` (проект) + переменные окружения.
165
+
166
+ Ключевые опции (полный список в `src/config/defaults.ts`):
167
+
168
+ | Опция | По умолчанию | Описание |
169
+ |-------|-------------|----------|
170
+ | `model` | `qwen3.5-9b` | Имя модели для бэкенда |
171
+ | `provider.baseUrl` | `http://localhost:1234/v1` | URL OpenAI-совместимого API |
172
+ | `contextWindow` | `32768` | Контекстное окно модели в токенах |
173
+ | `autoPlan` | `true` | Авто-создание планов для многошаговых задач |
174
+ | `maxToolIterations` | `25` | Макс. вызовов инструментов за запуск |
175
+ | `stuckThreshold` | `8` | Итераций без прогресса до stuck-detection |
176
+ | `moe.enabled` | `false` | Включить Agent-Level MoE |
177
+ | `locale` | `en` | Язык интерфейса (`en` / `ru`) |
178
+ | `logLevel` | `info` | Уровень логирования |
179
+
180
+ ### Agent-Level MoE
181
+
182
+ ```json
183
+ {
184
+ "moe": { "enabled": true },
185
+ "orchestrator": {
186
+ "model": "qwen3-70b-414k",
187
+ "provider": { "baseUrl": "http://localhost:1234/v1" }
188
+ },
189
+ "experts": {
190
+ "code": { "model": "qwen3.5-9b", "tool_tags": ["file", "code", "shell"], "max_attempts": 3 },
191
+ "research": { "model": "qwen3.5-9b", "tool_tags": ["research"], "max_attempts": 3 },
192
+ "browser": { "model": "qwen3.5-9b", "tool_tags": ["browser", "vision"], "max_attempts": 3 }
193
+ }
194
+ }
195
+ ```
196
+
197
+ ---
198
+
199
+ ## Архитектура
200
+
201
+ ```
202
+ CLI (main.ts → commands.ts / repl.ts / setup.ts)
203
+ → Core (agent.ts state machine → prompt-builder.ts)
204
+ → LLM Layer (provider.ts → openai-compat.ts → response.ts → token-counter.ts)
205
+ → Tools (registry.ts → executor.ts → 20+ tools)
206
+ → Modules (skills, plugins, mcp, pipelines, indexer, memory, context, session,
207
+ hallucination, execution, updater, user-profile, browser)
208
+ ```
209
+
210
+ ### Структура проекта
211
+
212
+ ```
213
+ src/
214
+ ├── core/ # Цикл агента, сборщик промптов, типы
215
+ ├── llm/ # Абстракция провайдера, OpenAI-совместимость, стриминг, подсчёт токенов
216
+ ├── tools/ # 20+ инструментов с реестром, исполнителем, скоуп-гардами
217
+ ├── modules/ # 13 модулей (скиллы, плагины, mcp, пайплайны, indexer, память, контекст, сессии, галлюцинации, выполнение, апдейтер, профиль, браузер)
218
+ ├── cli/ # Точка входа, команды, REPL, мастер настройки
219
+ ├── config/ # 3-слойный конфиг: defaults → глобальный → проект
220
+ ├── i18n/ # en.json + ru.json + t()
221
+ ├── ui/ # Markdown→ANSI форматтер
222
+ └── logger/ # Структурированный логгер с уровнями и дочерними логгерами
223
+ ```
224
+
225
+ ---
226
+
227
+ ## Инструменты
228
+
229
+ | Инструмент | Описание |
230
+ |------------|----------|
231
+ | `read_file` | Чтение файла с offset/limit |
232
+ | `write_file` | Создание/перезапись с созданием директорий |
233
+ | `edit_file` | Поиск-и-замена в существующих файлах |
234
+ | `glob` | Поиск по glob-паттернам |
235
+ | `grep` | Поиск по содержимому через ripgrep |
236
+ | `list_dir` | Список содержимого директории |
237
+ | `create_dir` | Создание директории (рекурсивно) |
238
+ | `delete_file` | Удаление файла или пустой директории |
239
+ | `move_file` | Перемещение/переименование файла или директории |
240
+ | `file_info` | Метаданные файла/директории |
241
+ | `bash` | Выполнение shell-команд |
242
+ | `subagent` | Изолированный сабагент со скоупом |
243
+ | `web_search` | Поиск в интернете |
244
+ | `web_fetch` | Загрузка веб-страницы (15K символов, 15s таймаут) |
245
+ | `web_browse` | Браузер на Playwright (клик, ввод, скролл, скриншот) |
246
+ | `plan` | Создание/обновление/отмена планов |
247
+ | `todo` | Отслеживание задач |
248
+ | `question` | Задать вопрос пользователю |
249
+ | `approve` | Запросить подтверждение пользователя |
250
+ | `load_skill` | Загрузить скилл во время выполнения |
251
+ | `pipeline_run` | Выполнить YAML-пайплайн |
252
+ | `mcp_call` | Вызвать инструмент MCP-сервера |
253
+ | `search_history` | Поиск по истории сессий |
254
+ | `project_map` | Запрос карты проекта (summary, refresh, find) |
255
+
256
+ ---
257
+
258
+ ## Тестирование
259
+
260
+ ```bash
261
+ bun test # Модульные + компонентные тесты
262
+ bun test tests/agent.test.ts # Один файл
263
+ bun run test:integration # Интеграционные тесты (требуют LLM-бэкенд)
264
+ bun run typecheck # Проверка типов
265
+ ```
266
+
267
+ ### Тестирование агента из консоли (agent-driven)
268
+
269
+ MMA можно тестировать в одноразовом headless-режиме без интерактивного REPL — это удобно для проверки фич и регрессий из терминала или другим агентом:
270
+
271
+ ```bash
272
+ # Одноразовый прогон: без AGENTS.md, выход сразу после ответа, песочница
273
+ bun run mma "<промпт>" --no-agents-md --exit-on-complete -d <путь-к-песочнице>
274
+ ```
275
+
276
+ - **Песочница** — всегда внутри `_testing/` в корне проекта (например `_testing/<case-name>/`), никогда в корне или в `src/`. Папка `_testing/` добавлена в `.gitignore`.
277
+ - **`--no-agents-md`** — не грузить AGENTS.md проекта в системный промпт (чистая среда).
278
+ - **`--exit-on-complete`** — выйти сразу после первого финального ответа; интерактивные тулзы (`question`/`approve`) не блокируют stdin, а возвращают ошибку.
279
+ - **`-d <dir>`** — рабочая директория агента (туда он создаёт файлы).
280
+ - Каждый прогон сохраняется в сессию `~/.mma/sessions/<id>/` — можно посмотреть через `bun run mma session list` / `session show <id>`.
281
+
282
+ ---
283
+
284
+ ## Принципы дизайна
285
+
286
+ 1. **Ни одного файла >300 строк** — разделяй при приближении к лимиту
287
+ 2. **Маленькие файлы, одна ответственность** — каждый файл делает одно дело
288
+ 3. **KISS state machine** — никаких god-объектов, никакой вложенности if-else в цикле агента
289
+ 4. **Изоляция ошибок плагинов** — падение одного плагина не останавливает другие
290
+ 5. **Безопасность путей** — все файловые инструменты проверяют `targetPath.startsWith(baseDir)`
291
+ 6. **TDD** — сначала тест, потом реализация, потом коммит
292
+ 7. **Никаких захардкоженных строк** — весь текст через `t()` i18n
293
+ 8. **Никакого keyword matching** — LLM решает когда планировать, не эвристики
294
+ 9. **Без TUI** — минимальный CLI + REPL с markdown→ANSI
295
+
296
+ ---
297
+
298
+ ## Лицензия
299
+
300
+ MIT
301
+
302
+ ---
303
+
304
+ ## Благодарности
305
+
306
+ - [Qwen3.5-9B](https://qwen.readthedocs.io/) — основная целевая модель
307
+ - [LM Studio](https://lmstudio.ai/) — рекомендуемый локальный инференс-сервер
308
+ - [llama.cpp](https://github.com/ggerganov/llama.cpp) — инференс-движок
309
+
310
+ ---
311
+
312
+ **Сделано для локальных моделей. Работает везде.**
package/bin/mma.mjs CHANGED
@@ -1,8 +1,8 @@
1
- #!/usr/bin/env node
2
- import { fileURLToPath, pathToFileURL } from "node:url";
3
- import { dirname, join } from "node:path";
4
-
5
- const __dirname = dirname(fileURLToPath(import.meta.url));
6
- const main = join(__dirname, "..", "dist", "main.js");
7
-
8
- await import(pathToFileURL(main).href);
1
+ #!/usr/bin/env node
2
+ import { fileURLToPath, pathToFileURL } from "node:url";
3
+ import { dirname, join } from "node:path";
4
+
5
+ const __dirname = dirname(fileURLToPath(import.meta.url));
6
+ const main = join(__dirname, "..", "dist", "main.js");
7
+
8
+ await import(pathToFileURL(main).href);
package/dist/main.js CHANGED
@@ -5664,8 +5664,13 @@ var init_read_file = __esm(() => {
5664
5664
  remaining: String(total - end),
5665
5665
  next: String(end + 1)
5666
5666
  }) : "";
5667
- return { success: true, output: `${header}
5668
- ${selected}${truncated}` };
5667
+ const display = truncated ? `${header}${truncated}` : header;
5668
+ return {
5669
+ success: true,
5670
+ output: `${header}
5671
+ ${selected}${truncated}`,
5672
+ display
5673
+ };
5669
5674
  }
5670
5675
  };
5671
5676
  });
@@ -9342,11 +9347,12 @@ ${t("tool.truncated", { tokens: Math.ceil(removedChars / 2) })}`;
9342
9347
  onMeta?.(`
9343
9348
  ` + result.display + `
9344
9349
  `);
9345
- }
9346
- const metaOut = pluginManager.runOnMeta({ iteration, logger }, result.output);
9347
- onMeta?.(`
9350
+ } else {
9351
+ const metaOut = pluginManager.runOnMeta({ iteration, logger }, result.output);
9352
+ onMeta?.(`
9348
9353
  ` + pc.dim(metaOut) + `
9349
9354
  `);
9355
+ }
9350
9356
  if (result.diff) {
9351
9357
  onMeta?.(`
9352
9358
  ` + result.diff + `
@@ -15594,7 +15600,7 @@ function ansiRegex({ onlyFirst = false } = {}) {
15594
15600
  return new RegExp(pattern, onlyFirst ? undefined : "g");
15595
15601
  }
15596
15602
 
15597
- // node_modules/strip-ansi/index.js
15603
+ // node_modules/string-width/node_modules/strip-ansi/index.js
15598
15604
  function stripAnsi(string) {
15599
15605
  if (typeof string !== "string") {
15600
15606
  throw new TypeError(`Expected a \`string\`, got \`${typeof string}\``);
@@ -15693,135 +15699,65 @@ var init_get_east_asian_width = __esm(() => {
15693
15699
  init_lookup();
15694
15700
  });
15695
15701
 
15702
+ // node_modules/emoji-regex/index.js
15703
+ var require_emoji_regex = __commonJS((exports, module) => {
15704
+ module.exports = () => {
15705
+ return /[#*0-9]\uFE0F?\u20E3|[\xA9\xAE\u203C\u2049\u2122\u2139\u2194-\u2199\u21A9\u21AA\u231A\u231B\u2328\u23CF\u23ED-\u23EF\u23F1\u23F2\u23F8-\u23FA\u24C2\u25AA\u25AB\u25B6\u25C0\u25FB\u25FC\u25FE\u2600-\u2604\u260E\u2611\u2614\u2615\u2618\u2620\u2622\u2623\u2626\u262A\u262E\u262F\u2638-\u263A\u2640\u2642\u2648-\u2653\u265F\u2660\u2663\u2665\u2666\u2668\u267B\u267E\u267F\u2692\u2694-\u2697\u2699\u269B\u269C\u26A0\u26A7\u26AA\u26B0\u26B1\u26BD\u26BE\u26C4\u26C8\u26CF\u26D1\u26E9\u26F0-\u26F5\u26F7\u26F8\u26FA\u2702\u2708\u2709\u270F\u2712\u2714\u2716\u271D\u2721\u2733\u2734\u2744\u2747\u2757\u2763\u27A1\u2934\u2935\u2B05-\u2B07\u2B1B\u2B1C\u2B55\u3030\u303D\u3297\u3299]\uFE0F?|[\u261D\u270C\u270D](?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?|[\u270A\u270B](?:\uD83C[\uDFFB-\uDFFF])?|[\u23E9-\u23EC\u23F0\u23F3\u25FD\u2693\u26A1\u26AB\u26C5\u26CE\u26D4\u26EA\u26FD\u2705\u2728\u274C\u274E\u2753-\u2755\u2795-\u2797\u27B0\u27BF\u2B50]|\u26D3\uFE0F?(?:\u200D\uD83D\uDCA5)?|\u26F9(?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?(?:\u200D[\u2640\u2642]\uFE0F?)?|\u2764\uFE0F?(?:\u200D(?:\uD83D\uDD25|\uD83E\uDE79))?|\uD83C(?:[\uDC04\uDD70\uDD71\uDD7E\uDD7F\uDE02\uDE37\uDF21\uDF24-\uDF2C\uDF36\uDF7D\uDF96\uDF97\uDF99-\uDF9B\uDF9E\uDF9F\uDFCD\uDFCE\uDFD4-\uDFDF\uDFF5\uDFF7]\uFE0F?|[\uDF85\uDFC2\uDFC7](?:\uD83C[\uDFFB-\uDFFF])?|[\uDFC4\uDFCA](?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDFCB\uDFCC](?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDCCF\uDD8E\uDD91-\uDD9A\uDE01\uDE1A\uDE2F\uDE32-\uDE36\uDE38-\uDE3A\uDE50\uDE51\uDF00-\uDF20\uDF2D-\uDF35\uDF37-\uDF43\uDF45-\uDF4A\uDF4C-\uDF7C\uDF7E-\uDF84\uDF86-\uDF93\uDFA0-\uDFC1\uDFC5\uDFC6\uDFC8\uDFC9\uDFCF-\uDFD3\uDFE0-\uDFF0\uDFF8-\uDFFF]|\uDDE6\uD83C[\uDDE8-\uDDEC\uDDEE\uDDF1\uDDF2\uDDF4\uDDF6-\uDDFA\uDDFC\uDDFD\uDDFF]|\uDDE7\uD83C[\uDDE6\uDDE7\uDDE9-\uDDEF\uDDF1-\uDDF4\uDDF6-\uDDF9\uDDFB\uDDFC\uDDFE\uDDFF]|\uDDE8\uD83C[\uDDE6\uDDE8\uDDE9\uDDEB-\uDDEE\uDDF0-\uDDF7\uDDFA-\uDDFF]|\uDDE9\uD83C[\uDDEA\uDDEC\uDDEF\uDDF0\uDDF2\uDDF4\uDDFF]|\uDDEA\uD83C[\uDDE6\uDDE8\uDDEA\uDDEC\uDDED\uDDF7-\uDDFA]|\uDDEB\uD83C[\uDDEE-\uDDF0\uDDF2\uDDF4\uDDF7]|\uDDEC\uD83C[\uDDE6\uDDE7\uDDE9-\uDDEE\uDDF1-\uDDF3\uDDF5-\uDDFA\uDDFC\uDDFE]|\uDDED\uD83C[\uDDF0\uDDF2\uDDF3\uDDF7\uDDF9\uDDFA]|\uDDEE\uD83C[\uDDE8-\uDDEA\uDDF1-\uDDF4\uDDF6-\uDDF9]|\uDDEF\uD83C[\uDDEA\uDDF2\uDDF4\uDDF5]|\uDDF0\uD83C[\uDDEA\uDDEC-\uDDEE\uDDF2\uDDF3\uDDF5\uDDF7\uDDFC\uDDFE\uDDFF]|\uDDF1\uD83C[\uDDE6-\uDDE8\uDDEE\uDDF0\uDDF7-\uDDFB\uDDFE]|\uDDF2\uD83C[\uDDE6\uDDE8-\uDDED\uDDF0-\uDDFF]|\uDDF3\uD83C[\uDDE6\uDDE8\uDDEA-\uDDEC\uDDEE\uDDF1\uDDF4\uDDF5\uDDF7\uDDFA\uDDFF]|\uDDF4\uD83C\uDDF2|\uDDF5\uD83C[\uDDE6\uDDEA-\uDDED\uDDF0-\uDDF3\uDDF7-\uDDF9\uDDFC\uDDFE]|\uDDF6\uD83C\uDDE6|\uDDF7\uD83C[\uDDEA\uDDF4\uDDF8\uDDFA\uDDFC]|\uDDF8\uD83C[\uDDE6-\uDDEA\uDDEC-\uDDF4\uDDF7-\uDDF9\uDDFB\uDDFD-\uDDFF]|\uDDF9\uD83C[\uDDE6\uDDE8\uDDE9\uDDEB-\uDDED\uDDEF-\uDDF4\uDDF7\uDDF9\uDDFB\uDDFC\uDDFF]|\uDDFA\uD83C[\uDDE6\uDDEC\uDDF2\uDDF3\uDDF8\uDDFE\uDDFF]|\uDDFB\uD83C[\uDDE6\uDDE8\uDDEA\uDDEC\uDDEE\uDDF3\uDDFA]|\uDDFC\uD83C[\uDDEB\uDDF8]|\uDDFD\uD83C\uDDF0|\uDDFE\uD83C[\uDDEA\uDDF9]|\uDDFF\uD83C[\uDDE6\uDDF2\uDDFC]|\uDF44(?:\u200D\uD83D\uDFEB)?|\uDF4B(?:\u200D\uD83D\uDFE9)?|\uDFC3(?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D(?:[\u2640\u2642]\uFE0F?(?:\u200D\u27A1\uFE0F?)?|\u27A1\uFE0F?))?|\uDFF3\uFE0F?(?:\u200D(?:\u26A7\uFE0F?|\uD83C\uDF08))?|\uDFF4(?:\u200D\u2620\uFE0F?|\uDB40\uDC67\uDB40\uDC62\uDB40(?:\uDC65\uDB40\uDC6E\uDB40\uDC67|\uDC73\uDB40\uDC63\uDB40\uDC74|\uDC77\uDB40\uDC6C\uDB40\uDC73)\uDB40\uDC7F)?)|\uD83D(?:[\uDC3F\uDCFD\uDD49\uDD4A\uDD6F\uDD70\uDD73\uDD76-\uDD79\uDD87\uDD8A-\uDD8D\uDDA5\uDDA8\uDDB1\uDDB2\uDDBC\uDDC2-\uDDC4\uDDD1-\uDDD3\uDDDC-\uDDDE\uDDE1\uDDE3\uDDE8\uDDEF\uDDF3\uDDFA\uDECB\uDECD-\uDECF\uDEE0-\uDEE5\uDEE9\uDEF0\uDEF3]\uFE0F?|[\uDC42\uDC43\uDC46-\uDC50\uDC66\uDC67\uDC6B-\uDC6D\uDC72\uDC74-\uDC76\uDC78\uDC7C\uDC83\uDC85\uDC8F\uDC91\uDCAA\uDD7A\uDD95\uDD96\uDE4C\uDE4F\uDEC0\uDECC](?:\uD83C[\uDFFB-\uDFFF])?|[\uDC6E-\uDC71\uDC73\uDC77\uDC81\uDC82\uDC86\uDC87\uDE45-\uDE47\uDE4B\uDE4D\uDE4E\uDEA3\uDEB4\uDEB5](?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDD74\uDD90](?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?|[\uDC00-\uDC07\uDC09-\uDC14\uDC16-\uDC25\uDC27-\uDC3A\uDC3C-\uDC3E\uDC40\uDC44\uDC45\uDC51-\uDC65\uDC6A\uDC79-\uDC7B\uDC7D-\uDC80\uDC84\uDC88-\uDC8E\uDC90\uDC92-\uDCA9\uDCAB-\uDCFC\uDCFF-\uDD3D\uDD4B-\uDD4E\uDD50-\uDD67\uDDA4\uDDFB-\uDE2D\uDE2F-\uDE34\uDE37-\uDE41\uDE43\uDE44\uDE48-\uDE4A\uDE80-\uDEA2\uDEA4-\uDEB3\uDEB7-\uDEBF\uDEC1-\uDEC5\uDED0-\uDED2\uDED5-\uDED8\uDEDC-\uDEDF\uDEEB\uDEEC\uDEF4-\uDEFC\uDFE0-\uDFEB\uDFF0]|\uDC08(?:\u200D\u2B1B)?|\uDC15(?:\u200D\uD83E\uDDBA)?|\uDC26(?:\u200D(?:\u2B1B|\uD83D\uDD25))?|\uDC3B(?:\u200D\u2744\uFE0F?)?|\uDC41\uFE0F?(?:\u200D\uD83D\uDDE8\uFE0F?)?|\uDC68(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDC68\uDC69]\u200D\uD83D(?:\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?)|[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?)|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]))|\uD83C(?:\uDFFB(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC68\uD83C[\uDFFC-\uDFFF])|\uD83E(?:[\uDD1D\uDEEF]\u200D\uD83D\uDC68\uD83C[\uDFFC-\uDFFF]|[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3])))?|\uDFFC(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC68\uD83C[\uDFFB\uDFFD-\uDFFF])|\uD83E(?:[\uDD1D\uDEEF]\u200D\uD83D\uDC68\uD83C[\uDFFB\uDFFD-\uDFFF]|[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3])))?|\uDFFD(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC68\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])|\uD83E(?:[\uDD1D\uDEEF]\u200D\uD83D\uDC68\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF]|[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3])))?|\uDFFE(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC68\uD83C[\uDFFB-\uDFFD\uDFFF])|\uD83E(?:[\uDD1D\uDEEF]\u200D\uD83D\uDC68\uD83C[\uDFFB-\uDFFD\uDFFF]|[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3])))?|\uDFFF(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC68\uD83C[\uDFFB-\uDFFE])|\uD83E(?:[\uDD1D\uDEEF]\u200D\uD83D\uDC68\uD83C[\uDFFB-\uDFFE]|[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3])))?))?|\uDC69(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?[\uDC68\uDC69]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?|\uDC69\u200D\uD83D(?:\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?))|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]))|\uD83C(?:\uDFFB(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC69\uD83C[\uDFFC-\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFC-\uDFFF]|\uDEEF\u200D\uD83D\uDC69\uD83C[\uDFFC-\uDFFF])))?|\uDFFC(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC69\uD83C[\uDFFB\uDFFD-\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB\uDFFD-\uDFFF]|\uDEEF\u200D\uD83D\uDC69\uD83C[\uDFFB\uDFFD-\uDFFF])))?|\uDFFD(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC69\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF]|\uDEEF\u200D\uD83D\uDC69\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])))?|\uDFFE(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC69\uD83C[\uDFFB-\uDFFD\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB-\uDFFD\uDFFF]|\uDEEF\u200D\uD83D\uDC69\uD83C[\uDFFB-\uDFFD\uDFFF])))?|\uDFFF(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83D\uDC69\uD83C[\uDFFB-\uDFFE])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB-\uDFFE]|\uDEEF\u200D\uD83D\uDC69\uD83C[\uDFFB-\uDFFE])))?))?|\uDD75(?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?(?:\u200D[\u2640\u2642]\uFE0F?)?|\uDE2E(?:\u200D\uD83D\uDCA8)?|\uDE35(?:\u200D\uD83D\uDCAB)?|\uDE36(?:\u200D\uD83C\uDF2B\uFE0F?)?|\uDE42(?:\u200D[\u2194\u2195]\uFE0F?)?|\uDEB6(?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D(?:[\u2640\u2642]\uFE0F?(?:\u200D\u27A1\uFE0F?)?|\u27A1\uFE0F?))?)|\uD83E(?:[\uDD0C\uDD0F\uDD18-\uDD1F\uDD30-\uDD34\uDD36\uDD77\uDDB5\uDDB6\uDDBB\uDDD2\uDDD3\uDDD5\uDEC3-\uDEC5\uDEF0\uDEF2-\uDEF8](?:\uD83C[\uDFFB-\uDFFF])?|[\uDD26\uDD35\uDD37-\uDD39\uDD3C-\uDD3E\uDDB8\uDDB9\uDDCD\uDDCF\uDDD4\uDDD6-\uDDDD](?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDDDE\uDDDF](?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDD0D\uDD0E\uDD10-\uDD17\uDD20-\uDD25\uDD27-\uDD2F\uDD3A\uDD3F-\uDD45\uDD47-\uDD76\uDD78-\uDDB4\uDDB7\uDDBA\uDDBC-\uDDCC\uDDD0\uDDE0-\uDDFF\uDE70-\uDE7C\uDE80-\uDE8A\uDE8E-\uDEC2\uDEC6\uDEC8\uDECD-\uDEDC\uDEDF-\uDEEA\uDEEF]|\uDDCE(?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D(?:[\u2640\u2642]\uFE0F?(?:\u200D\u27A1\uFE0F?)?|\u27A1\uFE0F?))?|\uDDD1(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3\uDE70]|\uDD1D\u200D\uD83E\uDDD1|\uDDD1\u200D\uD83E\uDDD2(?:\u200D\uD83E\uDDD2)?|\uDDD2(?:\u200D\uD83E\uDDD2)?))|\uD83C(?:\uDFFB(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFC-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83E\uDDD1\uD83C[\uDFFC-\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3\uDE70]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF]|\uDEEF\u200D\uD83E\uDDD1\uD83C[\uDFFC-\uDFFF])))?|\uDFFC(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB\uDFFD-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83E\uDDD1\uD83C[\uDFFB\uDFFD-\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3\uDE70]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF]|\uDEEF\u200D\uD83E\uDDD1\uD83C[\uDFFB\uDFFD-\uDFFF])))?|\uDFFD(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83E\uDDD1\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3\uDE70]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF]|\uDEEF\u200D\uD83E\uDDD1\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])))?|\uDFFE(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB-\uDFFD\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFD\uDFFF])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3\uDE70]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF]|\uDEEF\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFD\uDFFF])))?|\uDFFF(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB-\uDFFE]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC30\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFE])|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3\uDE70]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF]|\uDEEF\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFE])))?))?|\uDEF1(?:\uD83C(?:\uDFFB(?:\u200D\uD83E\uDEF2\uD83C[\uDFFC-\uDFFF])?|\uDFFC(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB\uDFFD-\uDFFF])?|\uDFFD(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])?|\uDFFE(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB-\uDFFD\uDFFF])?|\uDFFF(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB-\uDFFE])?))?)/g;
15706
+ };
15707
+ });
15708
+
15696
15709
  // node_modules/string-width/index.js
15697
- function isDoubleWidthNonRgiEmojiSequence(segment) {
15698
- if (segment.length > 50) {
15699
- return false;
15700
- }
15701
- if (unqualifiedKeycapRegex.test(segment)) {
15702
- return true;
15703
- }
15704
- if (segment.includes("‍")) {
15705
- const pictographics = segment.match(extendedPictographicRegex);
15706
- return pictographics !== null && pictographics.length >= 2;
15707
- }
15708
- return false;
15709
- }
15710
- function baseVisible(segment) {
15711
- return segment.replace(leadingNonPrintingRegex, "");
15712
- }
15713
- function isZeroWidthCluster(segment) {
15714
- return zeroWidthClusterRegex.test(segment);
15715
- }
15716
- function isHangulLeadingJamo(codePoint) {
15717
- return codePoint >= 4352 && codePoint <= 4447 || codePoint >= 43360 && codePoint <= 43388;
15718
- }
15719
- function isHangulVowelJamo(codePoint) {
15720
- return codePoint >= 4448 && codePoint <= 4519 || codePoint >= 55216 && codePoint <= 55238;
15721
- }
15722
- function isHangulTrailingJamo(codePoint) {
15723
- return codePoint >= 4520 && codePoint <= 4607 || codePoint >= 55243 && codePoint <= 55291;
15724
- }
15725
- function isHangulJamo(codePoint) {
15726
- return isHangulLeadingJamo(codePoint) || isHangulVowelJamo(codePoint) || isHangulTrailingJamo(codePoint);
15727
- }
15728
- function hangulClusterWidth(visibleSegment, eastAsianWidthOptions) {
15729
- const codePoints = [];
15730
- for (const character of visibleSegment) {
15731
- if (zeroWidthClusterRegex.test(character)) {
15732
- continue;
15733
- }
15734
- codePoints.push(character.codePointAt(0));
15735
- }
15736
- if (codePoints.length === 0) {
15737
- return;
15738
- }
15739
- let width = 0;
15740
- for (let index = 0;index < codePoints.length; index++) {
15741
- const codePoint = codePoints[index];
15742
- if (!isHangulJamo(codePoint)) {
15743
- if (width === 0) {
15744
- return;
15745
- }
15746
- for (let remaining = index;remaining < codePoints.length; remaining++) {
15747
- width += eastAsianWidth(codePoints[remaining], eastAsianWidthOptions);
15748
- }
15749
- return width;
15750
- }
15751
- if (isHangulLeadingJamo(codePoint) && isHangulVowelJamo(codePoints[index + 1])) {
15752
- width += 2;
15753
- index += isHangulTrailingJamo(codePoints[index + 2]) ? 2 : 1;
15754
- continue;
15755
- }
15756
- width += eastAsianWidth(codePoint, eastAsianWidthOptions);
15757
- }
15758
- return width;
15759
- }
15760
- function trailingWidth(visibleSegment, eastAsianWidthOptions) {
15761
- let extra = 0;
15762
- let first = true;
15763
- for (const character of visibleSegment) {
15764
- if (first) {
15765
- first = false;
15766
- continue;
15767
- }
15768
- if (spacingMarkRegex.test(character) || character >= "＀" && character <= "￯") {
15769
- extra += eastAsianWidth(character.codePointAt(0), eastAsianWidthOptions);
15770
- }
15771
- }
15772
- return extra;
15773
- }
15774
- function stringWidth(input, options = {}) {
15775
- if (typeof input !== "string" || input.length === 0) {
15710
+ function stringWidth(string, options = {}) {
15711
+ if (typeof string !== "string" || string.length === 0) {
15776
15712
  return 0;
15777
15713
  }
15778
15714
  const {
15779
15715
  ambiguousIsNarrow = true,
15780
15716
  countAnsiEscapeCodes = false
15781
15717
  } = options;
15782
- let string = input;
15783
- if (!countAnsiEscapeCodes && (string.includes("\x1B") || string.includes("›"))) {
15718
+ if (!countAnsiEscapeCodes) {
15784
15719
  string = stripAnsi(string);
15785
15720
  }
15786
15721
  if (string.length === 0) {
15787
15722
  return 0;
15788
15723
  }
15789
- if (/^[\u0020-\u007E]*$/.test(string)) {
15790
- return string.length;
15791
- }
15792
15724
  let width = 0;
15793
15725
  const eastAsianWidthOptions = { ambiguousAsWide: !ambiguousIsNarrow };
15794
- for (const { segment } of segmenter.segment(string)) {
15795
- if (isZeroWidthCluster(segment)) {
15726
+ for (const { segment: character } of segmenter.segment(string)) {
15727
+ const codePoint = character.codePointAt(0);
15728
+ if (codePoint <= 31 || codePoint >= 127 && codePoint <= 159) {
15796
15729
  continue;
15797
15730
  }
15798
- if (rgiEmojiRegex.test(segment) || isDoubleWidthNonRgiEmojiSequence(segment)) {
15799
- width += 2;
15731
+ if (codePoint >= 8203 && codePoint <= 8207 || codePoint === 65279) {
15732
+ continue;
15733
+ }
15734
+ if (codePoint >= 768 && codePoint <= 879 || codePoint >= 6832 && codePoint <= 6911 || codePoint >= 7616 && codePoint <= 7679 || codePoint >= 8400 && codePoint <= 8447 || codePoint >= 65056 && codePoint <= 65071) {
15800
15735
  continue;
15801
15736
  }
15802
- const visibleSegment = baseVisible(segment);
15803
- const hangulWidth = hangulClusterWidth(visibleSegment, eastAsianWidthOptions);
15804
- if (hangulWidth !== undefined) {
15805
- width += hangulWidth;
15737
+ if (codePoint >= 55296 && codePoint <= 57343) {
15738
+ continue;
15739
+ }
15740
+ if (codePoint >= 65024 && codePoint <= 65039) {
15741
+ continue;
15742
+ }
15743
+ if (defaultIgnorableCodePointRegex.test(character)) {
15744
+ continue;
15745
+ }
15746
+ if (import_emoji_regex.default().test(character)) {
15747
+ width += 2;
15806
15748
  continue;
15807
15749
  }
15808
- const codePoint = visibleSegment.codePointAt(0);
15809
15750
  width += eastAsianWidth(codePoint, eastAsianWidthOptions);
15810
- width += trailingWidth(visibleSegment, eastAsianWidthOptions);
15811
15751
  }
15812
15752
  return width;
15813
15753
  }
15814
- var segmenter, zeroWidthClusterRegex, leadingNonPrintingRegex, spacingMarkRegex, rgiEmojiRegex, unqualifiedKeycapRegex, extendedPictographicRegex;
15754
+ var import_emoji_regex, segmenter, defaultIgnorableCodePointRegex;
15815
15755
  var init_string_width = __esm(() => {
15816
15756
  init_strip_ansi();
15817
15757
  init_get_east_asian_width();
15758
+ import_emoji_regex = __toESM(require_emoji_regex(), 1);
15818
15759
  segmenter = new Intl.Segmenter;
15819
- zeroWidthClusterRegex = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Format}|\p{Nonspacing_Mark}|\p{Enclosing_Mark}|\p{Surrogate})+$/v;
15820
- leadingNonPrintingRegex = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Nonspacing_Mark}\p{Enclosing_Mark}\p{Surrogate}]+/v;
15821
- spacingMarkRegex = /\p{Spacing_Mark}/v;
15822
- rgiEmojiRegex = /^\p{RGI_Emoji}$/v;
15823
- unqualifiedKeycapRegex = /^[\d#*]\u20E3$/;
15824
- extendedPictographicRegex = /\p{Extended_Pictographic}/gu;
15760
+ defaultIgnorableCodePointRegex = /^\p{Default_Ignorable_Code_Point}$/u;
15825
15761
  });
15826
15762
 
15827
15763
  // src/ui/table.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "micro-models-agent",
3
- "version": "0.24.2",
3
+ "version": "0.24.3",
4
4
  "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
5
5
  "type": "module",
6
6
  "bin": {