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.mdDevelopment
cd agent-mesh
pnpm install
pnpm build
pnpm test
pnpm lintDeployment
Bridge Worker
cd agent-mesh
npx wrangler deploy --config packages/worker/wrangler.tomlCLI 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 testcd agent-mesh && pnpm buildcd.. && pnpm testcd.. && pnpm run lint- 改本地 Web UI / daemon 文案边界时，确认口径一致：完整 transcript 留在本地，Agents Hot 不是 transcript surface
- 改 provider / ingress 时，补本地 smoke 或 Mac Mini 实机验证
Further Reading
agent-mesh/CLAUDE.mdreferences/architecture.mdreferences/protocol-reference.md.claude/skills/agent-mesh-creator/references/cli-reference.md