@kernl-sdk/xai 0.1.0

package/dist/convert/event.js

@@ -0,0 +1,314 @@
+import { randomID } from "@kernl-sdk/shared/lib";
+/**
+ * Map kernl voice ID to Grok voice name.
+ * Falls back to "Ara" (default) if not a valid Grok voice.
+ */
+function toGrokVoice(voiceId) {
+    if (!voiceId)
+        return undefined;
+    const validVoices = ["Ara", "Rex", "Sal", "Eve", "Leo"];
+    return validVoices.includes(voiceId)
+        ? voiceId
+        : "Ara";
+}
+/**
+ * Codec for turn detection config.
+ */
+export const TURN_DETECTION = {
+    encode(config) {
+        return {
+            type: config.mode === "manual" ? null : "server_vad",
+        };
+    },
+    decode(config) {
+        return {
+            mode: config?.type === "server_vad" ? "server_vad" : "manual",
+        };
+    },
+};
+/**
+ * Codec for audio config.
+ */
+export const AUDIO_CONFIG = {
+    encode(config) {
+        const result = {};
+        if (config.inputFormat) {
+            result.input = {
+                format: {
+                    type: config.inputFormat.mimeType || "audio/pcm",
+                    rate: config.inputFormat.sampleRate,
+                },
+            };
+        }
+        if (config.outputFormat) {
+            result.output = {
+                format: {
+                    type: config.outputFormat.mimeType || "audio/pcm",
+                    rate: config.outputFormat.sampleRate,
+                },
+            };
+        }
+        return result;
+    },
+    decode(config) {
+        return {
+            inputFormat: config.input?.format
+                ? {
+                    mimeType: config.input.format.type,
+                    sampleRate: config.input.format.rate,
+                }
+                : undefined,
+            outputFormat: config.output?.format
+                ? {
+                    mimeType: config.output.format.type,
+                    sampleRate: config.output.format.rate,
+                }
+                : undefined,
+        };
+    },
+};
+/**
+ * Codec for session config.
+ */
+export const SESSION_CONFIG = {
+    encode(config) {
+        const tools = config.tools
+            ?.filter((t) => t.kind === "function")
+            .map((t) => ({
+            type: "function",
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+        }));
+        return {
+            instructions: config.instructions,
+            voice: toGrokVoice(config.voice?.voiceId),
+            turn_detection: config.turnDetection
+                ? TURN_DETECTION.encode(config.turnDetection)
+                : undefined,
+            audio: config.audio ? AUDIO_CONFIG.encode(config.audio) : undefined,
+            tools: tools?.length ? tools : undefined,
+        };
+    },
+    decode(config) {
+        return {
+            instructions: config.instructions,
+            voice: config.voice ? { voiceId: config.voice } : undefined,
+            turnDetection: config.turn_detection
+                ? TURN_DETECTION.decode(config.turn_detection)
+                : undefined,
+            audio: config.audio ? AUDIO_CONFIG.decode(config.audio) : undefined,
+        };
+    },
+};
+/**
+ * Codec for conversation items.
+ */
+export const ITEM = {
+    encode(item) {
+        switch (item.kind) {
+            case "message": {
+                const content = item.content.map((c) => {
+                    switch (c.kind) {
+                        case "text":
+                            return { type: "input_text", text: c.text };
+                        default:
+                            return { type: "input_text", text: "" };
+                    }
+                });
+                return {
+                    type: "message",
+                    role: item.role,
+                    content,
+                };
+            }
+            case "tool-result":
+                return {
+                    type: "function_call_output",
+                    call_id: item.callId,
+                    output: item.error ?? JSON.stringify(item.result) ?? "",
+                };
+            default:
+                throw new Error(`Unsupported item kind: ${item.kind}`);
+        }
+    },
+    decode(item) {
+        switch (item.type) {
+            case "message":
+                return {
+                    kind: "message",
+                    id: randomID(),
+                    role: item.role,
+                    content: item.content.map((c) => ({
+                        kind: "text",
+                        text: "text" in c ? c.text : "",
+                    })),
+                };
+            case "function_call_output":
+                return {
+                    kind: "tool-result",
+                    callId: item.call_id,
+                    toolId: "",
+                    state: "completed",
+                    result: item.output,
+                    error: null,
+                };
+            default:
+                throw new Error(`Unsupported Grok item type: ${item.type}`);
+        }
+    },
+};
+/**
+ * Codec for client events (kernl → Grok).
+ */
+export const CLIENT_EVENT = {
+    encode(event) {
+        switch (event.kind) {
+            case "session.update":
+                return {
+                    type: "session.update",
+                    session: SESSION_CONFIG.encode(event.config),
+                };
+            case "audio.input.append":
+                return { type: "input_audio_buffer.append", audio: event.audio };
+            case "audio.input.commit":
+                return { type: "input_audio_buffer.commit" };
+            case "audio.input.clear":
+                return { type: "input_audio_buffer.clear" };
+            case "item.create":
+                return {
+                    type: "conversation.item.create",
+                    item: ITEM.encode(event.item),
+                    previous_item_id: event.previousItemId,
+                };
+            case "response.create":
+                return { type: "response.create" };
+            case "tool.result":
+                return {
+                    type: "conversation.item.create",
+                    item: {
+                        type: "function_call_output",
+                        call_id: event.callId,
+                        output: event.error ?? event.result ?? "",
+                    },
+                };
+            // Unsupported by Grok
+            case "item.delete":
+            case "item.truncate":
+            case "response.cancel":
+            case "activity.start":
+            case "activity.end":
+                return null;
+            default:
+                return null;
+        }
+    },
+    decode() {
+        throw new Error("CLIENT_EVENT.decode: use SERVER_EVENT instead");
+    },
+};
+/**
+ * Codec for server events (Grok → kernl).
+ */
+export const SERVER_EVENT = {
+    encode() {
+        throw new Error("SERVER_EVENT.encode: use CLIENT_EVENT instead");
+    },
+    decode(event) {
+        switch (event.type) {
+            case "conversation.created":
+                // Grok sends conversation.created instead of session.created
+                return {
+                    kind: "session.created",
+                    session: {
+                        id: event.conversation.id,
+                        config: {},
+                    },
+                };
+            case "session.updated":
+                return {
+                    kind: "session.updated",
+                    session: {
+                        id: event.event_id,
+                        config: SESSION_CONFIG.decode(event.session),
+                    },
+                };
+            case "input_audio_buffer.committed":
+                return { kind: "audio.input.committed", itemId: event.item_id };
+            case "input_audio_buffer.cleared":
+                return { kind: "audio.input.cleared" };
+            case "input_audio_buffer.speech_started":
+                return {
+                    kind: "speech.started",
+                    audioStartMs: 0, // Grok doesn't provide this
+                    itemId: event.item_id,
+                };
+            case "input_audio_buffer.speech_stopped":
+                return {
+                    kind: "speech.stopped",
+                    audioEndMs: 0, // Grok doesn't provide this
+                    itemId: event.item_id,
+                };
+            case "conversation.item.added":
+                return {
+                    kind: "item.created",
+                    item: ITEM.decode(event.item),
+                    previousItemId: event.previous_item_id,
+                };
+            case "conversation.item.input_audio_transcription.completed":
+                return {
+                    kind: "transcript.input",
+                    itemId: event.item_id,
+                    text: event.transcript,
+                };
+            case "response.created":
+                return { kind: "response.created", responseId: event.response.id };
+            case "response.output_item.added":
+                // Could emit tool.start here for function calls
+                return null;
+            case "response.done":
+                return {
+                    kind: "response.done",
+                    responseId: event.response.id,
+                    status: event.response.status === "completed" ? "completed" : "failed",
+                    usage: undefined,
+                };
+            case "response.output_audio.delta":
+                return {
+                    kind: "audio.output.delta",
+                    responseId: event.response_id,
+                    itemId: event.item_id,
+                    audio: event.delta,
+                };
+            case "response.output_audio.done":
+                return {
+                    kind: "audio.output.done",
+                    responseId: event.response_id,
+                    itemId: event.item_id,
+                };
+            case "response.output_audio_transcript.delta":
+                return {
+                    kind: "transcript.output.delta",
+                    responseId: event.response_id,
+                    itemId: event.item_id,
+                    delta: event.delta,
+                };
+            case "response.output_audio_transcript.done":
+                return {
+                    kind: "transcript.output",
+                    responseId: event.response_id,
+                    itemId: event.item_id,
+                    text: "", // Grok doesn't include final text in done event
+                };
+            case "response.function_call_arguments.done":
+                return {
+                    kind: "tool.call",
+                    callId: event.call_id,
+                    toolId: event.name,
+                    arguments: event.arguments,
+                };
+            default:
+                return null;
+        }
+    },
+};

package/dist/convert/types.d.ts

@@ -0,0 +1,212 @@
+import type { JSONSchema7 } from "json-schema";
+/**
+ * Grok (xAI) Realtime API wire types.
+ *
+ * Based on https://docs.x.ai/docs/guides/realtime-voice-agent
+ */
+export type GrokClientEvent = GrokSessionUpdate | GrokInputAudioBufferAppend | GrokInputAudioBufferCommit | GrokInputAudioBufferClear | GrokConversationItemCreate | GrokResponseCreate;
+export interface GrokSessionUpdate {
+    type: "session.update";
+    session: GrokSessionConfig;
+}
+export interface GrokInputAudioBufferAppend {
+    type: "input_audio_buffer.append";
+    audio: string;
+}
+export interface GrokInputAudioBufferCommit {
+    type: "input_audio_buffer.commit";
+}
+export interface GrokInputAudioBufferClear {
+    type: "input_audio_buffer.clear";
+}
+export interface GrokConversationItemCreate {
+    type: "conversation.item.create";
+    item: GrokItem;
+    previous_item_id?: string;
+}
+export interface GrokResponseCreate {
+    type: "response.create";
+}
+export type GrokServerEvent = GrokConversationCreated | GrokSessionUpdated | GrokInputAudioBufferCommitted | GrokInputAudioBufferCleared | GrokInputAudioBufferSpeechStarted | GrokInputAudioBufferSpeechStopped | GrokConversationItemAdded | GrokConversationItemInputAudioTranscriptionCompleted | GrokResponseCreated | GrokResponseOutputItemAdded | GrokResponseDone | GrokResponseOutputAudioDelta | GrokResponseOutputAudioDone | GrokResponseOutputAudioTranscriptDelta | GrokResponseOutputAudioTranscriptDone | GrokResponseFunctionCallArgumentsDone;
+export interface GrokConversationCreated {
+    type: "conversation.created";
+    event_id: string;
+    conversation: {
+        id: string;
+        object: "realtime.conversation";
+    };
+}
+export interface GrokSessionUpdated {
+    type: "session.updated";
+    event_id: string;
+    session: GrokSession;
+}
+export interface GrokInputAudioBufferCommitted {
+    type: "input_audio_buffer.committed";
+    event_id: string;
+    previous_item_id?: string;
+    item_id: string;
+}
+export interface GrokInputAudioBufferCleared {
+    type: "input_audio_buffer.cleared";
+    event_id: string;
+}
+export interface GrokInputAudioBufferSpeechStarted {
+    type: "input_audio_buffer.speech_started";
+    event_id: string;
+    item_id: string;
+}
+export interface GrokInputAudioBufferSpeechStopped {
+    type: "input_audio_buffer.speech_stopped";
+    event_id: string;
+    item_id: string;
+}
+export interface GrokConversationItemAdded {
+    type: "conversation.item.added";
+    event_id: string;
+    previous_item_id?: string;
+    item: GrokItemWithId;
+}
+export interface GrokConversationItemInputAudioTranscriptionCompleted {
+    type: "conversation.item.input_audio_transcription.completed";
+    event_id: string;
+    item_id: string;
+    transcript: string;
+}
+export interface GrokResponseCreated {
+    type: "response.created";
+    event_id: string;
+    response: {
+        id: string;
+        object: "realtime.response";
+        status: "in_progress";
+        output: unknown[];
+    };
+}
+export interface GrokResponseOutputItemAdded {
+    type: "response.output_item.added";
+    event_id: string;
+    response_id: string;
+    output_index: number;
+    item: GrokItemWithId;
+}
+export interface GrokResponseDone {
+    type: "response.done";
+    event_id: string;
+    response: {
+        id: string;
+        object: "realtime.response";
+        status: "completed" | "cancelled" | "failed";
+    };
+}
+export interface GrokResponseOutputAudioDelta {
+    type: "response.output_audio.delta";
+    event_id: string;
+    response_id: string;
+    item_id: string;
+    output_index: number;
+    content_index: number;
+    delta: string;
+}
+export interface GrokResponseOutputAudioDone {
+    type: "response.output_audio.done";
+    event_id: string;
+    response_id: string;
+    item_id: string;
+}
+export interface GrokResponseOutputAudioTranscriptDelta {
+    type: "response.output_audio_transcript.delta";
+    event_id: string;
+    response_id: string;
+    item_id: string;
+    delta: string;
+}
+export interface GrokResponseOutputAudioTranscriptDone {
+    type: "response.output_audio_transcript.done";
+    event_id: string;
+    response_id: string;
+    item_id: string;
+}
+export interface GrokResponseFunctionCallArgumentsDone {
+    type: "response.function_call_arguments.done";
+    event_id: string;
+    response_id?: string;
+    item_id?: string;
+    call_id: string;
+    name: string;
+    arguments: string;
+}
+export interface GrokSession {
+    instructions?: string;
+    voice?: GrokVoice;
+    turn_detection?: GrokTurnDetection;
+}
+export interface GrokSessionConfig {
+    instructions?: string;
+    voice?: GrokVoice;
+    turn_detection?: GrokTurnDetection | null;
+    audio?: GrokAudioConfig;
+    tools?: GrokTool[];
+}
+/**
+ * Available Grok voices.
+ */
+export type GrokVoice = "Ara" | "Rex" | "Sal" | "Eve" | "Leo";
+export interface GrokTurnDetection {
+    type: "server_vad" | null;
+}
+export interface GrokAudioConfig {
+    input?: {
+        format?: GrokAudioFormat;
+    };
+    output?: {
+        format?: GrokAudioFormat;
+    };
+}
+export interface GrokAudioFormat {
+    type: "audio/pcm" | "audio/pcmu" | "audio/pcma";
+    rate?: number;
+}
+export type GrokTool = GrokFunctionTool | GrokWebSearchTool | GrokXSearchTool | GrokFileSearchTool;
+export interface GrokFunctionTool {
+    type: "function";
+    name: string;
+    description?: string;
+    parameters?: JSONSchema7;
+}
+export interface GrokWebSearchTool {
+    type: "web_search";
+}
+export interface GrokXSearchTool {
+    type: "x_search";
+    allowed_x_handles?: string[];
+}
+export interface GrokFileSearchTool {
+    type: "file_search";
+    vector_store_ids: string[];
+    max_num_results?: number;
+}
+export type GrokItem = GrokMessageItem | GrokFunctionCallOutputItem;
+export interface GrokMessageItem {
+    type: "message";
+    role: "user" | "assistant";
+    content: GrokContentPart[];
+}
+export interface GrokFunctionCallOutputItem {
+    type: "function_call_output";
+    call_id: string;
+    output: string;
+}
+export type GrokItemWithId = GrokItem & {
+    id: string;
+    object: "realtime.item";
+    status: "completed" | "in_progress";
+};
+export type GrokContentPart = {
+    type: "input_text";
+    text: string;
+} | {
+    type: "input_audio";
+    transcript?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/convert/types.js

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import { GrokRealtimeModel, type GrokRealtimeOptions } from "./realtime/model.js";
+/**
+ * xAI provider interface.
+ */
+export interface XAIProvider {
+    /**
+     * Create a Grok realtime voice model.
+     *
+     * @example
+     * ```ts
+     * import { xai } from '@kernl-sdk/xai';
+     *
+     * const model = xai.realtime();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const model = xai.realtime({
+     *   apiKey: 'xai-...',
+     * });
+     * ```
+     */
+    realtime(options?: GrokRealtimeOptions): GrokRealtimeModel;
+}
+/**
+ * xAI provider.
+ *
+ * @example
+ * ```ts
+ * import { xai } from '@kernl-sdk/xai';
+ *
+ * const model = xai.realtime();
+ * ```
+ */
+export declare const xai: XAIProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,CAAC;CAC5D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,GAAG,EAAE,WAIjB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import { GrokRealtimeModel } from "./realtime/model.js";
+/**
+ * xAI provider.
+ *
+ * @example
+ * ```ts
+ * import { xai } from '@kernl-sdk/xai';
+ *
+ * const model = xai.realtime();
+ * ```
+ */
+export const xai = {
+    realtime(options) {
+        return new GrokRealtimeModel(options);
+    },
+};

package/dist/model.d.ts

@@ -0,0 +1,36 @@
+import type { RealtimeModel, RealtimeConnection, RealtimeConnectOptions, ClientCredential } from "@kernl-sdk/protocol";
+/**
+ * Options for creating a Grok realtime model.
+ */
+export interface GrokRealtimeOptions {
+    /**
+     * xAI API key. Defaults to XAI_API_KEY env var.
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the realtime API.
+     */
+    baseUrl?: string;
+}
+/**
+ * Grok (xAI) realtime model implementation.
+ */
+export declare class GrokRealtimeModel implements RealtimeModel {
+    readonly spec: "1.0";
+    readonly provider = "xai";
+    readonly modelId: string;
+    private apiKey;
+    private baseUrl;
+    constructor(modelId: string, options?: GrokRealtimeOptions);
+    /**
+     * Create ephemeral credential for client-side connections.
+     *
+     * Must be called server-side where API key is available.
+     */
+    authenticate(): Promise<ClientCredential>;
+    /**
+     * Establish a WebSocket connection to the Grok realtime API.
+     */
+    connect(options?: RealtimeConnectOptions): Promise<RealtimeConnection>;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAO7B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,QAAQ,CAAC,QAAQ,SAAS;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAS1D;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAgC/C;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA4E7E"}