@spekoai/sdk 0.0.3 → 0.3.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 0.3.0 (2026-05-02)
+
+### 🚀 Features
+
+- **adapter-livekit:** wire tool calls through /v1/complete ([#105](https://github.com/SpekoAI/platform/pull/105))
+- **dashboard:** /phone-numbers page — buy + edit + release US numbers ([ec3d541](https://github.com/SpekoAI/platform/commit/ec3d541))
+- **telephony:** Telnyx outbound + inbound + phone number CRUD ([c5cc1f0](https://github.com/SpekoAI/platform/commit/c5cc1f0))
+
+### ❤️ Thank You
+
+- Baymurat785 @Baymurat785
+- Claude Opus 4.7 (1M context)
+
 # Changelog
 
 All notable changes to `@spekoai/sdk` will be documented in this file.
@@ -7,6 +20,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, ChatTool, ChatToolCall, ChatToolChoice, CompleteParams, CompleteResult, RealtimeProvider, RealtimeToolSpec, RealtimeConnectParams, RealtimeFrame, RealtimeEventHandler, RealtimeSessionHandle, VoiceDialParams, VoiceDialResult, PhoneNumberDirection, PhoneNumberRow, PhoneNumberCreateParams, PhoneNumberUpdateParams, AvailablePhoneNumber, PhoneNumberSearchParams, } 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,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/lib/client.d.ts

@@ -1,6 +1,9 @@
 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';
+import { Voice } from './resources/voice.js';
+import { PhoneNumbers } from './resources/phone-numbers.js';
 /**
  * Speko client — one API, every voice provider.
  *
@@ -12,21 +15,22 @@ 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;
+    readonly voice: Voice;
+    readonly phoneNumbers: PhoneNumbers;
     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;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAK5D;;;;;;;;;;;;;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;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;gBAEhC,OAAO,EAAE,kBAAkB;IAuBvC;;;;;;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,12 @@
 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';
+import { Voice } from './resources/voice.js';
+import { PhoneNumbers } from './resources/phone-numbers.js';
 const DEFAULT_BASE_URL = 'https://api.speko.ai';
 const DEFAULT_TIMEOUT = 30_000;
 /**
@@ -17,14 +20,15 @@ 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;
+    voice;
+    phoneNumbers;
     transcribeResource;
     synthesizeResource;
     completeResource;
@@ -37,15 +41,18 @@ 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.voice = new Voice(http);
+        this.phoneNumbers = new PhoneNumbers(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/http.d.ts

@@ -13,6 +13,7 @@ export declare class HttpClient {
     get<T>(path: string, externalSignal?: AbortSignal): Promise<T>;
     post<T>(path: string, body: unknown, externalSignal?: AbortSignal): Promise<T>;
     delete<T>(path: string, externalSignal?: AbortSignal): Promise<T>;
+    patch<T>(path: string, body: unknown, externalSignal?: AbortSignal): Promise<T>;
     /**
      * Send raw bytes as the request body and parse a JSON response.
      * Used by `speko.transcribe()` to upload audio and receive a transcript.

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

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,iBAAiB;IAWhC,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IAsBP,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9D,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IAIP,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE;;;OAGG;IACG,UAAU,CAAC,CAAC,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,UAAU,EACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IA4Bb;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IA4BlE;;;;OAIG;IACH,OAAO,CAAC,WAAW;YA6BL,WAAW;CA4B1B"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,iBAAiB;IAWhC,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IAsBP,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9D,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IAIP,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjE,KAAK,CAAC,CAAC,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IAIb;;;OAGG;IACG,UAAU,CAAC,CAAC,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,UAAU,EACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,CAAC,CAAC;IA4Bb;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IA4BlE;;;;OAIG;IACH,OAAO,CAAC,WAAW;YA6BL,WAAW;CA4B1B"}

package/dist/lib/http.js

@@ -43,6 +43,9 @@ export class HttpClient {
     async delete(path, externalSignal) {
         return this.request('DELETE', path, undefined, externalSignal);
     }
+    async patch(path, body, externalSignal) {
+        return this.request('PATCH', path, body, externalSignal);
+    }
     /**
      * Send raw bytes as the request body and parse a JSON response.
      * Used by `speko.transcribe()` to upload audio and receive a transcript.

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/phone-numbers.d.ts

@@ -0,0 +1,49 @@
+import type { HttpClient } from '../http.js';
+import type { AvailablePhoneNumber, PhoneNumberCreateParams, PhoneNumberRow, PhoneNumberSearchParams, PhoneNumberUpdateParams } from '../types/index.js';
+/**
+ * Phone numbers Speko has provisioned (or imported) on Telnyx for your
+ * organization. Each number can be used for outbound dialing and/or
+ * inbound, and carries an optional metadata template that's merged into
+ * the worker dispatch payload when the number is used.
+ *
+ * @example
+ * ```ts
+ * // List org's numbers
+ * const numbers = await speko.phoneNumbers.list();
+ *
+ * // Provision a new US local number
+ * const num = await speko.phoneNumbers.create({
+ *   e164: '+12015551234',
+ *   direction: 'both',
+ *   label: 'Sales line',
+ *   dispatchMetadataTemplate: {
+ *     intent: { language: 'en', optimizeFor: 'latency' },
+ *     systemPrompt: 'You are a helpful sales agent for Acme.',
+ *   },
+ * });
+ * ```
+ */
+export declare class PhoneNumbers {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(): Promise<PhoneNumberRow[]>;
+    /**
+     * Search Telnyx's pool for orderable US numbers. Filter by area code
+     * and/or locality. Results include cost so you can preview "$1 upfront +
+     * $1/month" before committing to {@link create}.
+     *
+     * @example
+     * ```ts
+     * const candidates = await speko.phoneNumbers.searchAvailable({ areaCode: '415' });
+     * console.log(candidates[0].friendlyName); // "+1 (415) 555-0123"
+     * ```
+     */
+    searchAvailable(params?: PhoneNumberSearchParams): Promise<AvailablePhoneNumber[]>;
+    get(id: string): Promise<PhoneNumberRow>;
+    create(params: PhoneNumberCreateParams): Promise<PhoneNumberRow>;
+    update(id: string, params: PhoneNumberUpdateParams): Promise<PhoneNumberRow>;
+    delete(id: string): Promise<{
+        released: boolean;
+    }>;
+}
+//# sourceMappingURL=phone-numbers.d.ts.map

package/dist/lib/resources/phone-numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-numbers.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/phone-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjC;;;;;;;;;;OAUG;IACH,eAAe,CACb,MAAM,GAAE,uBAA4B,GACnC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAWlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMxC,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhE,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAO1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAKnD"}

package/dist/lib/resources/phone-numbers.js

@@ -0,0 +1,66 @@
+/**
+ * Phone numbers Speko has provisioned (or imported) on Telnyx for your
+ * organization. Each number can be used for outbound dialing and/or
+ * inbound, and carries an optional metadata template that's merged into
+ * the worker dispatch payload when the number is used.
+ *
+ * @example
+ * ```ts
+ * // List org's numbers
+ * const numbers = await speko.phoneNumbers.list();
+ *
+ * // Provision a new US local number
+ * const num = await speko.phoneNumbers.create({
+ *   e164: '+12015551234',
+ *   direction: 'both',
+ *   label: 'Sales line',
+ *   dispatchMetadataTemplate: {
+ *     intent: { language: 'en', optimizeFor: 'latency' },
+ *     systemPrompt: 'You are a helpful sales agent for Acme.',
+ *   },
+ * });
+ * ```
+ */
+export class PhoneNumbers {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list() {
+        return this.http.get('/v1/phone-numbers');
+    }
+    /**
+     * Search Telnyx's pool for orderable US numbers. Filter by area code
+     * and/or locality. Results include cost so you can preview "$1 upfront +
+     * $1/month" before committing to {@link create}.
+     *
+     * @example
+     * ```ts
+     * const candidates = await speko.phoneNumbers.searchAvailable({ areaCode: '415' });
+     * console.log(candidates[0].friendlyName); // "+1 (415) 555-0123"
+     * ```
+     */
+    searchAvailable(params = {}) {
+        const query = new URLSearchParams();
+        if (params.areaCode)
+            query.set('areaCode', params.areaCode);
+        if (params.locality)
+            query.set('locality', params.locality);
+        if (params.limit !== undefined)
+            query.set('limit', String(params.limit));
+        const qs = query.toString();
+        return this.http.get(`/v1/phone-numbers/available${qs ? `?${qs}` : ''}`);
+    }
+    get(id) {
+        return this.http.get(`/v1/phone-numbers/${encodeURIComponent(id)}`);
+    }
+    create(params) {
+        return this.http.post('/v1/phone-numbers', params);
+    }
+    update(id, params) {
+        return this.http.patch(`/v1/phone-numbers/${encodeURIComponent(id)}`, params);
+    }
+    delete(id) {
+        return this.http.delete(`/v1/phone-numbers/${encodeURIComponent(id)}`);
+    }
+}

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
+            }
+        }
+    }
+}