loop.js
Loop engineering 框架:声明 Goal,由只读 Verify Agent 裁定 Round,直到任务 settle。
开源
loop.js 是开源 TypeScript 框架,面向目标驱动的 Agent 循环。你声明 goal 与验收标准;引擎按 Execute → Handoff → Verify 推进 Round(每轮新鲜上下文、磁盘记忆、usd/rounds/timeout 守卫、崩溃可恢复),并可选本地 cron 或 Modal 调度。当前执行器基于 Anthropic Claude Agent SDK。状态为 v0.2 beta(2026 年 7 月发布窗口内 npm `@loop.js/core` 为 0.2.0-beta)。
官方资源
选型建议
当“完成”必须由独立 Agent 裁定、且循环可能超出单次终端会话时选 loop.js;通用图编排选 LangGraph;需要更宽的多 Agent 应用 SDK 时选 OpenAI Agents SDK 或 Mastra。
快速对比
loop.js 专注在独立 Verify 裁定下收敛目标;LangGraph 建模通用有状态图;OpenAI Agents SDK 与 Mastra 是更宽的 Agent 应用 SDK。
| loop.js | LangGraph | OpenAI Agents SDK | |
|---|---|---|---|
| 最适合 | 只有独立裁判说 done 才停止的自治循环 | 带 checkpoint、分支与 HITL 的图工作流 | OpenAI 优先、需要工具与 handoff 的 Agent |
| 循环模型 | Goal + Execute + Verify Round;worker 不自批作业 | 显式图节点、边与持久状态 | SDK 内的 Agent loop、工具与 handoff |
| 当前运行时 | TypeScript/`@loop.js/core` + Claude Agent SDK;本地或 Modal cron | Python 优先的 LangGraph 与 LangChain 生态 | 围绕 OpenAI 模型与 API 的 Python/JS SDK |
| 主要取舍 | settle/预算语义强;beta API 且执行器偏 Anthropic | 工作流最灵活,图建模成本更高 | OpenAI 产品路径快;缺少专用 goal–verify 机制 |
适用场景
- 需要独立 Verify Agent 的目标驱动循环
- 崩溃可恢复的磁盘 Round 与花费/轮次守卫
- 通过 OS cron 或 Modal 调度的维护型循环
- 已使用 Anthropic / Claude Agent SDK 的 TypeScript 团队
不适用场景
- 当前就需要多供应商执行器的团队(v0.2 仅 Claude Agent SDK)
- 更适合通用图建模的复杂分支工作流
- 无法接受 pre-1.0 beta API 的项目
核心概念
loop engineeringGoal / Execute / VerifyRound独立 Verify Agent磁盘 handoff 记忆usd / rounds / timeout 守卫Lock 与崩溃恢复loop cron(本地或 Modal)
最小实现形态
运行 `npm create @loop.js@latest my-loop`,配置 `ANTHROPIC_API_KEY`,编辑脚手架中的 `goal`/`verify`,再执行 `npx loop run`,直到 Verify Agent settle 或守卫触发。