@kuralle-syrinx/grok 4.4.0 → 4.5.0

package/dist/from-grok-realtime.d.ts

@@ -0,0 +1,31 @@
+import type { SocketFactory } from "@kuralle-syrinx/ws";
+import { base64ToBytes, bytesToBase64, type RealtimeAdapter, type RealtimeToolDef } from "@kuralle-syrinx/realtime";
+export interface GrokRealtimeOptions {
+    readonly apiKey: string;
+    readonly model?: string;
+    readonly voice?: string;
+    readonly socketFactory: SocketFactory;
+    readonly url?: () => string;
+    readonly turnDetection?: Record<string, unknown> | null;
+    readonly tools?: readonly RealtimeToolDef[];
+    readonly debug?: boolean;
+    readonly instructions?: string;
+    readonly inputRateHz?: number;
+    readonly outputRateHz?: number;
+    /** Input audio format. Defaults to `{ type: "audio/pcm", rate: inputRateHz }`. */
+    readonly inputAudioFormat?: Record<string, unknown>;
+    /** Output audio format. Defaults to `{ type: "audio/pcm", rate: outputRateHz }`. */
+    readonly outputAudioFormat?: Record<string, unknown>;
+    readonly temperature?: number;
+    readonly modalities?: readonly string[];
+    readonly inputTranscription?: Record<string, unknown> | boolean;
+    readonly toolChoice?: string | Record<string, unknown>;
+    /**
+     * Merged last into `session.update.session` for provider-specific fields the
+     * adapter does not enumerate. Overrides same-key defaults when both set.
+     */
+    readonly sessionConfig?: Record<string, unknown>;
+}
+export declare function fromGrokRealtime(opts: GrokRealtimeOptions): RealtimeAdapter;
+export { base64ToBytes, bytesToBase64 };
+//# sourceMappingURL=from-grok-realtime.d.ts.map

package/dist/from-grok-realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-grok-realtime.d.ts","sourceRoot":"","sources":["../src/from-grok-realtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,aAAa,EAEb,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAMlC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,oFAAoF;IACpF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CAqF3E;AAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/dist/from-grok-realtime.js

@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: MIT
+import { base64ToBytes, bytesToBase64, createOpenAiCompatibleRealtimeAdapter, } from "@kuralle-syrinx/realtime";
+const DEFAULT_MODEL = "grok-voice-latest";
+const DEFAULT_VOICE = "eve";
+const DEFAULT_SAMPLE_RATE_HZ = 24_000;
+export function fromGrokRealtime(opts) {
+    const inputRateHz = opts.inputRateHz ?? DEFAULT_SAMPLE_RATE_HZ;
+    const outputRateHz = opts.outputRateHz ?? DEFAULT_SAMPLE_RATE_HZ;
+    const voice = opts.voice ?? DEFAULT_VOICE;
+    return createOpenAiCompatibleRealtimeAdapter({
+        apiKey: opts.apiKey,
+        socketFactory: opts.socketFactory,
+        debug: opts.debug,
+        debugLogPrefix: "[grok-raw]",
+        defaultModel: DEFAULT_MODEL,
+        model: opts.model,
+        url: opts.url,
+        buildUrl: (model) => `wss://api.x.ai/v1/realtime?model=${encodeURIComponent(model)}`,
+        caps: {
+            inputSampleRateHz: inputRateHz,
+            outputSampleRateHz: outputRateHz,
+            supportsConcurrentToolAudio: false,
+            supportsTruncate: false,
+            emitsServerSpeechStarted: false,
+        },
+        buildSessionUpdate: () => {
+            const turnDetection = "turnDetection" in opts ? opts.turnDetection : { type: "server_vad" };
+            const inputAudio = {
+                format: opts.inputAudioFormat ?? { type: "audio/pcm", rate: inputRateHz },
+            };
+            if (opts.inputTranscription !== undefined) {
+                inputAudio["transcription"] =
+                    opts.inputTranscription === true ? {} : opts.inputTranscription;
+            }
+            const session = {
+                voice,
+                turn_detection: turnDetection,
+                tools: (opts.tools ?? []).map((t) => ({
+                    type: "function",
+                    name: t.name,
+                    description: t.description,
+                    parameters: t.parameters,
+                })),
+                audio: {
+                    input: inputAudio,
+                    output: {
+                        format: opts.outputAudioFormat ?? { type: "audio/pcm", rate: outputRateHz },
+                        voice,
+                    },
+                },
+            };
+            if (opts.instructions !== undefined) {
+                session["instructions"] = opts.instructions;
+            }
+            if (opts.temperature !== undefined) {
+                session["temperature"] = opts.temperature;
+            }
+            if (opts.modalities !== undefined) {
+                session["output_modalities"] = opts.modalities;
+            }
+            if (opts.toolChoice !== undefined) {
+                session["tool_choice"] = opts.toolChoice;
+            }
+            if (opts.sessionConfig) {
+                Object.assign(session, opts.sessionConfig);
+            }
+            return session;
+        },
+        supportsTruncate: false,
+        defaultErrorMessage: "Grok Realtime error",
+        extendServerMessage: (type, msg, ctx) => {
+            if (type !== "conversation.item.input_audio_transcription.updated")
+                return false;
+            const transcript = typeof msg["transcript"] === "string" ? msg["transcript"] : "";
+            if (transcript.length > 0) {
+                ctx.push({
+                    type: "transcript",
+                    role: "user",
+                    text: transcript,
+                    final: true,
+                });
+            }
+            return true;
+        },
+    });
+}
+export { base64ToBytes, bytesToBase64 };
+//# sourceMappingURL=from-grok-realtime.js.map

package/dist/from-grok-realtime.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { GrokSTTPlugin } from "./stt.js";
+export { GrokTTSPlugin } from "./tts.js";
+export { fromGrokRealtime, type GrokRealtimeOptions } from "./from-grok-realtime.js";
+//# 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":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+export { GrokSTTPlugin } from "./stt.js";
+export { GrokTTSPlugin } from "./tts.js";
+export { fromGrokRealtime } from "./from-grok-realtime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAA4B,MAAM,yBAAyB,CAAC"}

package/dist/stt.d.ts

@@ -0,0 +1,17 @@
+import { type PipelineBus, type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+import type { SocketFactory } from "@kuralle-syrinx/ws";
+export declare class GrokSTTPlugin implements VoicePlugin {
+    private readonly socketFactory?;
+    readonly endpointingCapability: {
+        owner: "provider_stt";
+        disableConfig: {
+            emit_eos_on_final: boolean;
+            finalize_on_speech_final: boolean;
+        };
+    };
+    constructor(socketFactory?: SocketFactory | undefined);
+    private session;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=stt.d.ts.map

package/dist/stt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt.d.ts","sourceRoot":"","sources":["../src/stt.ts"],"names":[],"mappings":"AAMA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAgGpE,qBAAa,aAAc,YAAW,WAAW;IASnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAR3C,QAAQ,CAAC,qBAAqB;;;;;;MAM5B;gBAE2B,aAAa,CAAC,EAAE,aAAa,YAAA;IAE1D,OAAO,CAAC,OAAO,CAAoC;IAE7C,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/stt.js

@@ -0,0 +1,179 @@
+// SPDX-License-Identifier: MIT
+//
+// Grok (xAI) STT Plugin. The streaming lifecycle lives in @kuralle-syrinx/stt-core. This
+// file is the Grok wire protocol: connect URL + query knobs, audio.done finalize, and
+// decode of transcript.created / transcript.partial (is_final / duration / speech_final).
+import { assertAudioFormat, optionalStringConfig, readProviderRetryConfig, requireStringConfig, } from "@kuralle-syrinx/core";
+import { defaultNodeSocketFactory, startStreamingSttSession, } from "@kuralle-syrinx/stt-core";
+const AUDIO_DONE = JSON.stringify({ type: "audio.done" });
+class GrokSttWireProtocol {
+    ready = false;
+    isReady() {
+        return this.ready;
+    }
+    onConnectionLost() {
+        this.ready = false;
+    }
+    encodeFinalize() {
+        return [AUDIO_DONE];
+    }
+    encodeClose() {
+        return [AUDIO_DONE];
+    }
+    decode(data, _isBinary) {
+        if (typeof data !== "string")
+            return [];
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch (err) {
+            return [
+                {
+                    type: "error",
+                    error: new Error(`Grok STT provider sent malformed JSON: ${err instanceof Error ? err.message : String(err)}`),
+                },
+            ];
+        }
+        const type = typeof msg["type"] === "string" ? msg["type"] : "";
+        switch (type) {
+            case "transcript.created":
+                this.ready = true;
+                return [];
+            case "transcript.partial":
+                return this.decodePartial(msg);
+            case "transcript.done":
+                return [];
+            case "error":
+                return [
+                    {
+                        type: "error",
+                        error: new Error(typeof msg["message"] === "string" ? msg["message"] : "Grok STT provider error"),
+                    },
+                ];
+            default:
+                return [];
+        }
+    }
+    decodePartial(msg) {
+        const text = typeof msg["text"] === "string" ? msg["text"].trim() : "";
+        if (!text)
+            return [];
+        const isFinal = msg["is_final"] === true;
+        const speechFinal = msg["speech_final"] === true;
+        const confidence = typeof msg["end_of_turn_confidence"] === "number" ? msg["end_of_turn_confidence"] : 0;
+        // contextId is stamped by the session from the audio/turn context.
+        const contextId = "";
+        if (!isFinal) {
+            return [{ type: "interim", contextId, text }];
+        }
+        return [
+            {
+                type: "final",
+                contextId,
+                text,
+                confidence,
+                speechFinal,
+                audioSeconds: typeof msg["duration"] === "number" ? msg["duration"] : undefined,
+                provider: {
+                    speechFinal,
+                    words: msg["words"],
+                    start: msg["start"],
+                    duration: msg["duration"],
+                },
+            },
+        ];
+    }
+}
+export class GrokSTTPlugin {
+    socketFactory;
+    endpointingCapability = {
+        owner: "provider_stt",
+        disableConfig: {
+            emit_eos_on_final: false,
+            finalize_on_speech_final: false,
+        },
+    };
+    constructor(socketFactory) {
+        this.socketFactory = socketFactory;
+    }
+    session = null;
+    async initialize(bus, config) {
+        const apiKey = requireStringConfig(config, "api_key");
+        const sampleRate = config["sample_rate"] ?? 16000;
+        const language = optionalStringConfig(config, "language") ?? "en";
+        const endpointUrl = optionalStringConfig(config, "endpoint_url") ?? "wss://api.x.ai/v1/stt";
+        const encoding = optionalStringConfig(config, "encoding") ?? "pcm";
+        const interimResults = config["interim_results"] ?? true;
+        const endpointing = config["endpointing"] ?? 10;
+        const smartTurn = typeof config["smart_turn"] === "number" ? config["smart_turn"] : undefined;
+        const smartTurnTimeoutMs = typeof config["smart_turn_timeout"] === "number" ? config["smart_turn_timeout"] : undefined;
+        const diarize = config["diarize"] ?? false;
+        const keyterm = optionalStringConfig(config, "keyterm");
+        const emitEosOnFinal = config["emit_eos_on_final"] ?? true;
+        const queryParams = readPlainObject(config["query_params"]);
+        const audioFormat = { encoding: "pcm_s16le", sampleRateHz: sampleRate, channels: 1 };
+        assertAudioFormat(audioFormat);
+        this.session = await startStreamingSttSession(bus, {
+            protocol: new GrokSttWireProtocol(),
+            provider: { name: "grok", model: "stt", region: "global" },
+            format: audioFormat,
+            language,
+            emitEosOnFinal,
+            url: () => {
+                const params = new URLSearchParams({
+                    sample_rate: String(sampleRate),
+                    encoding,
+                    interim_results: String(interimResults),
+                    language,
+                    endpointing: String(endpointing),
+                });
+                if (smartTurn !== undefined)
+                    params.set("smart_turn", String(smartTurn));
+                if (smartTurnTimeoutMs !== undefined) {
+                    params.set("smart_turn_timeout", String(smartTurnTimeoutMs));
+                }
+                if (diarize)
+                    params.set("diarize", "true");
+                if (keyterm)
+                    params.set("keyterm", keyterm);
+                applyQueryParams(params, queryParams);
+                const separator = endpointUrl.includes("?") ? "&" : "?";
+                return `${endpointUrl}${separator}${params.toString()}`;
+            },
+            headers: { Authorization: `Bearer ${apiKey}` },
+            socketFactory: this.socketFactory ?? (await defaultNodeSocketFactory()),
+            retry: readProviderRetryConfig(config),
+            replayBufferSize: config["replay_buffer_size"] ?? 64,
+            metricPrefix: "stt.grok",
+        });
+    }
+    async close() {
+        await this.session?.dispose();
+        this.session = null;
+    }
+}
+function readPlainObject(value) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    return undefined;
+}
+function applyQueryParams(params, extra) {
+    if (!extra)
+        return;
+    for (const [key, value] of Object.entries(extra)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item === undefined || item === null)
+                    continue;
+                params.append(key, String(item));
+            }
+            continue;
+        }
+        params.set(key, String(value));
+    }
+}
+//# sourceMappingURL=stt.js.map

package/dist/stt.js.map

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

package/dist/tts.d.ts

@@ -0,0 +1,10 @@
+import { type PipelineBus, type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+import type { SocketFactory } from "@kuralle-syrinx/ws";
+export declare class GrokTTSPlugin implements VoicePlugin {
+    private readonly socketFactory?;
+    constructor(socketFactory?: SocketFactory | undefined);
+    private session;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=tts.d.ts.map

package/dist/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../src/tts.ts"],"names":[],"mappings":"AAQA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAiGpE,qBAAa,aAAc,YAAW,WAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAAd,aAAa,CAAC,EAAE,aAAa,YAAA;IAE1D,OAAO,CAAC,OAAO,CAAoC;IAE7C,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/tts.js

@@ -0,0 +1,178 @@
+// SPDX-License-Identifier: MIT
+//
+// Grok (xAI) TTS Plugin. The streaming lifecycle lives in @kuralle-syrinx/tts-core. This
+// file is the Grok wire protocol: single-context streaming (one active utterance at a time),
+// text.delta/text.done/text.clear out, base64 audio.delta in. Grok frames carry no key, so
+// inbound audio is attributed to the one current context. Raw PCM may split mid-sample, so
+// Grok relies on the engine's streaming carry.
+import { Route, assertAudioFormat, optionalStringConfig, readProviderRetryConfig, requireStringConfig, } from "@kuralle-syrinx/core";
+import { attributionKey, defaultNodeSocketFactory, startStreamingTtsSession, } from "@kuralle-syrinx/tts-core";
+import { base64ToBytes } from "@kuralle-syrinx/realtime";
+const KEEP_ALIVE_INTERVAL_MS = 10_000;
+class GrokWireProtocol {
+    modelId;
+    // Grok streams one context at a time; inbound frames carry no key, so they're attributed
+    // to the current one. (Audio for an interrupted context is dropped by the engine's
+    // cancelled-key tracking, which subsumes Grok's old `clearedPending` race guard.)
+    current = null;
+    charactersByKey = new Map();
+    constructor(modelId) {
+        this.modelId = modelId;
+    }
+    attributionFor(contextId) {
+        this.current = attributionKey(contextId);
+        return { key: this.current, contextId };
+    }
+    encodeText(key, text) {
+        this.charactersByKey.set(key, (this.charactersByKey.get(key) ?? 0) + text.length);
+        return [JSON.stringify({ type: "text.delta", delta: text })];
+    }
+    encodeFinish() {
+        return [JSON.stringify({ type: "text.done" })];
+    }
+    encodeCancel(key) {
+        this.charactersByKey.delete(key);
+        return [JSON.stringify({ type: "text.clear" })];
+    }
+    encodeClose() {
+        return [];
+    }
+    decode(data) {
+        if (typeof data !== "string")
+            return [];
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return []; // Grok ignores unparseable frames (does not fail the session).
+        }
+        const key = this.current;
+        switch (msg["type"]) {
+            case "audio.delta": {
+                if (!key)
+                    return [];
+                const delta = typeof msg["delta"] === "string" ? msg["delta"] : "";
+                if (delta.length === 0)
+                    return [];
+                try {
+                    return [{ type: "audio", key, pcm: base64ToBytes(delta) }];
+                }
+                catch (err) {
+                    return [{ type: "error", key, error: err instanceof Error ? err : new Error(String(err)) }];
+                }
+            }
+            case "audio.done": {
+                const characters = key ? (this.charactersByKey.get(key) ?? 0) : 0;
+                if (key)
+                    this.charactersByKey.delete(key);
+                this.current = null;
+                if (!key)
+                    return [];
+                const events = [];
+                // Sideband before context_end so the engine still has the key→context mapping.
+                if (characters > 0) {
+                    const modelId = this.modelId;
+                    events.push({
+                        type: "sideband",
+                        key,
+                        route: Route.Background,
+                        build: (ctxId, timestampMs) => ({
+                            kind: "usage.recorded",
+                            contextId: ctxId,
+                            timestampMs,
+                            stage: "tts",
+                            provider: "grok",
+                            model: modelId,
+                            characters,
+                        }),
+                    });
+                }
+                events.push({ type: "context_end", key });
+                return events;
+            }
+            case "audio.clear":
+                // Provider acknowledged a text.clear. Audio for the interrupted context is already
+                // dropped via the engine's cancelled tracking; nothing more to do.
+                return [];
+            case "error":
+                if (key)
+                    this.charactersByKey.delete(key);
+                return key ? [{ type: "error", key, error: grokProviderError(msg) }] : [];
+            default:
+                return [];
+        }
+    }
+}
+export class GrokTTSPlugin {
+    socketFactory;
+    constructor(socketFactory) {
+        this.socketFactory = socketFactory;
+    }
+    session = null;
+    async initialize(bus, config) {
+        const apiKey = requireStringConfig(config, "api_key");
+        const voiceId = optionalStringConfig(config, "voice_id") ?? "eve";
+        const language = optionalStringConfig(config, "language") ?? "en";
+        const endpointUrl = optionalStringConfig(config, "endpoint_url") ?? "wss://api.x.ai/v1/tts";
+        const sampleRate = readPositiveInteger(config["sample_rate"], 16000);
+        const codec = optionalStringConfig(config, "codec") ?? "pcm";
+        const bitRate = readPositiveIntegerOrUndefined(config["bit_rate"]);
+        const audioFormat = { encoding: "pcm_s16le", sampleRateHz: sampleRate, channels: 1 };
+        assertAudioFormat(audioFormat);
+        this.session = await startStreamingTtsSession(bus, {
+            protocol: new GrokWireProtocol(voiceId),
+            provider: { name: "grok", model: voiceId, region: "global" },
+            format: audioFormat,
+            sampleRateHz: sampleRate,
+            url: () => {
+                const params = new URLSearchParams({
+                    language,
+                    voice: voiceId,
+                    codec,
+                    sample_rate: String(sampleRate),
+                });
+                if (bitRate !== undefined)
+                    params.set("bit_rate", String(bitRate));
+                const separator = endpointUrl.includes("?") ? "&" : "?";
+                return `${endpointUrl}${separator}${params.toString()}`;
+            },
+            headers: { Authorization: `Bearer ${apiKey}` },
+            retry: readProviderRetryConfig(config),
+            finishTimeoutMs: readNonNegativeInteger(config["finish_timeout_ms"], 2000),
+            metricPrefix: "tts.grok",
+            socketFactory: this.socketFactory ?? (await defaultNodeSocketFactory()),
+            replayBufferSize: config["replay_buffer_size"] ?? 32,
+            keepAliveIntervalMs: KEEP_ALIVE_INTERVAL_MS,
+        });
+    }
+    async close() {
+        await this.session?.dispose();
+        this.session = null;
+    }
+}
+function grokProviderError(msg) {
+    const message = (typeof msg["message"] === "string" && msg["message"]) ||
+        (typeof msg["error"] === "string" && msg["error"]) ||
+        "Grok TTS provider error";
+    return new Error(message);
+}
+function readPositiveInteger(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    const integer = Math.floor(value);
+    return integer > 0 ? integer : fallback;
+}
+function readPositiveIntegerOrUndefined(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    const integer = Math.floor(value);
+    return integer > 0 ? integer : undefined;
+}
+function readNonNegativeInteger(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    const integer = Math.floor(value);
+    return integer >= 0 ? integer : fallback;
+}
+//# sourceMappingURL=tts.js.map

package/dist/tts.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/grok",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "private": false,
   "description": "xAI Grok adapters for Syrinx — STT, TTS, and realtime",
   "keywords": [
@@ -23,29 +23,48 @@
     "url": "https://github.com/kuralle/syrinx/issues"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./stt": "./src/stt.ts",
-    "./tts": "./src/tts.ts",
-    "./realtime": "./src/from-grok-realtime.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./stt": {
+      "types": "./dist/stt.d.ts",
+      "default": "./dist/stt.js"
+    },
+    "./tts": {
+      "types": "./dist/tts.d.ts",
+      "default": "./dist/tts.js"
+    },
+    "./realtime": {
+      "types": "./dist/from-grok-realtime.d.ts",
+      "default": "./dist/from-grok-realtime.js"
+    }
   },
   "dependencies": {
-    "@kuralle-syrinx/realtime": "4.4.0",
-    "@kuralle-syrinx/core": "4.4.0",
-    "@kuralle-syrinx/tts-core": "4.4.0",
-    "@kuralle-syrinx/stt-core": "4.4.0",
-    "@kuralle-syrinx/ws": "4.4.0"
+    "@kuralle-syrinx/realtime": "4.5.0",
+    "@kuralle-syrinx/stt-core": "4.5.0",
+    "@kuralle-syrinx/ws": "4.5.0",
+    "@kuralle-syrinx/tts-core": "4.5.0",
+    "@kuralle-syrinx/core": "4.5.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@types/ws": "^8.5.0",
     "typescript": "^5.7.0",
     "vitest": "^3.2.6",
     "ws": "^8.21.0"
   },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
   }
 }