@spekoai/sdk 0.0.3 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-04-26
+
+### Added
+
+- `RoutingIntent.region` — optional string forwarded to the gateway as
+  `intent.region`. Set when latency to a specific geography matters
+  (e.g. `'us-east4'`, `'eu-west1'`); STT/TTS rankings differ per
+  region. Omitting it preserves the previous behaviour: the server
+  defaults to `'global'`, which surfaces the region-agnostic (batch)
+  benchmark rows. Plumbed through `transcribe()`, `synthesize()`, and
+  `complete({ intent })`.
+
+## [0.2.0] - 2026-04-26
+
+### Removed
+
+- **BREAKING**: `RoutingIntent.vertical` removed (and the `Vertical`
+  union type along with it). The router now ranks on
+  `(language, optimizeFor)` only. Callers passing `vertical` will fail
+  to type-check; the gateway also rejects the field. Old persisted
+  session pipeline configs containing `vertical` are tolerated server-
+  side.
+
 ## [0.0.3] - 2026-04-13
 
 ### Fixed

package/README.md

@@ -3,8 +3,8 @@
 Official TypeScript SDK for [Speko](https://speko.ai) — one API, every voice provider.
 
 Speko is a voice AI gateway that benchmarks every STT, LLM, and TTS provider
-across languages and verticals, then routes each request to the best provider
-in real time. Failover is handled. You write one integration; Speko picks the
+across languages, then routes each request to the best provider in real
+time. Failover is handled. You write one integration; Speko picks the
 right provider for every call.
 
 ## Installation
@@ -25,23 +25,22 @@ import { readFile } from 'node:fs/promises';
 
 const speko = new Speko({ apiKey: process.env.SPEKO_API_KEY });
 
-// Transcribe — best STT provider auto-routed for your language + vertical
+// Transcribe — best STT provider auto-routed for your language
 const audio = await readFile('./call.wav');
 const { text, provider, confidence } = await speko.transcribe(audio, {
   language: 'es-MX',
-  vertical: 'healthcare',
+  region: 'us-east4', // optional — rank streaming providers in this region
 });
 
 // Synthesize — best TTS provider auto-routed
 const speech = await speko.synthesize('Hello world', {
   language: 'en',
-  vertical: 'general',
 });
 
 // Complete — best LLM provider auto-routed
 const { text: reply } = await speko.complete({
   messages: [{ role: 'user', content: 'Hi!' }],
-  intent: { language: 'en', vertical: 'general' },
+  intent: { language: 'en' },
 });
 ```
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { Speko } from './lib/client.js';
 export { SpekoApiError, SpekoAuthError, SpekoRateLimitError } from './lib/errors.js';
-export type { SpekoClientOptions, PipelineConfig, CreateSessionParams, Session, SessionDetail, UsageSummary, UsageByProvider, UsageQueryParams, Vertical, OptimizeFor, RoutingIntent, TranscribeOptions, TranscribeResult, SynthesizeOptions, SynthesizeResult, ChatMessage, CompleteParams, CompleteResult, } from './lib/types/index.js';
+export type { SpekoClientOptions, KeySource, UsageSummary, UsageByProvider, UsageQueryParams, OrganizationBalance, CreditLedgerEntry, CreditLedgerKind, CreditLedgerPage, CreditLedgerQueryParams, OptimizeFor, RoutingIntent, PipelineConstraints, TranscribeOptions, TranscribeResult, SynthesizeOptions, SynthesizeResult, ChatMessage, CompleteParams, CompleteResult, RealtimeProvider, RealtimeToolSpec, RealtimeConnectParams, RealtimeFrame, RealtimeEventHandler, RealtimeSessionHandle, } from './lib/types/index.js';
 //# sourceMappingURL=index.d.ts.map

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,iBAAiB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrF,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACrF,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/lib/client.d.ts

@@ -1,6 +1,7 @@
 import type { CompleteParams, CompleteResult, SpekoClientOptions, SynthesizeOptions, SynthesizeResult, TranscribeOptions, TranscribeResult } from './types/index.js';
-import { Sessions } from './resources/sessions.js';
 import { Usage } from './resources/usage.js';
+import { Credits } from './resources/credits.js';
+import { Realtime } from './resources/realtime.js';
 /**
  * Speko client — one API, every voice provider.
  *
@@ -12,21 +13,20 @@ import { Usage } from './resources/usage.js';
  *
  * const { text, provider } = await speko.transcribe(audioBytes, {
  *   language: 'es-MX',
- *   vertical: 'healthcare',
  * });
  * ```
  */
 export declare class Speko {
-    /** Real-time voice sessions over LiveKit (back-compat path). */
-    readonly sessions: Sessions;
     readonly usage: Usage;
+    readonly credits: Credits;
+    readonly realtime: Realtime;
     private readonly transcribeResource;
     private readonly synthesizeResource;
     private readonly completeResource;
     constructor(options: SpekoClientOptions);
     /**
      * Transcribe audio. The router picks the best STT provider for your
-     * `(language, vertical, optimizeFor)` and fails over automatically.
+     * `(language, optimizeFor)` and fails over automatically.
      *
      * Pass an `AbortSignal` to cancel the in-flight request — useful when a
      * calling framework (e.g. LiveKit Agents) tears down a session mid-call.

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAQ7C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,KAAK;IAChB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;gBAEhC,OAAO,EAAE,kBAAkB;IAoBvC;;;;;;OAMG;IACH,UAAU,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;;OAIG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,cAAc,CAAC;CAG3B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAIjD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAKnD;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;gBAEhC,OAAO,EAAE,kBAAkB;IAqBvC;;;;;;OAMG;IACH,UAAU,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;;OAIG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,cAAc,EACtB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,cAAc,CAAC;CAG3B"}

package/dist/lib/client.js

@@ -1,9 +1,10 @@
 import { HttpClient } from './http.js';
-import { Sessions } from './resources/sessions.js';
 import { Usage } from './resources/usage.js';
+import { Credits } from './resources/credits.js';
 import { Transcribe } from './resources/transcribe.js';
 import { Synthesize } from './resources/synthesize.js';
 import { Complete } from './resources/complete.js';
+import { Realtime } from './resources/realtime.js';
 const DEFAULT_BASE_URL = 'https://api.speko.ai';
 const DEFAULT_TIMEOUT = 30_000;
 /**
@@ -17,14 +18,13 @@ const DEFAULT_TIMEOUT = 30_000;
  *
  * const { text, provider } = await speko.transcribe(audioBytes, {
  *   language: 'es-MX',
- *   vertical: 'healthcare',
  * });
  * ```
  */
 export class Speko {
-    /** Real-time voice sessions over LiveKit (back-compat path). */
-    sessions;
     usage;
+    credits;
+    realtime;
     transcribeResource;
     synthesizeResource;
     completeResource;
@@ -37,15 +37,16 @@ export class Speko {
             apiKey: options.apiKey,
             timeout: options.timeout ?? DEFAULT_TIMEOUT,
         });
-        this.sessions = new Sessions(http);
         this.usage = new Usage(http);
+        this.credits = new Credits(http);
+        this.realtime = new Realtime(http);
         this.transcribeResource = new Transcribe(http);
         this.synthesizeResource = new Synthesize(http);
         this.completeResource = new Complete(http);
     }
     /**
      * Transcribe audio. The router picks the best STT provider for your
-     * `(language, vertical, optimizeFor)` and fails over automatically.
+     * `(language, optimizeFor)` and fails over automatically.
      *
      * Pass an `AbortSignal` to cancel the in-flight request — useful when a
      * calling framework (e.g. LiveKit Agents) tears down a session mid-call.

package/dist/lib/resources/complete.d.ts

@@ -5,13 +5,13 @@ export declare class Complete {
     constructor(http: HttpClient);
     /**
      * Run an LLM completion. The Speko router picks the best provider for your
-     * `(language, vertical, optimizeFor)` and falls over automatically.
+     * `(language, optimizeFor)` and falls over automatically.
      *
      * @example
      * ```ts
      * const { text, provider } = await speko.complete({
      *   messages: [{ role: 'user', content: 'Hi!' }],
-     *   intent: { language: 'en', vertical: 'general' },
+     *   intent: { language: 'en' },
      * });
      * ```
      */

package/dist/lib/resources/complete.js

@@ -5,13 +5,13 @@ export class Complete {
     }
     /**
      * Run an LLM completion. The Speko router picks the best provider for your
-     * `(language, vertical, optimizeFor)` and falls over automatically.
+     * `(language, optimizeFor)` and falls over automatically.
      *
      * @example
      * ```ts
      * const { text, provider } = await speko.complete({
      *   messages: [{ role: 'user', content: 'Hi!' }],
-     *   intent: { language: 'en', vertical: 'general' },
+     *   intent: { language: 'en' },
      * });
      * ```
      */

package/dist/lib/resources/credits.d.ts

@@ -0,0 +1,28 @@
+import type { HttpClient } from '../http.js';
+import type { CreditLedgerPage, CreditLedgerQueryParams, OrganizationBalance } from '../types/index.js';
+/**
+ * Prepaid credit balance + append-only ledger. Balance is reported in
+ * micro-USD (`1_000_000` µ$ = $1) alongside a float USD helper.
+ */
+export declare class Credits {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Current credit balance for the caller's organization.
+     *
+     * @example
+     * ```ts
+     * const { balanceUsd } = await speko.credits.getBalance();
+     * if (balanceUsd < 0.5) showLowBalanceBanner();
+     * ```
+     */
+    getBalance(): Promise<OrganizationBalance>;
+    /**
+     * Most-recent-first page of credit movements (grants, debits, topups,
+     * refunds, adjustments). `nextCursor` is the `createdAt` of the last
+     * entry on the current page — pass it back as `cursor` to fetch the
+     * next page; `null` means no more pages.
+     */
+    getLedger(params?: CreditLedgerQueryParams): Promise<CreditLedgerPage>;
+}
+//# sourceMappingURL=credits.d.ts.map

package/dist/lib/resources/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/credits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;OAQG;IACH,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI1C;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAUvE"}

package/dist/lib/resources/credits.js

@@ -0,0 +1,37 @@
+/**
+ * Prepaid credit balance + append-only ledger. Balance is reported in
+ * micro-USD (`1_000_000` µ$ = $1) alongside a float USD helper.
+ */
+export class Credits {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Current credit balance for the caller's organization.
+     *
+     * @example
+     * ```ts
+     * const { balanceUsd } = await speko.credits.getBalance();
+     * if (balanceUsd < 0.5) showLowBalanceBanner();
+     * ```
+     */
+    getBalance() {
+        return this.http.get('/v1/credits/balance');
+    }
+    /**
+     * Most-recent-first page of credit movements (grants, debits, topups,
+     * refunds, adjustments). `nextCursor` is the `createdAt` of the last
+     * entry on the current page — pass it back as `cursor` to fetch the
+     * next page; `null` means no more pages.
+     */
+    getLedger(params) {
+        const query = new URLSearchParams();
+        if (params?.limit)
+            query.set('limit', String(params.limit));
+        if (params?.cursor)
+            query.set('cursor', params.cursor);
+        const qs = query.toString();
+        return this.http.get(`/v1/credits/ledger${qs ? `?${qs}` : ''}`);
+    }
+}

package/dist/lib/resources/realtime.d.ts

@@ -0,0 +1,15 @@
+import type { HttpClient } from '../http.js';
+import type { RealtimeConnectParams, RealtimeSessionHandle } from '../types/index.js';
+export declare class Realtime {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Open a speech-to-speech session. Posts `/v1/sessions` with `mode: 's2s'`
+     * to mint a short-lived WebSocket token, then opens a direct WS to the
+     * server's S2S proxy. The proxy bridges to the underlying provider
+     * (OpenAI Realtime, Gemini Live, xAI Grok Voice) so the client sees a
+     * single transport regardless of which backend is in use.
+     */
+    connect(params: RealtimeConnectParams): Promise<RealtimeSessionHandle>;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/lib/resources/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,qBAAqB,EAGrB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAU3B,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA2B7E"}

package/dist/lib/resources/realtime.js

@@ -0,0 +1,173 @@
+export class Realtime {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Open a speech-to-speech session. Posts `/v1/sessions` with `mode: 's2s'`
+     * to mint a short-lived WebSocket token, then opens a direct WS to the
+     * server's S2S proxy. The proxy bridges to the underlying provider
+     * (OpenAI Realtime, Gemini Live, xAI Grok Voice) so the client sees a
+     * single transport regardless of which backend is in use.
+     */
+    async connect(params) {
+        const response = await this.http.post('/v1/sessions', {
+            mode: 's2s',
+            s2s: {
+                provider: params.provider,
+                model: params.model,
+                voice: params.voice,
+                systemPrompt: params.systemPrompt,
+                temperature: params.temperature,
+                inputSampleRate: params.inputSampleRate,
+                outputSampleRate: params.outputSampleRate,
+                tools: params.tools,
+            },
+            metadata: params.metadata,
+            ttlSeconds: params.ttlSeconds,
+        });
+        return new BrowserRealtimeHandle(response.sessionId, response.wsUrl, response.wsToken, response.expiresAt);
+    }
+}
+class BrowserRealtimeHandle {
+    sessionId;
+    expiresAt;
+    ws;
+    handlers = new Set();
+    closed = false;
+    constructor(sessionId, wsUrl, wsToken, expiresAt) {
+        this.sessionId = sessionId;
+        this.expiresAt = expiresAt;
+        // Pass the token as the first subprotocol — browsers can't set headers
+        // on `new WebSocket()`, so subprotocol is the only auth carrier that
+        // doesn't leak through URL params.
+        this.ws = new WebSocket(wsUrl, [wsToken]);
+        this.ws.binaryType = 'arraybuffer';
+        this.ws.addEventListener('message', (evt) => {
+            this.dispatchIncoming(evt.data);
+        });
+        this.ws.addEventListener('close', (evt) => {
+            this.closed = true;
+            this.emit({ type: 'close', code: evt.code, reason: evt.reason });
+        });
+        this.ws.addEventListener('error', () => {
+            this.emit({
+                type: 'error',
+                code: 'WS_ERROR',
+                message: 'WebSocket transport error',
+            });
+        });
+    }
+    sendAudio(pcm) {
+        if (this.closed || this.ws.readyState !== 1)
+            return;
+        // Copy to ensure we send a plain ArrayBuffer, not a typed-array view that
+        // might alias a SharedArrayBuffer.
+        const copy = new Uint8Array(pcm.byteLength);
+        copy.set(pcm);
+        this.ws.send(copy.buffer);
+    }
+    commit() {
+        this.sendControl('commit');
+    }
+    interrupt() {
+        this.sendJson({ t: 'interrupt' });
+    }
+    sendToolResult(callId, output) {
+        this.sendJson({ t: 'tool_result', callId, output });
+    }
+    on(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    close(code = 1000, reason = 'client_closed') {
+        if (this.closed)
+            return;
+        this.closed = true;
+        try {
+            this.ws.close(code, reason);
+        }
+        catch {
+            // ignore
+        }
+    }
+    sendControl(action) {
+        this.sendJson({ t: 'control', action });
+    }
+    sendJson(payload) {
+        if (this.closed || this.ws.readyState !== 1)
+            return;
+        try {
+            this.ws.send(JSON.stringify(payload));
+        }
+        catch {
+            // ignore
+        }
+    }
+    dispatchIncoming(data) {
+        if (data instanceof ArrayBuffer) {
+            this.emit({
+                type: 'audio',
+                pcm: new Uint8Array(data),
+                sampleRate: 24000,
+            });
+            return;
+        }
+        if (typeof data !== 'string')
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        const t = parsed['t'];
+        switch (t) {
+            case 'transcript':
+                this.emit({
+                    type: 'transcript',
+                    role: parsed['role'],
+                    text: String(parsed['text'] ?? ''),
+                    final: Boolean(parsed['final']),
+                });
+                break;
+            case 'tool_call':
+                this.emit({
+                    type: 'tool_call',
+                    callId: String(parsed['callId'] ?? ''),
+                    name: String(parsed['name'] ?? ''),
+                    arguments: String(parsed['arguments'] ?? ''),
+                });
+                break;
+            case 'usage':
+                this.emit({
+                    type: 'usage',
+                    inputAudioTokens: Number(parsed['inputAudioTokens'] ?? 0),
+                    outputAudioTokens: Number(parsed['outputAudioTokens'] ?? 0),
+                });
+                break;
+            case 'error':
+                this.emit({
+                    type: 'error',
+                    code: String(parsed['code'] ?? 'UNKNOWN'),
+                    message: String(parsed['message'] ?? ''),
+                });
+                break;
+            default:
+                break;
+        }
+    }
+    emit(frame) {
+        for (const handler of this.handlers) {
+            try {
+                handler(frame);
+            }
+            catch {
+                // swallow — a misbehaving handler shouldn't break the pump
+            }
+        }
+    }
+}

package/dist/lib/resources/synthesize.d.ts

@@ -5,7 +5,7 @@ export declare class Synthesize {
     constructor(http: HttpClient);
     /**
      * Synthesize text into audio. The Speko router picks the best TTS provider
-     * for your `(language, vertical, optimizeFor)` and falls over automatically.
+     * for your `(language, optimizeFor)` and falls over automatically.
      *
      * The returned audio's format depends on the chosen provider — check the
      * `contentType` field on the result. ElevenLabs returns `audio/mpeg`,
@@ -15,7 +15,6 @@ export declare class Synthesize {
      * ```ts
      * const result = await speko.synthesize('Hello world', {
      *   language: 'en',
-     *   vertical: 'general',
      * });
      * await writeFile(`out.${result.contentType.includes('mpeg') ? 'mp3' : 'pcm'}`, result.audio);
      * ```

package/dist/lib/resources/synthesize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/synthesize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;;;OAgBG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;CA2B7B"}
+{"version":3,"file":"synthesize.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/synthesize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;CA4B7B"}

package/dist/lib/resources/synthesize.js

@@ -5,7 +5,7 @@ export class Synthesize {
     }
     /**
      * Synthesize text into audio. The Speko router picks the best TTS provider
-     * for your `(language, vertical, optimizeFor)` and falls over automatically.
+     * for your `(language, optimizeFor)` and falls over automatically.
      *
      * The returned audio's format depends on the chosen provider — check the
      * `contentType` field on the result. ElevenLabs returns `audio/mpeg`,
@@ -15,7 +15,6 @@ export class Synthesize {
      * ```ts
      * const result = await speko.synthesize('Hello world', {
      *   language: 'en',
-     *   vertical: 'general',
      * });
      * await writeFile(`out.${result.contentType.includes('mpeg') ? 'mp3' : 'pcm'}`, result.audio);
      * ```
@@ -23,7 +22,7 @@ export class Synthesize {
     async call(text, options, abortSignal) {
         const intent = {
             language: options.language,
-            vertical: options.vertical,
+            ...(options.region !== undefined && { region: options.region }),
             ...(options.optimizeFor !== undefined && { optimizeFor: options.optimizeFor }),
         };
         const body = { text, intent };
@@ -31,6 +30,8 @@ export class Synthesize {
             body['voice'] = options.voice;
         if (options.speed !== undefined)
             body['speed'] = options.speed;
+        if (options.constraints !== undefined)
+            body['constraints'] = options.constraints;
         const { bytes, headers } = await this.http.requestBinary('POST', '/v1/synthesize', body, abortSignal);
         return {
             audio: bytes,

package/dist/lib/resources/transcribe.d.ts

@@ -5,14 +5,13 @@ export declare class Transcribe {
     constructor(http: HttpClient);
     /**
      * Transcribe audio. The Speko router picks the best STT provider for
-     * your `(language, vertical, optimizeFor)` and falls over automatically.
+     * your `(language, optimizeFor)` and falls over automatically.
      *
      * @example
      * ```ts
      * const audio = await readFile('./call.wav');
      * const { text, provider, confidence } = await speko.transcribe(audio, {
      *   language: 'es-MX',
-     *   vertical: 'healthcare',
      * });
      * ```
      */

package/dist/lib/resources/transcribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;OAYG;IACG,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;CAkB7B"}
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;OAWG;IACG,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;CAuB7B"}

package/dist/lib/resources/transcribe.js

@@ -5,26 +5,29 @@ export class Transcribe {
     }
     /**
      * Transcribe audio. The Speko router picks the best STT provider for
-     * your `(language, vertical, optimizeFor)` and falls over automatically.
+     * your `(language, optimizeFor)` and falls over automatically.
      *
      * @example
      * ```ts
      * const audio = await readFile('./call.wav');
      * const { text, provider, confidence } = await speko.transcribe(audio, {
      *   language: 'es-MX',
-     *   vertical: 'healthcare',
      * });
      * ```
      */
     async call(audio, options, abortSignal) {
         const intent = {
             language: options.language,
-            vertical: options.vertical,
+            ...(options.region !== undefined && { region: options.region }),
             ...(options.optimizeFor !== undefined && { optimizeFor: options.optimizeFor }),
         };
-        return this.http.requestRaw('POST', '/v1/transcribe', audio, {
+        const headers = {
             'Content-Type': options.contentType ?? 'audio/wav',
             'X-Speko-Intent': JSON.stringify(intent),
-        }, abortSignal);
+        };
+        if (options.constraints) {
+            headers['X-Speko-Constraints'] = JSON.stringify(options.constraints);
+        }
+        return this.http.requestRaw('POST', '/v1/transcribe', audio, headers, abortSignal);
     }
 }

package/dist/lib/types/index.d.ts

@@ -7,65 +7,23 @@ export interface SpekoClientOptions {
     /** Request timeout in milliseconds. Defaults to 30000. */
     timeout?: number;
 }
-/** Pipeline configuration for a voice session. */
-export interface PipelineConfig {
-    stt: {
-        provider: string;
-        model?: string;
-        language?: string;
-        keywords?: string[];
-    };
-    llm: {
-        provider: string;
-        model: string;
-        systemPrompt?: string;
-        temperature?: number;
-        maxTokens?: number;
-    };
-    tts: {
-        provider: string;
-        voice: string;
-        model?: string;
-        speed?: number;
-    };
-}
-/** Parameters for creating a session. */
-export interface CreateSessionParams {
-    pipeline: PipelineConfig;
-    metadata?: Record<string, unknown>;
-}
-/** A voice session returned by the API. */
-export interface Session {
-    id: string;
-    status: 'created' | 'connecting' | 'active' | 'ended' | 'failed';
-    roomName: string;
-    token: string;
-    livekitUrl: string;
-    createdAt: string;
-}
-/** A session detail object. */
-export interface SessionDetail {
-    id: string;
-    workspaceId: string;
-    status: 'created' | 'connecting' | 'active' | 'ended' | 'failed';
-    roomName: string;
-    pipelineConfig: PipelineConfig;
-    metadata: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-    endedAt: string | null;
-}
+/** BYOK = customer key, no Speko charge. MANAGED = platform key, billed. */
+export type KeySource = 'BYOK' | 'MANAGED';
 /** Usage record for a workspace. */
 export interface UsageSummary {
     totalSessions: number;
     totalMinutes: number;
     totalCost: number;
     breakdown: UsageByProvider[];
+    /** Current organization balance in micro-USD (1_000_000 µ$ = $1), as string. */
+    balanceMicroUsd: string;
+    balanceUsd: number;
 }
 export interface UsageByProvider {
     provider: string;
     type: 'stt' | 'llm' | 'tts';
     metric: string;
+    keySource: KeySource;
     quantity: number;
     cost: number;
 }
@@ -76,20 +34,63 @@ export interface UsageQueryParams {
     /** End date (ISO 8601). */
     to?: string;
 }
-/** Vertical labels supported by the router. */
-export type Vertical = 'general' | 'healthcare' | 'finance' | 'legal';
+/** Current prepaid credit balance. */
+export interface OrganizationBalance {
+    balanceMicroUsd: string;
+    balanceUsd: number;
+    updatedAt: string;
+}
+export type CreditLedgerKind = 'grant' | 'debit' | 'topup' | 'refund' | 'adjustment';
+export interface CreditLedgerEntry {
+    id: string;
+    kind: CreditLedgerKind;
+    /** Signed. Positive for grants/topups/refunds, negative for debits. */
+    amountMicroUsd: string;
+    metric: string | null;
+    provider: string | null;
+    sessionId: string | null;
+    createdAt: string;
+}
+export interface CreditLedgerPage {
+    entries: CreditLedgerEntry[];
+    /** Pass back as `cursor` for the next page, or null if exhausted. */
+    nextCursor: string | null;
+}
+export interface CreditLedgerQueryParams {
+    limit?: number;
+    cursor?: string;
+}
 /** Optimization preset that biases the router's weighted score. */
 export type OptimizeFor = 'balanced' | 'accuracy' | 'latency' | 'cost';
 /** Routing intent passed to the proxy primitives. */
 export interface RoutingIntent {
     /** BCP-47 language tag, e.g. "en" or "es-MX". */
     language: string;
-    vertical: Vertical;
+    /**
+     * Region to rank streaming providers in (e.g. `"us-east4"`, `"eu-west1"`).
+     * Defaults to `"global"` on the server, which surfaces region-agnostic
+     * (batch) benchmark rows. Set this when latency to a specific
+     * geography matters — STT/TTS rankings differ per region.
+     */
+    region?: string;
     optimizeFor?: OptimizeFor;
 }
+/**
+ * Optional constraints layered on top of `RoutingIntent`. The router still
+ * ranks candidates by benchmark score — but if `allowedProviders[modality]`
+ * is set and non-empty, it only considers that subset.
+ */
+export interface PipelineConstraints {
+    allowedProviders?: {
+        stt?: string[];
+        llm?: string[];
+        tts?: string[];
+    };
+}
 export interface TranscribeOptions extends RoutingIntent {
     /** MIME type of the audio body. Defaults to "audio/wav". */
     contentType?: string;
+    constraints?: PipelineConstraints;
 }
 export interface TranscribeResult {
     text: string;
@@ -103,6 +104,7 @@ export interface SynthesizeOptions extends RoutingIntent {
     /** Optional voice override. Otherwise the SDK uses each provider's default. */
     voice?: string;
     speed?: number;
+    constraints?: PipelineConstraints;
 }
 export interface SynthesizeResult {
     /** Raw audio bytes. Format depends on the chosen provider — see `contentType`. */
@@ -124,6 +126,7 @@ export interface CompleteParams {
     systemPrompt?: string;
     temperature?: number;
     maxTokens?: number;
+    constraints?: PipelineConstraints;
 }
 export interface CompleteResult {
     text: string;
@@ -136,4 +139,71 @@ export interface CompleteResult {
     failoverCount: number;
     scoresRunId: string | null;
 }
+export type RealtimeProvider = 'openai' | 'google' | 'xai';
+export interface RealtimeToolSpec {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface RealtimeConnectParams {
+    provider: RealtimeProvider;
+    model: string;
+    voice?: string;
+    systemPrompt?: string;
+    temperature?: number;
+    inputSampleRate?: 16000 | 24000;
+    outputSampleRate?: 16000 | 24000;
+    tools?: RealtimeToolSpec[];
+    metadata?: Record<string, unknown>;
+    /** Max session duration in seconds. Server-capped at 1800 (30 min). */
+    ttlSeconds?: number;
+}
+/**
+ * Event shape emitted by a `RealtimeSessionHandle`. Binary audio comes in
+ * as `audio` frames; text control messages come through typed variants.
+ */
+export type RealtimeFrame = {
+    type: 'audio';
+    pcm: Uint8Array;
+    sampleRate: number;
+} | {
+    type: 'transcript';
+    role: 'user' | 'assistant';
+    text: string;
+    final: boolean;
+} | {
+    type: 'tool_call';
+    callId: string;
+    name: string;
+    arguments: string;
+} | {
+    type: 'usage';
+    inputAudioTokens: number;
+    outputAudioTokens: number;
+} | {
+    type: 'error';
+    code: string;
+    message: string;
+} | {
+    type: 'close';
+    code: number;
+    reason: string;
+};
+export type RealtimeEventHandler = (frame: RealtimeFrame) => void;
+export interface RealtimeSessionHandle {
+    readonly sessionId: string;
+    readonly expiresAt: string;
+    /** Send a PCM16 audio chunk up to the model. */
+    sendAudio(pcm: Uint8Array): void;
+    /** Signal user-turn boundary / commit the input buffer. */
+    commit(): void;
+    /** Interrupt the current assistant response. */
+    interrupt(): void;
+    /** Return a previously-requested tool call result. */
+    sendToolResult(callId: string, output: string): void;
+    /** Subscribe to frames. Returns an unsubscribe callback. */
+    on(handler: RealtimeEventHandler): () => void;
+    /** Close the session. Safe to call multiple times. */
+    close(code?: number, reason?: string): void;
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/types/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spekoai/sdk",
-  "version": "0.0.3",
+  "version": "0.2.1",
   "description": "Official Speko TypeScript SDK — one API, every voice provider",
   "license": "MIT",
   "author": "Speko",

package/dist/lib/resources/sessions.d.ts

@@ -1,44 +0,0 @@
-import type { HttpClient } from '../http.js';
-import type { CreateSessionParams, Session, SessionDetail } from '../types/index.js';
-export declare class Sessions {
-    private readonly http;
-    constructor(http: HttpClient);
-    /**
-     * Create a new voice session.
-     *
-     * @example
-     * ```ts
-     * const session = await speko.sessions.create({
-     *   pipeline: {
-     *     stt: { provider: 'deepgram' },
-     *     llm: { provider: 'openai', model: 'gpt-4o' },
-     *     tts: { provider: 'elevenlabs', voice: 'rachel' },
-     *   },
-     * });
-     * console.log(session.token); // Use to connect via LiveKit
-     * ```
-     */
-    create(params: CreateSessionParams): Promise<Session>;
-    /**
-     * Get a session by ID.
-     *
-     * @example
-     * ```ts
-     * const session = await speko.sessions.get('sess_abc123');
-     * ```
-     */
-    get(sessionId: string): Promise<SessionDetail>;
-    /**
-     * End an active session.
-     *
-     * @example
-     * ```ts
-     * await speko.sessions.end('sess_abc123');
-     * ```
-     */
-    end(sessionId: string): Promise<{
-        id: string;
-        status: string;
-    }>;
-}
-//# sourceMappingURL=sessions.d.ts.map

package/dist/lib/resources/sessions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,mBAAmB,EACnB,OAAO,EACP,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAKtE"}

package/dist/lib/resources/sessions.js

@@ -1,46 +0,0 @@
-export class Sessions {
-    http;
-    constructor(http) {
-        this.http = http;
-    }
-    /**
-     * Create a new voice session.
-     *
-     * @example
-     * ```ts
-     * const session = await speko.sessions.create({
-     *   pipeline: {
-     *     stt: { provider: 'deepgram' },
-     *     llm: { provider: 'openai', model: 'gpt-4o' },
-     *     tts: { provider: 'elevenlabs', voice: 'rachel' },
-     *   },
-     * });
-     * console.log(session.token); // Use to connect via LiveKit
-     * ```
-     */
-    async create(params) {
-        return this.http.post('/v1/sessions', params);
-    }
-    /**
-     * Get a session by ID.
-     *
-     * @example
-     * ```ts
-     * const session = await speko.sessions.get('sess_abc123');
-     * ```
-     */
-    async get(sessionId) {
-        return this.http.get(`/v1/sessions/${sessionId}`);
-    }
-    /**
-     * End an active session.
-     *
-     * @example
-     * ```ts
-     * await speko.sessions.end('sess_abc123');
-     * ```
-     */
-    async end(sessionId) {
-        return this.http.delete(`/v1/sessions/${sessionId}`);
-    }
-}