npm - mio-agent-runtime - Versions diffs - 0.5.4 → 0.5.6 - Mend

mio-agent-runtime 0.5.4 → 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

package/README.md +227 -89
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,102 +1,240 @@
-# mio-agent-runtime
+# Mio Agent Runtime
-Mio Agent Runtime 的可发布 CLI 包。
+**安装一次，所有 Agent 自动获得记忆、观察、策略和进化能力。**
-安装一次，所有 Agent 自动接入 Mio。
+Mio 不替代任何 AI Agent，而是作为统一智能层嵌入它们。安装后，Codex、OpenCode、Hermes、WorkBuddy 的决策、错误和结果自动进入共享记忆库，跨 Agent 复用经验。
-## Install
+```
+  Codex ─┐
+OpenCode ─┤──── MCP ──── Mio Intelligence Core
+  Hermes ─┤                ├─ Memory        决策 / 上下文 / 问题记录
+WorkBuddy ─┘                ├─ Observer      被动观察 Agent 行为
+                            ├─ Policy        高风险操作拦截
+                            ├─ Experience    跨 Agent 经验复用
+                            ├─ Ideas         记忆驱动创意生成
+                            └─ Evolution     生态级优化建议
+```
+---
+## Quick Start
 ```bash
-npm install -g mio-agent-runtime
+npm install -g mio-agent-runtime    # 全局安装
+mio init                            # 初始化 MIO_HOME
+mio install codex                   # 接入 Codex（可换 opencode / hermes / workbuddy）
+mio status                          # 确认状态
 ```
-> 新机器 / 升级：请安装 `>=0.3.6`（Codex + OpenCode + Hermes 被动观察）。
-> 旧版本只有主动 MCP 规则注入，没有「无感存/取」。安装后执行一次
-> `mio init && mio install <host>`。
-## Commands
-```text
-mio init                    Initialize MIO_HOME
-mio mcp                     Start Mio MCP server (stdio)
-mio install <host>          Install Mio into a host (codex|opencode|workbuddy)
-mio status                  Show runtime and adapter status
-mio agents                  List installed agents
-mio observe                 Watch WorkBuddy transcripts and auto-ingest task outcomes (foreground)
-mio observe --start|--stop|--status|--once   Manage the background observer daemon
-mio --json status           Machine-readable status
-mio --json agents           Machine-readable agents
+安装后重启目标 Agent 即可。无需改变任何使用习惯。
+---
+## CLI
+| 命令 | 说明 |
+|------|------|
+| `mio init` | 创建 `~/.mio-intelligence` 目录和默认配置 |
+| `mio install <host>` | 接入指定 Agent，写入 MCP 配置 + 规则，启动观察器 |
+| `mio mcp` | 启动 MCP Server（stdio 模式） |
+| `mio status` | 显示运行时状态、各 Adapter 状态、观察器进程 |
+| `mio agents` | 列出已安装的 Agent |
+| `mio observe` | 前台持续监听（Ctrl+C 停止） |
+| `mio observe --start` | 启动后台观察守护进程 |
+| `mio observe --stop` | 停止后台守护进程 |
+| `mio observe --status` | 查看观察器运行状态 |
+| `mio observe --once` | 执行一次采集周期 |
+| `mio --json <cmd>` | 任意命令加 `--json` 输出机器可读格式 |
+**`mio install` 执行流程：**
+```
+mio install codex
+  │
+  ├─ 写入 MCP Server 配置到 ~/.codex/config.json
+  ├─ 注入 Agent 使用规则到 AGENTS.md
+  ├─ 回填最近 24h 历史会话
+  └─ 启动后台被动观察器
 ```
-## Host notes
-- OpenCode uses `~/.config/opencode/opencode.json` for MCP registration and
-  `~/.config/opencode/AGENTS.md` for global instructions. `mio install opencode`
-  writes both files and injects Mio usage rules into `AGENTS.md` so OpenCode
-  calls Mio memory/observer/policy automatically. If OpenCode is already
-  running, restart it once so it reloads both files. `mio observe` also
-  passively tails the OpenCode session database (`opencode db`) without
-  requiring the model to call Mio tools.
-- Hermes uses `hermes mcp add mio-intelligence --command node --args <server>`
-  to register the Mio MCP server. Hermes has native memory and reads
-  AGENTS.md Context Files, so retrieval works without Mio rule injection.
-- WorkBuddy uses `~/.workbuddy/mcp.json` and requires each custom MCP server to
-  be approved in `~/.workbuddy/mcp-approvals.json`. `mio install workbuddy`
-  writes both files and injects Mio usage rules into
-  `~/.workbuddy/CODEBUDDY.md` (user-level memory rules, auto-loaded by
-  WorkBuddy into every session; the CLI hardcodes the CodeBuddy product name, so the file is CODEBUDDY.md not WORKBUDDY.md) plus `<workspace>/AGENTS.md` (project-level).
-  If WorkBuddy is already running, restart it once so it reloads the approval
-  and memory rule files.
-## Passive observer (`mio observe`)
-WorkBuddy 的默认模型不一定会主动调用 Mio MCP 工具，即使规则已注入
-(`CODEBUDDY.md` / `AGENTS.md`)。`mio observe` 是一个不依赖模型自觉的
-兜底：它持续监听 `~/.workbuddy/projects/**/*.jsonl` 会话记录，把每个任务的
-结果（`task_outcome`）、工具调用错误（`error`）以及完成任务的摘要自动写入
-`MIO_HOME/traces.jsonl` 和 `MIO_HOME/memory.jsonl`（与 MCP 服务同一套
-schema，`source=workbuddy-observer`）。
-- `mio install <host>` 会自动执行一次回填并启动后台观察器。
-- 除了写入 `MIO_HOME`，观察器还会把任务摘要**写回 WorkBuddy 自己的记忆文件**
-  (`<workspace>/.workbuddy/memory/YYYY-MM-DD.md`，标为 `## Mio 自动摘要`)。
-  WorkBuddy 的系统提示要求模型每次会话维护并阅读这些文件，所以下一次会话
-  WorkBuddy 会**被动取到** Mio 记录的内容——单 Agent 的「存 + 取」闭环不依赖
-  模型调用 Mio 工具。
-- 已处理的文件偏移记录在 `MIO_HOME/observe-state.json`，不会重复写入。
-- 只回填最近 24h 内更新的会话，避免把历史记录灌入记忆库。
-OpenCode 会话不依赖模型自觉：`mio observe` 通过 `opencode db` 增量读取
-`~/.local/share/opencode/opencode.db`（Windows 下该文件被 OpenCode 独占锁定，
-必须经 opencode 自带 CLI 读取），按 `part` 表的 rowid 做增量游标，只传输
-`text`/`tool` 两种 part，把每个用户回合的 `task_outcome` 与工具错误写入
-`MIO_HOME/traces.jsonl` / `memory.jsonl`（`source=opencode-observer`），并同样
-把摘要写回 `<workspace>/AGENTS.md` 的 `MIO_CONTEXT` 块，供 OpenCode 下一会话
-被动取用。首次启动只回填最近 24h 的 part，避免历史会话灌入记忆库。
-Hermes（Nous hermes-agent）同理：`mio observe` 以只读方式增量读取
-`<LocalAppData>/hermes/state.db`（`messages.id` 自增游标，无需调用 hermes CLI），
-把每个用户回合的 `task_outcome` 写入 `MIO_HOME`（`source=hermes-observer`）。
-Hermes 本身有原生记忆，Mio 只负责让 Hermes 经验进入跨 Agent 生态；仅当会话
-发生在真实 git 仓库时才写回该仓库的 `AGENTS.md`，避免污染用户主目录。
+---
+## MCP Tools
+### Memory — `mio.memory.*`
+| Tool | Description |
+|------|-------------|
+| `mio.memory.record` | 记录决策、上下文、问题、笔记，支持项目级 / 全局级 |
+| `mio.memory.query` | 按关键词、标签、类型检索历史记忆 |
+| `mio.memory.analyze` | 分析记忆质量：类型分布、重复检测、低质量记录 |
+| `mio.memory.archive` | 归档不再需要的记忆（可恢复） |
+| `mio.memory.migrate` | 在项目级与全局级之间迁移记忆记录 |
+### Observer — `mio.observer.*`
+| Tool | Description |
+|------|-------------|
+| `mio.observer.ingest` | 上报 Agent 事件：工具调用、错误、重试、任务结果 |
+| `mio.observer.subscribe` | 订阅特定项目 / 事件类型的实时通知 |
+| `mio.observer.digest` | 拉取自上次以来的新匹配事件 |
+### Policy — `mio.policy.*`
+| Tool | Description |
+|------|-------------|
+| `mio.policy.check` | 执行高风险操作前检查历史失败率和风险等级，返回建议 |
+### Experience — `mio.experience.*`
+| Tool | Description |
+|------|-------------|
+| `mio.experience.reuse` | 记录一次跨 Agent 经验复用：来源 Agent → 目标 Agent → 是否改善结果 |
+| `mio.experience.confirm` | 人工确认自动声明的复用记录 |
+| `mio.experience.list` | 查询复用证据，按状态 / Agent 过滤 |
+### Task — `mio.task.*`
+| Tool | Description |
+|------|-------------|
+| `mio.task.route` | 根据历史经验为任务推荐最佳执行 Agent |
+| `mio.task.record_outcome` | 记录任务执行结果（成功 / 失败 / 中止） |
+### Agent — `mio.agent.*`
+| Tool | Description |
+|------|-------------|
+| `mio.agent.register` | 注册 Agent 元数据（名称、能力、宿主） |
+| `mio.agent.list` | 列出已注册的 Agent |
+| `mio.agent.report` | 查询指定 Agent 的能力报告和行为摘要 |
+### Ideas — `mio.idea.*`
+| Tool | Description |
+|------|-------------|
+| `mio.idea.generate` | 基于记忆库，用 5 种策略生成创意：SCAMPER / 类比 / 第一性原理 / 随机刺激 / 约束反转 |
+| `mio.idea.list` | 查询已保存的创意，按目标 / 策略 / 时间段过滤 |
+### Evolution — `mio.evolution.*`
+| Tool | Description |
+|------|-------------|
+| `mio.evolution.report` | 生成 Agent 生态系统分析报告 |
+| `mio.evolution.suggest` | 输出可执行优化建议（含 nextAction 和 impact） |
+### Validation — `mio.phase0.*`
+| Tool | Description |
+|------|-------------|
+| `mio.phase0.report` | 生成跨 Agent 价值验证报告（JSON / Markdown） |
+---
+## Supported Hosts
+| Host | MCP Config | Passive Observer | Notes |
+|------|-----------|-----------------|-------|
+| **Codex** | `~/.codex/config.json` | 不需要 | 默认主动调用 MCP 工具 |
+| **OpenCode** | `~/.config/opencode/opencode.json` | `opencode db` 增量读取 | 同时写入 `AGENTS.md` 的 `MIO_CONTEXT` 块 |
+| **Hermes** | `hermes mcp add` | `state.db` 自增游标 | 有原生记忆，Mio 负责跨 Agent 经验接入 |
+| **WorkBuddy** | `~/.workbuddy/mcp.json` | 监听 `projects/**/*.jsonl` | 写回 `CODEBUDDY.md` + `<workspace>/AGENTS.md` |
+**被动观察器**是核心差异化：不依赖 Agent 主动调用，自动从会话日志中提取任务结果和工具错误，写入统一数据层。
+```
+Agent 会话日志
+  ↓
+mio observe（被动监听）
+  ↓
+提取 task_outcome / error / summary
+  ↓
+写入 MIO_HOME/traces.jsonl + memory.jsonl
+  ↓
+写回 Agent 原生记忆文件（单 Agent 闭环）
+```
+增量机制：已处理文件偏移记录在 `observe-state.json`，只回填 24h 内更新的会话。
+---
 ## MIO_HOME
-默认 `~/.mio-intelligence`，可通过环境变量 `MIO_HOME` 覆盖。
-## Package layout
-```text
-packages/mio-cli
-├── bin/mio.js
-├── adapters/
-│   ├── codex.js
-│   ├── opencode.js
-│   └── workbuddy.js
-├── observe/
-│   └── observer.js
-├── server/
-│   └── mio-intelligence-mcp/index.js
-└── package.json
+默认 `~/.mio-intelligence`，可通过 `MIO_HOME` 环境变量覆盖。
+```
+~/.mio-intelligence/
+  config.json              运行时配置
+  memory.jsonl             记忆存储
+  traces.jsonl             行为追踪
+  experience-reuse.jsonl   跨 Agent 复用记录
+  ideas.jsonl              创意想法
+  suggestions.jsonl        进化建议
+  observe-state.json       观察器增量游标
+  observe.pid              后台守护进程 ID
+  logs/                    运行日志
+```
+---
+## Architecture
+```
+传统模式：每个 Agent 独立运作
+  Codex (记忆A)    OpenCode (记忆B)    Hermes (记忆C)
+       ↓                 ↓                  ↓
+     重复探索           重复探索            重复探索
+Mio 模式：统一智能层
+  Codex ─┐
+OpenCode ─┤         ┌─────────────────────────┐
+  Hermes ─┤────────>│  Mio Intelligence Core   │
+WorkBuddy ─┘        │                         │
+                    │  Memory · Observer · Policy │
+                    │  Experience · Ideas · Evolution │
+                    └─────────────────────────┘
+                              │
+                    跨 Agent 经验复用 + 生态优化
 ```
+| | 单 Agent Memory | Mio Control Plane |
+|---|---|---|
+| **作用域** | 单个 Agent | 多 Agent 生态 |
+| **数据采集** | 依赖主动调用 | 被动观察 + 主动调用 |
+| **经验流动** | 无 | 跨 Agent 复用 + 证据验证 |
+| **风险管理** | 无 | 统一策略检查 |
+| **优化目标** | 单 Agent 记忆质量 | 整个生态的效率和质量 |
+---
+## Version Requirements
+| Version | Capability |
+|---------|-----------|
+| < 0.3.6 | 仅主动 MCP 规则注入 |
+| >= 0.3.6 | 被动观察 + 无感存取 |
+| >= 0.5.0 | 创意生成 + 进化建议 |
+---
+## Development
+```bash
+git clone https://github.com/your-org/akemi-mio.git
+cd akemi-mio
+npm run check    # 全量语法检查
+```
+**发布流程：**
+1. 编辑 `server/mio-intelligence-mcp/index.js`
+2. 复制到 `tmp/mio-agent-runtime/package/server/mio-intelligence-mcp/index.js`
+3. Bump `tmp/mio-agent-runtime/package/package.json` 版本号
+4. `cd tmp/mio-agent-runtime/package && npm publish`
+---
+## License
+MIT

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "mio-agent-runtime",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Mio Agent Runtime installer and MCP intelligence layer",
   "license": "MIT",
   "type": "commonjs",