@kernl-sdk/ai 0.3.5 → 0.4.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @kernl-sdk/ai@0.3.5 build /home/runner/work/kernl/kernl/packages/providers/ai
+> @kernl-sdk/ai@0.4.0 build /home/runner/work/kernl/kernl/packages/providers/ai
 > tsc && tsc-alias --resolve-full-paths
 

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @kernl/ai
 
+## 0.4.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.3.5
 
 ### Patch Changes

package/dist/__tests__/integration.test.js

@@ -210,7 +210,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
                 events.push(event);
             }
             // Should have text-delta events
-            const textDeltas = events.filter((e) => e.kind === "text-delta");
+            const textDeltas = events.filter((e) => e.kind === "text.delta");
             expect(textDeltas.length).toBeGreaterThan(0);
             // Each text-delta should have text
             for (const delta of textDeltas) {
@@ -263,13 +263,13 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have text-delta events (for streaming UX)
-            const textDeltas = events.filter((e) => e.kind === "text-delta");
+            const textDeltas = events.filter((e) => e.kind === "text.delta");
             expect(textDeltas.length).toBeGreaterThan(0);
             // Should have text-start event
-            const textStarts = events.filter((e) => e.kind === "text-start");
+            const textStarts = events.filter((e) => e.kind === "text.start");
             expect(textStarts.length).toBeGreaterThan(0);
             // Should have text-end event
-            const textEnds = events.filter((e) => e.kind === "text-end");
+            const textEnds = events.filter((e) => e.kind === "text.end");
             expect(textEnds.length).toBeGreaterThan(0);
             // Should have complete Message item (for history)
             const messages = events.filter((e) => e.kind === "message");
@@ -334,7 +334,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have a tool-call event
-            const toolCalls = events.filter((e) => e.kind === "tool-call");
+            const toolCalls = events.filter((e) => e.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             const toolCall = toolCalls[0];
             expect(toolCall.callId).toBeDefined();
@@ -385,7 +385,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             });
             expect(response.content).toBeDefined();
             // Should have a tool call
-            const toolCalls = response.content.filter((item) => item.kind === "tool-call");
+            const toolCalls = response.content.filter((item) => item.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             // Tool call should have proper structure
             const toolCall = toolCalls[0];
@@ -433,7 +433,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             });
             expect(response.content).toBeDefined();
             // Should have a tool call since it's required
-            const toolCalls = response.content.filter((item) => item.kind === "tool-call");
+            const toolCalls = response.content.filter((item) => item.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
         });
         it("should handle multiple tool calls", async () => {
@@ -475,7 +475,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             });
             expect(response.content).toBeDefined();
             // Should potentially have multiple tool calls
-            const toolCalls = response.content.filter((item) => item.kind === "tool-call");
+            const toolCalls = response.content.filter((item) => item.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
         });
         it("should handle multi-turn conversation with tool results", async () => {
@@ -513,7 +513,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             });
             expect(firstResponse.content).toBeDefined();
             // Extract tool calls
-            const toolCalls = firstResponse.content.filter((item) => item.kind === "tool-call");
+            const toolCalls = firstResponse.content.filter((item) => item.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             const toolCall = toolCalls[0];
             expect(toolCall.callId).toBeDefined();
@@ -529,7 +529,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
                     },
                     ...firstResponse.content,
                     {
-                        kind: "tool-result",
+                        kind: "tool.result",
                         callId: toolCall.callId,
                         toolId: toolCall.toolId,
                         state: "completed",
@@ -612,7 +612,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             });
             expect(response.content).toBeDefined();
             // Should have a tool call
-            const toolCalls = response.content.filter((item) => item.kind === "tool-call");
+            const toolCalls = response.content.filter((item) => item.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             const toolCall = toolCalls[0];
             expect(toolCall.callId).toBeDefined();
@@ -732,7 +732,7 @@ describe.skipIf(SKIP_OPENAI_TESTS)("AISDKLanguageModel - OpenAI", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have text-delta events for streaming JSON
-            const textDeltas = events.filter((e) => e.kind === "text-delta");
+            const textDeltas = events.filter((e) => e.kind === "text.delta");
             expect(textDeltas.length).toBeGreaterThan(0);
             // Should have a complete message with the JSON
             const messages = events.filter((e) => e.kind === "message");
@@ -803,7 +803,7 @@ describe.skipIf(SKIP_ANTHROPIC_TESTS)("AISDKLanguageModel - Anthropic", () => {
             });
             expect(response.content).toBeDefined();
             // Should have a tool call
-            const toolCalls = response.content.filter((item) => item.kind === "tool-call");
+            const toolCalls = response.content.filter((item) => item.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             const toolCall = toolCalls[0];
             expect(toolCall.callId).toBeDefined();
@@ -861,7 +861,7 @@ describe.skipIf(SKIP_ANTHROPIC_TESTS)("AISDKLanguageModel - Anthropic", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have a tool-call event
-            const toolCalls = events.filter((e) => e.kind === "tool-call");
+            const toolCalls = events.filter((e) => e.kind === "tool.call");
             expect(toolCalls.length).toBeGreaterThan(0);
             const toolCall = toolCalls[0];
             expect(toolCall.callId).toBeDefined();
@@ -948,7 +948,7 @@ describe.skipIf(SKIP_ANTHROPIC_TESTS)("AISDKLanguageModel - Anthropic", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have text-delta events for streaming JSON
-            const textDeltas = events.filter((e) => e.kind === "text-delta");
+            const textDeltas = events.filter((e) => e.kind === "text.delta");
             expect(textDeltas.length).toBeGreaterThan(0);
             // Should have a complete message with the JSON
             const messages = events.filter((e) => e.kind === "message");
@@ -1097,7 +1097,7 @@ describe.skipIf(SKIP_GOOGLE_TESTS)("AISDKLanguageModel - Google", () => {
             }
             expect(events.length).toBeGreaterThan(0);
             // Should have text-delta events for streaming JSON
-            const textDeltas = events.filter((e) => e.kind === "text-delta");
+            const textDeltas = events.filter((e) => e.kind === "text.delta");
             expect(textDeltas.length).toBeGreaterThan(0);
             // Should have a complete message with the JSON
             const messages = events.filter((e) => e.kind === "message");

package/dist/__tests__/language-model.test.js

@@ -80,19 +80,19 @@ describe("AISDKLanguageModel", () => {
             // Should have: start, 3 deltas, end, complete Message, finish
             expect(events).toHaveLength(7);
             // Check delta events
-            expect(events[0]).toMatchObject({ kind: "text-start", id: "text-1" });
+            expect(events[0]).toMatchObject({ kind: "text.start", id: "text-1" });
             expect(events[1]).toMatchObject({
-                kind: "text-delta",
+                kind: "text.delta",
                 id: "text-1",
                 text: "Hello",
             });
             expect(events[2]).toMatchObject({
-                kind: "text-delta",
+                kind: "text.delta",
                 id: "text-1",
                 text: " ",
             });
             expect(events[3]).toMatchObject({
-                kind: "text-delta",
+                kind: "text.delta",
                 id: "text-1",
                 text: "World",
             });
@@ -112,7 +112,7 @@ describe("AISDKLanguageModel", () => {
             });
             expect(messageEvent.id).toBeDefined();
             // Check end event (yielded after Message)
-            expect(events[5]).toMatchObject({ kind: "text-end", id: "text-1" });
+            expect(events[5]).toMatchObject({ kind: "text.end", id: "text-1" });
             // Check finish event
             expect(events[6]).toMatchObject({ kind: "finish" });
         });
@@ -184,16 +184,16 @@ describe("AISDKLanguageModel", () => {
             expect(events).toHaveLength(6);
             // Check delta events
             expect(events[0]).toMatchObject({
-                kind: "reasoning-start",
+                kind: "reasoning.start",
                 id: "reason-1",
             });
             expect(events[1]).toMatchObject({
-                kind: "reasoning-delta",
+                kind: "reasoning.delta",
                 id: "reason-1",
                 text: "Let me think",
             });
             expect(events[2]).toMatchObject({
-                kind: "reasoning-delta",
+                kind: "reasoning.delta",
                 id: "reason-1",
                 text: " about this",
             });
@@ -208,7 +208,7 @@ describe("AISDKLanguageModel", () => {
             expect(reasoningEvent.id).toBeDefined();
             // Check end event (yielded after Reasoning)
             expect(events[4]).toMatchObject({
-                kind: "reasoning-end",
+                kind: "reasoning.end",
                 id: "reason-1",
             });
             // Check finish event
@@ -412,7 +412,7 @@ describe("AISDKLanguageModel", () => {
             // Should have tool-call and finish
             expect(events).toHaveLength(2);
             expect(events[0]).toMatchObject({
-                kind: "tool-call",
+                kind: "tool.call",
                 callId: "call-123",
                 toolId: "calculator",
                 state: IN_PROGRESS,

package/dist/convert/__tests__/message.test.js

@@ -191,7 +191,7 @@ describe("MESSAGE codec", () => {
     describe("encode - tool-call items", () => {
         it("should encode tool-call item", () => {
             const result = MESSAGE.encode({
-                kind: "tool-call",
+                kind: "tool.call",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: "completed",
@@ -203,7 +203,7 @@ describe("MESSAGE codec", () => {
                     {
                         type: "tool-call",
                         toolCallId: "call-123",
-                        toolName: "get_weather",
+                        toolId: "get_weather",
                         input: { city: "SF" },
                         providerOptions: undefined,
                     },
@@ -212,7 +212,7 @@ describe("MESSAGE codec", () => {
         });
         it("should include providerMetadata for tool-call", () => {
             const result = MESSAGE.encode({
-                kind: "tool-call",
+                kind: "tool.call",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: "completed",
@@ -228,7 +228,7 @@ describe("MESSAGE codec", () => {
     describe("encode - tool-result items", () => {
         it("should encode tool-result item", () => {
             const result = MESSAGE.encode({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: "completed",
@@ -241,7 +241,7 @@ describe("MESSAGE codec", () => {
                     {
                         type: "tool-result",
                         toolCallId: "call-123",
-                        toolName: "get_weather",
+                        toolId: "get_weather",
                         output: {
                             type: "json",
                             value: { temp: 72, conditions: "sunny" },
@@ -253,7 +253,7 @@ describe("MESSAGE codec", () => {
         });
         it("should encode tool-result item with error", () => {
             const result = MESSAGE.encode({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: "failed",
@@ -266,7 +266,7 @@ describe("MESSAGE codec", () => {
                     {
                         type: "tool-result",
                         toolCallId: "call-123",
-                        toolName: "get_weather",
+                        toolId: "get_weather",
                         output: {
                             type: "error-text",
                             value: "Network timeout",

package/dist/convert/__tests__/settings.test.js

@@ -80,7 +80,7 @@ describe("MODEL_SETTINGS codec", () => {
             };
             const result = MODEL_SETTINGS.encode(settings);
             expect(result).toEqual({
-                toolChoice: { type: "tool", toolName: "get_weather" },
+                toolChoice: { type: "tool", toolId: "get_weather" },
             });
         });
         it("should encode providerOptions", () => {

package/dist/convert/__tests__/stream.test.js

@@ -11,7 +11,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "text-start",
+                kind: "text.start",
                 id: "text-1",
                 providerMetadata: { openai: { data: "value" } },
             });
@@ -25,7 +25,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "text-delta",
+                kind: "text.delta",
                 id: "text-1",
                 text: "Hello",
                 providerMetadata: undefined,
@@ -39,7 +39,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "text-end",
+                kind: "text.end",
                 id: "text-1",
                 providerMetadata: undefined,
             });
@@ -54,7 +54,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "reasoning-start",
+                kind: "reasoning.start",
                 id: "reason-1",
                 providerMetadata: undefined,
             });
@@ -68,7 +68,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "reasoning-delta",
+                kind: "reasoning.delta",
                 id: "reason-1",
                 text: "thinking...",
                 providerMetadata: undefined,
@@ -82,7 +82,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "reasoning-end",
+                kind: "reasoning.end",
                 id: "reason-1",
                 providerMetadata: undefined,
             });
@@ -99,9 +99,9 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-input-start",
+                kind: "tool.input.start",
                 id: "tool-1",
-                toolName: "calculator",
+                toolId: "calculator",
                 title: "Calculate",
                 providerMetadata: undefined,
             });
@@ -115,7 +115,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-input-delta",
+                kind: "tool.input.delta",
                 id: "tool-1",
                 delta: "partial input",
                 providerMetadata: undefined,
@@ -129,7 +129,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-input-end",
+                kind: "tool.input.end",
                 id: "tool-1",
                 providerMetadata: undefined,
             });
@@ -144,7 +144,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-call",
+                kind: "tool.call",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: IN_PROGRESS,
@@ -162,7 +162,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-call",
+                kind: "tool.call",
                 callId: "call-empty",
                 toolId: "list_issues",
                 state: IN_PROGRESS,
@@ -181,7 +181,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: "completed",
@@ -201,7 +201,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "tool-result",
+                kind: "tool.result",
                 callId: "call-123",
                 toolId: "get_weather",
                 state: "failed",
@@ -224,7 +224,7 @@ describe("STREAM_PART codec", () => {
             };
             const result = STREAM_PART.decode(part);
             expect(result).toEqual({
-                kind: "stream-start",
+                kind: "stream.start",
                 warnings: [
                     {
                         type: "unsupported-setting",
@@ -359,9 +359,9 @@ describe("convertStream", () => {
             events.push(event);
         }
         expect(events).toHaveLength(4);
-        expect(events[0]).toMatchObject({ kind: "text-start" });
-        expect(events[1]).toMatchObject({ kind: "text-delta", text: "Hello" });
-        expect(events[2]).toMatchObject({ kind: "text-end" });
+        expect(events[0]).toMatchObject({ kind: "text.start" });
+        expect(events[1]).toMatchObject({ kind: "text.delta", text: "Hello" });
+        expect(events[2]).toMatchObject({ kind: "text.end" });
         expect(events[3]).toMatchObject({ kind: "finish", finishReason: "stop" });
     });
     it("should filter out null events", async () => {
@@ -395,7 +395,7 @@ describe("convertStream", () => {
             events.push(event);
         }
         expect(events).toHaveLength(2);
-        expect(events[0]).toMatchObject({ kind: "text-delta" });
+        expect(events[0]).toMatchObject({ kind: "text.delta" });
         expect(events[1]).toMatchObject({ kind: "finish" });
     });
     it("should handle empty stream", async () => {

package/dist/convert/__tests__/tools.test.js

@@ -140,7 +140,7 @@ describe("TOOL_CHOICE codec", () => {
             });
             expect(result).toEqual({
                 type: "tool",
-                toolName: "get_weather",
+                toolId: "get_weather",
             });
         });
     });