mio-agent-runtime 0.5.5 → 0.5.6

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 (2) hide show
  1. package/README.md +153 -225
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,309 +1,237 @@
1
1
  # Mio Agent Runtime
2
2
 
3
- > 让所有 AI Agent 共享记忆、观察行为、积累经验——安装一次，无感增强。
3
+ **安装一次，所有 Agent 自动获得记忆、观察、策略和进化能力。**
4
4
 
5
- Mio 是 **Agent Control Plane**：不替代任何 Agent，而是为它们提供统一的智能层。
6
- 安装到 Codex、OpenCode、Hermes、WorkBuddy 后，所有 Agent 的决策、错误和结果自动进入共享记忆，跨 Agent 复用经验。
5
+ Mio 不替代任何 AI Agent，而是作为统一智能层嵌入它们。安装后，Codex、OpenCode、Hermes、WorkBuddy 的决策、错误和结果自动进入共享记忆库，跨 Agent 复用经验。
7
6
 
8
7
  ```
9
- ┌─────────────────────────────────────────────┐
10
- │ 用户的日常工具 │
11
- │ Codex · OpenCode · Hermes · WorkBuddy │
12
- └──────────────────┬──────────────────────────┘
13
- │ MCP
14
- ┌─────────┴─────────┐
15
- │ Mio Intelligence │
16
- │ │
17
- │ Memory │ 决策、上下文、问题记录
18
- │ Observer │ 被动观察 Agent 行为
19
- │ Policy │ 高风险操作拦截
20
- │ Experience │ 跨 Agent 经验复用
21
- │ Ideas │ 记忆驱动的创意生成
22
- │ Evolution │ 生态级优化建议
23
- └───────────────────┘
8
+ Codex ─┐
9
+ OpenCode ─┤──── MCP ──── Mio Intelligence Core
10
+ Hermes ─┤ ├─ Memory 决策 / 上下文 / 问题记录
11
+ WorkBuddy ─┘ ├─ Observer 被动观察 Agent 行为
12
+ ├─ Policy 高风险操作拦截
13
+ ├─ Experience 跨 Agent 经验复用
14
+ ├─ Ideas 记忆驱动创意生成
15
+ └─ Evolution 生态级优化建议
24
16
  ```
25
17
 
26
18
  ---
27
19
 
28
- ## 快速开始
20
+ ## Quick Start
29
21
 
30
22
  ```bash
31
- # 1. 全局安装
32
- npm install -g mio-agent-runtime
23
+ npm install -g mio-agent-runtime # 全局安装
24
+ mio init # 初始化 MIO_HOME
25
+ mio install codex # 接入 Codex（可换 opencode / hermes / workbuddy）
26
+ mio status # 确认状态
27
+ ```
33
28
 
34
- # 2. 初始化
35
- mio init
29
+ 安装后重启目标 Agent 即可。无需改变任何使用习惯。
36
30
 
37
- # 3. 接入你使用的 Agent（可多选）
38
- mio install codex # Codex Desktop / CLI
39
- mio install opencode # OpenCode
40
- mio install hermes # Hermes (Nous)
41
- mio install workbuddy # WorkBuddy
31
+ ---
42
32
 
43
- # 4. 查看状态
44
- mio status
45
- ```
33
+ ## CLI
46
34
 
47
- 安装完成后**重启对应 Agent**，Mio 即自动生效。无需改变任何使用习惯。
35
+ | 命令 | 说明 |
36
+ |------|------|
37
+ | `mio init` | 创建 `~/.mio-intelligence` 目录和默认配置 |
38
+ | `mio install <host>` | 接入指定 Agent，写入 MCP 配置 + 规则，启动观察器 |
39
+ | `mio mcp` | 启动 MCP Server（stdio 模式） |
40
+ | `mio status` | 显示运行时状态、各 Adapter 状态、观察器进程 |
41
+ | `mio agents` | 列出已安装的 Agent |
42
+ | `mio observe` | 前台持续监听（Ctrl+C 停止） |
43
+ | `mio observe --start` | 启动后台观察守护进程 |
44
+ | `mio observe --stop` | 停止后台守护进程 |
45
+ | `mio observe --status` | 查看观察器运行状态 |
46
+ | `mio observe --once` | 执行一次采集周期 |
47
+ | `mio --json <cmd>` | 任意命令加 `--json` 输出机器可读格式 |
48
+
49
+ **`mio install` 执行流程：**
50
+
51
+ ```
52
+ mio install codex
53
+ │
54
+ ├─ 写入 MCP Server 配置到 ~/.codex/config.json
55
+ ├─ 注入 Agent 使用规则到 AGENTS.md
56
+ ├─ 回填最近 24h 历史会话
57
+ └─ 启动后台被动观察器
58
+ ```
48
59
 
49
60
  ---
50
61
 
51
- ## 核心能力
62
+ ## MCP Tools
52
63
 
53
- ### 记忆 — `mio.memory.*`
64
+ ### Memory — `mio.memory.*`
54
65
 
55
- | 工具 | 功能 |
56
- |------|------|
57
- | `mio.memory.record` | 记录决策、上下文、问题、笔记 |
58
- | `mio.memory.query` | 按关键词/标签/类型检索历史记忆 |
66
+ | Tool | Description |
67
+ |------|-------------|
68
+ | `mio.memory.record` | 记录决策、上下文、问题、笔记，支持项目级 / 全局级 |
69
+ | `mio.memory.query` | 按关键词、标签、类型检索历史记忆 |
59
70
  | `mio.memory.analyze` | 分析记忆质量：类型分布、重复检测、低质量记录 |
60
71
  | `mio.memory.archive` | 归档不再需要的记忆（可恢复） |
61
- | `mio.memory.migrate` | 在项目级和全局级之间迁移记忆 |
72
+ | `mio.memory.migrate` | 在项目级与全局级之间迁移记忆记录 |
62
73
 
63
- ### 观察 — `mio.observer.*`
74
+ ### Observer — `mio.observer.*`
64
75
 
65
- | 工具 | 功能 |
66
- |------|------|
76
+ | Tool | Description |
77
+ |------|-------------|
67
78
  | `mio.observer.ingest` | 上报 Agent 事件：工具调用、错误、重试、任务结果 |
68
- | `mio.observer.subscribe` | 订阅特定项目/事件类型的实时通知 |
69
- | `mio.observer.digest` | 拉取自上次以来的新事件 |
79
+ | `mio.observer.subscribe` | 订阅特定项目 / 事件类型的实时通知 |
80
+ | `mio.observer.digest` | 拉取自上次以来的新匹配事件 |
70
81
 
71
- ### 策略 — `mio.policy.*`
82
+ ### Policy — `mio.policy.*`
72
83
 
73
- | 工具 | 功能 |
74
- |------|------|
75
- | `mio.policy.check` | 执行高风险操作前检查历史失败率和风险等级 |
84
+ | Tool | Description |
85
+ |------|-------------|
86
+ | `mio.policy.check` | 执行高风险操作前检查历史失败率和风险等级，返回建议 |
76
87
 
77
- ### 经验 — `mio.experience.*`
88
+ ### Experience — `mio.experience.*`
78
89
 
79
- | 工具 | 功能 |
80
- |------|------|
81
- | `mio.experience.reuse` | 记录一次跨 Agent 经验复用（来源→目标→是否改善结果） |
90
+ | Tool | Description |
91
+ |------|-------------|
92
+ | `mio.experience.reuse` | 记录一次跨 Agent 经验复用：来源 Agent → 目标 Agent → 是否改善结果 |
82
93
  | `mio.experience.confirm` | 人工确认自动声明的复用记录 |
83
- | `mio.experience.list` | 查询复用证据，按状态/Agent 过滤 |
94
+ | `mio.experience.list` | 查询复用证据，按状态 / Agent 过滤 |
84
95
 
85
- ### 任务 — `mio.task.*`
96
+ ### Task — `mio.task.*`
86
97
 
87
- | 工具 | 功能 |
88
- |------|------|
89
- | `mio.task.route` | 根据历史经验为任务推荐最佳 Agent |
90
- | `mio.task.record_outcome` | 记录任务执行结果（成功/失败/中止） |
98
+ | Tool | Description |
99
+ |------|-------------|
100
+ | `mio.task.route` | 根据历史经验为任务推荐最佳执行 Agent |
101
+ | `mio.task.record_outcome` | 记录任务执行结果（成功 / 失败 / 中止） |
91
102
 
92
103
  ### Agent — `mio.agent.*`
93
104
 
94
- | 工具 | 功能 |
95
- |------|------|
105
+ | Tool | Description |
106
+ |------|-------------|
96
107
  | `mio.agent.register` | 注册 Agent 元数据（名称、能力、宿主） |
97
108
  | `mio.agent.list` | 列出已注册的 Agent |
98
109
  | `mio.agent.report` | 查询指定 Agent 的能力报告和行为摘要 |
99
110
 
100
- ### 创意 — `mio.idea.*`
111
+ ### Ideas — `mio.idea.*`
101
112
 
102
- | 工具 | 功能 |
103
- |------|------|
104
- | `mio.idea.generate` | 基于记忆库，用 SCAMPER / 类比 / 第一性原理 / 随机刺激 / 约束反转 五种策略生成创意 |
105
- | `mio.idea.list` | 查询已保存的创意，按目标/策略/时间段过滤 |
113
+ | Tool | Description |
114
+ |------|-------------|
115
+ | `mio.idea.generate` | 基于记忆库，用 5 种策略生成创意：SCAMPER / 类比 / 第一性原理 / 随机刺激 / 约束反转 |
116
+ | `mio.idea.list` | 查询已保存的创意，按目标 / 策略 / 时间段过滤 |
106
117
 
107
- ### 进化 — `mio.evolution.*`
118
+ ### Evolution — `mio.evolution.*`
108
119
 
109
- | 工具 | 功能 |
110
- |------|------|
111
- | `mio.evolution.report` | 生成生态系统分析报告 |
112
- | `mio.evolution.suggest` | 输出可执行的优化建议（带 nextAction 和 impact） |
120
+ | Tool | Description |
121
+ |------|-------------|
122
+ | `mio.evolution.report` | 生成 Agent 生态系统分析报告 |
123
+ | `mio.evolution.suggest` | 输出可执行优化建议（含 nextAction 和 impact） |
113
124
 
114
- ### 验证 — `mio.phase0.*`
125
+ ### Validation — `mio.phase0.*`
115
126
 
116
- | 工具 | 功能 |
117
- |------|------|
118
- | `mio.phase0.report` | 生成 Phase 0 跨 Agent 验证报告（JSON / Markdown） |
127
+ | Tool | Description |
128
+ |------|-------------|
129
+ | `mio.phase0.report` | 生成跨 Agent 价值验证报告（JSON / Markdown） |
119
130
 
120
131
  ---
121
132
 
122
- ## 支持的 Agent 宿主
123
-
124
- ### Codex (OpenAI)
125
-
126
- - **接入方式**：修改 `~/.codex/config.json`，注入 `mcpServers.mio`
127
- - **工作流增强**：AGENTS.md 规则注入 → Agent 自动在决策前后调用 Mio
128
- - **被动观察**：不依赖，Codex 默认主动调用 MCP 工具
129
-
130
- ### OpenCode
131
-
132
- - **接入方式**：修改 `~/.config/opencode/opencode.json`（MCP）+ `~/.config/opencode/AGENTS.md`（规则）
133
- - **被动观察**：`mio observe` 通过 `opencode db` 增量读取会话数据库，自动提取任务结果和工具错误，写回 `<workspace>/AGENTS.md` 的 `MIO_CONTEXT` 块
134
- - **增量机制**：按 `part` 表的 `rowid` 游标，只传输 `text` / `tool` 类型，首次只回填 24h 内数据
135
-
136
- ### Hermes (Nous)
137
-
138
- - **接入方式**：`hermes mcp add mio-intelligence --command node --args <server>`
139
- - **被动观察**：增量读取 `<LocalAppData>/hermes/state.db`（`messages.id` 自增游标），无需调用 hermes CLI
140
- - **写回策略**：仅当会话发生在真实 git 仓库时写回 `AGENTS.md`，避免污染用户主目录
141
-
142
- ### WorkBuddy
143
-
144
- - **接入方式**：写入 `~/.workbuddy/mcp.json` + `~/.workbuddy/mcp-approvals.json`
145
- - **规则注入**：写入 `~/.workbuddy/CODEBUDDY.md`（用户级）+ `<workspace>/AGENTS.md`（项目级）
146
- - **被动观察**：监听 `~/.workbuddy/projects/**/*.jsonl`，自动提取任务结果，写回 `<workspace>/.workbuddy/memory/YYYY-MM-DD.md`
147
-
148
- > 所有宿主的被动观察器共享同一套 schema，数据统一存入 `MIO_HOME`，实现跨 Agent 经验复用。
149
-
150
- ---
133
+ ## Supported Hosts
151
134
 
152
- ## 被动观察器
135
+ | Host | MCP Config | Passive Observer | Notes |
136
+ |------|-----------|-----------------|-------|
137
+ | **Codex** | `~/.codex/config.json` | 不需要 | 默认主动调用 MCP 工具 |
138
+ | **OpenCode** | `~/.config/opencode/opencode.json` | `opencode db` 增量读取 | 同时写入 `AGENTS.md` 的 `MIO_CONTEXT` 块 |
139
+ | **Hermes** | `hermes mcp add` | `state.db` 自增游标 | 有原生记忆，Mio 负责跨 Agent 经验接入 |
140
+ | **WorkBuddy** | `~/.workbuddy/mcp.json` | 监听 `projects/**/*.jsonl` | 写回 `CODEBUDDY.md` + `<workspace>/AGENTS.md` |
153
141
 
154
- 被动观察器是 Mio 的核心差异化能力：**不依赖 Agent 主动调用，自动采集行为数据。**
142
+ **被动观察器**是核心差异化：不依赖 Agent 主动调用，自动从会话日志中提取任务结果和工具错误，写入统一数据层。
155
143
 
156
- ```text
157
- Agent 会话日志
158
- ↓
159
- mio observe
160
- ↓
161
- ┌──────────────────┐
162
- │ 提取 task_outcome │
163
- │ 提取 tool error │
164
- │ 生成任务摘要 │
165
- └────────┬─────────┘
166
- ↓
167
- MIO_HOME/traces.jsonl ← 统一行为数据
168
- MIO_HOME/memory.jsonl ← 自动记忆
169
- ↓
170
- 写回 Agent 原生记忆文件 ← 单 Agent 闭环
171
144
  ```
172
-
173
- ### 后台守护进程
174
-
175
- ```bash
176
- mio observe --start # 启动后台守护
177
- mio observe --stop # 停止
178
- mio observe --status # 查看状态
179
- mio observe --once # 执行一次采集周期
180
- mio observe # 前台持续监听（Ctrl+C 停止）
181
- ```
182
-
183
- ### 增量与去重
184
-
185
- - 已处理的文件偏移记录在 `MIO_HOME/observe-state.json`，不会重复写入
186
- - 只回填最近 24h 内更新的会话，避免历史灌入
187
-
188
- ---
189
-
190
- ## CLI 命令
191
-
192
- ```text
193
- mio init 初始化 MIO_HOME 目录结构
194
- mio mcp 启动 MCP Server（stdio 模式，供 Agent 调用）
195
- mio install <host> 接入指定 Agent（codex|opencode|workbuddy|hermes）
196
- mio status 显示运行时状态和所有 Adapter 状态
197
- mio agents 列出已安装的 Agent
198
- mio observe 观察器管理（见上方）
199
- mio --json status 机器可读的状态输出
200
- mio --json agents 机器可读的 Agent 列表
145
+ Agent 会话日志
146
+ ↓
147
+ mio observe（被动监听）
148
+ ↓
149
+ 提取 task_outcome / error / summary
150
+ ↓
151
+ 写入 MIO_HOME/traces.jsonl + memory.jsonl
152
+ ↓
153
+ 写回 Agent 原生记忆文件（单 Agent 闭环）
201
154
  ```
202
155
 
203
- ### `mio install` 做了什么
204
-
205
- ```text
206
- mio install codex
207
- │
208
- ├── 修改 ~/.codex/config.json → 添加 mio MCP Server
209
- ├── 注入 AGENTS.md 规则 → Agent 自动调用 Mio
210
- ├── 执行一次历史回填 → 被动观察已有会话
211
- └── 启动后台观察器 → 持续采集
212
- ```
156
+ 增量机制：已处理文件偏移记录在 `observe-state.json`，只回填 24h 内更新的会话。
213
157
 
214
158
  ---
215
159
 
216
- ## MIO_HOME 目录结构
160
+ ## MIO_HOME
217
161
 
218
162
  默认 `~/.mio-intelligence`，可通过 `MIO_HOME` 环境变量覆盖。
219
163
 
220
- ```text
164
+ ```
221
165
  ~/.mio-intelligence/
222
- ├── config.json 运行时配置（已安装的 Agent 列表）
223
- ├── memory.jsonl 记忆存储（决策、上下文、问题）
224
- ├── traces.jsonl 行为追踪（任务结果、工具调用）
225
- ├── experience-reuse.jsonl 跨 Agent 经验复用记录
226
- ├── ideas.jsonl 生成的创意想法
227
- ├── suggestions.jsonl 进化建议
228
- ├── observe-state.json 观察器增量游标
229
- ├── observe.pid 后台观察器进程 ID
230
- └── logs/ 运行日志
166
+ config.json 运行时配置
167
+ memory.jsonl 记忆存储
168
+ traces.jsonl 行为追踪
169
+ experience-reuse.jsonl 跨 Agent 复用记录
170
+ ideas.jsonl 创意想法
171
+ suggestions.jsonl 进化建议
172
+ observe-state.json 观察器增量游标
173
+ observe.pid 后台守护进程 ID
174
+ logs/ 运行日志
231
175
  ```
232
176
 
233
177
  ---
234
178
 
235
- ## 架构定位
236
-
237
- Mio 不是又一个 AI 助手，而是 **Agent 的控制平面**。
238
-
239
- ```text
240
- 传统模式（每个 Agent 独立）：
241
-
242
- Codex OpenCode Hermes WorkBuddy
243
- (各自记忆) (各自记忆) (各自记忆) (各自记忆)
179
+ ## Architecture
244
180
 
245
- Mio 模式（统一智能层）：
246
-
247
- Codex OpenCode Hermes WorkBuddy
248
- \ | / /
249
- └───────┴────────┴──────────┘
250
- |
251
- Mio Intelligence
252
- ┌──────┴──────┐
253
- │ Memory │ 跨 Agent 共享
254
- │ Observer │ 行为自动采集
255
- │ Policy │ 风险统一管理
256
- │ Experience │ 复用证据链
257
- │ Ideas │ 记忆驱动创意
258
- │ Evolution │ 生态优化
259
- └─────────────┘
181
+ ```
182
+ 传统模式：每个 Agent 独立运作
183
+
184
+ Codex (记忆A) OpenCode (记忆B) Hermes (记忆C)
185
+ ↓ ↓ ↓
186
+ 重复探索 重复探索 重复探索
187
+
188
+ Mio 模式：统一智能层
189
+
190
+ Codex ─┐
191
+ OpenCode ─┤ ┌─────────────────────────┐
192
+ Hermes ─┤────────>│ Mio Intelligence Core │
193
+ WorkBuddy ─┘ │ │
194
+ │ Memory · Observer · Policy │
195
+ │ Experience · Ideas · Evolution │
196
+ └─────────────────────────┘
197
+ │
198
+ 跨 Agent 经验复用 + 生态优化
260
199
  ```
261
200
 
262
- ### 核心差异
263
-
264
- | 维度 | Agent Memory | Mio Control Plane |
265
- |------|-------------|-------------------|
266
- | 作用域 | 单 Agent | 多 Agent 生态 |
267
- | 数据采集 | 依赖 Agent 主动调用 | 被动观察 + 主动调用 |
268
- | 经验流动 | 无 | 跨 Agent 复用 + 证据验证 |
269
- | 风险管理 | 无 | 统一策略检查 |
270
- | 优化对象 | 单个 Agent 的记忆 | 整个 Agent 生态的质量和效率 |
201
+ | | 单 Agent Memory | Mio Control Plane |
202
+ |---|---|---|
203
+ | **作用域** | 单个 Agent | 多 Agent 生态 |
204
+ | **数据采集** | 依赖主动调用 | 被动观察 + 主动调用 |
205
+ | **经验流动** | 无 | 跨 Agent 复用 + 证据验证 |
206
+ | **风险管理** | 无 | 统一策略检查 |
207
+ | **优化目标** | 单 Agent 记忆质量 | 整个生态的效率和质量 |
271
208
 
272
209
  ---
273
210
 
274
- ## 版本要求
211
+ ## Version Requirements
275
212
 
276
- | 版本 | 能力 |
277
- |------|------|
278
- | `< 0.3.6` | 仅主动 MCP 规则注入 |
279
- | `≥ 0.3.6` | 被动观察 + 无感存取 |
280
- | `≥ 0.5.0` | 创意生成 + 进化建议 |
281
-
282
- ```bash
283
- npm install -g mio-agent-runtime@latest
284
- ```
213
+ | Version | Capability |
214
+ |---------|-----------|
215
+ | < 0.3.6 | 仅主动 MCP 规则注入 |
216
+ | >= 0.3.6 | 被动观察 + 无感存取 |
217
+ | >= 0.5.0 | 创意生成 + 进化建议 |
285
218
 
286
219
  ---
287
220
 
288
- ## 开发
221
+ ## Development
289
222
 
290
223
  ```bash
291
224
  git clone https://github.com/your-org/akemi-mio.git
292
225
  cd akemi-mio
293
- node --check server/mio-intelligence-mcp/index.js # 语法检查
294
- npm run check # 全量检查
226
+ npm run check # 全量语法检查
295
227
  ```
296
228
 
297
- ### 发布流程
229
+ **发布流程：**
298
230
 
299
- ```bash
300
- # 1. 编辑 server/mio-intelligence-mcp/index.js
301
- # 2. 复制到 npm 包目录
302
- cp server/mio-intelligence-mcp/index.js tmp/mio-agent-runtime/package/server/mio-intelligence-mcp/index.js
303
- # 3. 更新版本号
304
- # 4. 发布
305
- cd tmp/mio-agent-runtime/package && npm publish
306
- ```
231
+ 1. 编辑 `server/mio-intelligence-mcp/index.js`
232
+ 2. 复制到 `tmp/mio-agent-runtime/package/server/mio-intelligence-mcp/index.js`
233
+ 3. Bump `tmp/mio-agent-runtime/package/package.json` 版本号
234
+ 4. `cd tmp/mio-agent-runtime/package && npm publish`
307
235
 
308
236
  ---
309
237
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mio-agent-runtime",
3
- "version": "0.5.5",
3
+ "version": "0.5.6",
4
4
  "description": "Mio Agent Runtime installer and MCP intelligence layer",
5
5
  "license": "MIT",
6
6
  "type": "commonjs",