@iola_adm/iola-cli 0.1.29 → 0.1.30

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.
package/wiki/Home.md CHANGED
@@ -31,6 +31,7 @@ iola ask "найди школу 29"
31
31
  - [Skills и toolsets](Skills-и-toolsets)
32
32
  - [Локальные файлы](Локальные-файлы)
33
33
  - [Рабочая среда агента](Рабочая-среда-агента)
34
+ - [Платформа агента](Платформа-агента)
34
35
  - [Расширения и локальные данные](Расширения-и-локальные-данные)
35
36
  - [Архивы и мастер настройки](Архивы-и-мастер-настройки)
36
37
  - [Daemon, RPC и cron](Daemon-RPC-и-cron)
@@ -35,6 +35,7 @@ iola quality
35
35
  iola history search "Петрова"
36
36
  iola sessions search "Петрова"
37
37
  iola sessions compact 1
38
+ iola sessions replay 1
38
39
  ```
39
40
 
40
41
  AI:
@@ -45,7 +46,10 @@ iola ask "найди школу 29" --schema json
45
46
  iola ask "найди школу 29" --bare --quiet
46
47
  iola agents list
47
48
  iola agents run quality-checker "проверь школы"
49
+ iola subagents list
50
+ iola subagents run data-analyst "найди школы"
48
51
  iola skills list
52
+ iola skills bundles
49
53
  iola tools toolsets
50
54
  iola files status
51
55
  iola files mode read-only
@@ -55,7 +59,11 @@ iola policy use analyst
55
59
  iola tasks list
56
60
  iola artifacts list
57
61
  iola snapshot list
62
+ iola sandbox fork
58
63
  iola trace last
64
+ iola trajectory last
65
+ iola usage summary
66
+ iola budget status
59
67
  iola export education-contacts --format xlsx --output contacts.xlsx
60
68
  iola changes list
61
69
  iola archive doctor
@@ -67,7 +75,10 @@ iola index folder ./docs
67
75
  iola reports list
68
76
  iola plugins list
69
77
  iola mcp serve
78
+ iola mcp serve --stdio
70
79
  iola memory suggest
80
+ iola memory curate
81
+ iola review config
71
82
  ```
72
83
 
73
84
  Контекст, расписания и daemon:
@@ -75,6 +86,8 @@ iola memory suggest
75
86
  ```bash
76
87
  iola context init
77
88
  iola context list
89
+ iola settings list
90
+ iola settings validate
78
91
  iola cron add "каждый день 09:00 -- quality"
79
92
  iola cron tick
80
93
  iola daemon status
@@ -0,0 +1,104 @@
1
+ # Платформа агента
2
+
3
+ `iola-cli` можно использовать не только как набор команд, но и как локальную платформу агента для работы с открытыми данными городского округа "Город Йошкар-Ола".
4
+
5
+ ## MCP server
6
+
7
+ Локальный MCP server поддерживает `stdio` и HTTP:
8
+
9
+ ```bash
10
+ iola mcp serve --stdio
11
+ iola mcp serve
12
+ ```
13
+
14
+ Доступные MCP-разделы:
15
+
16
+ - `tools/list`, `tools/call`: `status`, `search`, `card`, `quality`, `sync`, `files.tree`, `files.read`, `files.search`, `index.search`, `report`;
17
+ - `resources/list`, `resources/read`: `iola://status`, `iola://sync`, `iola://settings`, `iola://skills`, `iola://memory`, `iola://artifacts`;
18
+ - `prompts/list`, `prompts/get`: `data-question`, `document-review`, `report-build`.
19
+
20
+ ## Настройки слоями
21
+
22
+ Настройки собираются из нескольких слоев:
23
+
24
+ 1. встроенные значения;
25
+ 2. пользовательский файл `~/.iola/config.json`;
26
+ 3. проектный файл `.iola/config.json`;
27
+ 4. локальный файл `.iola/local.json`;
28
+ 5. переменные окружения для runtime.
29
+
30
+ Команды:
31
+
32
+ ```bash
33
+ iola settings list
34
+ iola settings get ai.activeProfile
35
+ iola settings validate
36
+ iola settings init
37
+ ```
38
+
39
+ ## Subagents
40
+
41
+ Subagents позволяют запускать разные рабочие роли поверх тех же данных и AI-профилей:
42
+
43
+ ```bash
44
+ iola subagents list
45
+ iola subagents run data-analyst "найди школы на Петрова"
46
+ iola subagents parallel data-analyst,reviewer "проверь результат"
47
+ iola subagents add culture --profile local --tools --prompt "Работай со слоями культуры Йошкар-Олы."
48
+ ```
49
+
50
+ ## Usage и budget
51
+
52
+ CLI пишет примерный учет запросов, символов, токенов и стоимости:
53
+
54
+ ```bash
55
+ iola usage summary
56
+ iola usage models
57
+ iola usage sessions
58
+ iola budget set daily 5
59
+ iola budget status
60
+ ```
61
+
62
+ Для локальной Ollama стоимость считается `0`, для внешних API используется грубая оценка, чтобы видеть порядок расходов.
63
+
64
+ ## Sandbox и trajectory
65
+
66
+ Sandbox делает копию workspace для рискованных действий:
67
+
68
+ ```bash
69
+ iola sandbox fork
70
+ iola sandbox run "npm test"
71
+ iola sandbox diff PATH
72
+ ```
73
+
74
+ Trajectory export нужен для разбора действий агента:
75
+
76
+ ```bash
77
+ iola trajectory last
78
+ iola trajectory export --format jsonl --output run.jsonl
79
+ ```
80
+
81
+ ## Hooks
82
+
83
+ Hooks можно запускать до и после tools, а также при ошибках:
84
+
85
+ ```bash
86
+ iola hooks events
87
+ iola hooks add PreToolUse "iola trace last 5"
88
+ iola hooks add files_search:"iola memory add Поиск по файлам использовался"
89
+ iola hooks audit
90
+ ```
91
+
92
+ События: `SessionStart`, `BeforeTool`, `AfterTool`, `PreToolUse`, `PostToolUse`, `OnError`, `AfterSync`, `BeforeExport`, `SessionEnd`.
93
+
94
+ ## Review
95
+
96
+ Команды review дают быстрые проверки:
97
+
98
+ ```bash
99
+ iola review config
100
+ iola review data
101
+ iola review docs ./docs
102
+ iola review report report.docx
103
+ ```
104
+