@burtson-labs/agent-core 1.6.13 → 1.6.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +38 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,9 +1,9 @@
1
1
  <div align="center">
2
- <picture>
3
- <source media="(prefers-color-scheme: dark)" srcset="https://cdn.burtson.ai/logos/burtson-labs-logo-alt.png" />
4
- <source media="(prefers-color-scheme: light)" srcset="https://cdn.burtson.ai/logos/burtson-labs-logo.png" />
5
- <img src="https://cdn.burtson.ai/logos/burtson-labs-logo-alt.png" alt="Burtson Labs" width="150" />
6
- </picture>
2
+ <a href="https://burtson.ai">
3
+ <picture>
4
+ <img src="https://cdn.burtson.ai/logos/bandit-stealth.png" alt="Bandit Stealth" width="150" style="width: 150px !important; max-width: 150px !important; height: auto; display: inline-block;" />
5
+ </picture>
6
+ </a>
7
7
 
8
8
  # @burtson-labs/agent-core
9
9
 
@@ -20,6 +20,39 @@
20
20
  pnpm add @burtson-labs/agent-core
21
21
  ```
22
22
 
23
+ ## <img src="https://api.iconify.design/lucide/zap.svg?color=%23a60ee5&width=22" align="absmiddle"> Quick start
24
+
25
+ `agent-core` is provider-agnostic — pair it with a provider client (`@burtson-labs/agent-adapters-provider` wraps Ollama, OpenAI-compatible endpoints, and the hosted Bandit gateway) and a host-side tool set (`@burtson-labs/host-kit` ships the extras the CLI and extension use). The minimal shape:
26
+
27
+ ```ts
28
+ import { createAgentRuntime } from "@burtson-labs/agent-core";
29
+
30
+ const runtime = createAgentRuntime({
31
+ providerClient, // satisfies ProviderClient
32
+ systemPrompt: "You are a helpful coding agent.",
33
+ tools: [/* built-ins + your own */]
34
+ });
35
+
36
+ const plan = await runtime.plan("Summarize this repo");
37
+ const result = await runtime.execute();
38
+ const report = await runtime.report();
39
+ ```
40
+
41
+ The host wires up streaming + auth on the provider; the loop owns iteration, retry/fallback, compaction, output-budget serialization, and the detector contract.
42
+
43
+ ### Typical pairings
44
+
45
+ | You need | Add |
46
+ |---|---|
47
+ | LLM provider (Ollama / OpenAI / cloud) | [`@burtson-labs/agent-adapters-provider`](https://www.npmjs.com/package/@burtson-labs/agent-adapters-provider) |
48
+ | Run on Node (shell + filesystem) | [`@burtson-labs/agent-adapters-node`](https://www.npmjs.com/package/@burtson-labs/agent-adapters-node) |
49
+ | Run in the browser | [`@burtson-labs/agent-adapters-web`](https://www.npmjs.com/package/@burtson-labs/agent-adapters-web) |
50
+ | Run inside a VS Code extension | [`@burtson-labs/agent-adapters-vscode`](https://www.npmjs.com/package/@burtson-labs/agent-adapters-vscode) |
51
+ | Run from a GitHub Action | [`@burtson-labs/agent-adapters-github`](https://www.npmjs.com/package/@burtson-labs/agent-adapters-github) |
52
+ | Memory / hooks / `@`-mentions / extra tools | [`@burtson-labs/host-kit`](https://www.npmjs.com/package/@burtson-labs/host-kit) |
53
+ | Pre-built runtime (CLI + extension parity) | [`@burtson-labs/stealth-core-runtime`](https://www.npmjs.com/package/@burtson-labs/stealth-core-runtime) |
54
+ | React UI for plan / chat / diff / telemetry | [`@burtson-labs/agent-ui`](https://www.npmjs.com/package/@burtson-labs/agent-ui) |
55
+
23
56
  ## <img src="https://api.iconify.design/lucide/puzzle.svg?color=%23a60ee5&width=22" align="absmiddle"> What's inside
24
57
 
25
58
  | Path | Purpose |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@burtson-labs/agent-core",
3
- "version": "1.6.13",
3
+ "version": "1.6.15",
4
4
  "description": "Core reasoning and planning engine for Bandit Agent Framework.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",