@kernl-sdk/ai 0.3.4 → 0.4.0

package/src/convert/__tests__/ui-stream.test.ts

@@ -9,7 +9,7 @@ describe("STREAM_UI_PART codec", () => {
   describe("encode - text events", () => {
     it("should encode text-start event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "text-start",
+        kind: "text.start",
         id: "text-1",
       };
 
@@ -23,7 +23,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should encode text-delta event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "text-delta",
+        kind: "text.delta",
         id: "text-1",
         text: "Hello world",
       };
@@ -39,7 +39,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should encode text-end event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "text-end",
+        kind: "text.end",
         id: "text-1",
       };
 
@@ -55,7 +55,7 @@ describe("STREAM_UI_PART codec", () => {
   describe("encode - reasoning events", () => {
     it("should encode reasoning-start event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "reasoning-start",
+        kind: "reasoning.start",
         id: "reason-1",
       };
 
@@ -69,7 +69,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should encode reasoning-delta event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "reasoning-delta",
+        kind: "reasoning.delta",
         id: "reason-1",
         text: "thinking step by step",
       };
@@ -85,7 +85,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should encode reasoning-end event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "reasoning-end",
+        kind: "reasoning.end",
         id: "reason-1",
       };
 
@@ -101,9 +101,9 @@ describe("STREAM_UI_PART codec", () => {
   describe("encode - tool input events", () => {
     it("should encode tool-input-start event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-input-start",
+        kind: "tool.input.start",
         id: "tool-1",
-        toolName: "calculator",
+        toolId: "calculator",
       };
 
       const result = STREAM_UI_PART.encode(event);
@@ -111,15 +111,15 @@ describe("STREAM_UI_PART codec", () => {
       expect(result).toEqual({
         type: "tool-input-start",
         toolCallId: "tool-1",
-        toolName: "calculator",
+        toolId: "calculator",
       });
     });
 
     it("should encode tool-input-start event with title", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-input-start",
+        kind: "tool.input.start",
         id: "tool-1",
-        toolName: "calculator",
+        toolId: "calculator",
         title: "Calculate sum",
       };
 
@@ -128,14 +128,14 @@ describe("STREAM_UI_PART codec", () => {
       expect(result).toEqual({
         type: "tool-input-start",
         toolCallId: "tool-1",
-        toolName: "calculator",
+        toolId: "calculator",
         title: "Calculate sum",
       });
     });
 
     it("should encode tool-input-delta event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-input-delta",
+        kind: "tool.input.delta",
         id: "tool-1",
         delta: '{"a": 1',
       };
@@ -151,7 +151,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should return null for tool-input-end event", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-input-end",
+        kind: "tool.input.end",
         id: "tool-1",
       };
 
@@ -164,7 +164,7 @@ describe("STREAM_UI_PART codec", () => {
   describe("encode - tool call and result events", () => {
     it("should encode tool-call as tool-input-available", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-call",
+        kind: "tool.call",
         callId: "call-123",
         toolId: "calculator",
         state: COMPLETED,
@@ -176,14 +176,14 @@ describe("STREAM_UI_PART codec", () => {
       expect(result).toEqual({
         type: "tool-input-available",
         toolCallId: "call-123",
-        toolName: "calculator",
+        toolId: "calculator",
         input: { a: 5, b: 3 },
       });
     });
 
     it("should handle tool-call with empty arguments string", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-call",
+        kind: "tool.call",
         callId: "call-empty",
         toolId: "list_issues",
         state: IN_PROGRESS,
@@ -195,14 +195,14 @@ describe("STREAM_UI_PART codec", () => {
       expect(result).toEqual({
         type: "tool-input-available",
         toolCallId: "call-empty",
-        toolName: "list_issues",
+        toolId: "list_issues",
         input: {},
       });
     });
 
     it("should encode successful tool-result as tool-output-available", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-result",
+        kind: "tool.result",
         callId: "call-123",
         toolId: "calculator",
         state: COMPLETED,
@@ -221,7 +221,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should encode failed tool-result as tool-output-error", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-result",
+        kind: "tool.result",
         callId: "call-123",
         toolId: "calculator",
         state: FAILED,
@@ -240,7 +240,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should handle failed tool-result with null error", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-result",
+        kind: "tool.result",
         callId: "call-123",
         toolId: "calculator",
         state: FAILED,
@@ -261,7 +261,7 @@ describe("STREAM_UI_PART codec", () => {
   describe("encode - stream control events", () => {
     it("should encode stream-start as start", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "stream-start",
+        kind: "stream.start",
       };
 
       const result = STREAM_UI_PART.encode(event);
@@ -356,7 +356,7 @@ describe("STREAM_UI_PART codec", () => {
   describe("encode - providerMetadata omission", () => {
     it("should omit providerMetadata from text events", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "text-delta",
+        kind: "text.delta",
         id: "text-1",
         text: "Hello",
         providerMetadata: {
@@ -376,7 +376,7 @@ describe("STREAM_UI_PART codec", () => {
 
     it("should omit providerMetadata from tool calls", () => {
       const event: LanguageModelStreamEvent = {
-        kind: "tool-call",
+        kind: "tool.call",
         callId: "call-123",
         toolId: "calculator",
         state: COMPLETED,
@@ -391,7 +391,7 @@ describe("STREAM_UI_PART codec", () => {
       expect(result).toEqual({
         type: "tool-input-available",
         toolCallId: "call-123",
-        toolName: "calculator",
+        toolId: "calculator",
         input: { x: 1 },
       });
       expect(result).not.toHaveProperty("providerMetadata");
@@ -416,11 +416,11 @@ describe("STREAM_UI_PART codec", () => {
 describe("toUIMessageStream", () => {
   it("should convert async iterable to readable stream", async () => {
     const events: LanguageModelStreamEvent[] = [
-      { kind: "stream-start" },
-      { kind: "text-start", id: "text-1" },
-      { kind: "text-delta", id: "text-1", text: "Hello" },
-      { kind: "text-delta", id: "text-1", text: " world" },
-      { kind: "text-end", id: "text-1" },
+      { kind: "stream.start" },
+      { kind: "text.start", id: "text-1" },
+      { kind: "text.delta", id: "text-1", text: "Hello" },
+      { kind: "text.delta", id: "text-1", text: " world" },
+      { kind: "text.end", id: "text-1" },
       { kind: "finish", finishReason: "stop", usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 } },
     ];
 
@@ -453,11 +453,11 @@ describe("toUIMessageStream", () => {
 
   it("should filter out null events", async () => {
     const events: LanguageModelStreamEvent[] = [
-      { kind: "text-start", id: "text-1" },
-      { kind: "text-delta", id: "text-1", text: "Hello" },
-      { kind: "tool-input-end", id: "tool-1" }, // Should be filtered (returns null)
+      { kind: "text.start", id: "text-1" },
+      { kind: "text.delta", id: "text-1", text: "Hello" },
+      { kind: "tool.input.end", id: "tool-1" }, // Should be filtered (returns null)
       { kind: "raw", rawValue: {} }, // Should be filtered (returns null)
-      { kind: "text-end", id: "text-1" },
+      { kind: "text.end", id: "text-1" },
     ];
 
     async function* generateEvents() {
@@ -485,11 +485,11 @@ describe("toUIMessageStream", () => {
 
   it("should handle tool calls and results", async () => {
     const events: LanguageModelStreamEvent[] = [
-      { kind: "tool-input-start", id: "tool-1", toolName: "calculator" },
-      { kind: "tool-input-delta", id: "tool-1", delta: '{"x":' },
-      { kind: "tool-input-delta", id: "tool-1", delta: '5}' },
-      { kind: "tool-call", callId: "tool-1", toolId: "calculator", state: COMPLETED, arguments: '{"x":5}' },
-      { kind: "tool-result", callId: "tool-1", toolId: "calculator", state: COMPLETED, result: 25, error: null },
+      { kind: "tool.input.start", id: "tool-1", toolId: "calculator" },
+      { kind: "tool.input.delta", id: "tool-1", delta: '{"x":' },
+      { kind: "tool.input.delta", id: "tool-1", delta: '5}' },
+      { kind: "tool.call", callId: "tool-1", toolId: "calculator", state: COMPLETED, arguments: '{"x":5}' },
+      { kind: "tool.result", callId: "tool-1", toolId: "calculator", state: COMPLETED, result: 25, error: null },
     ];
 
     async function* generateEvents() {
@@ -509,17 +509,17 @@ describe("toUIMessageStream", () => {
     }
 
     expect(chunks).toEqual([
-      { type: "tool-input-start", toolCallId: "tool-1", toolName: "calculator" },
+      { type: "tool-input-start", toolCallId: "tool-1", toolId: "calculator" },
       { type: "tool-input-delta", toolCallId: "tool-1", inputTextDelta: '{"x":' },
       { type: "tool-input-delta", toolCallId: "tool-1", inputTextDelta: '5}' },
-      { type: "tool-input-available", toolCallId: "tool-1", toolName: "calculator", input: { x: 5 } },
+      { type: "tool-input-available", toolCallId: "tool-1", toolId: "calculator", input: { x: 5 } },
       { type: "tool-output-available", toolCallId: "tool-1", output: 25 },
     ]);
   });
 
   it("should handle errors in stream", async () => {
     const events: LanguageModelStreamEvent[] = [
-      { kind: "text-start", id: "text-1" },
+      { kind: "text.start", id: "text-1" },
       { kind: "error", error: new Error("Network timeout") },
     ];
 

package/src/convert/message.ts

@@ -106,7 +106,7 @@ export const MESSAGE: Codec<LanguageModelItem, LanguageModelV3Message> = {
         };
       }
 
-      case "tool-call": {
+      case "tool.call": {
         return {
           role: "assistant",
           content: [
@@ -121,7 +121,7 @@ export const MESSAGE: Codec<LanguageModelItem, LanguageModelV3Message> = {
         };
       }
 
-      case "tool-result": {
+      case "tool.result": {
         return {
           role: "tool",
           content: [

package/src/convert/response.ts

@@ -68,7 +68,7 @@ export const MODEL_RESPONSE: Codec<LanguageModelResponse, AISdkGenerateResult> =
 
           case "tool-call":
             content.push({
-              kind: "tool-call",
+              kind: "tool.call",
               callId: item.toolCallId,
               toolId: item.toolName,
               state: IN_PROGRESS,
@@ -79,7 +79,7 @@ export const MODEL_RESPONSE: Codec<LanguageModelResponse, AISdkGenerateResult> =
 
           case "tool-result":
             content.push({
-              kind: "tool-result",
+              kind: "tool.result",
               callId: item.toolCallId,
               toolId: item.toolName,
               state: item.isError ? FAILED : COMPLETED,

package/src/convert/stream.ts

@@ -49,14 +49,14 @@ export const STREAM_PART: Codec<
     switch (part.type) {
       case "text-start":
         return {
-          kind: "text-start",
+          kind: "text.start",
           id: part.id,
           providerMetadata: part.providerMetadata,
         };
 
       case "text-delta":
         return {
-          kind: "text-delta",
+          kind: "text.delta",
           id: part.id,
           text: part.delta,
           providerMetadata: part.providerMetadata,
@@ -64,21 +64,21 @@ export const STREAM_PART: Codec<
 
       case "text-end":
         return {
-          kind: "text-end",
+          kind: "text.end",
           id: part.id,
           providerMetadata: part.providerMetadata,
         };
 
       case "reasoning-start":
         return {
-          kind: "reasoning-start",
+          kind: "reasoning.start",
           id: part.id,
           providerMetadata: part.providerMetadata,
         };
 
       case "reasoning-delta":
         return {
-          kind: "reasoning-delta",
+          kind: "reasoning.delta",
           id: part.id,
           text: part.delta,
           providerMetadata: part.providerMetadata,
@@ -86,23 +86,23 @@ export const STREAM_PART: Codec<
 
       case "reasoning-end":
         return {
-          kind: "reasoning-end",
+          kind: "reasoning.end",
           id: part.id,
           providerMetadata: part.providerMetadata,
         };
 
       case "tool-input-start":
         return {
-          kind: "tool-input-start",
+          kind: "tool.input.start",
           id: part.id,
-          toolName: part.toolName,
+          toolId: part.toolName,
           title: part.title,
           providerMetadata: part.providerMetadata,
         };
 
       case "tool-input-delta":
         return {
-          kind: "tool-input-delta",
+          kind: "tool.input.delta",
           id: part.id,
           delta: part.delta,
           providerMetadata: part.providerMetadata,
@@ -110,14 +110,14 @@ export const STREAM_PART: Codec<
 
       case "tool-input-end":
         return {
-          kind: "tool-input-end",
+          kind: "tool.input.end",
           id: part.id,
           providerMetadata: part.providerMetadata,
         };
 
       case "tool-call":
         return {
-          kind: "tool-call",
+          kind: "tool.call",
           callId: part.toolCallId,
           toolId: part.toolName,
           state: IN_PROGRESS,
@@ -128,7 +128,7 @@ export const STREAM_PART: Codec<
       case "tool-result":
         // provider-defined tools can stream tool results
         return {
-          kind: "tool-result",
+          kind: "tool.result",
           callId: part.toolCallId,
           toolId: part.toolName,
           state: part.isError ? FAILED : COMPLETED,
@@ -139,7 +139,7 @@ export const STREAM_PART: Codec<
 
       case "stream-start":
         return {
-          kind: "stream-start",
+          kind: "stream.start",
           warnings: part.warnings.map(WARNING.decode),
         };
 

package/src/convert/ui-message.ts

@@ -170,7 +170,7 @@ const TOOL_UI_PART: Codec<
     switch (part.state) {
       case "input-available": {
         const call: ToolCall = {
-          kind: "tool-call",
+          kind: "tool.call",
           callId,
           toolId,
           state: IN_PROGRESS,
@@ -182,7 +182,7 @@ const TOOL_UI_PART: Codec<
 
       case "output-available": {
         const result: ToolResult = {
-          kind: "tool-result",
+          kind: "tool.result",
           callId,
           toolId,
           state: COMPLETED,
@@ -195,7 +195,7 @@ const TOOL_UI_PART: Codec<
 
       case "output-error": {
         const result: ToolResult = {
-          kind: "tool-result",
+          kind: "tool.result",
           callId,
           toolId,
           state: FAILED,
@@ -291,8 +291,8 @@ export function historyToUIMessages(items: LanguageModelItem[]): UIMessage[] {
         const toolMap = new Map<
           string,
           {
-            call?: Extract<LanguageModelItem, { kind: "tool-call" }>;
-            result?: Extract<LanguageModelItem, { kind: "tool-result" }>;
+            call?: Extract<LanguageModelItem, { kind: "tool.call" }>;
+            result?: Extract<LanguageModelItem, { kind: "tool.result" }>;
           }
         >();
         const reasoningParts: Extract<
@@ -303,10 +303,10 @@ export function historyToUIMessages(items: LanguageModelItem[]): UIMessage[] {
         while (j < items.length && items[j].kind !== "message") {
           const next = items[j];
 
-          if (next.kind === "tool-call") {
+          if (next.kind === "tool.call") {
             const existing = toolMap.get(next.callId) || {};
             toolMap.set(next.callId, { ...existing, call: next });
-          } else if (next.kind === "tool-result") {
+          } else if (next.kind === "tool.result") {
             const existing = toolMap.get(next.callId) || {};
             toolMap.set(next.callId, { ...existing, result: next });
           } else if (next.kind === "reasoning") {

package/src/convert/ui-stream.ts

@@ -49,60 +49,60 @@ export const STREAM_UI_PART: Codec<
 > = {
   encode: (event: LanguageModelStreamEvent): UIMessageChunk | null => {
     switch (event.kind) {
-      case "text-start":
+      case "text.start":
         return {
           type: "text-start",
           id: event.id,
         };
 
-      case "text-delta":
+      case "text.delta":
         return {
           type: "text-delta",
           id: event.id,
           delta: event.text,
         };
 
-      case "text-end":
+      case "text.end":
         return {
           type: "text-end",
           id: event.id,
         };
 
-      case "reasoning-start":
+      case "reasoning.start":
         return {
           type: "reasoning-start",
           id: event.id,
         };
 
-      case "reasoning-delta":
+      case "reasoning.delta":
         return {
           type: "reasoning-delta",
           id: event.id,
           delta: event.text,
         };
 
-      case "reasoning-end":
+      case "reasoning.end":
         return {
           type: "reasoning-end",
           id: event.id,
         };
 
-      case "tool-input-start":
+      case "tool.input.start":
         return {
           type: "tool-input-start",
           toolCallId: event.id,
-          toolName: event.toolName,
+          toolName: event.toolId,
           ...(event.title != null ? { title: event.title } : {}),
         };
 
-      case "tool-input-delta":
+      case "tool.input.delta":
         return {
           type: "tool-input-delta",
           toolCallId: event.id,
           inputTextDelta: event.delta,
         };
 
-      case "tool-call":
+      case "tool.call":
         return {
           type: "tool-input-available",
           toolCallId: event.callId,
@@ -110,7 +110,7 @@ export const STREAM_UI_PART: Codec<
           input: JSON.parse(event.arguments),
         };
 
-      case "tool-result":
+      case "tool.result":
         // Convert tool result to tool-output-available or tool-output-error
         if (event.state === FAILED) {
           return {
@@ -126,7 +126,7 @@ export const STREAM_UI_PART: Codec<
           output: event.result,
         };
 
-      case "stream-start":
+      case "stream.start":
         return {
           type: "start",
         };
@@ -151,7 +151,7 @@ export const STREAM_UI_PART: Codec<
       case "message":
       case "reasoning":
       // - events without direct UI equivalents -
-      case "tool-input-end":
+      case "tool.input.end":
       case "raw":
         return null;
 

package/src/language-model.ts

@@ -74,13 +74,13 @@ export class AISDKLanguageModel implements LanguageModel {
 
     for await (const event of convertStream(stream.stream)) {
       switch (event.kind) {
-        case "text-start": {
+        case "text.start": {
           tbuf[event.id] = "";
           yield event;
           break;
         }
 
-        case "text-delta": {
+        case "text.delta": {
           if (tbuf[event.id] !== undefined) {
             tbuf[event.id] += event.text;
           }
@@ -88,7 +88,7 @@ export class AISDKLanguageModel implements LanguageModel {
           break;
         }
 
-        case "text-end": {
+        case "text.end": {
           const text = tbuf[event.id];
           if (text !== undefined) {
             yield message({
@@ -102,13 +102,13 @@ export class AISDKLanguageModel implements LanguageModel {
           break;
         }
 
-        case "reasoning-start": {
+        case "reasoning.start": {
           rbuf[event.id] = "";
           yield event;
           break;
         }
 
-        case "reasoning-delta": {
+        case "reasoning.delta": {
           if (rbuf[event.id] !== undefined) {
             rbuf[event.id] += event.text;
           }
@@ -116,7 +116,7 @@ export class AISDKLanguageModel implements LanguageModel {
           break;
         }
 
-        case "reasoning-end": {
+        case "reasoning.end": {
           const text = rbuf[event.id];
           if (text !== undefined) {
             yield reasoning({
@@ -130,7 +130,7 @@ export class AISDKLanguageModel implements LanguageModel {
         }
 
         default:
-          // all other events (tool-call, tool-result, finish, etc.) pass through
+          // all other events (tool.call, tool.result, finish, etc.) pass through
           yield event;
           break;
       }