@kernl-sdk/xai 0.1.0 → 0.2.0

package/dist/convert/event.js

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

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

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

package/dist/convert/types.js

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

package/dist/model.d.ts

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

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

package/dist/model.js

@@ -1,112 +0,0 @@
-import { GrokRealtimeConnection } from "./connection.js";
-const XAI_REALTIME_URL = "wss://api.x.ai/v1/realtime";
-const XAI_CLIENT_SECRETS_URL = "https://api.x.ai/v1/realtime/client_secrets";
-/**
- * Grok (xAI) realtime model implementation.
- */
-export class GrokRealtimeModel {
-    spec = "1.0";
-    provider = "xai";
-    modelId;
-    apiKey;
-    baseUrl;
-    constructor(modelId, options) {
-        this.modelId = modelId;
-        this.apiKey =
-            options?.apiKey ??
-                (typeof process !== "undefined" ? process.env?.XAI_API_KEY : null) ??
-                null;
-        this.baseUrl = options?.baseUrl ?? XAI_REALTIME_URL;
-    }
-    /**
-     * Create ephemeral credential for client-side connections.
-     *
-     * Must be called server-side where API key is available.
-     */
-    async authenticate() {
-        if (!this.apiKey) {
-            throw new Error("API key required for authenticate(). " +
-                "Call this server-side where XAI_API_KEY is available.");
-        }
-        const res = await fetch(XAI_CLIENT_SECRETS_URL, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${this.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                expires_after: { seconds: 300 },
-            }),
-        });
-        if (!res.ok) {
-            const text = await res.text();
-            throw new Error(`Failed to create credential: ${res.status} ${text}`);
-        }
-        const data = (await res.json());
-        return {
-            kind: "token",
-            token: data.value,
-            expiresAt: new Date(Date.now() + 300_000), // 5 min TTL
-        };
-    }
-    /**
-     * Establish a WebSocket connection to the Grok realtime API.
-     */
-    async connect(options) {
-        const credential = options?.credential;
-        if (credential && credential.kind !== "token") {
-            throw new Error(`Grok requires token credentials, got "${credential.kind}".`);
-        }
-        const authToken = credential?.token ?? this.apiKey;
-        if (!authToken) {
-            throw new Error("No API key or credential provided. " +
-                "Either set XAI_API_KEY or pass a credential from authenticate().");
-        }
-        // Use injectable WebSocket or globalThis.WebSocket
-        const WS = options?.websocket ?? globalThis.WebSocket;
-        if (!WS) {
-            throw new Error("No WebSocket available. In Node.js <22, use WebSocketTransport with the 'ws' package:\n" +
-                "  import WebSocket from 'ws';\n" +
-                "  import { WebSocketTransport } from 'kernl';\n" +
-                "  new RealtimeSession(agent, { transport: new WebSocketTransport({ websocket: WebSocket }), ... })");
-        }
-        // Grok uses standard Authorization header via protocols
-        // Browser WebSocket doesn't support custom headers, so we pass token in subprotocol
-        const url = this.baseUrl;
-        // For browser: use subprotocol to pass auth (similar pattern to OpenAI)
-        // For Node.js with 'ws' package: headers can be passed directly
-        const protocols = [`token.${authToken}`];
-        const ws = new WS(url, protocols);
-        const connection = new GrokRealtimeConnection(ws);
-        await new Promise((resolve, reject) => {
-            if (options?.abort?.aborted) {
-                return reject(new Error("Connection aborted"));
-            }
-            const onOpen = () => {
-                cleanup();
-                resolve();
-            };
-            const onError = (event) => {
-                cleanup();
-                const err = event instanceof Error
-                    ? event
-                    : new Error("WebSocket connection failed");
-                reject(err);
-            };
-            const onAbort = () => {
-                cleanup();
-                ws.close();
-                reject(new Error("Connection aborted"));
-            };
-            const cleanup = () => {
-                ws.removeEventListener("open", onOpen);
-                ws.removeEventListener("error", onError);
-                options?.abort?.removeEventListener("abort", onAbort);
-            };
-            ws.addEventListener("open", onOpen);
-            ws.addEventListener("error", onError);
-            options?.abort?.addEventListener("abort", onAbort);
-        });
-        return connection;
-    }
-}