kernl 0.11.4 → 0.12.1

package/.turbo/turbo-build.log

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

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # @kernl/core
 
+## 0.12.1
+
+### Patch Changes
+
+- 58e9db2: Fix provider normalization and ThreadStreamEvent types
+  - Normalize AI SDK provider strings (`anthropic.messages` -> `anthropic`, etc.)
+  - Export `ThreadStreamEvent` from kernl for consumers
+  - Update `toUIMessageStream` to accept `ThreadStreamEvent` from `agent.stream()`
+  - Add `kernl` as dependency to `@kernl-sdk/ai` (breaking circular devDep)
+
+- 320b76a: Add emit helper and sequence streamed events
+  - Thread now yields `ThreadEvent` with `seq` for complete items (messages, tool calls, tool results)
+  - Delta and control events remain ephemeral `StreamEvent` without seq
+  - Internal `emit()` helper reduces boilerplate in event emission
+
+## 0.12.0
+
+### Minor Changes
+
+- 8815744: **BREAKING:** Refactor event kind naming from kebab-case to dot notation
+
+  This aligns the language model stream/item kinds with the existing realtime events naming convention.
+
+  ### Kind value changes
+
+  | Old                | New                |
+  | ------------------ | ------------------ |
+  | `tool-call`        | `tool.call`        |
+  | `tool-result`      | `tool.result`      |
+  | `text-start`       | `text.start`       |
+  | `text-delta`       | `text.delta`       |
+  | `text-end`         | `text.end`         |
+  | `reasoning-start`  | `reasoning.start`  |
+  | `reasoning-delta`  | `reasoning.delta`  |
+  | `reasoning-end`    | `reasoning.end`    |
+  | `tool-input-start` | `tool.input.start` |
+  | `tool-input-delta` | `tool.input.delta` |
+  | `tool-input-end`   | `tool.input.end`   |
+  | `stream-start`     | `stream.start`     |
+
+  ### ToolInputStartEvent: `toolName` → `toolId`
+
+  The `ToolInputStartEvent` now uses `toolId` to match `ToolCall` and `ToolResult`.
+
+  ### Migration
+
+  If you have persisted thread events, run:
+
+  ```sql
+  UPDATE thread_events SET kind = 'tool.call' WHERE kind = 'tool-call';
+  UPDATE thread_events SET kind = 'tool.result' WHERE kind = 'tool-result';
+  ```
+
+### Patch Changes
+
+- Updated dependencies [8815744]
+  - @kernl-sdk/protocol@0.5.0
+  - @kernl-sdk/retrieval@0.1.9
+
 ## 0.11.4
 
 ### Patch Changes

package/dist/agent/__tests__/run.test.js

@@ -218,7 +218,7 @@ describe("Agent.stream() lifecycle", () => {
         for await (const event of agent.stream("Hello")) {
             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 () => {
         const storage = new InMemoryStorage();
@@ -247,7 +247,7 @@ describe("Agent.stream() lifecycle", () => {
         expect(history.length).toBeGreaterThan(0);
         // Should have streamed events
         expect(events).toEqual(expect.arrayContaining([
-            { kind: "stream-start" },
+            { kind: "stream.start" },
             expect.objectContaining({ kind: "message" }),
         ]));
     });

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { MCPServerSSE } from "./mcp/sse.js";
 export { MCPServerStreamableHttp } from "./mcp/http.js";
 export type { MThread as Thread, MThreadEvent as ThreadEvent, MThreadEventBase as ThreadEventBase, } from "./api/models/index.js";
 export type { RThreadsListParams as ThreadsListParams, RThreadGetOptions as ThreadGetOptions, RThreadHistoryParams as ThreadHistoryParams, RThreadCreateParams as ThreadCreateParams, RThreadUpdateParams as ThreadUpdateParams, } from "./api/resources/threads/index.js";
-export { THREAD_STATES, type ThreadState, type PublicThreadEvent, } from "./thread/types.js";
+export { THREAD_STATES, type ThreadState, type PublicThreadEvent, type ThreadStreamEvent, } from "./thread/types.js";
 export type { ThreadStore, NewThread, ThreadUpdate, ThreadFilter, ThreadHistoryOptions, ThreadInclude, ThreadListOptions, SortOrder, KernlStorage, Transaction, } from "./storage/index.js";
 export { Memory, MemoryByteEncoder } from "./memory/index.js";
 export type { MemoryStore, MemoryScope, NewMemory, MemoryConfig, MemoryReindexParams, MemoryRecord, MemoryKind, MemoryRecordUpdate, MemoryFilter, MemoryListOptions, MemorySearchQuery, WorkingMemorySnapshot, ShortTermMemorySnapshot, MemoryIndexBase, MemorySearchIndex, MemoryGraphIndex, MemoryArchiveIndex, GraphTraversalQuery, GraphTraversalResult, ArchiveQuery, ArchiveResult, MemoryByte, MemoryByteCodec, } from "./memory/index.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,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,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"}

package/dist/lifecycle/__tests__/hooks.test.js

@@ -238,7 +238,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "echo",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -302,7 +302,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "add",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -359,7 +359,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "add",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -415,7 +415,7 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "failing",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -473,14 +473,14 @@ describe("Lifecycle Hooks", () => {
                         content: [
                             message({ role: "assistant", text: "" }),
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool1",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
                                 arguments: JSON.stringify({ value: "a" }),
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool2",
                                 state: IN_PROGRESS,
                                 callId: "call_2",

package/dist/storage/__tests__/in-memory.test.js

@@ -312,7 +312,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/dist/thread/__tests__/fixtures/mock-model.js

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

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

@@ -1,5 +1,4 @@
-import { LanguageModel, LanguageModelRequest, LanguageModelResponse } from "@kernl-sdk/protocol";
-import type { ThreadStreamEvent } from "../../thread/types.js";
+import { LanguageModel, LanguageModelRequest, LanguageModelResponse, LanguageModelStreamEvent } from "@kernl-sdk/protocol";
 /**
  * A mock language model that echoes the user input back as an assistant message.
  * Useful for testing the execution flow without calling a real LLM.
@@ -11,7 +10,7 @@ export declare class MockLanguageModel implements LanguageModel {
     readonly provider = "mock";
     readonly modelId = "mock-model";
     generate(request: LanguageModelRequest): Promise<LanguageModelResponse>;
-    stream(request: LanguageModelRequest): AsyncIterable<ThreadStreamEvent>;
+    stream(request: LanguageModelRequest): AsyncIterable<LanguageModelStreamEvent>;
     /**
      * Extract text from the input (LanguageModelItem[])
      */

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,EAGtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;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,iBAAiB,CAAC;IAKnC;;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;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"}

package/dist/thread/__tests__/thread-persistence.test.js

@@ -67,7 +67,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 },
@@ -127,7 +127,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 },
@@ -167,7 +167,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();
@@ -177,8 +177,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" }),
             //   ])
             // );
         });
@@ -220,7 +220,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 () => {
             // TODO: Enable once InMemoryStorage is implemented

package/dist/thread/__tests__/thread.test.js

@@ -164,7 +164,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "echo",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -233,7 +233,7 @@ describe("Thread", () => {
                 }),
                 // Tool call (tick 1)
                 expect.objectContaining({
-                    kind: "tool-call",
+                    kind: "tool.call",
                     toolId: "echo",
                     callId: "call_1",
                     state: IN_PROGRESS,
@@ -241,7 +241,7 @@ describe("Thread", () => {
                 }),
                 // Tool result (executed after tick 1)
                 expect.objectContaining({
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: "call_1",
                     toolId: "echo",
                     state: COMPLETED,
@@ -271,7 +271,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -297,7 +297,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_2",
@@ -371,7 +371,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "nonexistent",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -418,9 +418,9 @@ describe("Thread", () => {
             await thread.execute();
             const history = thread.history;
             // Check that the tool result is an error
-            const toolResult = history.find((e) => e.kind === "tool-result");
+            const toolResult = history.find((e) => e.kind === "tool.result");
             expect(toolResult).toEqual(expect.objectContaining({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call_1",
                 toolId: "nonexistent",
                 state: FAILED,
@@ -443,7 +443,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "failing",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -499,9 +499,9 @@ describe("Thread", () => {
             const thread = new Thread({ agent, input: userMessage("test") });
             await thread.execute();
             const history = thread.history;
-            const toolResult = history.find((e) => e.kind === "tool-result");
+            const toolResult = history.find((e) => e.kind === "tool.result");
             expect(toolResult).toMatchObject({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call_1",
                 toolId: "failing",
                 state: FAILED,
@@ -524,7 +524,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "add",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -577,9 +577,9 @@ describe("Thread", () => {
             await thread.execute();
             // @ts-expect-error
             const history = thread.history;
-            const toolResult = history.find((e) => e.kind === "tool-result");
+            const toolResult = history.find((e) => e.kind === "tool.result");
             expect(toolResult).toEqual(expect.objectContaining({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call_1",
                 toolId: "add",
                 state: COMPLETED,
@@ -604,14 +604,14 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool1",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
                                 arguments: JSON.stringify({ value: "a" }),
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "tool2",
                                 state: IN_PROGRESS,
                                 callId: "call_2",
@@ -672,11 +672,11 @@ describe("Thread", () => {
             await thread.execute();
             const history = thread.history;
             // Should have both tool results in history
-            const toolResults = history.filter((e) => e.kind === "tool-result");
+            const toolResults = history.filter((e) => e.kind === "tool.result");
             expect(toolResults).toHaveLength(2);
             expect(toolResults).toEqual(expect.arrayContaining([
                 expect.objectContaining({
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: "call_1",
                     toolId: "tool1",
                     state: COMPLETED,
@@ -684,7 +684,7 @@ describe("Thread", () => {
                     error: null,
                 }),
                 expect.objectContaining({
-                    kind: "tool-result",
+                    kind: "tool.result",
                     callId: "call_2",
                     toolId: "tool2",
                     state: COMPLETED,
@@ -709,7 +709,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: `call_${callCount}`,
@@ -777,7 +777,7 @@ describe("Thread", () => {
                                 content: [],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",
@@ -880,7 +880,7 @@ describe("Thread", () => {
                                 content: [{ kind: "text", text: "Let me use a tool" }],
                             },
                             {
-                                kind: "tool-call",
+                                kind: "tool.call",
                                 toolId: "simple",
                                 state: IN_PROGRESS,
                                 callId: "call_1",

package/dist/thread/thread.d.ts

@@ -113,6 +113,10 @@ export declare class Thread<TContext = unknown, TOutput extends AgentOutputType
      * TODO: Emit thread.stop when cancelled (neither result nor error set)
      */
     cancel(): void;
+    /**
+     * Emit an agent event with common fields auto-filled.
+     */
+    private emit;
     /**
      * Perform the actions returned by the model
      */

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

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/thread/thread.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EAML,aAAa,EAKd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAEV,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,MAAM,CACjB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,eAAe,GAAG,MAAM;IAExC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAIlD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAAwE;IACvF,OAAO,CAAC,OAAO,CAAC,CAAiC;IAEjD,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC;IAgCrD;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CACpD;IAQD;;;;;;;OAOG;IACI,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC;IAmDjD;;;;;OAKG;YACY,QAAQ;IAiEvB;;;;;OAKG;YACY,IAAI;IAoEnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;;;OAIG;IACH,MAAM;IAQN;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IAkF1B;;OAEG;YACW,mBAAmB;CAsDlC"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/thread/thread.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EAML,aAAa,EAMd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAEV,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAGpB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,MAAM,CACjB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,eAAe,GAAG,MAAM;IAExC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAIlD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,OAAO,CAAwE;IACvF,OAAO,CAAC,OAAO,CAAC,CAAiC;IAEjD,OAAO,CAAC,KAAK,CAAC,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAc;gBAElB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC;IAgCrD;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CACpD;IAQD;;;;;;;OAOG;IACI,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC;IA+BjD;;;;;OAKG;YACY,QAAQ;IAmEvB;;;;;OAKG;YACY,IAAI;IA2CnB;;;;;OAKG;YACW,UAAU;IAuCxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,KAAK,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE;IAiBnD;;;;OAIG;IACH,MAAM;IAIN;;OAEG;IACH,OAAO,CAAC,IAAI;IAuBZ;;OAEG;YACW,cAAc;IAyC5B;;;;OAIG;YACW,YAAY;IAsE1B;;OAEG;YACW,mBAAmB;CAsDlC"}