kernl 0.11.4 → 0.12.1

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,
-        });
-        yield { kind: "stream-start" }; // always yield start immediately
+        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
      */
@@ -380,7 +360,7 @@ export class Thread {
         const pendingApprovals = [];
         // (TODO): clean this - approval tracking should be handled differently
         for (const e of toolEvents) {
-            if (e.kind === "tool-result" &&
+            if (e.kind === "tool.result" &&
                 e.state === "requires_approval" // (TODO): fix this
             ) {
                 // find the original tool call for this pending approval
@@ -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,
@@ -440,7 +412,7 @@ export class Thread {
                     error: res.error,
                 });
                 return {
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: call.callId,
                     toolId: call.toolId,
                     state: res.state,
@@ -449,18 +421,14 @@ 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,
                     error: error instanceof Error ? error.message : String(error),
                 });
                 return {
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: call.callId,
                     toolId: call.toolId,
                     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,
@@ -32,7 +32,7 @@ export function tevent(event) {
  * Check if an event is a tool call
  */
 export function isActionIntention(event) {
-    return event.kind === "tool-call";
+    return event.kind === "tool.call";
 }
 /**
  * Extract action intentions from a list of events.
@@ -50,8 +50,8 @@ export function notDelta(event) {
     switch (event.kind) {
         case "message":
         case "reasoning":
-        case "tool-call":
-        case "tool-result":
+        case "tool.call":
+        case "tool.result":
             return true;
         // all other events are streaming deltas/control events
         default:
@@ -66,8 +66,8 @@ export function isPublicEvent(event) {
     switch (event.kind) {
         case "message":
         case "reasoning":
-        case "tool-call":
-        case "tool-result":
+        case "tool.call":
+        case "tool.result":
             return true;
         case "system":
             return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.11.4",
+  "version": "0.12.1",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -34,21 +34,19 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.2",
     "yaml": "^2.8.2",
-    "@kernl-sdk/protocol": "0.4.2",
-    "@kernl-sdk/shared": "^0.4.0",
-    "@kernl-sdk/retrieval": "0.1.8"
+    "@kernl-sdk/protocol": "0.5.0",
+    "@kernl-sdk/retrieval": "0.1.9",
+    "@kernl-sdk/shared": "^0.4.0"
   },
   "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.3.5"
+    "zod": "^4.1.8"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/agent/__tests__/run.test.ts

@@ -268,7 +268,7 @@ describe("Agent.stream() lifecycle", () => {
       events.push(event);
     }
 
-    expect(events[0]).toEqual({ kind: "stream-start" });
+    expect(events[0]).toEqual({ kind: "stream.start" });
   });
 
   it("should have same persistence behavior as run()", async () => {
@@ -305,7 +305,7 @@ describe("Agent.stream() lifecycle", () => {
     // Should have streamed events
     expect(events).toEqual(
       expect.arrayContaining([
-        { kind: "stream-start" },
+        { kind: "stream.start" },
         expect.objectContaining({ kind: "message" }),
       ]),
     );

package/src/index.ts

@@ -56,6 +56,7 @@ export {
   THREAD_STATES,
   type ThreadState,
   type PublicThreadEvent,
+  type ThreadStreamEvent,
 } from "./thread/types";
 
 // --- storage ---

package/src/lifecycle/__tests__/hooks.test.ts

@@ -308,7 +308,7 @@ describe("Lifecycle Hooks", () => {
             content: [
               message({ role: "assistant", text: "" }),
               {
-                kind: "tool-call" as const,
+                kind: "tool.call" as const,
                 toolId: "echo",
                 state: IN_PROGRESS,
                 callId: "call_1",
@@ -381,7 +381,7 @@ describe("Lifecycle Hooks", () => {
             content: [
               message({ role: "assistant", text: "" }),
               {
-                kind: "tool-call" as const,
+                kind: "tool.call" as const,
                 toolId: "add",
                 state: IN_PROGRESS,
                 callId: "call_1",
@@ -446,7 +446,7 @@ describe("Lifecycle Hooks", () => {
             content: [
               message({ role: "assistant", text: "" }),
               {
-                kind: "tool-call" as const,
+                kind: "tool.call" as const,
                 toolId: "add",
                 state: IN_PROGRESS,
                 callId: "call_1",
@@ -510,7 +510,7 @@ describe("Lifecycle Hooks", () => {
             content: [
               message({ role: "assistant", text: "" }),
               {
-                kind: "tool-call" as const,
+                kind: "tool.call" as const,
                 toolId: "failing",
                 state: IN_PROGRESS,
                 callId: "call_1",
@@ -576,14 +576,14 @@ describe("Lifecycle Hooks", () => {
             content: [
               message({ role: "assistant", text: "" }),
               {
-                kind: "tool-call" as const,
+                kind: "tool.call" as const,
                 toolId: "tool1",
                 state: IN_PROGRESS,
                 callId: "call_1",
                 arguments: JSON.stringify({ value: "a" }),
               },
               {
-                kind: "tool-call" as const,
+                kind: "tool.call" as const,
                 toolId: "tool2",
                 state: IN_PROGRESS,
                 callId: "call_2",

package/src/storage/__tests__/in-memory.test.ts

@@ -367,7 +367,7 @@ describe("InMemoryThreadStore", () => {
     it("should filter by kinds", async () => {
       await store.append([
         {
-          kind: "tool-call",
+          kind: "tool.call",
           id: "tc-1",
           tid: "thread-1",
           seq: 3,

package/src/thread/__tests__/fixtures/mock-model.ts

@@ -20,18 +20,18 @@ async function* streamFromResponse(
         if (contentItem.kind === "text") {
           // Yield text-start
           yield {
-            kind: "text-start" as const,
+            kind: "text.start" as const,
             id: item.id,
           };
           // Yield text-delta
           yield {
-            kind: "text-delta" as const,
+            kind: "text.delta" as const,
             id: item.id,
             text: contentItem.text,
           };
           // Yield text-end
           yield {
-            kind: "text-end" as const,
+            kind: "text.end" as const,
             id: item.id,
           };
         }

package/src/thread/__tests__/mock.ts

@@ -4,8 +4,8 @@ import {
   LanguageModelResponse,
   LanguageModelResponseItem,
   LanguageModelItem,
+  LanguageModelStreamEvent,
 } from "@kernl-sdk/protocol";
-import type { ThreadStreamEvent } from "@/thread/types";
 
 /**
  * A mock language model that echoes the user input back as an assistant message.
@@ -54,7 +54,7 @@ export class MockLanguageModel implements LanguageModel {
 
   async *stream(
     request: LanguageModelRequest,
-  ): AsyncIterable<ThreadStreamEvent> {
+  ): AsyncIterable<LanguageModelStreamEvent> {
     // TODO: Implement streaming (not needed for hello world)
     throw new Error("MockLanguageModel.stream() not implemented yet");
   }

package/src/thread/__tests__/thread-persistence.test.ts

@@ -77,7 +77,7 @@ describe("Thread Persistence", () => {
       //     return {
       //       content: [
       //         message({ role: "assistant", text: "" }),
-      //         { kind: "tool-call", toolId: "test", callId: "call_1", state: IN_PROGRESS, arguments: "{}" },
+      //         { kind: "tool.call", toolId: "test", callId: "call_1", state: IN_PROGRESS, arguments: "{}" },
       //       ],
       //       finishReason: "stop",
       //       usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
@@ -138,7 +138,7 @@ describe("Thread Persistence", () => {
       //     return {
       //       content: [
       //         message({ role: "assistant", text: "" }),
-      //         { kind: "tool-call", toolId: "echo", callId: "call_1", state: IN_PROGRESS, arguments: '{"text":"test"}' },
+      //         { kind: "tool.call", toolId: "echo", callId: "call_1", state: IN_PROGRESS, arguments: '{"text":"test"}' },
       //       ],
       //       finishReason: "stop",
       //       usage: { inputTokens: 2, outputTokens: 2, totalTokens: 4 },
@@ -178,7 +178,7 @@ describe("Thread Persistence", () => {
       //
       // // Find the append call for tick 1 (should include model message, tool-call, and tool-result)
       // const tick1Events = storage.calls.append.find(batch =>
-      //   batch.some(e => e.kind === "tool-result")
+      //   batch.some(e => e.kind === "tool.result")
       // );
       //
       // expect(tick1Events).toBeDefined();
@@ -188,8 +188,8 @@ describe("Thread Persistence", () => {
       // expect(tick1Events).toEqual(
       //   expect.arrayContaining([
       //     expect.objectContaining({ kind: "message", role: "assistant" }),
-      //     expect.objectContaining({ kind: "tool-call", toolId: "echo" }),
-      //     expect.objectContaining({ kind: "tool-result", toolId: "echo", result: "Echo: test" }),
+      //     expect.objectContaining({ kind: "tool.call", toolId: "echo" }),
+      //     expect.objectContaining({ kind: "tool.result", toolId: "echo", result: "Echo: test" }),
       //   ])
       // );
     });
@@ -232,7 +232,7 @@ describe("Thread Persistence", () => {
       // expect(lastUpdate.patch.state).toBe(STOPPED);
       //
       // // Verify stream-start event
-      // expect(events[0]).toEqual({ kind: "stream-start" });
+      // expect(events[0]).toEqual({ kind: "stream.start" });
     });
 
     it.skip("should persist STOPPED state even on model error", async () => {