kernl 0.12.1 → 0.12.3

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> kernl@0.12.1 build /home/runner/work/kernl/kernl/packages/kernl
+> kernl@0.12.3 build /home/runner/work/kernl/kernl/packages/kernl
 > tsc && tsc-alias --resolve-full-paths
 

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @kernl/core
 
+## 0.12.3
+
+### Patch Changes
+
+- 884e513: Align with @ai-sdk/provider v3 stable release
+  - Update LanguageModelUsage to nested structure (inputTokens.total, outputTokens.total, etc.)
+  - Update LanguageModelFinishReason to object with unified and raw properties
+  - Rename LanguageModelWarning to SharedWarning with updated structure
+  - Update tool type from "provider-defined" to "provider"
+  - Bump @ai-sdk peer dependencies from beta to stable (^3.0.3)
+
+- 0576a77: Fix model not being updated when resuming thread from storage
+- Updated dependencies [884e513]
+  - @kernl-sdk/protocol@0.5.1
+  - @kernl-sdk/retrieval@0.1.10
+
+## 0.12.2
+
+### Patch Changes
+
+- 11cf6fd: Add ModelRegistry and AgentRegistry classes to fix hydration issues when threads use model overrides. Models are now auto-registered in spawn/schedule methods.
+
 ## 0.12.1
 
 ### Patch Changes

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,qBAAa,KAAK,CACd,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,CAE9C,SAAQ,SAAS,CAAC,QAAQ,EAAE,OAAO,CACnC,YAAW,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC;IAEzC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IAErD,QAAQ,CAAC,UAAU,EAAE;QACnB,KAAK,EAAE,cAAc,EAAE,CAAC;QACxB,MAAM,EAAE,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;KAC5C,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAqB;IAC7C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;gBAEtB,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC;IAYlD;;;;;OAKG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,EACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAyD/D;;;;;;;OAOG;IACI,MAAM,CACX,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,EACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACvC,aAAa,CAAC,iBAAiB,CAAC;IA0DnC;;;;OAIG;IACH,IAAI,OAAO;mBAWI,MAAM,YAAY,iBAAiB;wBAE/B,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC;sBAEpC,MAAM;uBACL,MAAM,WAAW,oBAAoB;yBAEnC,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,OAAO,CAAC;sBASjD,MAAM,SAAS,mBAAmB;MAGnD;CACF"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,qBAAa,KAAK,CACd,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,CAE9C,SAAQ,SAAS,CAAC,QAAQ,EAAE,OAAO,CACnC,YAAW,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC;IAEzC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IAErD,QAAQ,CAAC,UAAU,EAAE;QACnB,KAAK,EAAE,cAAc,EAAE,CAAC;QACxB,MAAM,EAAE,eAAe,CAAC,eAAe,CAAC,EAAE,CAAC;KAC5C,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAqB;IAC7C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;gBAEtB,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC;IAYlD;;;;;OAKG;IACG,GAAG,CACP,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,EACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IA4D/D;;;;;;;OAOG;IACI,MAAM,CACX,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,EACnC,OAAO,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACvC,aAAa,CAAC,iBAAiB,CAAC;IA6DnC;;;;OAIG;IACH,IAAI,OAAO;mBAWI,MAAM,YAAY,iBAAiB;wBAE/B,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC;sBAEpC,MAAM;uBACL,MAAM,WAAW,oBAAoB;yBAEnC,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,OAAO,CAAC;sBASjD,MAAM,SAAS,mBAAmB;MAGnD;CACF"}

package/dist/agent.js

@@ -27,14 +27,11 @@ export class Agent extends BaseAgent {
      * @throws {MisconfiguredError} If the agent is not bound to a kernl instance
      */
     async run(input, options) {
+        let thread = null;
         if (!this.kernl) {
             throw new MisconfiguredError(`Agent ${this.id} not bound to kernl. Call kernl.register(agent) first.`);
         }
-        const items = typeof input === "string"
-            ? [message({ role: "user", text: input })]
-            : input;
         const tid = options?.threadId;
-        let thread = null;
         if (tid) {
             // no concurrent execution of same thread - correctness contract
             // TODO: race condition - need to check again after async storage.get()
@@ -48,6 +45,9 @@ export class Agent extends BaseAgent {
                 }));
             }
         }
+        const items = typeof input === "string"
+            ? [message({ role: "user", text: input })]
+            : input;
         // create new thread if not found in storage or no tid provided
         if (!thread) {
             const ctx = options?.context
@@ -69,6 +69,9 @@ export class Agent extends BaseAgent {
         if (options?.context) {
             thread.context.context = options.context;
         }
+        if (options?.model) {
+            thread.model = options.model;
+        }
         thread.append(...items);
         return this.kernl.schedule(thread);
     }
@@ -124,6 +127,9 @@ export class Agent extends BaseAgent {
         if (options?.context) {
             thread.context.context = options.context;
         }
+        if (options?.model) {
+            thread.model = options.model;
+        }
         thread.append(...items);
         yield* this.kernl.scheduleStream(thread);
     }

package/dist/api/resources/agents/agents.d.ts

@@ -1,7 +1,7 @@
 import { Agent } from "../../../agent.js";
-import type { BaseAgent } from "../../../agent/base.js";
 import type { AgentOutputType } from "../../../agent/types.js";
 import type { UnknownContext } from "../../../context.js";
+import type { AgentRegistry } from "../../../kernl/registry.js";
 import type { TextOutput } from "../../../thread/types.js";
 /**
  * Agents resource.
@@ -16,7 +16,7 @@ import type { TextOutput } from "../../../thread/types.js";
  */
 export declare class RAgents {
     private readonly registry;
-    constructor(registry: Map<string, BaseAgent>);
+    constructor(registry: AgentRegistry);
     /**
      * Get a live Agent instance by id.
      *

package/dist/api/resources/agents/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAE7D;;;;;;;OAOG;IACH,GAAG,CACD,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,EAC5C,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS;IAQnD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE;IAMhD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,aAAa;IAEpD;;;;;;;OAOG;IACH,GAAG,CACD,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,EAC5C,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS;IAQnD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE;IAMhD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/dist/api/resources/agents/agents.js

@@ -45,6 +45,6 @@ export class RAgents {
      * Unregister an agent at runtime.
      */
     unregister(id) {
-        return this.registry.delete(id);
+        return this.registry.unregister(id);
     }
 }

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { Kernl } from "./kernl/index.js";
-export type { KernlOptions, StorageOptions, AgentRegistry, ModelRegistry, } from "./kernl/index.js";
+export type { KernlOptions, StorageOptions, IAgentRegistry, IModelRegistry, } from "./kernl/index.js";
+export { AgentRegistry, ModelRegistry } from "./kernl/index.js";
 export { Agent } from "./agent.js";
 export { Context } from "./context.js";
 export type { LifecycleEvent, ThreadStartEvent, ThreadStopEvent, ModelCallStartEvent, ModelCallEndEvent, ToolCallStartEvent, ToolCallEndEvent, } from "./lifecycle.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAIrD,YAAY,EACV,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,WAAW,EAC3B,gBAAgB,IAAI,eAAe,GACpC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,EACrC,oBAAoB,IAAI,mBAAmB,EAC3C,mBAAmB,IAAI,kBAAkB,EACzC,mBAAmB,IAAI,kBAAkB,GAC1C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAIrD,YAAY,EACV,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,WAAW,EAC3B,gBAAgB,IAAI,eAAe,GACpC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,EACrC,oBAAoB,IAAI,mBAAmB,EAC3C,mBAAmB,IAAI,kBAAkB,EACzC,mBAAmB,IAAI,kBAAkB,GAC1C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { Kernl } from "./kernl/index.js";
+export { AgentRegistry, ModelRegistry } from "./kernl/index.js";
 export { Agent } from "./agent.js";
 export { Context } from "./context.js";
 // --- realtime ---

package/dist/kernl/index.d.ts

@@ -1,3 +1,4 @@
 export { Kernl } from "./kernl.js";
-export type { KernlOptions, StorageOptions, MemoryOptions, AgentRegistry, ModelRegistry, } from "./types.js";
+export { AgentRegistry, ModelRegistry } from "./registry.js";
+export type { KernlOptions, StorageOptions, MemoryOptions, IAgentRegistry, IModelRegistry, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/kernl/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/kernl/index.js

@@ -1 +1,2 @@
 export { Kernl } from "./kernl.js";
+export { AgentRegistry, ModelRegistry } from "./registry.js";

package/dist/kernl/kernl.d.ts

@@ -3,9 +3,9 @@ import { KernlHooks } from "../lifecycle.js";
 import type { Thread } from "../thread/index.js";
 import type { ResolvedAgentResponse } from "../guardrail.js";
 import { type KernlStorage } from "../storage/index.js";
+import { Memory } from "../memory/index.js";
 import { RThreads } from "../api/resources/threads/index.js";
 import { RAgents } from "../api/resources/agents/index.js";
-import { Memory } from "../memory/index.js";
 import type { ThreadExecuteResult, ThreadStreamEvent } from "../thread/types.js";
 import type { AgentOutputType } from "../agent/types.js";
 import type { KernlOptions } from "./types.js";
@@ -18,10 +18,10 @@ import type { KernlOptions } from "./types.js";
 export declare class Kernl extends KernlHooks {
     private readonly _agents;
     private readonly _models;
-    readonly storage: KernlStorage;
-    athreads: Map<string, Thread<any, any>>;
     private readonly _memopts;
     private readonly _storopts;
+    readonly storage: KernlStorage;
+    athreads: Map<string, Thread<any, any>>;
     private warnings;
     readonly threads: RThreads;
     readonly agents: RAgents;
@@ -58,6 +58,6 @@ export declare class Kernl extends KernlHooks {
      *
      * Initialize the memory system based on the storage + memory configuration.
      */
-    private initializeMemory;
+    private initmem;
 }
 //# sourceMappingURL=kernl.d.ts.map

package/dist/kernl/kernl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAIlB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,OAAO,CAAC,QAAQ,CAGd;IAGF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAatC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAgCrC;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAWnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA6BzB"}
+{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAG3E;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAEpD,OAAO,CAAC,QAAQ,CAGd;IAGF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAetC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IA6BrC;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAU/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAU/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAUnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAYnC;;;;OAIG;IACH,OAAO,CAAC,OAAO;CA6BhB"}

package/dist/kernl/kernl.js

@@ -1,10 +1,11 @@
 import { resolveEmbeddingModel } from "@kernl-sdk/retrieval";
 import { KernlHooks } from "../lifecycle.js";
 import { InMemoryStorage } from "../storage/index.js";
-import { RThreads } from "../api/resources/threads/index.js";
-import { RAgents } from "../api/resources/agents/index.js";
 import { Memory, MemoryByteEncoder, MemoryIndexHandle, buildMemoryIndexSchema, } from "../memory/index.js";
 import { logger } from "../lib/logger.js";
+import { RThreads } from "../api/resources/threads/index.js";
+import { RAgents } from "../api/resources/agents/index.js";
+import { AgentRegistry, ModelRegistry } from "./registry.js";
 /**
  * The kernl - manages agent processes, scheduling, and task lifecycle.
  *
@@ -12,12 +13,12 @@ import { logger } from "../lib/logger.js";
  * tracing.
  */
 export class Kernl extends KernlHooks {
-    _agents = new Map();
-    _models = new Map();
-    storage;
-    athreads = new Map(); /* active threads */
+    _agents;
+    _models;
     _memopts;
     _storopts;
+    storage;
+    athreads = new Map(); /* active threads */
     warnings = {
         embedding: false, // "Embeddings are not configured. If you want memories to auto-embed text content..."
         vector: false, // "No vector storage configured. The memories.search() function will not be..."
@@ -30,17 +31,19 @@ export class Kernl extends KernlHooks {
         super();
         this._memopts = options.memory;
         this._storopts = options.storage;
+        this._agents = new AgentRegistry();
+        this._models = new ModelRegistry();
         this.storage = options.storage?.db ?? new InMemoryStorage();
         this.storage.bind({ agents: this._agents, models: this._models });
         this.threads = new RThreads(this.storage.threads);
         this.agents = new RAgents(this._agents);
-        this.memories = this.initializeMemory();
+        this.memories = this.initmem();
     }
     /**
      * Registers a new agent with the kernl instance.
      */
     register(agent) {
-        this._agents.set(agent.id, agent);
+        this._agents.register(agent);
         agent.bind(this);
         // memory config warnings (log once)
         if (agent.memory.enabled) {
@@ -57,16 +60,14 @@ export class Kernl extends KernlHooks {
         }
         // auto-populate model registry for storage hydration (llm agents only - for now)
         if (agent.kind === "llm") {
-            const key = `${agent.model.provider}/${agent.model.modelId}`;
-            if (!this._models.has(key)) {
-                this._models.set(key, agent.model);
-            }
+            this._models.register(agent.model);
         }
     }
     /**
      * Spawn a new thread - blocking execution
      */
     async spawn(thread) {
+        this._models.register(thread.model);
         this.athreads.set(thread.tid, thread);
         try {
             return await thread.execute();
@@ -81,6 +82,7 @@ export class Kernl extends KernlHooks {
      * NOTE: just blocks for now
      */
     async schedule(thread) {
+        this._models.register(thread.model);
         this.athreads.set(thread.tid, thread);
         try {
             return await thread.execute();
@@ -95,6 +97,7 @@ export class Kernl extends KernlHooks {
      * Spawn a new thread - streaming execution
      */
     async *spawnStream(thread) {
+        this._models.register(thread.model);
         this.athreads.set(thread.tid, thread);
         try {
             yield* thread.stream();
@@ -109,6 +112,7 @@ export class Kernl extends KernlHooks {
      * Schedule an existing thread - streaming execution
      */
     async *scheduleStream(thread) {
+        this._models.register(thread.model);
         this.athreads.set(thread.tid, thread);
         try {
             yield* thread.stream();
@@ -123,7 +127,7 @@ export class Kernl extends KernlHooks {
      *
      * Initialize the memory system based on the storage + memory configuration.
      */
-    initializeMemory() {
+    initmem() {
         const embeddingModel = this._memopts?.embedding;
         const embedder = embeddingModel
             ? typeof embeddingModel === "string"

package/dist/kernl/registry.d.ts

@@ -0,0 +1,46 @@
+import type { LanguageModel } from "@kernl-sdk/protocol";
+import type { BaseAgent } from "../agent/base.js";
+import type { IAgentRegistry, IModelRegistry } from "./types.js";
+/**
+ * Registry for language models used by threads.
+ *
+ * Models are keyed by "{provider}/{modelId}" and must be registered before
+ * storage can hydrate threads that reference them.
+ */
+export declare class ModelRegistry implements IModelRegistry {
+    private readonly models;
+    /**
+     * Register a model instance. Idempotent - only adds if not already present.
+     */
+    register(model: LanguageModel): void;
+    /**
+     * Get a model by its composite key ("{provider}/{modelId}").
+     */
+    get(key: string): LanguageModel | undefined;
+}
+/**
+ * Registry for agents.
+ *
+ * Agents are keyed by their id and must be registered before threads can
+ * reference them.
+ */
+export declare class AgentRegistry implements IAgentRegistry {
+    private readonly agents;
+    /**
+     * Register an agent instance. Replaces existing agent with same id.
+     */
+    register(agent: BaseAgent<any>): void;
+    /**
+     * Get an agent by its id.
+     */
+    get(id: string): BaseAgent<any> | undefined;
+    /**
+     * Unregister an agent by id.
+     */
+    unregister(id: string): boolean;
+    /**
+     * List all registered agents.
+     */
+    values(): IterableIterator<BaseAgent<any>>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/kernl/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/kernl/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAEhE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOpC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAG5C;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAIrC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS;IAI3C;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CAG3C"}

package/dist/kernl/registry.js

@@ -0,0 +1,57 @@
+/**
+ * Registry for language models used by threads.
+ *
+ * Models are keyed by "{provider}/{modelId}" and must be registered before
+ * storage can hydrate threads that reference them.
+ */
+export class ModelRegistry {
+    models = new Map();
+    /**
+     * Register a model instance. Idempotent - only adds if not already present.
+     */
+    register(model) {
+        const key = `${model.provider}/${model.modelId}`;
+        if (!this.models.has(key)) {
+            this.models.set(key, model);
+        }
+    }
+    /**
+     * Get a model by its composite key ("{provider}/{modelId}").
+     */
+    get(key) {
+        return this.models.get(key);
+    }
+}
+/**
+ * Registry for agents.
+ *
+ * Agents are keyed by their id and must be registered before threads can
+ * reference them.
+ */
+export class AgentRegistry {
+    agents = new Map();
+    /**
+     * Register an agent instance. Replaces existing agent with same id.
+     */
+    register(agent) {
+        this.agents.set(agent.id, agent);
+    }
+    /**
+     * Get an agent by its id.
+     */
+    get(id) {
+        return this.agents.get(id);
+    }
+    /**
+     * Unregister an agent by id.
+     */
+    unregister(id) {
+        return this.agents.delete(id);
+    }
+    /**
+     * List all registered agents.
+     */
+    values() {
+        return this.agents.values();
+    }
+}

package/dist/kernl/types.d.ts

@@ -74,7 +74,7 @@ export interface KernlOptions {
  *
  * Satisfied by Map<string, BaseAgent>.
  */
-export interface AgentRegistry {
+export interface IAgentRegistry {
     get(id: string): BaseAgent<any> | undefined;
 }
 /**
@@ -86,7 +86,7 @@ export interface AgentRegistry {
  * TODO: Create an exhaustive model registry in the protocol package
  * with all supported models and their metadata.
  */
-export interface ModelRegistry {
+export interface IModelRegistry {
     get(key: string): LanguageModel | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/kernl/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernl/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CAKtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC7C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernl/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CAKtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC7C"}

package/dist/lib/env.d.ts

@@ -7,11 +7,11 @@ import { z } from "zod";
  */
 declare const envSchema: z.ZodObject<{
     LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
-        error: "error";
         trace: "trace";
         debug: "debug";
         info: "info";
         warn: "warn";
+        error: "error";
         fatal: "fatal";
     }>>;
     KERNL_LOG_MODEL_DATA: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
@@ -31,7 +31,7 @@ declare const envSchema: z.ZodObject<{
  * console.log(env.LOG_LEVEL);
  */
 export declare const env: {
-    LOG_LEVEL: "error" | "trace" | "debug" | "info" | "warn" | "fatal";
+    LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
     KERNL_LOG_MODEL_DATA: boolean;
     KERNL_LOG_TOOL_DATA: boolean;
 };

package/dist/storage/base.d.ts

@@ -1,7 +1,7 @@
 /**
  * Core storage contracts.
  */
-import type { AgentRegistry, ModelRegistry } from "../kernl/types.js";
+import type { IAgentRegistry, IModelRegistry } from "../kernl/types.js";
 import type { ThreadStore } from "./thread.js";
 import type { MemoryStore } from "../memory/store.js";
 /**
@@ -24,8 +24,8 @@ export interface KernlStorage {
      * Called by Kernl after construction to wire up agent/model lookups.
      */
     bind(registries: {
-        agents: AgentRegistry;
-        models: ModelRegistry;
+        agents: IAgentRegistry;
+        models: IModelRegistry;
     }): void;
     /**
      * Execute a function within a transaction.

package/dist/storage/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/storage/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC;IAKtB;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzE;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAMrB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/storage/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC;IAKtB;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAE3E;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhE;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAMrB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/storage/in-memory.d.ts

@@ -8,7 +8,7 @@
 import { Thread } from "../thread/index.js";
 import type { KernlStorage, Transaction, ThreadStore, NewThread, ThreadUpdate, ThreadInclude, ThreadListOptions, ThreadHistoryOptions } from "../storage/index.js";
 import type { ThreadEvent } from "../thread/types.js";
-import type { AgentRegistry, ModelRegistry } from "../kernl/types.js";
+import type { IAgentRegistry, IModelRegistry } from "../kernl/types.js";
 import type { MemoryStore, MemoryRecord, NewMemory, MemoryRecordUpdate, MemoryListOptions } from "../memory/index.js";
 /**
  * In-memory storage implementation.
@@ -18,8 +18,8 @@ export declare class InMemoryStorage implements KernlStorage {
     memories: InMemoryMemoryStore;
     constructor();
     bind(registries: {
-        agents: AgentRegistry;
-        models: ModelRegistry;
+        agents: IAgentRegistry;
+        models: IModelRegistry;
     }): void;
     transaction<T>(fn: (tx: Transaction) => Promise<T>): Promise<T>;
     init(): Promise<void>;
@@ -34,8 +34,8 @@ export declare class InMemoryThreadStore implements ThreadStore {
     private events;
     private registries;
     bind(registries: {
-        agents: AgentRegistry;
-        models: ModelRegistry;
+        agents: IAgentRegistry;
+        models: IModelRegistry;
     }): void;
     get(tid: string, include?: ThreadInclude): Promise<Thread | null>;
     list(options?: ThreadListOptions): Promise<Thread[]>;

package/dist/storage/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory.ts"],"names":[],"mappings":"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"}

package/dist/thread/__tests__/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/thread/__tests__/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EAGrB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,QAAQ,CAAC,QAAQ,UAAU;IAC3B,QAAQ,CAAC,OAAO,gBAAgB;IAE1B,QAAQ,CACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAgC1B,MAAM,CACX,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,wBAAwB,CAAC;IAK1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/thread/__tests__/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EAGrB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,QAAQ,CAAC,QAAQ,UAAU;IAC3B,QAAQ,CAAC,OAAO,gBAAgB;IAE1B,QAAQ,CACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyC1B,MAAM,CACX,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,wBAAwB,CAAC;IAK1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}

package/dist/thread/__tests__/mock.js

@@ -26,13 +26,22 @@ export class MockLanguageModel {
             },
         ];
         // Return with fake usage stats
+        const tokens = this.countTokens(userText);
         return {
             content,
-            finishReason: "stop",
+            finishReason: { unified: "stop", raw: "stop" },
             usage: {
-                inputTokens: this.countTokens(userText),
-                outputTokens: this.countTokens(userText),
-                totalTokens: this.countTokens(userText) * 2,
+                inputTokens: {
+                    total: tokens,
+                    noCache: tokens,
+                    cacheRead: undefined,
+                    cacheWrite: undefined,
+                },
+                outputTokens: {
+                    total: tokens,
+                    text: tokens,
+                    reasoning: undefined,
+                },
             },
             warnings: [],
         };

package/dist/thread/thread.js

@@ -155,13 +155,13 @@ export class Thread {
             for await (const e of this.tick()) {
                 if (e.kind === "error") {
                     err = e.error;
-                    logger.error(e.error); // (TODO): onError callback in options
+                    logger.error(err.message); // (TODO): onError callback in options
                 }
                 // complete items get persisted with seq, deltas are ephemeral
                 if (notDelta(e)) {
-                    const [seqd] = this.append(e);
-                    events.push(seqd);
-                    yield seqd;
+                    const [eseq] = this.append(e);
+                    events.push(eseq);
+                    yield eseq;
                 }
                 else {
                     yield e;
@@ -187,8 +187,8 @@ export class Thread {
             const { actions, pendingApprovals } = await this.performActions(intentions);
             // append + yield action events (sequenced)
             for (const a of actions) {
-                const [seqd] = this.append(a);
-                yield seqd;
+                const [eseq] = this.append(a);
+                yield eseq;
             }
             await this.checkpoint(); /* c3: tick complete */
             if (pendingApprovals.length > 0) {
@@ -216,7 +216,7 @@ export class Thread {
         const req = await this.prepareModelRequest(this.history);
         this.emit("model.call.start", { settings: req.settings ?? {} });
         let usage;
-        let finishReason = "unknown";
+        let finishReason = { unified: "other", raw: undefined };
         try {
             if (this.model.stream) {
                 for await (const event of this.model.stream(req)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -34,8 +34,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.2",
     "yaml": "^2.8.2",
-    "@kernl-sdk/protocol": "0.5.0",
-    "@kernl-sdk/retrieval": "0.1.9",
+    "@kernl-sdk/protocol": "0.5.1",
+    "@kernl-sdk/retrieval": "0.1.10",
     "@kernl-sdk/shared": "^0.4.0"
   },
   "peerDependencies": {

package/src/agent.ts

@@ -71,20 +71,15 @@ export class Agent<
     input: string | LanguageModelItem[],
     options?: ThreadExecuteOptions<TContext>,
   ): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>> {
+    let thread: Thread<TContext, TOutput> | null = null;
+
     if (!this.kernl) {
       throw new MisconfiguredError(
         `Agent ${this.id} not bound to kernl. Call kernl.register(agent) first.`,
       );
     }
 
-    const items =
-      typeof input === "string"
-        ? [message({ role: "user", text: input })]
-        : input;
     const tid = options?.threadId;
-
-    let thread: Thread<TContext, TOutput> | null = null;
-
     if (tid) {
       // no concurrent execution of same thread - correctness contract
       // TODO: race condition - need to check again after async storage.get()
@@ -100,6 +95,11 @@ export class Agent<
       }
     }
 
+    const items =
+      typeof input === "string"
+        ? [message({ role: "user", text: input })]
+        : input;
+
     // create new thread if not found in storage or no tid provided
     if (!thread) {
       const ctx = options?.context
@@ -123,6 +123,9 @@ export class Agent<
     if (options?.context) {
       thread.context.context = options.context;
     }
+    if (options?.model) {
+      thread.model = options.model;
+    }
     thread.append(...items);
     return this.kernl.schedule(thread);
   }
@@ -192,6 +195,9 @@ export class Agent<
     if (options?.context) {
       thread.context.context = options.context;
     }
+    if (options?.model) {
+      thread.model = options.model;
+    }
     thread.append(...items);
     yield* this.kernl.scheduleStream(thread);
   }

package/src/api/__tests__/threads.test.ts

@@ -4,7 +4,7 @@ import { message, RUNNING } from "@kernl-sdk/protocol";
 
 import { Agent } from "@/agent";
 import { InMemoryThreadStore } from "@/storage/in-memory";
-import type { AgentRegistry, ModelRegistry } from "@/kernl/types";
+import type { IAgentRegistry, IModelRegistry } from "@/kernl/types";
 import type { NewThread } from "@/storage";
 import { tevent } from "@/thread/utils";
 import type { ThreadEvent } from "@/thread/types";
@@ -14,8 +14,8 @@ import type { MThread } from "@/api/models";
 function createTestStore() {
   const store = new InMemoryThreadStore();
 
-  const agents: AgentRegistry & Map<string, Agent> = new Map();
-  const models: ModelRegistry & Map<string, any> = new Map();
+  const agents: IAgentRegistry & Map<string, Agent> = new Map();
+  const models: IModelRegistry & Map<string, any> = new Map();
 
   const model = {
     spec: "1.0" as const,

package/src/api/resources/agents/agents.ts

@@ -1,7 +1,7 @@
 import { Agent } from "@/agent";
-import type { BaseAgent } from "@/agent/base";
 import type { AgentOutputType } from "@/agent/types";
 import type { UnknownContext } from "@/context";
+import type { AgentRegistry } from "@/kernl/registry";
 import type { TextOutput } from "@/thread/types";
 
 /**
@@ -16,7 +16,7 @@ import type { TextOutput } from "@/thread/types";
  * to realtime agents is needed, add a separate `kernl.realtimeAgents` resource.
  */
 export class RAgents {
-  constructor(private readonly registry: Map<string, BaseAgent>) {}
+  constructor(private readonly registry: AgentRegistry) {}
 
   /**
    * Get a live Agent instance by id.
@@ -57,6 +57,6 @@ export class RAgents {
    * Unregister an agent at runtime.
    */
   unregister(id: string): boolean {
-    return this.registry.delete(id);
+    return this.registry.unregister(id);
   }
 }

package/src/index.ts

@@ -2,9 +2,10 @@ export { Kernl } from "./kernl";
 export type {
   KernlOptions,
   StorageOptions,
-  AgentRegistry,
-  ModelRegistry,
+  IAgentRegistry,
+  IModelRegistry,
 } from "./kernl";
+export { AgentRegistry, ModelRegistry } from "./kernl";
 export { Agent } from "./agent";
 export { Context } from "./context";
 

package/src/kernl/index.ts

@@ -1,8 +1,9 @@
 export { Kernl } from "./kernl";
+export { AgentRegistry, ModelRegistry } from "./registry";
 export type {
   KernlOptions,
   StorageOptions,
   MemoryOptions,
-  AgentRegistry,
-  ModelRegistry,
+  IAgentRegistry,
+  IModelRegistry,
 } from "./types";

package/src/kernl/kernl.ts

@@ -6,8 +6,6 @@ import { KernlHooks } from "@/lifecycle";
 import type { Thread } from "@/thread";
 import type { ResolvedAgentResponse } from "@/guardrail";
 import { InMemoryStorage, type KernlStorage } from "@/storage";
-import { RThreads } from "@/api/resources/threads";
-import { RAgents } from "@/api/resources/agents";
 import {
   Memory,
   MemoryByteEncoder,
@@ -16,10 +14,13 @@ import {
 } from "@/memory";
 
 import { logger } from "@/lib/logger";
-
+import { RThreads } from "@/api/resources/threads";
+import { RAgents } from "@/api/resources/agents";
 import type { ThreadExecuteResult, ThreadStreamEvent } from "@/thread/types";
 import type { AgentOutputType } from "@/agent/types";
+
 import type { KernlOptions, MemoryOptions, StorageOptions } from "./types";
+import { AgentRegistry, ModelRegistry } from "./registry";
 
 /**
  * The kernl - manages agent processes, scheduling, and task lifecycle.
@@ -28,15 +29,14 @@ import type { KernlOptions, MemoryOptions, StorageOptions } from "./types";
  * tracing.
  */
 export class Kernl extends KernlHooks {
-  private readonly _agents: Map<string, BaseAgent> = new Map();
-  private readonly _models: Map<string, LanguageModel> = new Map();
+  private readonly _agents: AgentRegistry;
+  private readonly _models: ModelRegistry;
+  private readonly _memopts: MemoryOptions | undefined;
+  private readonly _storopts: StorageOptions | undefined;
 
   readonly storage: KernlStorage;
   athreads: Map<string, Thread<any, any>> = new Map(); /* active threads */
 
-  private readonly _memopts: MemoryOptions | undefined;
-  private readonly _storopts: StorageOptions | undefined;
-
   private warnings = {
     embedding: false, // "Embeddings are not configured. If you want memories to auto-embed text content..."
     vector: false, // "No vector storage configured. The memories.search() function will not be..."
@@ -53,18 +53,20 @@ export class Kernl extends KernlHooks {
     this._memopts = options.memory;
     this._storopts = options.storage;
 
+    this._agents = new AgentRegistry();
+    this._models = new ModelRegistry();
     this.storage = options.storage?.db ?? new InMemoryStorage();
     this.storage.bind({ agents: this._agents, models: this._models });
     this.threads = new RThreads(this.storage.threads);
     this.agents = new RAgents(this._agents);
-    this.memories = this.initializeMemory();
+    this.memories = this.initmem();
   }
 
   /**
    * Registers a new agent with the kernl instance.
    */
   register(agent: BaseAgent<any>): void {
-    this._agents.set(agent.id, agent);
+    this._agents.register(agent);
     agent.bind(this);
 
     // memory config warnings (log once)
@@ -88,10 +90,7 @@ export class Kernl extends KernlHooks {
 
     // auto-populate model registry for storage hydration (llm agents only - for now)
     if (agent.kind === "llm") {
-      const key = `${agent.model.provider}/${agent.model.modelId}`;
-      if (!this._models.has(key)) {
-        this._models.set(key, agent.model as LanguageModel);
-      }
+      this._models.register(agent.model as LanguageModel);
     }
   }
 
@@ -101,6 +100,7 @@ export class Kernl extends KernlHooks {
   async spawn<TContext, TOutput extends AgentOutputType>(
     thread: Thread<TContext, TOutput>,
   ): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>> {
+    this._models.register(thread.model);
     this.athreads.set(thread.tid, thread);
     try {
       return await thread.execute();
@@ -117,6 +117,7 @@ export class Kernl extends KernlHooks {
   async schedule<TContext, TOutput extends AgentOutputType>(
     thread: Thread<TContext, TOutput>,
   ): Promise<ThreadExecuteResult<ResolvedAgentResponse<TOutput>>> {
+    this._models.register(thread.model);
     this.athreads.set(thread.tid, thread);
     try {
       return await thread.execute();
@@ -133,6 +134,7 @@ export class Kernl extends KernlHooks {
   async *spawnStream<TContext, TOutput extends AgentOutputType>(
     thread: Thread<TContext, TOutput>,
   ): AsyncIterable<ThreadStreamEvent> {
+    this._models.register(thread.model);
     this.athreads.set(thread.tid, thread);
     try {
       yield* thread.stream();
@@ -149,6 +151,7 @@ export class Kernl extends KernlHooks {
   async *scheduleStream<TContext, TOutput extends AgentOutputType>(
     thread: Thread<TContext, TOutput>,
   ): AsyncIterable<ThreadStreamEvent> {
+    this._models.register(thread.model);
     this.athreads.set(thread.tid, thread);
     try {
       yield* thread.stream();
@@ -164,7 +167,7 @@ export class Kernl extends KernlHooks {
    *
    * Initialize the memory system based on the storage + memory configuration.
    */
-  private initializeMemory(): Memory {
+  private initmem(): Memory {
     const embeddingModel = this._memopts?.embedding;
     const embedder = embeddingModel
       ? typeof embeddingModel === "string"

package/src/kernl/registry.ts

@@ -0,0 +1,69 @@
+import type { LanguageModel } from "@kernl-sdk/protocol";
+
+import type { BaseAgent } from "@/agent/base";
+import type { IAgentRegistry, IModelRegistry } from "./types";
+
+/**
+ * Registry for language models used by threads.
+ *
+ * Models are keyed by "{provider}/{modelId}" and must be registered before
+ * storage can hydrate threads that reference them.
+ */
+export class ModelRegistry implements IModelRegistry {
+  private readonly models: Map<string, LanguageModel> = new Map();
+
+  /**
+   * Register a model instance. Idempotent - only adds if not already present.
+   */
+  register(model: LanguageModel): void {
+    const key = `${model.provider}/${model.modelId}`;
+    if (!this.models.has(key)) {
+      this.models.set(key, model);
+    }
+  }
+
+  /**
+   * Get a model by its composite key ("{provider}/{modelId}").
+   */
+  get(key: string): LanguageModel | undefined {
+    return this.models.get(key);
+  }
+}
+
+/**
+ * Registry for agents.
+ *
+ * Agents are keyed by their id and must be registered before threads can
+ * reference them.
+ */
+export class AgentRegistry implements IAgentRegistry {
+  private readonly agents: Map<string, BaseAgent<any>> = new Map();
+
+  /**
+   * Register an agent instance. Replaces existing agent with same id.
+   */
+  register(agent: BaseAgent<any>): void {
+    this.agents.set(agent.id, agent);
+  }
+
+  /**
+   * Get an agent by its id.
+   */
+  get(id: string): BaseAgent<any> | undefined {
+    return this.agents.get(id);
+  }
+
+  /**
+   * Unregister an agent by id.
+   */
+  unregister(id: string): boolean {
+    return this.agents.delete(id);
+  }
+
+  /**
+   * List all registered agents.
+   */
+  values(): IterableIterator<BaseAgent<any>> {
+    return this.agents.values();
+  }
+}

package/src/kernl/types.ts

@@ -89,7 +89,7 @@ export interface KernlOptions {
  *
  * Satisfied by Map<string, BaseAgent>.
  */
-export interface AgentRegistry {
+export interface IAgentRegistry {
   get(id: string): BaseAgent<any> | undefined;
 }
 
@@ -102,6 +102,6 @@ export interface AgentRegistry {
  * TODO: Create an exhaustive model registry in the protocol package
  * with all supported models and their metadata.
  */
-export interface ModelRegistry {
+export interface IModelRegistry {
   get(key: string): LanguageModel | undefined;
 }

package/src/storage/base.ts

@@ -2,7 +2,7 @@
  * Core storage contracts.
  */
 
-import type { AgentRegistry, ModelRegistry } from "@/kernl/types";
+import type { IAgentRegistry, IModelRegistry } from "@/kernl/types";
 import type { ThreadStore } from "./thread";
 import type { MemoryStore } from "@/memory/store";
 
@@ -30,7 +30,7 @@ export interface KernlStorage {
    *
    * Called by Kernl after construction to wire up agent/model lookups.
    */
-  bind(registries: { agents: AgentRegistry; models: ModelRegistry }): void;
+  bind(registries: { agents: IAgentRegistry; models: IModelRegistry }): void;
 
   /**
    * Execute a function within a transaction.

package/src/storage/in-memory.ts

@@ -25,7 +25,7 @@ import type {
   SortOrder,
 } from "@/storage";
 import type { ThreadEvent, ThreadState } from "@/thread/types";
-import type { AgentRegistry, ModelRegistry } from "@/kernl/types";
+import type { IAgentRegistry, IModelRegistry } from "@/kernl/types";
 import type {
   MemoryStore,
   MemoryRecord,
@@ -47,7 +47,7 @@ export class InMemoryStorage implements KernlStorage {
     this.memories = new InMemoryMemoryStore();
   }
 
-  bind(registries: { agents: AgentRegistry; models: ModelRegistry }): void {
+  bind(registries: { agents: IAgentRegistry; models: IModelRegistry }): void {
     this.threads.bind(registries);
   }
 
@@ -93,10 +93,10 @@ interface ThreadData {
 export class InMemoryThreadStore implements ThreadStore {
   private threads = new Map<string, ThreadData>();
   private events = new Map<string, ThreadEvent[]>(); // tid -> events
-  private registries: { agents: AgentRegistry; models: ModelRegistry } | null =
+  private registries: { agents: IAgentRegistry; models: IModelRegistry } | null =
     null;
 
-  bind(registries: { agents: AgentRegistry; models: ModelRegistry }): void {
+  bind(registries: { agents: IAgentRegistry; models: IModelRegistry }): void {
     this.registries = registries;
   }
 

package/src/thread/__tests__/mock.ts

@@ -40,13 +40,22 @@ export class MockLanguageModel implements LanguageModel {
     ];
 
     // Return with fake usage stats
+    const tokens = this.countTokens(userText);
     return {
       content,
-      finishReason: "stop",
+      finishReason: { unified: "stop", raw: "stop" },
       usage: {
-        inputTokens: this.countTokens(userText),
-        outputTokens: this.countTokens(userText),
-        totalTokens: this.countTokens(userText) * 2,
+        inputTokens: {
+          total: tokens,
+          noCache: tokens,
+          cacheRead: undefined,
+          cacheWrite: undefined,
+        },
+        outputTokens: {
+          total: tokens,
+          text: tokens,
+          reasoning: undefined,
+        },
       },
       warnings: [],
     };

package/src/thread/thread.ts

@@ -216,13 +216,13 @@ export class Thread<
       for await (const e of this.tick()) {
         if (e.kind === "error") {
           err = e.error;
-          logger.error(e.error); // (TODO): onError callback in options
+          logger.error(err.message); // (TODO): onError callback in options
         }
         // complete items get persisted with seq, deltas are ephemeral
         if (notDelta(e)) {
-          const [seqd] = this.append(e);
-          events.push(seqd);
-          yield seqd;
+          const [eseq] = this.append(e);
+          events.push(eseq);
+          yield eseq;
         } else {
           yield e;
         }
@@ -253,8 +253,8 @@ export class Thread<
 
       // append + yield action events (sequenced)
       for (const a of actions) {
-        const [seqd] = this.append(a);
-        yield seqd;
+        const [eseq] = this.append(a);
+        yield eseq;
       }
 
       await this.checkpoint(); /* c3: tick complete */
@@ -289,7 +289,7 @@ export class Thread<
     this.emit("model.call.start", { settings: req.settings ?? {} });
 
     let usage: LanguageModelUsage | undefined;
-    let finishReason: LanguageModelFinishReason = "unknown";
+    let finishReason: LanguageModelFinishReason = { unified: "other", raw: undefined };
 
     try {
       if (this.model.stream) {