@iola_adm/iola-cli 0.1.29 → 0.1.31

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,8 @@ iola ask "найди школу 29"
31
31
  - [Skills и toolsets](Skills-и-toolsets)
32
32
  - [Локальные файлы](Локальные-файлы)
33
33
  - [Рабочая среда агента](Рабочая-среда-агента)
34
+ - [Платформа агента](Платформа-агента)
35
+ - [Браузерный агент](Браузерный-агент)
34
36
  - [Расширения и локальные данные](Расширения-и-локальные-данные)
35
37
  - [Архивы и мастер настройки](Архивы-и-мастер-настройки)
36
38
  - [Daemon, RPC и cron](Daemon-RPC-и-cron)
@@ -0,0 +1,68 @@
1
+ # Браузерный агент
2
+
3
+ `iola-cli` умеет подключать локальный браузерный runtime на Playwright. Сам npm-пакет остается легким: Chromium и Playwright ставятся отдельно при первом включении браузера.
4
+
5
+ ## Установка
6
+
7
+ ```bash
8
+ iola browser status
9
+ iola browser install
10
+ ```
11
+
12
+ Runtime хранится в `~/.iola/browser-runtime`.
13
+
14
+ ## Базовые команды
15
+
16
+ ```bash
17
+ iola browser open https://example.com
18
+ iola browser text https://example.com
19
+ iola browser html https://example.com --output page.html
20
+ iola browser screenshot https://example.com --output page.png
21
+ iola browser pdf https://example.com --output page.pdf
22
+ ```
23
+
24
+ `open` запускает видимый Chromium и держит его открытым. По умолчанию окно живет 10 минут. Можно задать время:
25
+
26
+ ```bash
27
+ iola browser open https://example.com --wait 30000
28
+ ```
29
+
30
+ ## Действия на странице
31
+
32
+ Клик:
33
+
34
+ ```bash
35
+ iola browser click https://example.com --selector "button" --output after-click.png
36
+ ```
37
+
38
+ Ввод:
39
+
40
+ ```bash
41
+ iola browser type https://example.com --selector "#q" --text "школа 29" --press Enter --wait 2000 --output search.png
42
+ ```
43
+
44
+ Выполнение JavaScript-выражения:
45
+
46
+ ```bash
47
+ iola browser eval https://example.com --script "document.title"
48
+ ```
49
+
50
+ ## MCP
51
+
52
+ Локальный MCP server также отдает браузерные tools:
53
+
54
+ - `browser.text`;
55
+ - `browser.screenshot`.
56
+
57
+ Перед использованием этих tools нужно один раз выполнить:
58
+
59
+ ```bash
60
+ iola browser install
61
+ ```
62
+
63
+ ## Режимы
64
+
65
+ - Для чтения страниц используйте `text`, `html`, `screenshot`, `pdf`.
66
+ - Для действий используйте `click` и `type`.
67
+ - Для ручной авторизации или просмотра используйте `open`.
68
+
@@ -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
@@ -66,8 +74,15 @@ iola import file data.csv --dataset custom
66
74
  iola index folder ./docs
67
75
  iola reports list
68
76
  iola plugins list
77
+ iola browser status
78
+ iola browser install
79
+ iola browser text https://example.com
80
+ iola browser screenshot https://example.com --output page.png
69
81
  iola mcp serve
82
+ iola mcp serve --stdio
70
83
  iola memory suggest
84
+ iola memory curate
85
+ iola review config
71
86
  ```
72
87
 
73
88
  Контекст, расписания и daemon:
@@ -75,6 +90,8 @@ iola memory suggest
75
90
  ```bash
76
91
  iola context init
77
92
  iola context list
93
+ iola settings list
94
+ iola settings validate
78
95
  iola cron add "каждый день 09:00 -- quality"
79
96
  iola cron tick
80
97
  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
+