@jackchen_me/open-multi-agent 0.2.0 → 1.0.1

package/dist/utils/trace.js

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Trace emission utilities for the observability layer.
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Safely emit a trace event. Swallows callback errors so a broken
+ * subscriber never crashes agent execution.
+ */
+export function emitTrace(fn, event) {
+    if (!fn)
+        return;
+    try {
+        // Guard async callbacks: if fn returns a Promise, swallow its rejection
+        // so an async onTrace never produces an unhandled promise rejection.
+        const result = fn(event);
+        if (result && typeof result.catch === 'function') {
+            ;
+            result.catch(noop);
+        }
+    }
+    catch {
+        // Intentionally swallowed — observability must never break execution.
+    }
+}
+function noop() { }
+/** Generate a unique run ID for trace correlation. */
+export function generateRunId() {
+    return randomUUID();
+}
+//# sourceMappingURL=trace.js.map

package/dist/utils/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,EAA6D,EAC7D,KAAiB;IAEjB,IAAI,CAAC,EAAE;QAAE,OAAM;IACf,IAAI,CAAC;QACH,wEAAwE;QACxE,qEAAqE;QACrE,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAY,CAAA;QACnC,IAAI,MAAM,IAAI,OAAQ,MAA2B,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACvE,CAAC;YAAC,MAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED,SAAS,IAAI,KAAI,CAAC;AAElB,sDAAsD;AACtD,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,EAAE,CAAA;AACrB,CAAC"}

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@jackchen_me/open-multi-agent",
-  "version": "0.2.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": [
@@ -41,8 +47,18 @@
     "openai": "^4.73.0",
     "zod": "^3.23.0"
   },
+  "peerDependencies": {
+    "@google/genai": "^1.48.0"
+  },
+  "peerDependenciesMeta": {
+    "@google/genai": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@google/genai": "^1.48.0",
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
     "tsx": "^4.21.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0"

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: npm ci
-      - run: npm run lint
-      - run: npm test

package/CLAUDE.md

@@ -1,72 +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
-```
-
-No test files exist yet in `tests/`. 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 lifecycle (idle→running→completed/error), conversation loop, concurrency pool with Semaphore |
-| 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).
-
-### Error Handling
-
-- Tool errors → caught, returned as `ToolResult(isError: true)`, never thrown
-- Task failures → 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,217 +0,0 @@
-# Open Multi-Agent
-
-构建能自动拆解目标的 AI 智能体团队。定义智能体的角色和工具，描述一个目标——框架自动规划任务图、调度依赖、并行执行。
-
-3 个运行时依赖，27 个源文件，一次 `runTeam()` 调用从目标到结果。
-
-[![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/)
-
-[English](./README.md) | **中文**
-
-## 为什么选择 Open Multi-Agent？
-
-- **自动任务拆解** — 用自然语言描述目标，内置的协调者智能体自动将其拆解为带依赖关系和分配的任务图——无需手动编排。
-- **多智能体团队** — 定义不同角色、工具甚至不同模型的智能体。它们通过消息总线和共享内存协作。
-- **任务 DAG 调度** — 任务之间存在依赖关系。框架进行拓扑排序——有依赖的任务等待，无依赖的任务并行执行。
-- **模型无关** — Claude、GPT、Gemma 4 和本地模型（Ollama、vLLM、LM Studio）可以在同一个团队中使用。通过 `baseURL` 即可接入任何 OpenAI 兼容服务。
-- **结构化输出** — 为任意智能体添加 `outputSchema`（Zod），输出自动解析为 JSON 并校验，校验失败自动重试一次。通过 `result.structured` 获取类型化结果。
-- **任务重试** — 为任务设置 `maxRetries`，失败时自动指数退避重试。所有尝试的 token 用量累计，确保计费准确。
-- **进程内执行** — 没有子进程开销。所有内容在一个 Node.js 进程中运行。可部署到 Serverless、Docker、CI/CD。
-
-## 快速开始
-
-需要 Node.js >= 18。
-
-```bash
-npm install @jackchen_me/open-multi-agent
-```
-
-在环境变量中设置 `ANTHROPIC_API_KEY`（以及可选的 `OPENAI_API_KEY` 或用于 Copilot 的 `GITHUB_TOKEN`）。通过 Ollama 使用本地模型无需 API key — 参见 [example 06](examples/06-local-model.ts)。
-
-三个智能体，一个目标——框架处理剩下的一切：
-
-```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
-```
-
-## 作者
-
-> JackChen — 前 WPS 产品经理，现独立创业者。关注小红书[「杰克西｜硅基杠杆」](https://www.xiaohongshu.com/user/profile/5a1bdc1e4eacab4aa39ea6d6)，持续获取我的 AI Agent 观点和思考。
-
-## 三种运行模式
-
-| 模式 | 方法 | 适用场景 |
-|------|------|----------|
-| 单智能体 | `runAgent()` | 一个智能体，一个提示词——最简入口 |
-| 自动编排团队 | `runTeam()` | 给一个目标，框架自动规划和执行 |
-| 显式任务管线 | `runTasks()` | 你自己定义任务图和分配 |
-
-## 贡献者
-
-<a href="https://github.com/JackChen-me/open-multi-agent/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=JackChen-me/open-multi-agent" />
-</a>
-
-## 示例
-
-所有示例都是可运行脚本，位于 [`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) | 纯本地 Gemma 4 智能体团队 + tool-calling — 零 API 费用 |
-| [09 — Gemma 4 自动编排](examples/09-gemma4-auto-orchestration.ts) | `runTeam()` 用 Gemma 4 当 coordinator — 自动任务拆解，完全本地 |
-
-## 架构
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│  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    │
-         │               └──────────────────────┘
-┌────────▼──────────┐
-│  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` | 已验证 |
-| GitHub Copilot | `provider: 'copilot'` | `GITHUB_TOKEN` | 已验证 |
-| Ollama / vLLM / LM Studio | `provider: 'openai'` + `baseURL` | — | 已验证 |
-
-已验证支持 tool-calling 的本地模型：**Gemma 4**（见[示例 08](examples/08-gemma4-local.ts)）。
-
-任何 OpenAI 兼容 API 均可通过 `provider: 'openai'` + `baseURL` 接入（DeepSeek、Groq、Mistral、Qwen、MiniMax 等）。这些 Provider 尚未完整验证——欢迎通过 [#25](https://github.com/JackChen-me/open-multi-agent/issues/25) 贡献验证。
-
-## 参与贡献
-
-欢迎提 Issue、功能需求和 PR。以下方向的贡献尤其有价值：
-
-- **Provider 集成** — 验证并文档化 OpenAI 兼容 Provider（DeepSeek、Groq、Qwen、MiniMax 等）通过 `baseURL` 接入。详见 [#25](https://github.com/JackChen-me/open-multi-agent/issues/25)。对于非 OpenAI 兼容的 Provider（如 Gemini），欢迎贡献新的 `LLMAdapter` 实现——接口只需两个方法：`chat()` 和 `stream()`。
-- **示例** — 真实场景的工作流和用例。
-- **文档** — 指南、教程和 API 文档。
-
-## 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=20260403" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=JackChen-me/open-multi-agent&type=Date&v=20260403" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=JackChen-me/open-multi-agent&type=Date&v=20260403" />
- </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.