@ burtson-labs/ 代理核心

土匪特工框架的核心推理与规划引擎.

拥有 ToolUseLoop ——在VS代码扩展和CLI主机中,驱动每个匪徒代理运行的迭代控制器,母或子代理.

安装

pnpm add @burtson-labs/agent-core

快开始

agent-core 是提供者不可知的——与提供者客户端对齐(@burtson-labs/agent-adapters-provider 包装 Ollama, OpenAI 兼容的端点,以及主机"盗贼"网关)和主机侧式工具集(@burtson-labs/host-kit 将额外CLI和扩展用途的船载。 最小形状 :

import { createAgentRuntime } from "@burtson-labs/agent-core";

const runtime = createAgentRuntime({
  providerClient,                    // satisfies ProviderClient
  systemPrompt: "You are a helpful coding agent.",
  tools: [/* built-ins + your own */]
});

const plan = await runtime.plan("Summarize this repo");
const result = await runtime.execute();
const report = await runtime.report();

主机在提供者上电线向上接通流线+auth;循环拥有迭代,重试/倒置,收缩,输出-预算序列化,以及探测器合同.

典型配对

里面的东西

正在测试

pnpm --filter @burtson-labs/agent-core test

套房是分开的 合成合同测试 (每个探测器集群一个文件)和 实时重播测试 (从 .bandit/turns/ 通过新循环重放 :

从真实的故障跟踪中添加回归固定

当你在真实运行中看到一个怪异的代理行为时,将转动日志固定器放下去测试套件,这样未来的循环变化就不能默默地倒退. 见 测试/固定/转弯/README.md 用于完整指南——重放-完成性限制,命名惯例,断言什么,以及复制-复制测试模板.

公约

• 每个探测器每转一发. 每个 tool_loop:*_nudge 在循环终止或模型恢复之前,事件起火最多一次。 添加新的探测器意味着添加出门旗+合同测试.
• 构造器选项必须流到运行时间 . ToolUseLoopOptions 适用于每个 runWithMessages 电话 合并发生于 runWithMessages 看到了吗 effectiveOptions = { ...defaultOptions, ...perCall }新选项需要相应的条目 试验/建造者 (文件的详尽性检查失败, 如果你忘了的话) .
• 帮手进去 test/_helpers.ts; 重新播放带入 test/_replay.ts。 。 。 . 两个文件名称从 _ 所以他们被排除在vitest的之外 test/**/*.test.ts glo.

框架中的立场

[host: VS Code extension or CLI]
              │
              ▼
       ┌──────────────┐
       │ ToolUseLoop  │  ← this package
       └──────┬───────┘
              │
        ┌─────┴─────┐
        ▼           ▼
 [tool registry]   [chat function]
        │              │
        ▼              ▼
  [host-kit tools]   [Ollama / Bandit cloud / etc.]

循环是主机不可知. 主机连接聊天功能(使用自己的监听/流出/认证),并提供一个工具注册;循环拥有迭代,重试/倒置政策,收缩,输出-预算序列化,以及检测器合同.

许可证

Apache 许可证 2.0 ——版权2026 Burtson Labs.