Agent Mesh Dev — Code Development Guide

How Agent Mesh Works Now

Agent Mesh 已经不是 “connect 把单个 agent 连上平台” 的模型了，而是：

• CLI / Daemon (packages/cli/ )

• 一台机器一个 daemon

• 管理多个 agent、多个 session、多个 task group

• 本地 chat/call 先命中 daemon

• daemon 同时启动本地 Web UI backend

• transcript 真源和历史查看面都在本地 daemon / Web UI

• Local Web UI (packages/ui/ )

• 提供 transcript、task、provider exposure、日志查看与基础管理动作

• 只绑定本机，不是公开入口

• 未来可被 Electron/Tauri 包装，但 v1 先走本地 Web UI

• Providers

• agents-hot : 通过 Bridge Worker 把本地 agent 暴露到平台

• generic-a2a : 在本地 daemon 上起标准 A2A HTTP ingress

• Bridge Worker (packages/worker/ )

• 继续负责 Agents Hot 线上 ingress 和转发

• Protocol (packages/protocol/ )

• Bridge / relay / A2A 相关消息类型

核心心智：

daemon 拥有本地 session 与 transcript 主权 -> 本地 Web UI 负责查看与管理 -> provider 负责暴露入口 -> 平台只做入口、权限和发现

Behavior

当此 skill 触发时：

• 先读 agent-mesh/CLAUDE.md

• 判断改动属于哪一层：

• daemon / local runtime

• provider / ingress

• worker / bridge

• protocol

• 不要再按旧的 connect-ticket/connect 架构去设计新能力

Sub-repo Location

agents-hot/ └── agent-mesh/ ├── packages/ │ ├── cli/ │ ├── ui/ │ ├── protocol/ │ └── worker/ ├── tests/ └── CLAUDE.md

Development

cd agent-mesh pnpm install pnpm build pnpm test pnpm lint

Deployment

Bridge Worker

cd agent-mesh npx wrangler deploy --config packages/worker/wrangler.toml

CLI Publishing

cd agent-mesh/packages/cli pnpm version patch --no-git-tag-version cd ../..

VERSION=$(node -p "require('./packages/cli/package.json').version") git add packages/cli/package.json git commit -m "release: v${VERSION}" git tag "v${VERSION}" git push origin main git push origin "v${VERSION}"

Main Project Integration Points

Main project file Purpose

src/lib/mesh-client.ts

Platform -> bridge relay client

src/lib/agent-session-service.ts

平台侧 session_id / user_sessions 索引逻辑

src/app/api/agents/[id]/chat/route.ts

Chat 入口

src/app/api/agents/[id]/call/route.ts

Call 入口

src/app/api/developer/agents/[id]/sessions/sync/route.ts

owner 本地 session 同步

Verification Order

• cd agent-mesh && pnpm test

• cd agent-mesh && pnpm build

• cd .. && pnpm test

• cd .. && pnpm run lint

• 改本地 Web UI / daemon 文案边界时，确认口径一致：完整 transcript 留在本地，Agents Hot 不是 transcript surface

• 改 provider / ingress 时，补本地 smoke 或 Mac Mini 实机验证

Further Reading

• agent-mesh/CLAUDE.md

• references/architecture.md

• references/protocol-reference.md

• .claude/skills/agent-mesh-creator/references/cli-reference.md