kernl 0.8.4 → 0.9.0

package/dist/api/resources/agents/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAEzD;;;;;OAKG;IACH,GAAG,CACD,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,EAC5C,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS;IAKnD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;OAKG;IACH,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE;IAOhD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/api/resources/agents/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAE7D;;;;;;;OAOG;IACH,GAAG,CACD,QAAQ,GAAG,cAAc,EACzB,OAAO,SAAS,eAAe,GAAG,UAAU,EAC5C,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,SAAS;IAQnD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,IAAI,IAAI,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE;IAMhD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/dist/api/resources/agents/agents.js

@@ -4,6 +4,10 @@
  * Thin facade over the in-process agent registry, returning live Agent instances.
  *
  * Note: agents are code, not persisted data; this is process-local.
+ *
+ * Currently only exposes LLM agents (kind: "llm"). RealtimeAgents are stored
+ * in the internal registry but not returned by these methods. If public access
+ * to realtime agents is needed, add a separate `kernl.realtimeAgents` resource.
  */
 export class RAgents {
     registry;
@@ -13,27 +17,29 @@ export class RAgents {
     /**
      * Get a live Agent instance by id.
      *
+     * Only returns LLM agents. Returns undefined for realtime agents.
+     *
      * Callers are expected to know the concrete TContext/TOutput types
      * for their own agents and can specify them via generics.
      */
     get(id) {
         const agent = this.registry.get(id);
-        return agent;
+        if (agent?.kind === "llm") {
+            return agent;
+        }
+        return undefined;
     }
     /**
-     * Check if an agent with the given id is registered.
+     * Check if an LLM agent with the given id is registered.
      */
     has(id) {
-        return this.registry.has(id);
+        return this.registry.get(id)?.kind === "llm";
     }
     /**
-     * List all registered agents as live instances.
-     *
-     * Since this is a heterogeneous collection, we expose the widest safe
-     * type parameters here.
+     * List all registered LLM agents as live instances.
      */
     list() {
-        return Array.from(this.registry.values());
+        return Array.from(this.registry.values()).filter((a) => a.kind === "llm");
     }
     /**
      * Unregister an agent at runtime.

package/dist/kernl/kernl.d.ts

@@ -1,4 +1,4 @@
-import { Agent } from "../agent.js";
+import { BaseAgent } from "../agent/base.js";
 import { UnknownContext } from "../context.js";
 import { KernlHooks } from "../lifecycle.js";
 import type { Thread } from "../thread/index.js";
@@ -31,7 +31,7 @@ export declare class Kernl extends KernlHooks<UnknownContext, AgentOutputType> {
     /**
      * Registers a new agent with the kernl instance.
      */
-    register(agent: Agent): void;
+    register(agent: BaseAgent): void;
     /**
      * Spawn a new thread - blocking execution
      */

package/dist/kernl/kernl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAIlB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,eAAe,CAAC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,OAAO,CAAC,QAAQ,CAGd;IAGF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAatC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAgC5B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAWnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA6BzB"}
+{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../../src/kernl/kernl.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EACL,MAAM,EAIP,MAAM,UAAU,CAAC;AAIlB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,eAAe,CAAC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAEjE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAa;IAEpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,OAAO,CAAC,QAAQ,CAGd;IAGF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,YAAiB;IAatC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAgChC;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACnD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EACtD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IAS/D;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC1D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IASnC;;;;OAIG;IACI,cAAc,CAAC,QAAQ,EAAE,OAAO,SAAS,eAAe,EAC7D,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAChC,aAAa,CAAC,iBAAiB,CAAC;IAWnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA6BzB"}

package/dist/kernl/kernl.js

@@ -55,12 +55,12 @@ export class Kernl extends KernlHooks {
                 this.warnings.vector = true;
             }
         }
-        // (TODO): implement exhaustive model registry in protocol/ package
-        //
-        // auto-populate model registry for storage hydration
-        const key = `${agent.model.provider}/${agent.model.modelId}`;
-        if (!this._models.has(key)) {
-            this._models.set(key, agent.model);
+        // auto-populate model registry for storage hydration (llm agents only - for now)
+        if (agent.kind === "llm") {
+            const key = `${agent.model.provider}/${agent.model.modelId}`;
+            if (!this._models.has(key)) {
+                this._models.set(key, agent.model);
+            }
         }
     }
     /**

package/dist/kernl/types.d.ts

@@ -1,6 +1,6 @@
 import { LanguageModel, EmbeddingModel } from "@kernl-sdk/protocol";
 import { SearchIndex } from "@kernl-sdk/retrieval";
-import { Agent } from "../agent.js";
+import { BaseAgent } from "../agent/base.js";
 import { KernlStorage } from "../storage/index.js";
 /**
  * Storage configuration for Kernl.
@@ -72,10 +72,10 @@ export interface KernlOptions {
 /**
  * Agent registry interface.
  *
- * Satisfied by Map<string, Agent>.
+ * Satisfied by Map<string, BaseAgent>.
  */
 export interface AgentRegistry {
-    get(id: string): Agent<any> | undefined;
+    get(id: string): BaseAgent<any> | undefined;
 }
 /**
  * Model registry interface.

package/dist/kernl/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernl/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CAKtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC7C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernl/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CAKtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC7C"}

package/dist/lib/env.d.ts

@@ -7,11 +7,11 @@ import { z } from "zod";
  */
 declare const envSchema: z.ZodObject<{
     LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
         trace: "trace";
         debug: "debug";
         info: "info";
         warn: "warn";
-        error: "error";
         fatal: "fatal";
     }>>;
     KERNL_LOG_MODEL_DATA: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
@@ -31,7 +31,7 @@ declare const envSchema: z.ZodObject<{
  * console.log(env.LOG_LEVEL);
  */
 export declare const env: {
-    LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+    LOG_LEVEL: "error" | "trace" | "debug" | "info" | "warn" | "fatal";
     KERNL_LOG_MODEL_DATA: boolean;
     KERNL_LOG_TOOL_DATA: boolean;
 };

package/dist/mcp/__tests__/utils.test.js

@@ -52,7 +52,7 @@ describe("mcpToFunctionTool", () => {
         expect(functionTool.description).toBe("Performs calculations");
         expect(functionTool.parameters).toBeDefined();
     });
-    it("should handle tools without inputSchema (undefined parameters)", () => {
+    it("should handle tools without inputSchema (empty object parameters)", () => {
         const server = createMockServer();
         // In practice, MCP SDK tools require inputSchema, but our function handles
         // the case where it might not be present. We use 'as any' to test this edge case.
@@ -62,7 +62,9 @@ describe("mcpToFunctionTool", () => {
         };
         const functionTool = mcpToFunctionTool(server, mcpTool);
         expect(functionTool.id).toBe("no_params");
-        expect(functionTool.parameters).toBeUndefined();
+        // When no inputSchema, we use an empty z.object({}) to match AI SDK behavior
+        expect(functionTool.parameters).toBeDefined();
+        expect(functionTool.parameters?.def.type).toBe("object");
     });
     it("should invoke server.callTool with correct params", async () => {
         const server = createMockServer();

package/dist/mcp/utils.d.ts

@@ -5,7 +5,7 @@ import type { MCPTool, MCPToolFilter } from "./types.js";
 /**
  * Converts an MCP tool definition into a function tool usable by the SDK.
  */
-export declare function mcpToFunctionTool(server: MCPServer, mcpTool: MCPTool): import("../tool/index.js").FunctionTool<unknown, z.ZodObject<{}, z.core.$strip>, {
+export declare function mcpToFunctionTool(server: MCPServer, mcpTool: MCPTool): import("../tool/tool.js").FunctionTool<unknown, z.ZodObject<{}, z.core.$strip>, {
     type: string;
     text: string;
 } | {

package/dist/mcp/utils.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { tool } from "../tool/index.js";
+import { tool } from "../tool/tool.js";
 /**
  * Converts an MCP tool definition into a function tool usable by the SDK.
  */

package/dist/realtime/agent.d.ts

@@ -0,0 +1,17 @@
+import type { RealtimeModel } from "@kernl-sdk/protocol";
+import type { UnknownContext } from "../context.js";
+import { BaseAgent } from "../agent/base.js";
+import type { RealtimeAgentConfig, RealtimeAgentVoiceConfig } from "./types.js";
+/**
+ * A realtime agent definition.
+ *
+ * Stateless configuration that describes what a realtime voice agent does.
+ * Create sessions with `new RealtimeSession(agent, options)`.
+ */
+export declare class RealtimeAgent<TContext = UnknownContext> extends BaseAgent<TContext> {
+    readonly kind = "realtime";
+    readonly model: RealtimeModel;
+    readonly voice?: RealtimeAgentVoiceConfig;
+    constructor(config: RealtimeAgentConfig<TContext>);
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/realtime/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/realtime/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,qBAAa,aAAa,CAAC,QAAQ,GAAG,cAAc,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC/E,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC;gBAE9B,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC;CAKlD"}

package/dist/realtime/agent.js

@@ -0,0 +1,17 @@
+import { BaseAgent } from "../agent/base.js";
+/**
+ * A realtime agent definition.
+ *
+ * Stateless configuration that describes what a realtime voice agent does.
+ * Create sessions with `new RealtimeSession(agent, options)`.
+ */
+export class RealtimeAgent extends BaseAgent {
+    kind = "realtime";
+    model;
+    voice;
+    constructor(config) {
+        super(config);
+        this.model = config.model;
+        this.voice = config.voice;
+    }
+}

package/dist/realtime/channel.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from "node:events";
+/**
+ * Base interface for audio I/O channels.
+ *
+ * Channels bridge between audio sources (browser mic, Twilio, Discord)
+ * and the realtime session. They handle audio capture/playback and emit
+ * events that the session listens to.
+ *
+ * Events emitted:
+ * - 'audio' (audio: string) - Raw audio chunk (base64)
+ * - 'commit' () - User finished speaking (VAD or manual)
+ * - 'interrupt' () - User started speaking mid-response
+ */
+export interface RealtimeChannel extends EventEmitter {
+    /**
+     * Send audio to be played/transmitted by the channel.
+     * Called by session when audio is received from the model.
+     */
+    sendAudio(audio: string): void;
+    /**
+     * Interrupt current audio playback.
+     * Called by session when response is cancelled.
+     */
+    interrupt(): void;
+    /**
+     * Clean up resources and close the channel.
+     */
+    close(): void;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/realtime/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/realtime/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/realtime/channel.js

@@ -0,0 +1 @@
+export {};

package/dist/realtime/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./channel.js";
+export * from "./agent.js";
+export * from "./session.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

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

package/dist/realtime/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./channel.js";
+export * from "./agent.js";
+export * from "./session.js";

package/dist/realtime/session.d.ts

@@ -0,0 +1,98 @@
+import { EventEmitter } from "node:events";
+import { RealtimeModel } from "@kernl-sdk/protocol";
+import { Context, UnknownContext } from "../context.js";
+import { RealtimeAgent } from "./agent.js";
+import type { RealtimeChannel } from "./channel.js";
+import type { RealtimeSessionOptions } from "./types.js";
+/**
+ * A realtime session manages the connection to a realtime model.
+ *
+ * Handles the bidirectional communication between an agent and a model,
+ * including audio I/O (via channels), tool execution, and event routing.
+ */
+export declare class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
+    /**
+     * Session ID. Null until connected.
+     */
+    id: string | null;
+    /**
+     * The agent definition.
+     */
+    readonly agent: RealtimeAgent<TContext>;
+    /**
+     * The realtime model.
+     */
+    readonly model: RealtimeModel;
+    /**
+     * The audio I/O channel (if any).
+     */
+    readonly channel: RealtimeChannel | null;
+    /**
+     * The session context.
+     */
+    readonly context: Context<TContext>;
+    /**
+     * The active connection. Null until connected.
+     */
+    private connection;
+    /**
+     * Session options.
+     */
+    private options;
+    constructor(agent: RealtimeAgent<TContext>, options?: RealtimeSessionOptions<TContext>);
+    /**
+     * Connect to the realtime model.
+     */
+    connect(): Promise<void>;
+    /**
+     * Initialize event listeners and send session configuration.
+     */
+    private init;
+    /**
+     * Build session configuration from agent.
+     */
+    private buildSessionConfig;
+    /**
+     * Handle incoming events from the connection.
+     *
+     * Maps protocol events to simplified user-facing events:
+     * - 'audio' - audio output from assistant
+     * - 'transcript' - speech transcriptions (user or assistant)
+     * - 'text' - text output from assistant
+     * - 'error' - errors
+     */
+    private onEvent;
+    /**
+     * Execute tool calls from the model.
+     */
+    private performActions;
+    /**
+     * Send audio to the model.
+     */
+    sendAudio(audio: string): void;
+    /**
+     * Commit the audio buffer (signal end of speech).
+     */
+    commit(): void;
+    /**
+     * Send a text message to the model.
+     */
+    sendMessage(text: string): void;
+    /**
+     * Interrupt the current response.
+     */
+    interrupt(): void;
+    /**
+     * Mute audio input.
+     */
+    mute(): void;
+    /**
+     * Unmute audio input.
+     */
+    unmute(): void;
+    /**
+     * Close the session and release resources.
+     */
+    close(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/realtime/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/realtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,aAAa,EAMd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,eAAe,CAAC,QAAQ,GAAG,cAAc,CAAE,SAAQ,YAAY;IAC1E;;OAEG;IACH,EAAE,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAmC;IAErD;;OAEG;IACH,OAAO,CAAC,OAAO,CAAmC;gBAGhD,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC9B,OAAO,GAAE,sBAAsB,CAAC,QAAQ,CAAM;IAiBhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B;;OAEG;YACW,IAAI;IAalB;;OAEG;YACW,kBAAkB;IAUhC;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;IAuCf;;OAEG;YACW,cAAc;IAyB5B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/realtime/session.js

@@ -0,0 +1,203 @@
+import { EventEmitter } from "node:events";
+import { message, } from "@kernl-sdk/protocol";
+import { Context } from "../context.js";
+import { MisconfiguredError } from "../lib/error.js";
+/**
+ * A realtime session manages the connection to a realtime model.
+ *
+ * Handles the bidirectional communication between an agent and a model,
+ * including audio I/O (via channels), tool execution, and event routing.
+ */
+export class RealtimeSession extends EventEmitter {
+    /**
+     * Session ID. Null until connected.
+     */
+    id = null;
+    /**
+     * The agent definition.
+     */
+    agent;
+    /**
+     * The realtime model.
+     */
+    model;
+    /**
+     * The audio I/O channel (if any).
+     */
+    channel;
+    /**
+     * The session context.
+     */
+    context;
+    /**
+     * The active connection. Null until connected.
+     */
+    connection = null;
+    /**
+     * Session options.
+     */
+    options;
+    constructor(agent, options = {}) {
+        super();
+        if (options.transport?.handlesAudio && options.channel) {
+            throw new MisconfiguredError("Cannot use channel with WebRTC transport - audio is handled by transport");
+        }
+        this.agent = agent;
+        this.model = options.model ?? agent.model;
+        this.channel = options.channel ?? null;
+        this.context = options.context ?? new Context("kernl", {});
+        this.options = options;
+    }
+    /**
+     * Connect to the realtime model.
+     */
+    async connect() {
+        const sessionConfig = await this.buildSessionConfig();
+        const options = {
+            ...this.options.connectOptions,
+            sessionConfig,
+        };
+        this.connection = this.options.transport
+            ? await this.options.transport.connect(this.model, options)
+            : await this.model.connect(options);
+        this.connection.on("event", this.onEvent.bind(this));
+        this.connection.on("error", (e) => this.emit("error", e));
+        this.connection.on("status", (s) => this.emit("status", s));
+        this.init();
+    }
+    /**
+     * Initialize event listeners and send session configuration.
+     */
+    async init() {
+        if (this.channel) {
+            this.channel.on("audio", (audio) => this.sendAudio(audio));
+            this.channel.on("commit", () => this.commit());
+            this.channel.on("interrupt", () => this.interrupt());
+        }
+        this.connection?.send({
+            kind: "session.update",
+            config: await this.buildSessionConfig(),
+        });
+    }
+    /**
+     * Build session configuration from agent.
+     */
+    async buildSessionConfig() {
+        const tools = await this.agent.tools(this.context);
+        return {
+            instructions: await this.agent.instructions(this.context),
+            tools: tools.map((t) => t.serialize()),
+            voice: this.agent.voice,
+        };
+    }
+    /**
+     * Handle incoming events from the connection.
+     *
+     * Maps protocol events to simplified user-facing events:
+     * - 'audio' - audio output from assistant
+     * - 'transcript' - speech transcriptions (user or assistant)
+     * - 'text' - text output from assistant
+     * - 'error' - errors
+     */
+    onEvent(event) {
+        switch (event.kind) {
+            // Audio output → 'audio'
+            case "audio.output.delta":
+                this.channel?.sendAudio(event.audio);
+                this.emit("audio", event);
+                break;
+            case "audio.output.done":
+                this.emit("audio", event);
+                break;
+            // Speech transcriptions → 'transcript'
+            case "transcript.input":
+            case "transcript.output":
+                this.emit("transcript", event);
+                break;
+            // Text output → 'text'
+            case "text.output":
+                this.emit("text", event);
+                break;
+            // Errors → 'error'
+            case "session.error":
+                this.emit("error", event.error);
+                break;
+            // Tool calls - handled internally
+            case "tool.call":
+                this.performActions(event);
+                break;
+            // Session lifecycle - internal state
+            case "session.created":
+                this.id = event.session.id;
+                break;
+        }
+    }
+    /**
+     * Execute tool calls from the model.
+     */
+    async performActions(event) {
+        const tool = this.agent.tool(event.toolId);
+        if (!tool || tool.type !== "function") {
+            this.connection?.send({
+                kind: "tool.result",
+                callId: event.callId,
+                error: `Unknown tool: ${event.toolId}`,
+            });
+            return;
+        }
+        const result = await tool.invoke(this.context, event.arguments, event.callId);
+        this.connection?.send({
+            kind: "tool.result",
+            callId: event.callId,
+            result: result.state === "completed" ? String(result.result) : undefined,
+            error: result.error ?? undefined,
+        });
+    }
+    /**
+     * Send audio to the model.
+     */
+    sendAudio(audio) {
+        this.connection?.send({ kind: "audio.input.append", audio });
+    }
+    /**
+     * Commit the audio buffer (signal end of speech).
+     */
+    commit() {
+        this.connection?.send({ kind: "audio.input.commit" });
+    }
+    /**
+     * Send a text message to the model.
+     */
+    sendMessage(text) {
+        this.connection?.send({
+            kind: "item.create",
+            item: message({ role: "user", text }),
+        });
+    }
+    /**
+     * Interrupt the current response.
+     */
+    interrupt() {
+        this.connection?.send({ kind: "response.cancel" });
+        this.channel?.interrupt();
+    }
+    /**
+     * Mute audio input.
+     */
+    mute() {
+        this.connection?.mute();
+    }
+    /**
+     * Unmute audio input.
+     */
+    unmute() {
+        this.connection?.unmute();
+    }
+    /**
+     * Close the session and release resources.
+     */
+    close() {
+        this.channel?.close();
+        this.connection?.close();
+    }
+}

package/dist/realtime/types.d.ts

@@ -0,0 +1,58 @@
+import { RealtimeModel, RealtimeTransport, RealtimeConnectOptions } from "@kernl-sdk/protocol";
+import { Context, UnknownContext } from "../context.js";
+import type { BaseAgentConfig } from "../agent/base.js";
+import type { RealtimeChannel } from "./channel.js";
+/**
+ * Configuration for a realtime agent.
+ */
+export interface RealtimeAgentConfig<TContext = UnknownContext> extends BaseAgentConfig<TContext> {
+    /**
+     * The realtime model to use for this agent.
+     */
+    model: RealtimeModel;
+    /**
+     * Voice configuration for the agent.
+     */
+    voice?: RealtimeAgentVoiceConfig;
+}
+/**
+ * Voice configuration for a realtime agent.
+ */
+export interface RealtimeAgentVoiceConfig {
+    /**
+     * Voice ID to use for audio output.
+     */
+    voiceId: string;
+    /**
+     * Playback speed multiplier.
+     */
+    speed?: number;
+}
+/**
+ * Options for creating a realtime session.
+ */
+export interface RealtimeSessionOptions<TContext = UnknownContext> {
+    /**
+     * Override the agent's default model for this session.
+     */
+    model?: RealtimeModel;
+    /**
+     * Audio I/O channel (e.g., BrowserChannel, TwilioChannel).
+     * Not used with WebRTC transport.
+     */
+    channel?: RealtimeChannel;
+    /**
+     * Custom transport (e.g., WebRTCTransport).
+     * If not provided, model.connect() creates the default transport.
+     */
+    transport?: RealtimeTransport;
+    /**
+     * Context for this session.
+     */
+    context?: Context<TContext>;
+    /**
+     * Options passed to model.connect() or transport.connect().
+     */
+    connectOptions?: RealtimeConnectOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/realtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,cAAc,CAC5D,SAAQ,eAAe,CAAC,QAAQ,CAAC;IACjC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,QAAQ,GAAG,cAAc;IAC/D;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC"}

package/dist/realtime/types.js

@@ -0,0 +1 @@
+export {};