README.md

@@ -139,15 +139,14 @@ For MapReduce-style fan-out without task dependencies, use `AgentPool.runParalle
 
 ## Examples
 
-16 runnable scripts and 1 full-stack demo in [`examples/`](./examples/). Start with these:
+16 runnable scripts in [`examples/`](./examples/). Start with these four:
 
 - [02 — Team Collaboration](examples/02-team-collaboration.ts): `runTeam()` coordinator pattern.
 - [06 — Local Model](examples/06-local-model.ts): Ollama and Claude in one pipeline via `baseURL`.
 - [09 — Structured Output](examples/09-structured-output.ts): any agent returns Zod-validated JSON.
 - [11 — Trace Observability](examples/11-trace-observability.ts): `onTrace` spans for LLM calls, tools, and tasks.
-- [with-vercel-ai-sdk](examples/with-vercel-ai-sdk/): Next.js app — OMA `runTeam()` + AI SDK `useChat` streaming.
 
-Run scripts with `npx tsx examples/02-team-collaboration.ts`.
+Run any with `npx tsx examples/02-team-collaboration.ts`.
 
 ## Architecture
 

README_zh.md

@@ -137,15 +137,14 @@ Tokens: 12847 output tokens
 
 ## 示例
 
-[`examples/`](./examples/) 里有 16 个可运行脚本和 1 个完整项目。推荐从这几个开始：
+[`examples/`](./examples/) 里有 15 个可运行脚本。推荐从这 4 个开始：
 
 - [02 — 团队协作](examples/02-team-collaboration.ts)：`runTeam()` 协调者模式。
 - [06 — 本地模型](examples/06-local-model.ts)：通过 `baseURL` 把 Ollama 和 Claude 放在同一条管线。
 - [09 — 结构化输出](examples/09-structured-output.ts)：任意 agent 产出 Zod 校验过的 JSON。
 - [11 — 可观测性](examples/11-trace-observability.ts)：`onTrace` 回调，为 LLM 调用、工具、任务发出结构化 span。
-- [with-vercel-ai-sdk](examples/with-vercel-ai-sdk/)：Next.js 应用 — OMA `runTeam()` + AI SDK `useChat` 流式输出。
 
-用 `npx tsx examples/02-team-collaboration.ts` 运行脚本示例。
+用 `npx tsx examples/02-team-collaboration.ts` 运行任意一个。
 
 ## 架构
 

examples/with-vercel-ai-sdk/.gitignore

@@ -1,5 +0,0 @@
-node_modules/
-.next/
-.env
-.env.local
-*.tsbuildinfo

examples/with-vercel-ai-sdk/README.md

@@ -1,59 +0,0 @@
-# with-vercel-ai-sdk
-
-A Next.js demo showing **open-multi-agent** (OMA) and **Vercel AI SDK** working together:
-
-- **OMA** orchestrates a research team (researcher agent + writer agent) via `runTeam()`
-- **AI SDK** streams the result to a chat UI via `useChat` + `streamText`
-
-## How it works
-
-```
-User message
-  │
-  ▼
-API route (app/api/chat/route.ts)
-  │
-  ├─ Phase 1: OMA runTeam()
-  │    coordinator decomposes goal → researcher gathers info → writer drafts article
-  │
-  └─ Phase 2: AI SDK streamText()
-       streams the team's output to the browser
-  │
-  ▼
-Chat UI (app/page.tsx) — useChat hook renders streamed response
-```
-
-## Setup
-
-```bash
-# 1. From repo root, install OMA dependencies
-cd ../..
-npm install
-
-# 2. Back to this example
-cd examples/with-vercel-ai-sdk
-npm install
-
-# 3. Set your API key
-export ANTHROPIC_API_KEY=sk-ant-...
-
-# 4. Run
-npm run dev
-```
-
-`npm run dev` automatically builds OMA before starting Next.js (via the `predev` script).
-
-Open [http://localhost:3000](http://localhost:3000), type a topic, and watch the research team work.
-
-## Prerequisites
-
-- Node.js >= 18
-- `ANTHROPIC_API_KEY` environment variable (used by both OMA and AI SDK)
-
-## Key files
-
-| File | Role |
-|------|------|
-| `app/api/chat/route.ts` | Backend — OMA orchestration + AI SDK streaming |
-| `app/page.tsx` | Frontend — chat UI with `useChat` hook |
-| `package.json` | References OMA via `file:../../` (local link) |

examples/with-vercel-ai-sdk/app/api/chat/route.ts

@@ -1,91 +0,0 @@
-import { streamText, convertToModelMessages, type UIMessage } from 'ai'
-import { createOpenAICompatible } from '@ai-sdk/openai-compatible'
-import { OpenMultiAgent } from '@jackchen_me/open-multi-agent'
-import type { AgentConfig } from '@jackchen_me/open-multi-agent'
-
-export const maxDuration = 120
-
-// --- DeepSeek via OpenAI-compatible API ---
-const DEEPSEEK_BASE_URL = 'https://api.deepseek.com'
-const DEEPSEEK_MODEL = 'deepseek-chat'
-
-const deepseek = createOpenAICompatible({
-  name: 'deepseek',
-  baseURL: `${DEEPSEEK_BASE_URL}/v1`,
-  apiKey: process.env.DEEPSEEK_API_KEY,
-})
-
-const researcher: AgentConfig = {
-  name: 'researcher',
-  model: DEEPSEEK_MODEL,
-  provider: 'openai',
-  baseURL: DEEPSEEK_BASE_URL,
-  apiKey: process.env.DEEPSEEK_API_KEY,
-  systemPrompt: `You are a research specialist. Given a topic, provide thorough, factual research
-with key findings, relevant data points, and important context.
-Be concise but comprehensive. Output structured notes, not prose.`,
-  maxTurns: 3,
-  temperature: 0.2,
-}
-
-const writer: AgentConfig = {
-  name: 'writer',
-  model: DEEPSEEK_MODEL,
-  provider: 'openai',
-  baseURL: DEEPSEEK_BASE_URL,
-  apiKey: process.env.DEEPSEEK_API_KEY,
-  systemPrompt: `You are an expert writer. Using research from team members (available in shared memory),
-write a well-structured, engaging article with clear headings and concise paragraphs.
-Do not repeat raw research — synthesize it into readable prose.`,
-  maxTurns: 3,
-  temperature: 0.4,
-}
-
-function extractText(message: UIMessage): string {
-  return message.parts
-    .filter((p): p is { type: 'text'; text: string } => p.type === 'text')
-    .map((p) => p.text)
-    .join('')
-}
-
-export async function POST(req: Request) {
-  const { messages }: { messages: UIMessage[] } = await req.json()
-  const lastText = extractText(messages.at(-1)!)
-
-  // --- Phase 1: OMA multi-agent orchestration ---
-  const orchestrator = new OpenMultiAgent({
-    defaultModel: DEEPSEEK_MODEL,
-    defaultProvider: 'openai',
-    defaultBaseURL: DEEPSEEK_BASE_URL,
-    defaultApiKey: process.env.DEEPSEEK_API_KEY,
-  })
-
-  const team = orchestrator.createTeam('research-writing', {
-    name: 'research-writing',
-    agents: [researcher, writer],
-    sharedMemory: true,
-  })
-
-  const teamResult = await orchestrator.runTeam(
-    team,
-    `Research and write an article about: ${lastText}`,
-  )
-
-  const teamOutput = teamResult.agentResults.get('coordinator')?.output ?? ''
-
-  // --- Phase 2: Stream result via Vercel AI SDK ---
-  const result = streamText({
-    model: deepseek(DEEPSEEK_MODEL),
-    system: `You are presenting research from a multi-agent team (researcher + writer).
-The team has already done the work. Your only job is to relay their output to the user
-in a well-formatted way. Keep the content faithful to the team output below.
-At the very end, add a one-line note that this was produced by a researcher agent
-and a writer agent collaborating via open-multi-agent.
-
-## Team Output
-${teamOutput}`,
-    messages: await convertToModelMessages(messages),
-  })
-
-  return result.toUIMessageStreamResponse()
-}

examples/with-vercel-ai-sdk/app/layout.tsx

@@ -1,14 +0,0 @@
-import type { Metadata } from 'next'
-
-export const metadata: Metadata = {
-  title: 'OMA + Vercel AI SDK',
-  description: 'Multi-agent research team powered by open-multi-agent, streamed via Vercel AI SDK',
-}
-
-export default function RootLayout({ children }: { children: React.ReactNode }) {
-  return (
-    <html lang="en">
-      <body style={{ margin: 0, background: '#fafafa' }}>{children}</body>
-    </html>
-  )
-}

examples/with-vercel-ai-sdk/app/page.tsx

@@ -1,97 +0,0 @@
-'use client'
-
-import { useState } from 'react'
-import { useChat } from '@ai-sdk/react'
-
-export default function Home() {
-  const { messages, sendMessage, status, error } = useChat()
-  const [input, setInput] = useState('')
-
-  const isLoading = status === 'submitted' || status === 'streaming'
-
-  const handleSubmit = async (e: React.FormEvent) => {
-    e.preventDefault()
-    if (!input.trim() || isLoading) return
-    const text = input
-    setInput('')
-    await sendMessage({ text })
-  }
-
-  return (
-    <main
-      style={{
-        maxWidth: 720,
-        margin: '0 auto',
-        padding: '32px 16px',
-        fontFamily: 'system-ui, -apple-system, sans-serif',
-      }}
-    >
-      <h1 style={{ fontSize: 22, marginBottom: 4 }}>Research Team</h1>
-      <p style={{ color: '#666', fontSize: 14, marginBottom: 28 }}>
-        Enter a topic. A <strong>researcher</strong> agent gathers information, a{' '}
-        <strong>writer</strong> agent composes an article &mdash; orchestrated by
-        open-multi-agent, streamed via Vercel AI SDK.
-      </p>
-
-      <div style={{ minHeight: 120 }}>
-        {messages.map((m) => (
-          <div key={m.id} style={{ marginBottom: 24, lineHeight: 1.7 }}>
-            <div style={{ fontWeight: 600, fontSize: 13, color: '#999', marginBottom: 4 }}>
-              {m.role === 'user' ? 'You' : 'Research Team'}
-            </div>
-            <div style={{ whiteSpace: 'pre-wrap', fontSize: 15 }}>
-              {m.parts
-                .filter((part): part is { type: 'text'; text: string } => part.type === 'text')
-                .map((part) => part.text)
-                .join('')}
-            </div>
-          </div>
-        ))}
-
-        {isLoading && status === 'submitted' && (
-          <div style={{ color: '#888', fontSize: 14, padding: '8px 0' }}>
-            Agents are collaborating &mdash; this may take a minute...
-          </div>
-        )}
-
-        {error && (
-          <div style={{ color: '#c00', fontSize: 14, padding: '8px 0' }}>
-            Error: {error.message}
-          </div>
-        )}
-      </div>
-
-      <form onSubmit={handleSubmit} style={{ display: 'flex', gap: 8, marginTop: 32 }}>
-        <input
-          value={input}
-          onChange={(e) => setInput(e.target.value)}
-          placeholder="Enter a topic to research..."
-          disabled={isLoading}
-          style={{
-            flex: 1,
-            padding: '10px 14px',
-            borderRadius: 8,
-            border: '1px solid #ddd',
-            fontSize: 15,
-            outline: 'none',
-          }}
-        />
-        <button
-          type="submit"
-          disabled={isLoading || !input.trim()}
-          style={{
-            padding: '10px 20px',
-            borderRadius: 8,
-            border: 'none',
-            background: isLoading ? '#ccc' : '#111',
-            color: '#fff',
-            cursor: isLoading ? 'not-allowed' : 'pointer',
-            fontSize: 15,
-          }}
-        >
-          Send
-        </button>
-      </form>
-    </main>
-  )
-}

examples/with-vercel-ai-sdk/next-env.d.ts

@@ -1,6 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

examples/with-vercel-ai-sdk/next.config.ts

@@ -1,7 +0,0 @@
-import type { NextConfig } from 'next'
-
-const nextConfig: NextConfig = {
-  serverExternalPackages: ['@jackchen_me/open-multi-agent'],
-}
-
-export default nextConfig

examples/with-vercel-ai-sdk/package.json

@@ -1,25 +0,0 @@
-{
-  "name": "with-vercel-ai-sdk",
-  "private": true,
-  "scripts": {
-    "predev": "cd ../.. && npm run build",
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start"
-  },
-  "dependencies": {
-    "@ai-sdk/openai-compatible": "^2.0.41",
-    "@ai-sdk/react": "^3.0.0",
-    "@jackchen_me/open-multi-agent": "file:../../",
-    "ai": "^6.0.0",
-    "next": "^16.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "typescript": "^5.6.0"
-  }
-}

examples/with-vercel-ai-sdk/tsconfig.json

@@ -1,41 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "ES2022"
-    ],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "incremental": true,
-    "plugins": [
-      {
-        "name": "next"
-      }
-    ],
-    "paths": {
-      "@/*": [
-        "./*"
-      ]
-    }
-  },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts",
-    ".next/dev/types/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}