kernl 0.12.0 → 0.12.2

package/dist/thread/thread.js

@@ -120,33 +120,14 @@ export class Thread {
         this.abort = new AbortController();
         this.tickres = undefined; // reset for this run
         await this.checkpoint(); /* c1: persist RUNNING state + initial input */
-        this.agent.emit("thread.start", {
-            kind: "thread.start",
-            threadId: this.tid,
-            agentId: this.agent.id,
-            namespace: this.namespace,
-            context: this.context,
-        });
+        this.emit("thread.start");
         yield { kind: "stream.start" }; // always yield start immediately
         try {
             yield* this._execute();
-            this.agent.emit("thread.stop", {
-                kind: "thread.stop",
-                threadId: this.tid,
-                agentId: this.agent.id,
-                namespace: this.namespace,
-                context: this.context,
-                state: STOPPED,
-                result: this.tickres,
-            });
+            this.emit("thread.stop", { state: STOPPED, result: this.tickres });
         }
         catch (err) {
-            this.agent.emit("thread.stop", {
-                kind: "thread.stop",
-                threadId: this.tid,
-                agentId: this.agent.id,
-                namespace: this.namespace,
-                context: this.context,
+            this.emit("thread.stop", {
                 state: STOPPED,
                 error: err instanceof Error ? err.message : String(err),
             });
@@ -176,12 +157,15 @@ export class Thread {
                     err = e.error;
                     logger.error(e.error); // (TODO): onError callback in options
                 }
-                // we don't want deltas in the history
+                // complete items get persisted with seq, deltas are ephemeral
                 if (notDelta(e)) {
-                    events.push(e);
-                    this.append(e);
+                    const [seqd] = this.append(e);
+                    events.push(seqd);
+                    yield seqd;
+                }
+                else {
+                    yield e;
                 }
-                yield e;
             }
             // if an error event occurred → throw it
             if (err) {
@@ -201,10 +185,10 @@ export class Thread {
             }
             // perform intended actions
             const { actions, pendingApprovals } = await this.performActions(intentions);
-            // append + yield action events
+            // append + yield action events (sequenced)
             for (const a of actions) {
-                this.append(a);
-                yield a;
+                const [seqd] = this.append(a);
+                yield seqd;
             }
             await this.checkpoint(); /* c3: tick complete */
             if (pendingApprovals.length > 0) {
@@ -228,16 +212,9 @@ export class Thread {
         this._tick++;
         // (TODO): check limits (if this._tick > this.limits.maxTicks)
         // (TODO): run input guardrails on first tick (if this._tick === 1)
+        // (TODO): compaction if necessary
         const req = await this.prepareModelRequest(this.history);
-        this.agent.emit("model.call.start", {
-            kind: "model.call.start",
-            provider: this.model.provider,
-            modelId: this.model.modelId,
-            settings: req.settings ?? {},
-            threadId: this.tid,
-            agentId: this.agent.id,
-            context: this.context,
-        });
+        this.emit("model.call.start", { settings: req.settings ?? {} });
         let usage;
         let finishReason = "unknown";
         try {
@@ -259,27 +236,10 @@ export class Thread {
                     yield event;
                 }
             }
-            this.agent.emit("model.call.end", {
-                kind: "model.call.end",
-                provider: this.model.provider,
-                modelId: this.model.modelId,
-                finishReason,
-                usage,
-                threadId: this.tid,
-                agentId: this.agent.id,
-                context: this.context,
-            });
+            this.emit("model.call.end", { finishReason, usage });
         }
         catch (error) {
-            this.agent.emit("model.call.end", {
-                kind: "model.call.end",
-                provider: this.model.provider,
-                modelId: this.model.modelId,
-                finishReason: "error",
-                threadId: this.tid,
-                agentId: this.agent.id,
-                context: this.context,
-            });
+            this.emit("model.call.end", { finishReason: "error" });
             yield {
                 kind: "error",
                 error: error instanceof Error ? error : new Error(String(error)),
@@ -356,9 +316,29 @@ export class Thread {
     cancel() {
         this.abort?.abort();
     }
-    // ----------------------------
-    // utils
-    // ----------------------------
+    /**
+     * Emit an agent event with common fields auto-filled.
+     */
+    emit(kind, payload) {
+        const base = {
+            kind,
+            threadId: this.tid,
+            agentId: this.agent.id,
+            context: this.context,
+        };
+        let auto = {};
+        switch (kind) {
+            case "thread.start":
+            case "thread.stop":
+                auto = { namespace: this.namespace };
+                break;
+            case "model.call.start":
+            case "model.call.end":
+                auto = { provider: this.model.provider, modelId: this.model.modelId };
+                break;
+        }
+        this.agent.emit(kind, { ...base, ...auto, ...payload });
+    }
     /**
      * Perform the actions returned by the model
      */
@@ -404,11 +384,7 @@ export class Thread {
     async executeTools(calls) {
         return await Promise.all(calls.map(async (call) => {
             const parsedArgs = JSON.parse(call.arguments || "{}");
-            this.agent.emit("tool.call.start", {
-                kind: "tool.call.start",
-                threadId: this.tid,
-                agentId: this.agent.id,
-                context: this.context,
+            this.emit("tool.call.start", {
                 toolId: call.toolId,
                 callId: call.callId,
                 args: parsedArgs,
@@ -426,11 +402,7 @@ export class Thread {
                 ctx.agent = this.agent;
                 ctx.approve(call.callId); // mark this call as approved
                 const res = await tool.invoke(ctx, call.arguments, call.callId);
-                this.agent.emit("tool.call.end", {
-                    kind: "tool.call.end",
-                    threadId: this.tid,
-                    agentId: this.agent.id,
-                    context: this.context,
+                this.emit("tool.call.end", {
                     toolId: call.toolId,
                     callId: call.callId,
                     state: res.state,
@@ -449,11 +421,7 @@ export class Thread {
                 };
             }
             catch (error) {
-                this.agent.emit("tool.call.end", {
-                    kind: "tool.call.end",
-                    threadId: this.tid,
-                    agentId: this.agent.id,
-                    context: this.context,
+                this.emit("tool.call.end", {
                     toolId: call.toolId,
                     callId: call.callId,
                     state: FAILED,

package/dist/thread/types.d.ts

@@ -1,4 +1,4 @@
-import { ToolCall, LanguageModel, LanguageModelItem, LanguageModelStreamEvent, RUNNING, STOPPED, INTERRUPTIBLE, UNINTERRUPTIBLE, ZOMBIE, DEAD } from "@kernl-sdk/protocol";
+import { ToolCall, LanguageModel, LanguageModelItem, RUNNING, STOPPED, INTERRUPTIBLE, UNINTERRUPTIBLE, ZOMBIE, DEAD, TextStartEvent, TextEndEvent, TextDeltaEvent, ReasoningStartEvent, ReasoningEndEvent, ReasoningDeltaEvent, ToolInputStartEvent, ToolInputEndEvent, ToolInputDeltaEvent, StartEvent, FinishEvent, AbortEvent, ErrorEvent, RawEvent } from "@kernl-sdk/protocol";
 import { Task } from "../task.js";
 import { Context } from "../context.js";
 import { Agent } from "../agent.js";
@@ -79,9 +79,24 @@ export interface ThreadSystemEvent extends ThreadEventBase {
  */
 export type ThreadEvent = (LanguageModelItem & ThreadEventBase) | ThreadSystemEvent;
 /**
- * Stream events - use protocol definition directly.
+ * Incremental content chunks (ephemeral, not persisted).
  */
-export type ThreadStreamEvent = LanguageModelStreamEvent;
+export type StreamDeltaEvent = TextDeltaEvent | ReasoningDeltaEvent | ToolInputDeltaEvent;
+/**
+ * Boundary markers + control flow (ephemeral, not persisted).
+ */
+export type StreamControlEvent = TextStartEvent | TextEndEvent | ReasoningStartEvent | ReasoningEndEvent | ToolInputStartEvent | ToolInputEndEvent | StartEvent | FinishEvent | AbortEvent | ErrorEvent | RawEvent;
+/**
+ * All ephemeral stream types (not persisted to history).
+ */
+export type StreamEvent = StreamDeltaEvent | StreamControlEvent;
+/**
+ * Thread stream events = sequenced ThreadEvents + ephemeral StreamEvents.
+ *
+ * Complete items (Message, ToolCall, etc.) are yielded as ThreadEvents with seq.
+ * Deltas and control events are yielded as StreamEvents without seq.
+ */
+export type ThreadStreamEvent = ThreadEvent | StreamEvent;
 /**
  * Result of thread execution
  */

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

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

package/dist/thread/utils.d.ts

@@ -1,12 +1,12 @@
 import type { ResolvedAgentResponse } from "../guardrail.js";
-import { ToolCall, LanguageModelItem } from "@kernl-sdk/protocol";
+import { ToolCall, LanguageModelItem, LanguageModelStreamEvent } from "@kernl-sdk/protocol";
 import type { AgentOutputType } from "../agent/types.js";
-import type { ThreadEvent, ThreadStreamEvent, ActionSet, PublicThreadEvent } from "./types.js";
+import type { ThreadEvent, ThreadEventBase, ActionSet, PublicThreadEvent } from "./types.js";
 /**
  * Create a ThreadEvent from a LanguageModelItem with thread metadata.
  *
  * @example
- * ```typescript
+ * ```ts
  * tevent({
  *   kind: "message",
  *   seq: 0,
@@ -28,17 +28,17 @@ export declare function tevent(event: {
 /**
  * Check if an event is a tool call
  */
-export declare function isActionIntention(event: LanguageModelItem): event is ToolCall;
+export declare function isActionIntention(event: ThreadEvent): event is ToolCall & ThreadEventBase;
 /**
  * Extract action intentions from a list of events.
  * Returns ActionSet if there are any tool calls, null otherwise.
  */
-export declare function getIntentions(events: LanguageModelItem[]): ActionSet | null;
+export declare function getIntentions(events: ThreadEvent[]): ActionSet | null;
 /**
  * Check if an event is NOT a delta/start/end event (i.e., a complete item).
  * Returns true for complete items: Message, Reasoning, ToolCall, ToolResult
  */
-export declare function notDelta(event: ThreadStreamEvent): event is LanguageModelItem;
+export declare function notDelta(event: LanguageModelStreamEvent): event is LanguageModelItem;
 /**
  * Check if an event is public/client-facing (not internal).
  * Filters out internal system events that clients don't need.
@@ -48,7 +48,7 @@ export declare function isPublicEvent(event: ThreadEvent): event is PublicThread
  * Extract the final text response from a list of items.
  * Returns null if no assistant message with text content is found.
  */
-export declare function getFinalResponse(items: LanguageModelItem[]): string | null;
+export declare function getFinalResponse(items: ThreadEvent[]): string | null;
 /**
  * Parse the final response according to the output type schema.
  *

package/dist/thread/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/thread/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EAEX,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,WAAW,CAad;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,QAAQ,CAE7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,iBAAiB,CAY7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,iBAAiB,CAc5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,IAAI,CAa1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,eAAe,EAChE,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,qBAAqB,CAAC,OAAO,CAAC,CAsBhC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/thread/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,SAAS,EACT,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,WAAW,CAad;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,GACjB,KAAK,IAAI,QAAQ,GAAG,eAAe,CAErC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,GAAG,IAAI,CAGrE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,wBAAwB,GAC9B,KAAK,IAAI,iBAAiB,CAY5B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,iBAAiB,CAc5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAapE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,eAAe,EAChE,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,GACd,qBAAqB,CAAC,OAAO,CAAC,CAsBhC"}

package/dist/thread/utils.js

@@ -5,7 +5,7 @@ import { ModelBehaviorError } from "../lib/error.js";
  * Create a ThreadEvent from a LanguageModelItem with thread metadata.
  *
  * @example
- * ```typescript
+ * ```ts
  * tevent({
  *   kind: "message",
  *   seq: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -35,20 +35,18 @@
     "@modelcontextprotocol/sdk": "^1.20.2",
     "yaml": "^2.8.2",
     "@kernl-sdk/protocol": "0.5.0",
-    "@kernl-sdk/retrieval": "0.1.9",
-    "@kernl-sdk/shared": "^0.4.0"
+    "@kernl-sdk/shared": "^0.4.0",
+    "@kernl-sdk/retrieval": "0.1.9"
   },
   "peerDependencies": {
     "zod": "^4.1.8"
   },
   "devDependencies": {
-    "@ai-sdk/openai": "3.0.0-beta.57",
     "@types/node": "^24.10.0",
     "tsc-alias": "^1.8.10",
     "typescript": "5.9.2",
     "vitest": "^4.0.8",
-    "zod": "^4.1.8",
-    "@kernl-sdk/ai": "0.4.0"
+    "zod": "^4.1.8"
   },
   "scripts": {
     "clean": "rm -rf dist",

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";
 
@@ -56,6 +57,7 @@ export {
   THREAD_STATES,
   type ThreadState,
   type PublicThreadEvent,
+  type ThreadStreamEvent,
 } from "./thread/types";
 
 // --- storage ---

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.