kernl 0.9.0 → 0.10.0

package/.turbo/turbo-build.log

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

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @kernl/core
 
+## 0.10.0
+
+### Minor Changes
+
+- f593374: Add realtime voice agents with multi-provider support.
+  - `RealtimeAgent` and `RealtimeSession` for voice-enabled AI agents
+  - OpenAI GPT-4o realtime with WebSocket streaming
+  - xAI Grok realtime with OpenAI-compatible protocol
+  - React hooks: `useRealtime`, `useBrowserAudio`, `LiveWaveform`
+  - Ephemeral credential pattern for secure browser connections
+  - Tool execution with client-side context support
+
+### Patch Changes
+
+- Updated dependencies [f593374]
+  - @kernl-sdk/protocol@0.4.0
+  - @kernl-sdk/retrieval@0.1.6
+
+## 0.9.1
+
+### Patch Changes
+
+- 25e46e7: Move zod to peerDependencies to prevent version conflicts
+
+  Consumers should add `zod` as a direct dependency in their project. This ensures
+  a single zod instance is used across all packages, avoiding type incompatibilities
+  that could cause TypeScript to hang during type checking.
+
+- Updated dependencies [25e46e7]
+  - @kernl-sdk/shared@0.3.1
+  - @kernl-sdk/protocol@0.3.1
+  - @kernl-sdk/retrieval@0.1.5
+
 ## 0.9.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -2,9 +2,10 @@ export { Kernl } from "./kernl/index.js";
 export type { KernlOptions, StorageOptions, AgentRegistry, ModelRegistry, } from "./kernl/index.js";
 export { Agent } from "./agent.js";
 export { Context } from "./context.js";
+export { RealtimeAgent, RealtimeSession, WebSocketTransport } from "./realtime/index.js";
+export type { RealtimeAgentConfig, RealtimeAgentVoiceConfig, RealtimeSessionOptions, WebSocketTransportOptions, } from "./realtime/index.js";
 export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool/index.js";
 export { MCPServerSSE } from "./mcp/sse.js";
-export { MCPServerStdio } from "./mcp/stdio.js";
 export { MCPServerStreamableHttp } from "./mcp/http.js";
 export type { MThread as Thread, MThreadEvent as ThreadEvent, MThreadEventBase as ThreadEventBase, } from "./api/models/index.js";
 export type { RThreadsListParams as ThreadsListParams, RThreadGetOptions as ThreadGetOptions, RThreadHistoryParams as ThreadHistoryParams, RThreadCreateParams as ThreadCreateParams, RThreadUpdateParams as ThreadUpdateParams, } from "./api/resources/threads/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAIrD,YAAY,EACV,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,WAAW,EAC3B,gBAAgB,IAAI,eAAe,GACpC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,EACrC,oBAAoB,IAAI,mBAAmB,EAC3C,mBAAmB,IAAI,kBAAkB,EACzC,mBAAmB,IAAI,kBAAkB,GAC1C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChF,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAIrD,YAAY,EACV,OAAO,IAAI,MAAM,EACjB,YAAY,IAAI,WAAW,EAC3B,gBAAgB,IAAI,eAAe,GACpC,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,IAAI,iBAAiB,EACvC,iBAAiB,IAAI,gBAAgB,EACrC,oBAAoB,IAAI,mBAAmB,EAC3C,mBAAmB,IAAI,kBAAkB,EACzC,mBAAmB,IAAI,kBAAkB,GAC1C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,10 +1,11 @@
 export { Kernl } from "./kernl/index.js";
 export { Agent } from "./agent.js";
 export { Context } from "./context.js";
+// --- realtime ---
+export { RealtimeAgent, RealtimeSession, WebSocketTransport } from "./realtime/index.js";
 // --- tools --
 export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool/index.js";
 export { MCPServerSSE } from "./mcp/sse.js";
-export { MCPServerStdio } from "./mcp/stdio.js";
 export { MCPServerStreamableHttp } from "./mcp/http.js";
 export { THREAD_STATES, } from "./thread/types.js";
 // --- memory ---

package/dist/lib/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;iBAab,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,GAAG;;;;CAA+B,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;iBAab,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,GAAG;;;;CAEf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/lib/env.js

@@ -26,4 +26,4 @@ const envSchema = z.object({
  * import { env } from '@/env';
  * console.log(env.LOG_LEVEL);
  */
-export const env = envSchema.parse(process.env);
+export const env = envSchema.parse(typeof process !== "undefined" ? process.env : {});

package/dist/lifecycle.d.ts

@@ -1,24 +1,10 @@
-import { EventEmitter } from "node:events";
+import { Emitter } from "@kernl-sdk/shared";
 import { Agent } from "./agent.js";
 import { Context, UnknownContext } from "./context.js";
 import { Tool } from "./tool/index.js";
 import type { ToolCall } from "@kernl-sdk/protocol";
 import { AgentOutputType } from "./agent/types.js";
 import { TextOutput } from "./thread/types.js";
-export type EventEmitterEvents = Record<string, any[]>;
-/**
- * Generic typed event emitter that wraps Node's EventEmitter with type safety
- */
-declare class TypedEventEmitter<EventTypes extends EventEmitterEvents = Record<string, any[]>> extends EventEmitter {
-    on<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
-    on(event: string | symbol, listener: (...args: any[]) => void): this;
-    off<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
-    off(event: string | symbol, listener: (...args: any[]) => void): this;
-    emit<K extends keyof EventTypes>(event: K, ...args: EventTypes[K]): boolean;
-    emit(event: string | symbol, ...args: any[]): boolean;
-    once<K extends keyof EventTypes>(event: K, listener: (...args: EventTypes[K]) => void): this;
-    once(event: string | symbol, listener: (...args: any[]) => void): this;
-}
 export type AgentHookEvents<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> = {
     /**
      * @param context - The context of the run
@@ -60,7 +46,7 @@ export type AgentHookEvents<TContext = UnknownContext, TOutput extends AgentOutp
  * Event emitter that every Agent instance inherits from and that emits events for the lifecycle
  * of the agent.
  */
-export declare class AgentHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends TypedEventEmitter<AgentHookEvents<TContext, TOutput>> {
+export declare class AgentHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends Emitter<AgentHookEvents<TContext, TOutput>> {
 }
 /**
  * Events emitted by the kernl during execution.
@@ -127,7 +113,6 @@ export type KernlHookEvents<TContext = UnknownContext, TOutput extends AgentOutp
 /**
  * Event emitter that the kernl uses to emit events for the lifecycle of every agent run.
  */
-export declare class KernlHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends TypedEventEmitter<KernlHookEvents<TContext, TOutput>> {
+export declare class KernlHooks<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> extends Emitter<KernlHookEvents<TContext, TOutput>> {
 }
-export {};
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

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

package/dist/lifecycle.js

@@ -1,29 +1,12 @@
-import { EventEmitter } from "node:events";
-/**
- * Generic typed event emitter that wraps Node's EventEmitter with type safety
- */
-class TypedEventEmitter extends EventEmitter {
-    on(event, listener) {
-        return super.on(event, listener);
-    }
-    off(event, listener) {
-        return super.off(event, listener);
-    }
-    emit(event, ...args) {
-        return super.emit(event, ...args);
-    }
-    once(event, listener) {
-        return super.once(event, listener);
-    }
-}
+import { Emitter } from "@kernl-sdk/shared";
 /**
  * Event emitter that every Agent instance inherits from and that emits events for the lifecycle
  * of the agent.
  */
-export class AgentHooks extends TypedEventEmitter {
+export class AgentHooks extends Emitter {
 }
 /**
  * Event emitter that the kernl uses to emit events for the lifecycle of every agent run.
  */
-export class KernlHooks extends TypedEventEmitter {
+export class KernlHooks extends Emitter {
 }

package/dist/memory/memory.js

@@ -68,7 +68,7 @@ export class Memory {
         return this._search.query({
             query: [{ text: q.query, tvec: tvec ?? undefined }],
             filter: q.filter ? MEMORY_FILTER.encode(q.filter) : undefined,
-            topK: q.limit ?? 20,
+            limit: q.limit ?? 20,
         });
     }
     /**

package/dist/realtime/index.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/realtime/index.js

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

package/dist/realtime/session.d.ts

@@ -1,16 +1,25 @@
-import { EventEmitter } from "node:events";
-import { RealtimeModel } from "@kernl-sdk/protocol";
+import { Emitter } from "@kernl-sdk/shared";
+import { RealtimeModel, RealtimeServerEvent, RealtimeChannel, TransportStatus } 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";
+/**
+ * Events emitted by a realtime session.
+ */
+export type RealtimeSessionEvents = {
+    audio: [event: RealtimeServerEvent];
+    transcript: [event: RealtimeServerEvent];
+    text: [event: RealtimeServerEvent];
+    error: [error: Error];
+    status: [status: TransportStatus];
+};
 /**
  * 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 {
+export declare class RealtimeSession<TContext = UnknownContext> extends Emitter<RealtimeSessionEvents> {
     /**
      * Session ID. Null until connected.
      */
@@ -48,24 +57,6 @@ export declare class RealtimeSession<TContext = UnknownContext> extends EventEmi
      * 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.
      */
@@ -94,5 +85,23 @@ export declare class RealtimeSession<TContext = UnknownContext> extends EventEmi
      * Close the session and release resources.
      */
     close(): void;
+    /**
+     * 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;
 }
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/realtime/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EACL,aAAa,EAEb,mBAAmB,EAEnB,eAAe,EAEf,eAAe,EAEhB,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,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACpC,UAAU,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtB,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,eAAe,CAC1B,QAAQ,GAAG,cAAc,CACzB,SAAQ,OAAO,CAAC,qBAAqB,CAAC;IACtC;;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;IAwB9B;;OAEG;YACW,IAAI;IAalB;;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;IAKb;;OAEG;YACW,kBAAkB;IAehC;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;IAuCf;;OAEG;YACW,cAAc;CAwB7B"}

package/dist/realtime/session.js

@@ -1,4 +1,4 @@
-import { EventEmitter } from "node:events";
+import { Emitter } from "@kernl-sdk/shared";
 import { message, } from "@kernl-sdk/protocol";
 import { Context } from "../context.js";
 import { MisconfiguredError } from "../lib/error.js";
@@ -8,7 +8,7 @@ import { MisconfiguredError } from "../lib/error.js";
  * 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 {
+export class RealtimeSession extends Emitter {
     /**
      * Session ID. Null until connected.
      */
@@ -56,6 +56,7 @@ export class RealtimeSession extends EventEmitter {
         const options = {
             ...this.options.connectOptions,
             sessionConfig,
+            credential: this.options.credential ?? this.options.connectOptions?.credential,
         };
         this.connection = this.options.transport
             ? await this.options.transport.connect(this.model, options)
@@ -63,6 +64,9 @@ export class RealtimeSession extends EventEmitter {
         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.connection.on("interrupted", () => this.channel?.interrupt());
+        // Emit current status (may have been set before listeners attached)
+        this.emit("status", this.connection.status);
         this.init();
     }
     /**
@@ -79,6 +83,53 @@ export class RealtimeSession extends EventEmitter {
             config: await this.buildSessionConfig(),
         });
     }
+    /**
+     * 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();
+    }
     /**
      * Build session configuration from agent.
      */
@@ -88,6 +139,11 @@ export class RealtimeSession extends EventEmitter {
             instructions: await this.agent.instructions(this.context),
             tools: tools.map((t) => t.serialize()),
             voice: this.agent.voice,
+            turnDetection: { mode: "server_vad" },
+            audio: {
+                inputFormat: { mimeType: "audio/pcm", sampleRate: 24000 },
+                outputFormat: { mimeType: "audio/pcm", sampleRate: 24000 },
+            },
         };
     }
     /**
@@ -101,7 +157,7 @@ export class RealtimeSession extends EventEmitter {
      */
     onEvent(event) {
         switch (event.kind) {
-            // Audio output → 'audio'
+            // audio output → 'audio'
             case "audio.output.delta":
                 this.channel?.sendAudio(event.audio);
                 this.emit("audio", event);
@@ -109,24 +165,24 @@ export class RealtimeSession extends EventEmitter {
             case "audio.output.done":
                 this.emit("audio", event);
                 break;
-            // Speech transcriptions → 'transcript'
+            // speech transcriptions → 'transcript'
             case "transcript.input":
             case "transcript.output":
                 this.emit("transcript", event);
                 break;
-            // Text output → 'text'
+            // text output → 'text'
             case "text.output":
                 this.emit("text", event);
                 break;
-            // Errors → 'error'
+            // ERrors → 'error'
             case "session.error":
                 this.emit("error", event.error);
                 break;
-            // Tool calls - handled internally
+            // tool calls - handled internally
             case "tool.call":
                 this.performActions(event);
                 break;
-            // Session lifecycle - internal state
+            // session lifecycle - internal state
             case "session.created":
                 this.id = event.session.id;
                 break;
@@ -153,51 +209,4 @@ export class RealtimeSession extends EventEmitter {
             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/transport.d.ts

@@ -0,0 +1,45 @@
+import type { RealtimeModel, RealtimeConnection, RealtimeTransport, RealtimeConnectOptions, WebSocketConstructor } from "@kernl-sdk/protocol";
+/**
+ * Options for creating a WebSocket transport.
+ */
+export interface WebSocketTransportOptions {
+    /**
+     * WebSocket constructor to use.
+     *
+     * Required in Node.js <22 (provide the 'ws' package).
+     * Optional in browsers and Node.js 22+ (uses globalThis.WebSocket).
+     *
+     * @example
+     * ```ts
+     * import WebSocket from 'ws';
+     * new WebSocketTransport({ websocket: WebSocket });
+     * ```
+     */
+    websocket?: WebSocketConstructor;
+}
+/**
+ * WebSocket transport for realtime connections.
+ *
+ * Use this transport when you need to provide a custom WebSocket implementation,
+ * such as the 'ws' package in Node.js <22.
+ *
+ * @example
+ * ```ts
+ * // Node.js <22
+ * import WebSocket from 'ws';
+ * const session = new RealtimeSession(agent, {
+ *   transport: new WebSocketTransport({ websocket: WebSocket }),
+ *   ...
+ * });
+ *
+ * // Browser or Node.js 22+ - no transport needed
+ * const session = new RealtimeSession(agent, { ... });
+ * ```
+ */
+export declare class WebSocketTransport implements RealtimeTransport {
+    readonly handlesAudio = false;
+    private WS;
+    constructor(options?: WebSocketTransportOptions);
+    connect(model: RealtimeModel, options?: RealtimeConnectOptions): Promise<RealtimeConnection>;
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/realtime/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,YAAY,SAAS;IAC9B,OAAO,CAAC,EAAE,CAAmC;gBAEjC,OAAO,CAAC,EAAE,yBAAyB;IAIzC,OAAO,CACX,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;CAM/B"}

package/dist/realtime/transport.js

@@ -0,0 +1,32 @@
+/**
+ * WebSocket transport for realtime connections.
+ *
+ * Use this transport when you need to provide a custom WebSocket implementation,
+ * such as the 'ws' package in Node.js <22.
+ *
+ * @example
+ * ```ts
+ * // Node.js <22
+ * import WebSocket from 'ws';
+ * const session = new RealtimeSession(agent, {
+ *   transport: new WebSocketTransport({ websocket: WebSocket }),
+ *   ...
+ * });
+ *
+ * // Browser or Node.js 22+ - no transport needed
+ * const session = new RealtimeSession(agent, { ... });
+ * ```
+ */
+export class WebSocketTransport {
+    handlesAudio = false;
+    WS;
+    constructor(options) {
+        this.WS = options?.websocket;
+    }
+    async connect(model, options) {
+        return model.connect({
+            ...options,
+            websocket: this.WS ?? options?.websocket,
+        });
+    }
+}

package/dist/realtime/types.d.ts

@@ -1,7 +1,6 @@
-import { RealtimeModel, RealtimeTransport, RealtimeConnectOptions } from "@kernl-sdk/protocol";
+import { RealtimeModel, RealtimeTransport, RealtimeConnectOptions, RealtimeChannel, ClientCredential } 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.
  */
@@ -50,6 +49,13 @@ export interface RealtimeSessionOptions<TContext = UnknownContext> {
      * Context for this session.
      */
     context?: Context<TContext>;
+    /**
+     * Ephemeral credential for client-side connections.
+     *
+     * Obtained from model.authenticate() on the server.
+     * Shorthand for connectOptions.credential.
+     */
+    credential?: ClientCredential;
     /**
      * Options passed to model.connect() or transport.connect().
      */

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

@@ -1 +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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;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;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;OAEG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kernl",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "A modern AI agent framework",
   "keywords": [
     "kernl",
@@ -34,10 +34,12 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.2",
     "yaml": "^2.8.2",
-    "zod": "^4.1.12",
-    "@kernl-sdk/protocol": "0.3.0",
-    "@kernl-sdk/retrieval": "0.1.4",
-    "@kernl-sdk/shared": "^0.3.0"
+    "@kernl-sdk/protocol": "0.4.0",
+    "@kernl-sdk/retrieval": "0.1.6",
+    "@kernl-sdk/shared": "^0.3.1"
+  },
+  "peerDependencies": {
+    "zod": "^4.1.8"
   },
   "devDependencies": {
     "@ai-sdk/openai": "3.0.0-beta.57",
@@ -45,7 +47,8 @@
     "tsc-alias": "^1.8.10",
     "typescript": "5.9.2",
     "vitest": "^4.0.8",
-    "@kernl-sdk/ai": "0.3.1"
+    "zod": "^4.1.8",
+    "@kernl-sdk/ai": "0.3.3"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/index.ts

@@ -8,11 +8,20 @@ export type {
 export { Agent } from "./agent";
 export { Context } from "./context";
 
+// --- realtime ---
+
+export { RealtimeAgent, RealtimeSession, WebSocketTransport } from "./realtime";
+export type {
+  RealtimeAgentConfig,
+  RealtimeAgentVoiceConfig,
+  RealtimeSessionOptions,
+  WebSocketTransportOptions,
+} from "./realtime";
+
 // --- tools --
 
 export { tool, Toolkit, FunctionToolkit, MCPToolkit } from "./tool";
 export { MCPServerSSE } from "./mcp/sse";
-export { MCPServerStdio } from "./mcp/stdio";
 export { MCPServerStreamableHttp } from "./mcp/http";
 
 // --- threads ---

package/src/lib/env.ts

@@ -28,7 +28,9 @@ const envSchema = z.object({
  * import { env } from '@/env';
  * console.log(env.LOG_LEVEL);
  */
-export const env = envSchema.parse(process.env);
+export const env = envSchema.parse(
+  typeof process !== "undefined" ? process.env : {},
+);
 
 /**
  * Type of the validated environment variables

package/src/lifecycle.ts

@@ -1,4 +1,4 @@
-import { EventEmitter } from "node:events";
+import { Emitter } from "@kernl-sdk/shared";
 
 import { Agent } from "./agent";
 import { Context, UnknownContext } from "./context";
@@ -8,56 +8,6 @@ import type { ToolCall } from "@kernl-sdk/protocol";
 import { AgentOutputType } from "@/agent/types";
 import { TextOutput } from "@/thread/types";
 
-export type EventEmitterEvents = Record<string, any[]>;
-
-/**
- * Generic typed event emitter that wraps Node's EventEmitter with type safety
- */
-class TypedEventEmitter<
-  EventTypes extends EventEmitterEvents = Record<string, any[]>,
-> extends EventEmitter {
-  // Overload for typed events
-  on<K extends keyof EventTypes>(
-    event: K,
-    listener: (...args: EventTypes[K]) => void,
-  ): this;
-  // Fallback for compatibility with parent
-  on(event: string | symbol, listener: (...args: any[]) => void): this;
-  on(event: any, listener: any): this {
-    return super.on(event, listener);
-  }
-
-  // Overload for typed events
-  off<K extends keyof EventTypes>(
-    event: K,
-    listener: (...args: EventTypes[K]) => void,
-  ): this;
-  // Fallback for compatibility with parent
-  off(event: string | symbol, listener: (...args: any[]) => void): this;
-  off(event: any, listener: any): this {
-    return super.off(event, listener);
-  }
-
-  // Overload for typed events
-  emit<K extends keyof EventTypes>(event: K, ...args: EventTypes[K]): boolean;
-  // Fallback for compatibility with parent
-  emit(event: string | symbol, ...args: any[]): boolean;
-  emit(event: any, ...args: any[]): boolean {
-    return super.emit(event, ...args);
-  }
-
-  // Overload for typed events
-  once<K extends keyof EventTypes>(
-    event: K,
-    listener: (...args: EventTypes[K]) => void,
-  ): this;
-  // Fallback for compatibility with parent
-  once(event: string | symbol, listener: (...args: any[]) => void): this;
-  once(event: any, listener: any): this {
-    return super.once(event, listener);
-  }
-}
-
 export type AgentHookEvents<
   TContext = UnknownContext,
   TOutput extends AgentOutputType = TextOutput,
@@ -108,7 +58,7 @@ export type AgentHookEvents<
 export class AgentHooks<
   TContext = UnknownContext,
   TOutput extends AgentOutputType = TextOutput,
-> extends TypedEventEmitter<AgentHookEvents<TContext, TOutput>> {}
+> extends Emitter<AgentHookEvents<TContext, TOutput>> {}
 
 /**
  * Events emitted by the kernl during execution.
@@ -178,4 +128,4 @@ export type KernlHookEvents<
 export class KernlHooks<
   TContext = UnknownContext,
   TOutput extends AgentOutputType = TextOutput,
-> extends TypedEventEmitter<KernlHookEvents<TContext, TOutput>> {}
+> extends Emitter<KernlHookEvents<TContext, TOutput>> {}

package/src/memory/memory.ts

@@ -97,7 +97,7 @@ export class Memory {
     return this._search.query({
       query: [{ text: q.query, tvec: tvec ?? undefined }],
       filter: q.filter ? MEMORY_FILTER.encode(q.filter) : undefined,
-      topK: q.limit ?? 20,
+      limit: q.limit ?? 20,
     });
   }
 

package/src/realtime/index.ts

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

package/src/realtime/session.ts

@@ -1,11 +1,12 @@
-import { EventEmitter } from "node:events";
-
+import { Emitter } from "@kernl-sdk/shared";
 import {
   RealtimeModel,
   RealtimeConnection,
   RealtimeServerEvent,
   RealtimeSessionConfig,
+  RealtimeChannel,
   ToolCallEvent,
+  TransportStatus,
   message,
 } from "@kernl-sdk/protocol";
 
@@ -13,16 +14,28 @@ import { Context, UnknownContext } from "@/context";
 import { MisconfiguredError } from "@/lib/error";
 
 import { RealtimeAgent } from "./agent";
-import type { RealtimeChannel } from "./channel";
 import type { RealtimeSessionOptions } from "./types";
 
+/**
+ * Events emitted by a realtime session.
+ */
+export type RealtimeSessionEvents = {
+  audio: [event: RealtimeServerEvent];
+  transcript: [event: RealtimeServerEvent];
+  text: [event: RealtimeServerEvent];
+  error: [error: Error];
+  status: [status: TransportStatus];
+};
+
 /**
  * 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<TContext = UnknownContext> extends EventEmitter {
+export class RealtimeSession<
+  TContext = UnknownContext,
+> extends Emitter<RealtimeSessionEvents> {
   /**
    * Session ID. Null until connected.
    */
@@ -85,6 +98,8 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
     const options = {
       ...this.options.connectOptions,
       sessionConfig,
+      credential:
+        this.options.credential ?? this.options.connectOptions?.credential,
     };
 
     this.connection = this.options.transport
@@ -94,6 +109,10 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
     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.connection.on("interrupted", () => this.channel?.interrupt());
+
+    // Emit current status (may have been set before listeners attached)
+    this.emit("status", this.connection.status);
 
     this.init();
   }
@@ -114,6 +133,60 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
     });
   }
 
+  /**
+   * Send audio to the model.
+   */
+  sendAudio(audio: string): void {
+    this.connection?.send({ kind: "audio.input.append", audio });
+  }
+
+  /**
+   * Commit the audio buffer (signal end of speech).
+   */
+  commit(): void {
+    this.connection?.send({ kind: "audio.input.commit" });
+  }
+
+  /**
+   * Send a text message to the model.
+   */
+  sendMessage(text: string): void {
+    this.connection?.send({
+      kind: "item.create",
+      item: message({ role: "user", text }),
+    });
+  }
+
+  /**
+   * Interrupt the current response.
+   */
+  interrupt(): void {
+    this.connection?.send({ kind: "response.cancel" });
+    this.channel?.interrupt();
+  }
+
+  /**
+   * Mute audio input.
+   */
+  mute(): void {
+    this.connection?.mute();
+  }
+
+  /**
+   * Unmute audio input.
+   */
+  unmute(): void {
+    this.connection?.unmute();
+  }
+
+  /**
+   * Close the session and release resources.
+   */
+  close(): void {
+    this.channel?.close();
+    this.connection?.close();
+  }
+
   /**
    * Build session configuration from agent.
    */
@@ -124,6 +197,11 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
       instructions: await this.agent.instructions(this.context),
       tools: tools.map((t) => t.serialize()),
       voice: this.agent.voice,
+      turnDetection: { mode: "server_vad" },
+      audio: {
+        inputFormat: { mimeType: "audio/pcm", sampleRate: 24000 },
+        outputFormat: { mimeType: "audio/pcm", sampleRate: 24000 },
+      },
     };
   }
 
@@ -138,7 +216,7 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
    */
   private onEvent(event: RealtimeServerEvent): void {
     switch (event.kind) {
-      // Audio output → 'audio'
+      // audio output → 'audio'
       case "audio.output.delta":
         this.channel?.sendAudio(event.audio);
         this.emit("audio", event);
@@ -147,28 +225,28 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
         this.emit("audio", event);
         break;
 
-      // Speech transcriptions → 'transcript'
+      // speech transcriptions → 'transcript'
       case "transcript.input":
       case "transcript.output":
         this.emit("transcript", event);
         break;
 
-      // Text output → 'text'
+      // text output → 'text'
       case "text.output":
         this.emit("text", event);
         break;
 
-      // Errors → 'error'
+      // ERrors → 'error'
       case "session.error":
         this.emit("error", event.error);
         break;
 
-      // Tool calls - handled internally
+      // tool calls - handled internally
       case "tool.call":
         this.performActions(event);
         break;
 
-      // Session lifecycle - internal state
+      // session lifecycle - internal state
       case "session.created":
         this.id = event.session.id;
         break;
@@ -202,58 +280,4 @@ export class RealtimeSession<TContext = UnknownContext> extends EventEmitter {
       error: result.error ?? undefined,
     });
   }
-
-  /**
-   * Send audio to the model.
-   */
-  sendAudio(audio: string): void {
-    this.connection?.send({ kind: "audio.input.append", audio });
-  }
-
-  /**
-   * Commit the audio buffer (signal end of speech).
-   */
-  commit(): void {
-    this.connection?.send({ kind: "audio.input.commit" });
-  }
-
-  /**
-   * Send a text message to the model.
-   */
-  sendMessage(text: string): void {
-    this.connection?.send({
-      kind: "item.create",
-      item: message({ role: "user", text }),
-    });
-  }
-
-  /**
-   * Interrupt the current response.
-   */
-  interrupt(): void {
-    this.connection?.send({ kind: "response.cancel" });
-    this.channel?.interrupt();
-  }
-
-  /**
-   * Mute audio input.
-   */
-  mute(): void {
-    this.connection?.mute();
-  }
-
-  /**
-   * Unmute audio input.
-   */
-  unmute(): void {
-    this.connection?.unmute();
-  }
-
-  /**
-   * Close the session and release resources.
-   */
-  close(): void {
-    this.channel?.close();
-    this.connection?.close();
-  }
 }

package/src/realtime/transport.ts

@@ -0,0 +1,64 @@
+import type {
+  RealtimeModel,
+  RealtimeConnection,
+  RealtimeTransport,
+  RealtimeConnectOptions,
+  WebSocketConstructor,
+} from "@kernl-sdk/protocol";
+
+/**
+ * Options for creating a WebSocket transport.
+ */
+export interface WebSocketTransportOptions {
+  /**
+   * WebSocket constructor to use.
+   *
+   * Required in Node.js <22 (provide the 'ws' package).
+   * Optional in browsers and Node.js 22+ (uses globalThis.WebSocket).
+   *
+   * @example
+   * ```ts
+   * import WebSocket from 'ws';
+   * new WebSocketTransport({ websocket: WebSocket });
+   * ```
+   */
+  websocket?: WebSocketConstructor;
+}
+
+/**
+ * WebSocket transport for realtime connections.
+ *
+ * Use this transport when you need to provide a custom WebSocket implementation,
+ * such as the 'ws' package in Node.js <22.
+ *
+ * @example
+ * ```ts
+ * // Node.js <22
+ * import WebSocket from 'ws';
+ * const session = new RealtimeSession(agent, {
+ *   transport: new WebSocketTransport({ websocket: WebSocket }),
+ *   ...
+ * });
+ *
+ * // Browser or Node.js 22+ - no transport needed
+ * const session = new RealtimeSession(agent, { ... });
+ * ```
+ */
+export class WebSocketTransport implements RealtimeTransport {
+  readonly handlesAudio = false;
+  private WS: WebSocketConstructor | undefined;
+
+  constructor(options?: WebSocketTransportOptions) {
+    this.WS = options?.websocket;
+  }
+
+  async connect(
+    model: RealtimeModel,
+    options?: RealtimeConnectOptions,
+  ): Promise<RealtimeConnection> {
+    return model.connect({
+      ...options,
+      websocket: this.WS ?? options?.websocket,
+    });
+  }
+}

package/src/realtime/types.ts

@@ -2,13 +2,13 @@ import {
   RealtimeModel,
   RealtimeTransport,
   RealtimeConnectOptions,
+  RealtimeChannel,
+  ClientCredential,
 } from "@kernl-sdk/protocol";
 
 import { Context, UnknownContext } from "@/context";
 import type { BaseAgentConfig } from "@/agent/base";
 
-import type { RealtimeChannel } from "./channel";
-
 /**
  * Configuration for a realtime agent.
  */
@@ -66,6 +66,14 @@ export interface RealtimeSessionOptions<TContext = UnknownContext> {
    */
   context?: Context<TContext>;
 
+  /**
+   * Ephemeral credential for client-side connections.
+   *
+   * Obtained from model.authenticate() on the server.
+   * Shorthand for connectOptions.credential.
+   */
+  credential?: ClientCredential;
+
   /**
    * Options passed to model.connect() or transport.connect().
    */

package/dist/realtime/channel.d.ts

@@ -1,30 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

package/src/realtime/channel.ts

@@ -1,32 +0,0 @@
-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;
-}