@zelari/core 2.39.0 → 2.40.0
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.
- package/README.md +23 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -50,6 +50,29 @@ Only the `exports` map in `package.json` is public. Prefer curated subpaths over
|
|
|
50
50
|
- Core versions are lockstep with the CLI (`verify-versions` gate); `CORE_VERSION`
|
|
51
51
|
never moves independently of a CLI release.
|
|
52
52
|
|
|
53
|
+
#### Three documented public interfaces (t53)
|
|
54
|
+
|
|
55
|
+
Everything else in this package is implementation detail. These three are the
|
|
56
|
+
interfaces we document, support, and pin by test:
|
|
57
|
+
|
|
58
|
+
| Interface | Subpath | Surface you may call |
|
|
59
|
+
|---|---|---|
|
|
60
|
+
| `AgentHarness` (class) | `@zelari/core/harness` | `run()` |
|
|
61
|
+
| `ToolRegistry` (class) + `getToolRegistry()` | `@zelari/core/harness/tools` | `register()`, `invoke()`, `getToolRegistry()` |
|
|
62
|
+
| Resource ledger | `@zelari/core/runtime` | `ResourceLedgerEntry`, `ResourceLedgerReason`, `computeBudget()`, `usageFromLedger()` |
|
|
63
|
+
|
|
64
|
+
- There is **no `Ledger` class** in this package: the ledger surface is the
|
|
65
|
+
`ResourceLedgerEntry` / `ResourceLedgerReason` pair plus the pure helpers above.
|
|
66
|
+
- Dropping one of these exports, or `AgentHarness.prototype.run` /
|
|
67
|
+
`ToolRegistry.prototype.invoke`, is a **breaking change → major**. Adding
|
|
68
|
+
exports is additive → minor.
|
|
69
|
+
- Pinned mechanically by
|
|
70
|
+
[`src/publicApi.contract.test.ts`](src/publicApi.contract.test.ts); rationale in
|
|
71
|
+
[ADR-0037](../../docs/decisions/0037-public-api-contract-tests.md).
|
|
72
|
+
- Note: the root `@zelari/core` barrel is permissive (14 `export *`) and still
|
|
73
|
+
re-exports `AgentHarness`, `computeBudget`, `usageFromLedger`, `CORE_VERSION`,
|
|
74
|
+
but **not** `ToolRegistry` — import that one from `@zelari/core/harness/tools`.
|
|
75
|
+
|
|
53
76
|
Stability policy: [docs/decisions/0004-public-api-stability-policy.md](../../docs/decisions/0004-public-api-stability-policy.md).
|
|
54
77
|
|
|
55
78
|
If you still import pre-0.5.0 `src/main/core/…` paths, see [MIGRATION.md](../../MIGRATION.md).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zelari/core",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.40.0",
|
|
4
4
|
"description": "Zelari Code core library — provider-neutral agent loop (AgentHarness), multi-agent council orchestration, and built-in skills. Used by the zelari-code CLI; consumable by other agent frontends.",
|
|
5
5
|
"author": "Anathema Studio <https://anathema-studio.com/>",
|
|
6
6
|
"license": "Apache-2.0",
|