@jackchen_me/open-multi-agent 1.0.0 → 1.0.1

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@jackchen_me/open-multi-agent",
-  "version": "1.0.0",
-  "description": "Production-grade multi-agent orchestration framework. Model-agnostic, supports team collaboration, task scheduling, and inter-agent communication.",
+  "version": "1.0.1",
+  "description": "TypeScript multi-agent framework — one runTeam() call from goal to result. Auto task decomposition, parallel execution. 3 dependencies, deploys anywhere Node.js runs.",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,6 +22,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
+    "test:e2e": "RUN_E2E=1 vitest run tests/e2e/",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,40 +0,0 @@
----
-name: Bug Report
-about: Report a bug to help us improve
-title: "[Bug] "
-labels: bug
-assignees: ''
----
-
-## Describe the bug
-
-A clear and concise description of what the bug is.
-
-## To Reproduce
-
-Steps to reproduce the behavior:
-
-1. Configure agent with '...'
-2. Call `runTeam(...)` with '...'
-3. See error
-
-## Expected behavior
-
-A clear description of what you expected to happen.
-
-## Error output
-
-```
-Paste any error messages or logs here
-```
-
-## Environment
-
-- OS: [e.g. macOS 14, Ubuntu 22.04]
-- Node.js version: [e.g. 20.11]
-- Package version: [e.g. 0.1.0]
-- LLM provider: [e.g. Anthropic, OpenAI]
-
-## Additional context
-
-Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,23 +0,0 @@
----
-name: Feature Request
-about: Suggest an idea for this project
-title: "[Feature] "
-labels: enhancement
-assignees: ''
----
-
-## Problem
-
-A clear description of the problem or limitation you're experiencing.
-
-## Proposed Solution
-
-Describe what you'd like to happen.
-
-## Alternatives Considered
-
-Any alternative solutions or features you've considered.
-
-## Additional context
-
-Add any other context, code examples, or screenshots about the feature request here.

package/.github/pull_request_template.md

@@ -1,14 +0,0 @@
-## What
-
-<!-- What does this PR do? One or two sentences. -->
-
-## Why
-
-<!-- Why is this change needed? Link to an issue if applicable: Fixes #123 -->
-
-## Checklist
-
-- [ ] `npm run lint` passes
-- [ ] `npm test` passes
-- [ ] Added/updated tests for changed behavior
-- [ ] No new runtime dependencies (or justified in the PR description)

package/.github/workflows/ci.yml

@@ -1,23 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [18, 20, 22]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: npm
-      - run: rm -f package-lock.json && npm install
-      - run: npm run lint
-      - run: npm test

package/CLAUDE.md

@@ -1,80 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Commands
-
-```bash
-npm run build          # Compile TypeScript (src/ → dist/)
-npm run dev            # Watch mode compilation
-npm run lint           # Type-check only (tsc --noEmit)
-npm test               # Run all tests (vitest run)
-npm run test:watch     # Vitest watch mode
-```
-
-Tests live in `tests/` (vitest). Examples in `examples/` are standalone scripts requiring API keys (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`).
-
-## Architecture
-
-ES module TypeScript framework for multi-agent orchestration. Three runtime dependencies: `@anthropic-ai/sdk`, `openai`, `zod`.
-
-### Core Execution Flow
-
-**`OpenMultiAgent`** (`src/orchestrator/orchestrator.ts`) is the top-level public API with three execution modes:
-
-1. **`runAgent(config, prompt)`** — single agent, one-shot
-2. **`runTeam(team, goal)`** — automatic orchestration: a temporary "coordinator" agent decomposes the goal into a task DAG via LLM call, then tasks execute in dependency order
-3. **`runTasks(team, tasks)`** — explicit task pipeline with user-defined dependencies
-
-### The Coordinator Pattern (runTeam)
-
-This is the framework's key feature. When `runTeam()` is called:
-1. A coordinator agent receives the goal + agent roster and produces a JSON task array (title, description, assignee, dependsOn)
-2. `TaskQueue` resolves dependencies topologically — independent tasks run in parallel, dependent tasks wait
-3. `Scheduler` auto-assigns any unassigned tasks (strategies: `dependency-first` default, `round-robin`, `least-busy`, `capability-match`)
-4. Each task result is written to `SharedMemory` so subsequent agents see prior results
-5. The coordinator synthesizes all task results into a final output
-
-### Layer Map
-
-| Layer | Files | Responsibility |
-|-------|-------|----------------|
-| Orchestrator | `orchestrator/orchestrator.ts`, `orchestrator/scheduler.ts` | Top-level API, task decomposition, coordinator pattern |
-| Team | `team/team.ts`, `team/messaging.ts` | Agent roster, MessageBus (point-to-point + broadcast), SharedMemory binding |
-| Agent | `agent/agent.ts`, `agent/runner.ts`, `agent/pool.ts`, `agent/structured-output.ts` | Agent lifecycle (idle→running→completed/error), conversation loop, concurrency pool with Semaphore, structured output validation |
-| Task | `task/queue.ts`, `task/task.ts` | Dependency-aware queue, auto-unblock on completion, cascade failure to dependents |
-| Tool | `tool/framework.ts`, `tool/executor.ts`, `tool/built-in/` | `defineTool()` with Zod schemas, ToolRegistry, parallel batch execution with concurrency semaphore |
-| LLM | `llm/adapter.ts`, `llm/anthropic.ts`, `llm/openai.ts` | `LLMAdapter` interface (`chat` + `stream`), factory `createAdapter()` |
-| Memory | `memory/shared.ts`, `memory/store.ts` | Namespaced key-value store (`agentName/key`), markdown summary injection into prompts |
-| Types | `types.ts` | All interfaces in one file to avoid circular deps |
-| Exports | `index.ts` | Public API surface |
-
-### Agent Conversation Loop (AgentRunner)
-
-`AgentRunner.run()`: send messages → extract tool-use blocks → execute tools in parallel batch → append results → loop until `end_turn` or `maxTurns` exhausted. Accumulates `TokenUsage` across all turns.
-
-### Concurrency Control
-
-Two independent semaphores: `AgentPool` (max concurrent agent runs, default 5) and `ToolExecutor` (max concurrent tool calls, default 4).
-
-### Structured Output
-
-Optional `outputSchema` (Zod) on `AgentConfig`. When set, the agent's final output is parsed as JSON and validated. On validation failure, one retry with error feedback is attempted. Validated data is available via `result.structured`. Logic lives in `agent/structured-output.ts`, wired into `Agent.executeRun()`.
-
-### Task Retry
-
-Optional `maxRetries`, `retryDelayMs`, `retryBackoff` on task config (used via `runTasks()`). `executeWithRetry()` in `orchestrator.ts` handles the retry loop with exponential backoff (capped at 30s). Token usage is accumulated across all attempts. Emits `task_retry` event via `onProgress`.
-
-### Error Handling
-
-- Tool errors → caught, returned as `ToolResult(isError: true)`, never thrown
-- Task failures → retry if `maxRetries > 0`, then cascade to all dependents; independent tasks continue
-- LLM API errors → propagate to caller
-
-### Built-in Tools
-
-`bash`, `file_read`, `file_write`, `file_edit`, `grep` — registered via `registerBuiltInTools(registry)`.
-
-### Adding an LLM Adapter
-
-Implement `LLMAdapter` interface with `chat(messages, options)` and `stream(messages, options)`, then register in `createAdapter()` factory in `src/llm/adapter.ts`.

package/CODE_OF_CONDUCT.md

@@ -1,48 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a positive experience for everyone, regardless of background or
-identity.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment:
-
-- Using welcoming and inclusive language
-- Being respectful of differing viewpoints and experiences
-- Gracefully accepting constructive feedback
-- Focusing on what is best for the community
-- Showing empathy towards other community members
-
-Examples of unacceptable behavior:
-
-- Trolling, insulting or derogatory comments, and personal attacks
-- Public or private unwelcome conduct
-- Publishing others' private information without explicit permission
-- Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate or harmful.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-
-## Enforcement
-
-Instances of unacceptable behavior may be reported to the community leaders
-responsible for enforcement at **jack@yuanasi.com**. All complaints will be
-reviewed and investigated promptly and fairly.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).

package/CONTRIBUTING.md

@@ -1,72 +0,0 @@
-# Contributing
-
-Thanks for your interest in contributing to Open Multi-Agent! This guide covers the basics to get you started.
-
-## Setup
-
-```bash
-git clone https://github.com/JackChen-me/open-multi-agent.git
-cd open-multi-agent
-npm install
-```
-
-Requires Node.js >= 18.
-
-## Development Commands
-
-```bash
-npm run build        # Compile TypeScript (src/ → dist/)
-npm run dev          # Watch mode compilation
-npm run lint         # Type-check (tsc --noEmit)
-npm test             # Run all tests (vitest)
-npm run test:watch   # Vitest watch mode
-```
-
-## Running Tests
-
-All tests live in `tests/`. They test core modules (TaskQueue, SharedMemory, ToolExecutor, Semaphore) without requiring API keys or network access.
-
-```bash
-npm test
-```
-
-Every PR must pass `npm run lint && npm test`. CI runs both automatically on Node 18, 20, and 22.
-
-## Making a Pull Request
-
-1. Fork the repo and create a branch from `main`
-2. Make your changes
-3. Add or update tests if you changed behavior
-4. Run `npm run lint && npm test` locally
-5. Open a PR against `main`
-
-### PR Checklist
-
-- [ ] `npm run lint` passes
-- [ ] `npm test` passes
-- [ ] New behavior has test coverage
-- [ ] Linked to a relevant issue (if one exists)
-
-## Code Style
-
-- TypeScript strict mode, ES modules (`.js` extensions in imports)
-- No additional linter/formatter configured — follow existing patterns
-- Keep dependencies minimal (currently 3 runtime deps: `@anthropic-ai/sdk`, `openai`, `zod`)
-
-## Architecture Overview
-
-See the [README](./README.md#architecture) for an architecture diagram. Key entry points:
-
-- **Orchestrator**: `src/orchestrator/orchestrator.ts` — top-level API
-- **Task system**: `src/task/queue.ts`, `src/task/task.ts` — dependency DAG
-- **Agent**: `src/agent/runner.ts` — conversation loop
-- **Tools**: `src/tool/framework.ts`, `src/tool/executor.ts` — tool registry and execution
-- **LLM adapters**: `src/llm/` — Anthropic, OpenAI, Copilot
-
-## Where to Contribute
-
-Check the [issues](https://github.com/JackChen-me/open-multi-agent/issues) page. Issues labeled `good first issue` are scoped and approachable. Issues labeled `help wanted` are larger but well-defined.
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.

package/DECISIONS.md

@@ -1,43 +0,0 @@
-# Architecture Decisions
-
-This document records deliberate "won't do" decisions for the project. These are features we evaluated and chose NOT to implement — not because they're bad ideas, but because they conflict with our positioning as the **simplest multi-agent framework**.
-
-If you're considering a PR in any of these areas, please open a discussion first.
-
-## Won't Do
-
-### 1. Agent Handoffs
-
-**What**: Agent A transfers an in-progress conversation to Agent B (like OpenAI Agents SDK `handoff()`).
-
-**Why not**: Handoffs are a different paradigm from our task-based model. Our tasks have clear boundaries — one agent, one task, one result. Handoffs blur those boundaries and add state-transfer complexity. Users who need handoffs likely need a different framework (OpenAI Agents SDK is purpose-built for this).
-
-### 2. State Persistence / Checkpointing
-
-**What**: Save workflow state to a database so long-running workflows can resume after crashes (like LangGraph checkpointing).
-
-**Why not**: Requires a storage backend (SQLite, Redis, Postgres), schema migrations, and serialization logic. This is enterprise infrastructure — it triples the complexity surface. Our target users run workflows that complete in seconds to minutes, not hours. If you need checkpointing, LangGraph is the right tool.
-
-**Related**: Closing #20 with this rationale.
-
-### 3. A2A Protocol (Agent-to-Agent)
-
-**What**: Google's open protocol for agents on different servers to discover and communicate with each other.
-
-**Why not**: Too early — the spec is still evolving and adoption is minimal. Our users run agents in a single process, not across distributed services. If A2A matures and there's real demand, we can revisit. Today it would add complexity for zero practical benefit.
-
-### 4. MCP Integration (Model Context Protocol)
-
-**What**: Anthropic's protocol for connecting LLMs to external tools and data sources.
-
-**Why not**: MCP is valuable but targets a different layer. Our `defineTool()` API already lets users wrap any external service as a tool in ~10 lines of code. Adding MCP would mean maintaining protocol compatibility, transport layers, and tool discovery — complexity that serves tool platform builders, not our target users who just want to run agent teams.
-
-### 5. Dashboard / Visualization
-
-**What**: Built-in web UI to visualize task DAGs, agent activity, and token usage.
-
-**Why not**: We expose data, we don't build UI. The `onProgress` callback and upcoming `onTrace` (#18) give users all the raw data. They can pipe it into Grafana, build a custom dashboard, or use console logs. Shipping a web UI means owning a frontend stack, which is outside our scope.
-
----
-
-*Last updated: 2026-04-03*

package/README_zh.md

@@ -1,277 +0,0 @@
-# Open Multi-Agent
-
-TypeScript 多智能体编排框架。一次 `runTeam()` 调用从目标到结果——框架自动拆解任务、解析依赖、并行执行。
-
-3 个运行时依赖 · 33 个源文件 · Node.js 能跑的地方都能部署 · 被 [Latent Space](https://www.latent.space/p/ainews-a-quiet-april-fools) AI News 提及（AI 工程领域头部 Newsletter，17 万+订阅者）
-
-[![GitHub stars](https://img.shields.io/github/stars/JackChen-me/open-multi-agent)](https://github.com/JackChen-me/open-multi-agent/stargazers)
-[![license](https://img.shields.io/github/license/JackChen-me/open-multi-agent)](./LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue)](https://www.typescriptlang.org/)
-[![coverage](https://img.shields.io/badge/coverage-71%25-brightgreen)](https://github.com/JackChen-me/open-multi-agent/actions)
-
-[English](./README.md) | **中文**
-
-## 为什么选择 Open Multi-Agent？
-
-- **目标进，结果出** — `runTeam(team, "构建一个 REST API")`。协调者智能体自动将目标拆解为带依赖关系的任务图，分配给对应智能体，独立任务并行执行，最终合成输出。无需手动定义任务或编排流程图。
-- **TypeScript 原生** — 为 Node.js 生态而生。`npm install` 即用，无需 Python 运行时、无子进程桥接、无额外基础设施。可嵌入 Express、Next.js、Serverless 函数或 CI/CD 流水线。
-- **可审计、极轻量** — 3 个运行时依赖（`@anthropic-ai/sdk`、`openai`、`zod`），33 个源文件。一个下午就能读完全部源码。
-- **模型无关** — Claude、GPT、Gemma 4 和本地模型（Ollama、vLLM、LM Studio、llama.cpp server）可以在同一个团队中使用。通过 `baseURL` 即可接入任何 OpenAI 兼容服务。
-- **多智能体协作** — 定义不同角色、工具和模型的智能体，通过消息总线和共享内存协作。
-- **结构化输出** — 为任意智能体添加 `outputSchema`（Zod），输出自动解析为 JSON 并校验，校验失败自动重试一次。通过 `result.structured` 获取类型化结果。
-- **任务重试** — 为任务设置 `maxRetries`，失败时自动指数退避重试。所有尝试的 token 用量累计，确保计费准确。
-- **人机协同** — `runTasks()` 支持可选的 `onApproval` 回调。每批任务完成后，由你的回调决定是否继续执行后续任务。
-- **生命周期钩子** — `AgentConfig` 上的 `beforeRun` / `afterRun`。在执行前拦截 prompt，或在执行后处理结果。从钩子中 throw 可中止运行。
-- **循环检测** — `AgentConfig` 上的 `loopDetection` 可检测智能体重复相同工具调用或文本输出的卡死循环。可配置行为：警告（默认）、终止、或自定义回调。
-- **可观测性** — 可选的 `onTrace` 回调为每次 LLM 调用、工具执行、任务和智能体运行发出结构化 span 事件——包含耗时、token 用量和共享的 `runId` 用于关联追踪。未订阅时零开销，零额外依赖。
-
-## 快速开始
-
-需要 Node.js >= 18。
-
-```bash
-npm install @jackchen_me/open-multi-agent
-```
-
-根据使用的 Provider 设置对应的 API key。通过 Ollama 使用本地模型无需 API key — 参见 [example 06](examples/06-local-model.ts)。
-
-- `ANTHROPIC_API_KEY`
-- `OPENAI_API_KEY`
-- `GEMINI_API_KEY`
-- `XAI_API_KEY`（Grok）
-- `GITHUB_TOKEN`（Copilot）
-
-三个智能体，一个目标——框架处理剩下的一切：
-
-```typescript
-import { OpenMultiAgent } from '@jackchen_me/open-multi-agent'
-import type { AgentConfig } from '@jackchen_me/open-multi-agent'
-
-const architect: AgentConfig = {
-  name: 'architect',
-  model: 'claude-sonnet-4-6',
-  systemPrompt: 'You design clean API contracts and file structures.',
-  tools: ['file_write'],
-}
-
-const developer: AgentConfig = {
-  name: 'developer',
-  model: 'claude-sonnet-4-6',
-  systemPrompt: 'You implement what the architect designs.',
-  tools: ['bash', 'file_read', 'file_write', 'file_edit'],
-}
-
-const reviewer: AgentConfig = {
-  name: 'reviewer',
-  model: 'claude-sonnet-4-6',
-  systemPrompt: 'You review code for correctness and clarity.',
-  tools: ['file_read', 'grep'],
-}
-
-const orchestrator = new OpenMultiAgent({
-  defaultModel: 'claude-sonnet-4-6',
-  onProgress: (event) => console.log(event.type, event.agent ?? event.task ?? ''),
-})
-
-const team = orchestrator.createTeam('api-team', {
-  name: 'api-team',
-  agents: [architect, developer, reviewer],
-  sharedMemory: true,
-})
-
-// 描述一个目标——框架将其拆解为任务并编排执行
-const result = await orchestrator.runTeam(team, 'Create a REST API for a todo list in /tmp/todo-api/')
-
-console.log(`成功: ${result.success}`)
-console.log(`Token 用量: ${result.totalTokenUsage.output_tokens} output tokens`)
-```
-
-执行过程：
-
-```
-agent_start coordinator
-task_start architect
-task_complete architect
-task_start developer
-task_start developer              // 无依赖的任务并行执行
-task_complete developer
-task_start reviewer               // 实现完成后自动解锁
-task_complete developer
-task_complete reviewer
-agent_complete coordinator        // 综合所有结果
-Success: true
-Tokens: 12847 output tokens
-```
-
-## 三种运行模式
-
-| 模式 | 方法 | 适用场景 |
-|------|------|----------|
-| 单智能体 | `runAgent()` | 一个智能体，一个提示词——最简入口 |
-| 自动编排团队 | `runTeam()` | 给一个目标，框架自动规划和执行 |
-| 显式任务管线 | `runTasks()` | 你自己定义任务图和分配 |
-
-## 示例
-
-所有示例都是可运行脚本，位于 [`examples/`](./examples/) 目录。使用 `npx tsx` 运行：
-
-```bash
-npx tsx examples/01-single-agent.ts
-```
-
-| 示例 | 展示内容 |
-|------|----------|
-| [01 — 单智能体](examples/01-single-agent.ts) | `runAgent()` 单次调用、`stream()` 流式输出、`prompt()` 多轮对话 |
-| [02 — 团队协作](examples/02-team-collaboration.ts) | `runTeam()` 自动编排 + 协调者模式 |
-| [03 — 任务流水线](examples/03-task-pipeline.ts) | `runTasks()` 显式依赖图（设计 → 实现 → 测试 + 评审） |
-| [04 — 多模型团队](examples/04-multi-model-team.ts) | `defineTool()` 自定义工具、Anthropic + OpenAI 混合、`AgentPool` |
-| [05 — Copilot](examples/05-copilot-test.ts) | GitHub Copilot 作为 LLM 提供者 |
-| [06 — 本地模型](examples/06-local-model.ts) | Ollama + Claude 混合流水线，通过 `baseURL` 接入（兼容 vLLM、LM Studio 等） |
-| [07 — 扇出聚合](examples/07-fan-out-aggregate.ts) | `runParallel()` MapReduce — 3 个分析师并行，然后综合 |
-| [08 — Gemma 4 本地](examples/08-gemma4-local.ts) | `runTasks()` + `runTeam()` 本地 Gemma 4 via Ollama — 零 API 费用 |
-| [09 — 结构化输出](examples/09-structured-output.ts) | `outputSchema`（Zod）— 校验 JSON 输出，通过 `result.structured` 获取 |
-| [10 — 任务重试](examples/10-task-retry.ts) | `maxRetries` / `retryDelayMs` / `retryBackoff` + `task_retry` 进度事件 |
-| [11 — 可观测性](examples/11-trace-observability.ts) | `onTrace` 回调 — LLM 调用、工具、任务、智能体的结构化 span 事件 |
-| [12 — Grok](examples/12-grok.ts) | 同示例 02（`runTeam()` 团队协作），使用 Grok（`XAI_API_KEY`） |
-| [13 — Gemini](examples/13-gemini.ts) | Gemini 适配器测试，使用 `gemini-2.5-flash`（`GEMINI_API_KEY`） |
-
-## 架构
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  OpenMultiAgent (Orchestrator)                                  │
-│                                                                 │
-│  createTeam()  runTeam()  runTasks()  runAgent()  getStatus()   │
-└──────────────────────┬──────────────────────────────────────────┘
-                       │
-            ┌──────────▼──────────┐
-            │  Team               │
-            │  - AgentConfig[]    │
-            │  - MessageBus       │
-            │  - TaskQueue        │
-            │  - SharedMemory     │
-            └──────────┬──────────┘
-                       │
-         ┌─────────────┴─────────────┐
-         │                           │
-┌────────▼──────────┐    ┌───────────▼───────────┐
-│  AgentPool        │    │  TaskQueue             │
-│  - Semaphore      │    │  - dependency graph    │
-│  - runParallel()  │    │  - auto unblock        │
-└────────┬──────────┘    │  - cascade failure     │
-         │               └───────────────────────┘
-┌────────▼──────────┐
-│  Agent            │
-│  - run()          │    ┌──────────────────────┐
-│  - prompt()       │───►│  LLMAdapter          │
-│  - stream()       │    │  - AnthropicAdapter  │
-└────────┬──────────┘    │  - OpenAIAdapter     │
-         │               │  - CopilotAdapter    │
-         │               │  - GeminiAdapter     │
-         │               │  - GrokAdapter       │
-         │               └──────────────────────┘
-┌────────▼──────────┐
-│  AgentRunner      │    ┌──────────────────────┐
-│  - conversation   │───►│  ToolRegistry        │
-│    loop           │    │  - defineTool()      │
-│  - tool dispatch  │    │  - 5 built-in tools  │
-└───────────────────┘    └──────────────────────┘
-```
-
-## 内置工具
-
-| 工具 | 说明 |
-|------|------|
-| `bash` | 执行 Shell 命令。返回 stdout + stderr。支持超时和工作目录设置。 |
-| `file_read` | 读取指定绝对路径的文件内容。支持偏移量和行数限制以处理大文件。 |
-| `file_write` | 写入或创建文件。自动创建父目录。 |
-| `file_edit` | 通过精确字符串匹配编辑文件。 |
-| `grep` | 使用正则表达式搜索文件内容。优先使用 ripgrep，回退到 Node.js 实现。 |
-
-## 支持的 Provider
-
-| Provider | 配置 | 环境变量 | 状态 |
-|----------|------|----------|------|
-| Anthropic (Claude) | `provider: 'anthropic'` | `ANTHROPIC_API_KEY` | 已验证 |
-| OpenAI (GPT) | `provider: 'openai'` | `OPENAI_API_KEY` | 已验证 |
-| Grok (xAI)   | `provider: 'grok'` | `XAI_API_KEY` | 已验证 |
-| GitHub Copilot | `provider: 'copilot'` | `GITHUB_TOKEN` | 已验证 |
-| Gemini | `provider: 'gemini'` | `GEMINI_API_KEY` | 已验证 |
-| Ollama / vLLM / LM Studio | `provider: 'openai'` + `baseURL` | — | 已验证 |
-| llama.cpp server | `provider: 'openai'` + `baseURL` | — | 已验证 |
-
-已验证支持 tool-calling 的本地模型：**Gemma 4**（见[示例 08](examples/08-gemma4-local.ts)）。
-
-任何 OpenAI 兼容 API 均可通过 `provider: 'openai'` + `baseURL` 接入（DeepSeek、Groq、Mistral、Qwen、MiniMax 等）。**Grok 现已原生支持**，使用 `provider: 'grok'`。
-
-### 本地模型 Tool-Calling
-
-框架支持通过 Ollama、vLLM、LM Studio 或 llama.cpp 运行的本地模型进行 tool-calling。Tool-calling 由这些服务通过 OpenAI 兼容 API 原生处理。
-
-**已验证模型：** Gemma 4、Llama 3.1、Qwen 3、Mistral、Phi-4。完整列表见 [ollama.com/search?c=tools](https://ollama.com/search?c=tools)。
-
-**兜底提取：** 如果本地模型以文本形式返回工具调用，而非使用 `tool_calls` 协议格式（常见于 thinking 模型或配置不当的服务），框架会自动从文本输出中提取。
-
-**超时设置：** 本地推理可能较慢。使用 `AgentConfig` 上的 `timeoutMs` 防止无限等待：
-
-```typescript
-const localAgent: AgentConfig = {
-  name: 'local',
-  model: 'llama3.1',
-  provider: 'openai',
-  baseURL: 'http://localhost:11434/v1',
-  apiKey: 'ollama',
-  tools: ['bash', 'file_read'],
-  timeoutMs: 120_000, // 2 分钟后中止
-}
-```
-
-**常见问题：**
-- 模型不调用工具？确保该模型出现在 Ollama 的 [Tools 分类](https://ollama.com/search?c=tools)中。并非所有模型都支持 tool-calling。
-- 使用 Ollama？更新到最新版（`ollama update`）——旧版本有已知的 tool-calling bug。
-- 代理干扰？本地服务使用 `no_proxy=localhost`。
-
-### LLM 配置示例
-
-```typescript
-const grokAgent: AgentConfig = {
-  name: 'grok-agent',
-  provider: 'grok',
-  model: 'grok-4',
-  systemPrompt: 'You are a helpful assistant.',
-}
-```
-
-（设置 `XAI_API_KEY` 环境变量即可，无需 `baseURL`。）
-
-## 参与贡献
-
-欢迎提 Issue、功能需求和 PR。以下方向的贡献尤其有价值：
-
-- **Provider 集成** — 验证并文档化 OpenAI 兼容 Provider（DeepSeek、Groq、Qwen、MiniMax 等）通过 `baseURL` 接入。详见 [#25](https://github.com/JackChen-me/open-multi-agent/issues/25)。对于非 OpenAI 兼容的 Provider，欢迎贡献新的 `LLMAdapter` 实现——接口只需两个方法：`chat()` 和 `stream()`。
-- **示例** — 真实场景的工作流和用例。
-- **文档** — 指南、教程和 API 文档。
-
-## 作者
-
-> JackChen — 前 WPS 产品经理，现独立创业者。关注小红书[「杰克西｜硅基杠杆」](https://www.xiaohongshu.com/user/profile/5a1bdc1e4eacab4aa39ea6d6)，持续获取我的 AI Agent 观点和思考。
-
-## 贡献者
-
-<a href="https://github.com/JackChen-me/open-multi-agent/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=JackChen-me/open-multi-agent&v=20260405" />
-</a>
-
-## Star 趋势
-
-<a href="https://star-history.com/#JackChen-me/open-multi-agent&Date">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=JackChen-me/open-multi-agent&type=Date&theme=dark&v=20260405" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=JackChen-me/open-multi-agent&type=Date&v=20260405" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=JackChen-me/open-multi-agent&type=Date&v=20260405" />
- </picture>
-</a>
-
-## 许可证
-
-MIT

package/SECURITY.md

@@ -1,17 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported |
-|---------|-----------|
-| latest  | Yes       |
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability, please report it responsibly via email:
-
-**jack@yuanasi.com**
-
-Please do **not** open a public GitHub issue for security vulnerabilities.
-
-We will acknowledge receipt within 48 hours and aim to provide a fix or mitigation plan within 7 days.