@zelari/core 2.39.0 → 2.41.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 CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Reusable runtime for [Zelari Code](https://github.com/N-THEM-Studio/zelari-code) — **Apache-2.0**.
4
4
 
5
- Current version: **2.39.0** (kept in lockstep with the `zelari-code` CLI).
5
+ Current version: **2.41.0** (kept in lockstep with the `zelari-code` CLI).
6
6
 
7
7
  ## What it is
8
8
 
@@ -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/dist/version.d.ts CHANGED
@@ -3,5 +3,5 @@
3
3
  * require.resolve('@zelari/core/package.json') (2.6.1 plan §7).
4
4
  * Kept in sync with package.json by scripts/verify-versions.mjs.
5
5
  */
6
- export declare const CORE_VERSION = "2.39.0";
6
+ export declare const CORE_VERSION = "2.41.0";
7
7
  //# sourceMappingURL=version.d.ts.map
package/dist/version.js CHANGED
@@ -3,5 +3,5 @@
3
3
  * require.resolve('@zelari/core/package.json') (2.6.1 plan §7).
4
4
  * Kept in sync with package.json by scripts/verify-versions.mjs.
5
5
  */
6
- export const CORE_VERSION = '2.39.0';
6
+ export const CORE_VERSION = '2.41.0';
7
7
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zelari/core",
3
- "version": "2.39.0",
3
+ "version": "2.41.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",