@kernl-sdk/protocol 0.1.1 → 0.2.0

package/.turbo/turbo-build.log

@@ -1,4 +1,5 @@
-
-> @kernl-sdk/protocol@0.1.1 build /Users/andjones/Documents/projects/kernl/packages/protocol
-> tsc && tsc-alias
-
+
+
+> @kernl-sdk/protocol@0.1.1 build /Users/andjones/Documents/projects/kernl/packages/protocol
+> tsc && tsc-alias
+

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @kernl/protocol
 
+## 0.2.0
+
+### Minor Changes
+
+- fffa89e: Add thread/task state constants and language model helper functions
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/codec.d.ts

@@ -1,5 +1,5 @@
 /**
- * Bidirectional codec for converting between Kernl protocol types and provider-specific types.
+ * Bidirectional codec for converting between kernl protocol types and provider-specific types.
  *
  * @example
  * ```typescript
@@ -11,11 +11,11 @@
  */
 export interface Codec<TKernl, TProvider> {
     /**
-     * Transform from Kernl protocol format to provider format.
+     * Transform from kernl protocol format to provider format.
      */
     encode: (value: TKernl) => TProvider;
     /**
-     * Transform from provider format to Kernl protocol format.
+     * Transform from provider format to kernl protocol format.
      */
     decode: (value: TProvider) => TKernl;
 }

package/dist/constants.d.ts

@@ -1,11 +1,61 @@
 /**
  * Protocol Constants
  *
- * Centralized constants for the Kernl protocol.
+ * Centralized constants for the kernl protocol.
  */
 export declare const IN_PROGRESS = "in_progress";
 export declare const COMPLETED = "completed";
 export declare const FAILED = "failed";
+/**
+ * Task is either:
+ * - Currently executing
+ * - In run queue waiting to be scheduled (might want to differentiate between running + queued here)
+ */
+export declare const RUNNING = "running";
+/**
+ * Task is sleeping/blocked, waiting for a condition.
+ * Can be woken up by:
+ * - The condition being met (e.g., approval granted)
+ * - A signal (e.g., user cancellation)
+ *
+ * Examples:
+ * - Waiting for tool approval
+ * - Waiting for user input
+ * - Sleeping on a timer
+ */
 export declare const INTERRUPTIBLE = "interruptible";
+/**
+ * Task is sleeping/blocked and CANNOT be interrupted by signals.
+ * Only wakes when the condition is met.
+ *
+ * Examples:
+ * - Waiting for critical I/O (model API call)
+ * - Waiting for resource that MUST complete
+ *
+ * Use sparingly - these tasks can't be cancelled!
+ */
 export declare const UNINTERRUPTIBLE = "uninterruptible";
+/**
+ * Task has been stopped by a signal (SIGSTOP).
+ * Will remain stopped until explicitly continued (SIGCONT).
+ *
+ * Examples:
+ * - User explicitly paused the agent
+ * - Debugger attached
+ */
+export declare const STOPPED = "stopped";
+/**
+ * Task has finished execution but hasn't been cleaned up yet.
+ * Waiting for parent to read exit status (wait/waitpid).
+ *
+ * Examples:
+ * - Agent completed but result not yet retrieved
+ * - Child agent finished, parent needs to collect result
+ */
+export declare const ZOMBIE = "zombie";
+/**
+ * Task is being removed from the system.
+ * Final cleanup in progress, about to be fully deleted.
+ */
+export declare const DEAD = "dead";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,MAAM,WAAW,CAAC;AAM/B;;;;GAIG;AACH,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,WAAW,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,IAAI,SAAS,CAAC"}

package/dist/constants.js

@@ -1,7 +1,7 @@
 /**
  * Protocol Constants
  *
- * Centralized constants for the Kernl protocol.
+ * Centralized constants for the kernl protocol.
  */
 // ----------------------------
 // Tool states
@@ -9,5 +9,58 @@
 export const IN_PROGRESS = "in_progress";
 export const COMPLETED = "completed";
 export const FAILED = "failed";
+// ----------------------------
+// Thread/Task states
+// ----------------------------
+/**
+ * Task is either:
+ * - Currently executing
+ * - In run queue waiting to be scheduled (might want to differentiate between running + queued here)
+ */
+export const RUNNING = "running";
+/**
+ * Task is sleeping/blocked, waiting for a condition.
+ * Can be woken up by:
+ * - The condition being met (e.g., approval granted)
+ * - A signal (e.g., user cancellation)
+ *
+ * Examples:
+ * - Waiting for tool approval
+ * - Waiting for user input
+ * - Sleeping on a timer
+ */
 export const INTERRUPTIBLE = "interruptible";
+/**
+ * Task is sleeping/blocked and CANNOT be interrupted by signals.
+ * Only wakes when the condition is met.
+ *
+ * Examples:
+ * - Waiting for critical I/O (model API call)
+ * - Waiting for resource that MUST complete
+ *
+ * Use sparingly - these tasks can't be cancelled!
+ */
 export const UNINTERRUPTIBLE = "uninterruptible";
+/**
+ * Task has been stopped by a signal (SIGSTOP).
+ * Will remain stopped until explicitly continued (SIGCONT).
+ *
+ * Examples:
+ * - User explicitly paused the agent
+ * - Debugger attached
+ */
+export const STOPPED = "stopped";
+/**
+ * Task has finished execution but hasn't been cleaned up yet.
+ * Waiting for parent to read exit status (wait/waitpid).
+ *
+ * Examples:
+ * - Agent completed but result not yet retrieved
+ * - Child agent finished, parent needs to collect result
+ */
+export const ZOMBIE = "zombie";
+/**
+ * Task is being removed from the system.
+ * Final cleanup in progress, about to be fully deleted.
+ */
+export const DEAD = "dead";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Kernl Provider Protocol
+ * kernl Provider Protocol
  *
  * Standard interfaces and types for AI model providers.
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,15 +1,10 @@
 /**
- * Kernl Provider Protocol
+ * kernl Provider Protocol
  *
  * Standard interfaces and types for AI model providers.
  */
-// Constants
 export * from "./constants";
-// Language Model Protocol
 export * from "./language-model";
-// Embedding Model Protocol
 export * from "./embedding-model";
-// Provider Base Types
 export * from "./provider";
-// Codec Interface
 export * from "./codec";

package/dist/language-model/index.d.ts

@@ -3,4 +3,5 @@ export * from "./model";
 export * from "./request";
 export * from "./stream";
 export * from "./tool";
+export * from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/language-model/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/language-model/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/language-model/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/language-model/index.js

@@ -3,3 +3,4 @@ export * from "./model";
 export * from "./request";
 export * from "./stream";
 export * from "./tool";
+export * from "./utils";

package/dist/language-model/item.d.ts

@@ -1,12 +1,12 @@
 import { SharedProviderMetadata } from "../provider";
 import { JSONValue } from "../json";
 import { IN_PROGRESS, COMPLETED, FAILED, INTERRUPTIBLE, UNINTERRUPTIBLE } from "../constants";
-export type LanguageModelItem = Message | Reasoning | ToolCall | ToolResult | Unknown;
+export type LanguageModelItem = Message | Reasoning | ToolCall | ToolResult;
 /**
  * A subset of LanguageModelItem that excludes items that wouldn't
  * make sense for a model to generate (e.g. system/user messages, tool results).
  */
-export type LanguageModelResponseItem = AssistantMessage | Reasoning | ToolCall | Unknown;
+export type LanguageModelResponseItem = AssistantMessage | Reasoning | ToolCall | ToolResult;
 export interface SharedBase {
     /**
      * Optional provider-specific metadata for the text part.
@@ -82,18 +82,6 @@ export interface Reasoning extends LanguageModelItemBase {
      */
     text: string;
 }
-/**
- * This is a catch all for events that are not part of the protocol.
- *
- * For example, a model might return an event that is not part of the protocol using this type.
- *
- * In that case everything returned from the model should be passed in the `providerMetadata` field.
- *
- * This enables new features to be added to be added by a model provider without breaking the protocol.
- */
-export interface Unknown extends LanguageModelItemBase {
-    readonly kind: "unknown";
-}
 export interface MessageBase extends SharedBase {
     readonly kind: "message";
     /**

package/dist/language-model/item.d.ts.map

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

package/dist/language-model/stream.d.ts

@@ -1,10 +1,10 @@
 import { SharedProviderMetadata } from "../provider";
 import type { LanguageModelFinishReason, LanguageModelUsage, LanguageModelWarning } from "./model";
-import type { ToolCallState } from "./item";
+import type { Message, Reasoning, ToolCall, ToolResult } from "./item";
 /**
- * Union of all possible language model stream events.
+ * Union of all language model stream events.
  */
-export type LanguageModelStreamEvent = TextStartEvent | TextEndEvent | TextDeltaEvent | ReasoningStartEvent | ReasoningEndEvent | ReasoningDeltaEvent | ToolInputStartEvent | ToolInputEndEvent | ToolInputDeltaEvent | ToolCallEvent | ToolResultEvent | StartEvent | FinishEvent | AbortEvent | ErrorEvent | RawEvent;
+export type LanguageModelStreamEvent = TextStartEvent | TextDeltaEvent | TextEndEvent | Message | ReasoningStartEvent | ReasoningDeltaEvent | ReasoningEndEvent | Reasoning | ToolInputStartEvent | ToolInputEndEvent | ToolInputDeltaEvent | ToolCall | ToolResult | StartEvent | FinishEvent | AbortEvent | ErrorEvent | RawEvent;
 /**
  * Base interface for all stream events.
  */
@@ -101,47 +101,6 @@ export interface ToolInputDeltaEvent extends StreamEventBase {
      */
     delta: string;
 }
-/**
- * Stream event containing a complete tool call.
- */
-export interface ToolCallEvent extends StreamEventBase {
-    readonly kind: "tool-call";
-    id: string;
-    /**
-     * The name of the tool being called.
-     */
-    toolName: string;
-    /**
-     * The arguments for the tool call as a JSON string.
-     */
-    arguments: string;
-}
-/**
- * Stream event containing a tool result from a provider-executed tool.
- */
-export interface ToolResultEvent extends StreamEventBase {
-    readonly kind: "tool-result";
-    /**
-     * The ID of the tool call that this result is associated with.
-     */
-    callId: string;
-    /**
-     * Name of the tool that generated this result.
-     */
-    toolId: string;
-    /**
-     * The state of the tool call.
-     */
-    state: ToolCallState;
-    /**
-     * Result of the tool call. This is a JSON-serializable value.
-     */
-    result: unknown;
-    /**
-     * Error message if the tool call failed.
-     */
-    error: string | null;
-}
 /**
  * Stream event indicating the start of agent execution.
  */

package/dist/language-model/stream.d.ts.map

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

package/dist/language-model/utils.d.ts

@@ -0,0 +1,19 @@
+import { SharedProviderMetadata } from "../provider";
+import { Message, Reasoning } from "./item";
+/**
+ * Create a message with text content
+ */
+export declare function message(options: {
+    role: "system" | "assistant" | "user";
+    text: string;
+    metadata?: Record<string, unknown>;
+    providerMetadata?: SharedProviderMetadata;
+}): Message;
+/**
+ * Create a reasoning item
+ */
+export declare function reasoning(options: {
+    text: string;
+    providerMetadata?: SharedProviderMetadata;
+}): Reasoning;
+//# sourceMappingURL=utils.d.ts.map

package/dist/language-model/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/language-model/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE5C;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE;IAC/B,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C,GAAG,OAAO,CASV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C,GAAG,SAAS,CAOZ"}

package/dist/language-model/utils.js

@@ -0,0 +1,25 @@
+import { randomID } from "@kernl-sdk/shared/lib";
+/**
+ * Create a message with text content
+ */
+export function message(options) {
+    return {
+        kind: "message",
+        role: options.role,
+        id: `msg_${randomID()}`,
+        content: [{ kind: "text", text: options.text }],
+        providerMetadata: options.providerMetadata,
+        metadata: options.metadata,
+    };
+}
+/**
+ * Create a reasoning item
+ */
+export function reasoning(options) {
+    return {
+        kind: "reasoning",
+        id: `rsn_${randomID()}`,
+        text: options.text,
+        providerMetadata: options.providerMetadata,
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kernl-sdk/protocol",
-  "version": "0.1.1",
-  "description": "Kernl Provider Protocol - Standard interfaces for AI model providers",
+  "version": "0.2.0",
+  "description": "Protocol specification for kernl",
   "keywords": [
     "kernl",
     "protocol",
@@ -26,6 +26,9 @@
       "import": "./dist/index.js"
     }
   },
+  "dependencies": {
+    "@kernl-sdk/shared": "0.1.1"
+  },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",
     "@types/node": "^24.10.0",

package/src/codec.ts

@@ -1,5 +1,5 @@
 /**
- * Bidirectional codec for converting between Kernl protocol types and provider-specific types.
+ * Bidirectional codec for converting between kernl protocol types and provider-specific types.
  *
  * @example
  * ```typescript
@@ -11,12 +11,12 @@
  */
 export interface Codec<TKernl, TProvider> {
   /**
-   * Transform from Kernl protocol format to provider format.
+   * Transform from kernl protocol format to provider format.
    */
   encode: (value: TKernl) => TProvider;
 
   /**
-   * Transform from provider format to Kernl protocol format.
+   * Transform from provider format to kernl protocol format.
    */
   decode: (value: TProvider) => TKernl;
 }

package/src/constants.ts

@@ -1,7 +1,7 @@
 /**
  * Protocol Constants
  *
- * Centralized constants for the Kernl protocol.
+ * Centralized constants for the kernl protocol.
  */
 
 // ----------------------------
@@ -11,5 +11,65 @@
 export const IN_PROGRESS = "in_progress";
 export const COMPLETED = "completed";
 export const FAILED = "failed";
+
+// ----------------------------
+// Thread/Task states
+// ----------------------------
+
+/**
+ * Task is either:
+ * - Currently executing
+ * - In run queue waiting to be scheduled (might want to differentiate between running + queued here)
+ */
+export const RUNNING = "running";
+
+/**
+ * Task is sleeping/blocked, waiting for a condition.
+ * Can be woken up by:
+ * - The condition being met (e.g., approval granted)
+ * - A signal (e.g., user cancellation)
+ *
+ * Examples:
+ * - Waiting for tool approval
+ * - Waiting for user input
+ * - Sleeping on a timer
+ */
 export const INTERRUPTIBLE = "interruptible";
+
+/**
+ * Task is sleeping/blocked and CANNOT be interrupted by signals.
+ * Only wakes when the condition is met.
+ *
+ * Examples:
+ * - Waiting for critical I/O (model API call)
+ * - Waiting for resource that MUST complete
+ *
+ * Use sparingly - these tasks can't be cancelled!
+ */
 export const UNINTERRUPTIBLE = "uninterruptible";
+
+/**
+ * Task has been stopped by a signal (SIGSTOP).
+ * Will remain stopped until explicitly continued (SIGCONT).
+ *
+ * Examples:
+ * - User explicitly paused the agent
+ * - Debugger attached
+ */
+export const STOPPED = "stopped";
+
+/**
+ * Task has finished execution but hasn't been cleaned up yet.
+ * Waiting for parent to read exit status (wait/waitpid).
+ *
+ * Examples:
+ * - Agent completed but result not yet retrieved
+ * - Child agent finished, parent needs to collect result
+ */
+export const ZOMBIE = "zombie";
+
+/**
+ * Task is being removed from the system.
+ * Final cleanup in progress, about to be fully deleted.
+ */
+export const DEAD = "dead";

package/src/index.ts

@@ -1,20 +1,11 @@
 /**
- * Kernl Provider Protocol
+ * kernl Provider Protocol
  *
  * Standard interfaces and types for AI model providers.
  */
 
-// Constants
 export * from "./constants";
-
-// Language Model Protocol
 export * from "./language-model";
-
-// Embedding Model Protocol
 export * from "./embedding-model";
-
-// Provider Base Types
 export * from "./provider";
-
-// Codec Interface
 export * from "./codec";

package/src/language-model/index.ts

@@ -3,3 +3,4 @@ export * from "./model";
 export * from "./request";
 export * from "./stream";
 export * from "./tool";
+export * from "./utils";

package/src/language-model/item.ts

@@ -8,12 +8,7 @@ import {
   UNINTERRUPTIBLE,
 } from "@/constants";
 
-export type LanguageModelItem =
-  | Message
-  | Reasoning
-  | ToolCall
-  | ToolResult
-  | Unknown;
+export type LanguageModelItem = Message | Reasoning | ToolCall | ToolResult;
 
 /**
  * A subset of LanguageModelItem that excludes items that wouldn't
@@ -23,7 +18,7 @@ export type LanguageModelResponseItem =
   | AssistantMessage
   | Reasoning
   | ToolCall
-  | Unknown;
+  | ToolResult;
 
 export interface SharedBase {
   /**
@@ -118,19 +113,6 @@ export interface Reasoning extends LanguageModelItemBase {
   text: string;
 }
 
-/**
- * This is a catch all for events that are not part of the protocol.
- *
- * For example, a model might return an event that is not part of the protocol using this type.
- *
- * In that case everything returned from the model should be passed in the `providerMetadata` field.
- *
- * This enables new features to be added to be added by a model provider without breaking the protocol.
- */
-export interface Unknown extends LanguageModelItemBase {
-  readonly kind: "unknown";
-}
-
 // ----------------------------
 // Message types
 // ----------------------------

package/src/language-model/stream.ts

@@ -5,23 +5,25 @@ import type {
   LanguageModelUsage,
   LanguageModelWarning,
 } from "./model";
-import type { ToolCallState } from "./item";
+import type { Message, Reasoning, ToolCall, ToolResult } from "./item";
 
 /**
- * Union of all possible language model stream events.
+ * Union of all language model stream events.
  */
 export type LanguageModelStreamEvent =
   | TextStartEvent
-  | TextEndEvent
   | TextDeltaEvent
+  | TextEndEvent
+  | Message
   | ReasoningStartEvent
-  | ReasoningEndEvent
   | ReasoningDeltaEvent
+  | ReasoningEndEvent
+  | Reasoning
   | ToolInputStartEvent
   | ToolInputEndEvent
   | ToolInputDeltaEvent
-  | ToolCallEvent
-  | ToolResultEvent
+  | ToolCall
+  | ToolResult
   | StartEvent
   | FinishEvent
   | AbortEvent
@@ -140,56 +142,6 @@ export interface ToolInputDeltaEvent extends StreamEventBase {
   delta: string;
 }
 
-/**
- * Stream event containing a complete tool call.
- */
-export interface ToolCallEvent extends StreamEventBase {
-  readonly kind: "tool-call";
-  id: string;
-
-  /**
-   * The name of the tool being called.
-   */
-  toolName: string;
-
-  /**
-   * The arguments for the tool call as a JSON string.
-   */
-  arguments: string;
-}
-
-/**
- * Stream event containing a tool result from a provider-executed tool.
- */
-export interface ToolResultEvent extends StreamEventBase {
-  readonly kind: "tool-result";
-
-  /**
-   * The ID of the tool call that this result is associated with.
-   */
-  callId: string;
-
-  /**
-   * Name of the tool that generated this result.
-   */
-  toolId: string;
-
-  /**
-   * The state of the tool call.
-   */
-  state: ToolCallState;
-
-  /**
-   * Result of the tool call. This is a JSON-serializable value.
-   */
-  result: unknown;
-
-  /**
-   * Error message if the tool call failed.
-   */
-  error: string | null;
-}
-
 /**
  * Stream event indicating the start of agent execution.
  */

package/src/language-model/utils.ts

@@ -0,0 +1,38 @@
+import { SharedProviderMetadata } from "@/provider";
+
+import { randomID } from "@kernl-sdk/shared/lib";
+import { Message, Reasoning } from "./item";
+
+/**
+ * Create a message with text content
+ */
+export function message(options: {
+  role: "system" | "assistant" | "user";
+  text: string;
+  metadata?: Record<string, unknown>;
+  providerMetadata?: SharedProviderMetadata;
+}): Message {
+  return {
+    kind: "message",
+    role: options.role,
+    id: `msg_${randomID()}`,
+    content: [{ kind: "text", text: options.text }],
+    providerMetadata: options.providerMetadata,
+    metadata: options.metadata,
+  };
+}
+
+/**
+ * Create a reasoning item
+ */
+export function reasoning(options: {
+  text: string;
+  providerMetadata?: SharedProviderMetadata;
+}): Reasoning {
+  return {
+    kind: "reasoning",
+    id: `rsn_${randomID()}`,
+    text: options.text,
+    providerMetadata: options.providerMetadata,
+  };
+}