@spekoai/sdk 0.4.0 → 0.4.2

package/dist/lib/resources/knowledge-bases.js

@@ -18,7 +18,7 @@ const DEFAULT_POLL_TIMEOUT_MS = 120_000;
  * const doc = await speko.knowledgeBases.uploadDocument(kb.id, {
  *   filename: 'faq.md',
  *   contentType: 'text/markdown',
- *   data: await Bun.file('faq.md').arrayBuffer(),
+ *   data: await readFile('faq.md'),
  * });
  *
  * const ready = await speko.knowledgeBases.pollDocumentReady(kb.id, doc.id);

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

@@ -1,10 +1,10 @@
 import type { HttpClient } from '../http.js';
-import type { AvailablePhoneNumber, PhoneNumberCreateParams, PhoneNumberRow, PhoneNumberSearchParams, PhoneNumberUpdateParams } from '../types/index.js';
+import type { AvailablePhoneNumber, PhoneNumberCreateParams, PhoneNumberImportSipTrunkParams, PhoneNumberKybDraftParams, PhoneNumberKybOverview, PhoneNumberKybSubmission, PhoneNumberKybSubmitParams, 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.
+ * Phone numbers Speko has provisioned as managed numbers or registered
+ * from your own SIP trunk. 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
@@ -28,7 +28,7 @@ export declare class PhoneNumbers {
     constructor(http: HttpClient);
     list(): Promise<PhoneNumberRow[]>;
     /**
-     * Search Telnyx's pool for orderable US numbers. Filter by area code
+     * Search the platform-managed 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}.
      *
@@ -41,9 +41,23 @@ export declare class PhoneNumbers {
     searchAvailable(params?: PhoneNumberSearchParams): Promise<AvailablePhoneNumber[]>;
     get(id: string): Promise<PhoneNumberRow>;
     create(params: PhoneNumberCreateParams): Promise<PhoneNumberRow>;
+    importSipTrunk(params: PhoneNumberImportSipTrunkParams): Promise<PhoneNumberRow>;
     update(id: string, params: PhoneNumberUpdateParams): Promise<PhoneNumberRow>;
     delete(id: string): Promise<{
         released: boolean;
     }>;
+    /**
+     * Read business verification state used to gate managed phone-number purchases.
+     * Includes the latest submission plus any SMS 10DLC-derived prefill.
+     */
+    getKyb(): Promise<PhoneNumberKybOverview>;
+    /**
+     * Save a draft business verification submission without sending it for review.
+     */
+    saveKybDraft(params: PhoneNumberKybDraftParams): Promise<PhoneNumberKybSubmission>;
+    /**
+     * Submit business verification for review. `attestationAccepted` must be `true`.
+     */
+    submitKyb(params: PhoneNumberKybSubmitParams): Promise<PhoneNumberKybSubmission>;
 }
 //# sourceMappingURL=phone-numbers.d.ts.map

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

@@ -1 +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"}
+{"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,+BAA+B,EAC/B,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,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,CAAC,MAAM,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAWtF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxC,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhE,cAAc,CAAC,MAAM,EAAE,+BAA+B,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAIlD;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAIzC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIlF;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAGjF"}

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

@@ -1,8 +1,8 @@
 /**
- * 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.
+ * Phone numbers Speko has provisioned as managed numbers or registered
+ * from your own SIP trunk. 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
@@ -30,7 +30,7 @@ export class PhoneNumbers {
         return this.http.get('/v1/phone-numbers');
     }
     /**
-     * Search Telnyx's pool for orderable US numbers. Filter by area code
+     * Search the platform-managed 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}.
      *
@@ -57,10 +57,32 @@ export class PhoneNumbers {
     create(params) {
         return this.http.post('/v1/phone-numbers', params);
     }
+    importSipTrunk(params) {
+        return this.http.post('/v1/phone-numbers/import', 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)}`);
     }
+    /**
+     * Read business verification state used to gate managed phone-number purchases.
+     * Includes the latest submission plus any SMS 10DLC-derived prefill.
+     */
+    getKyb() {
+        return this.http.get('/v1/phone-numbers/kyb');
+    }
+    /**
+     * Save a draft business verification submission without sending it for review.
+     */
+    saveKybDraft(params) {
+        return this.http.put('/v1/phone-numbers/kyb/draft', params);
+    }
+    /**
+     * Submit business verification for review. `attestationAccepted` must be `true`.
+     */
+    submitKyb(params) {
+        return this.http.post('/v1/phone-numbers/kyb/submit', params);
+    }
 }

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

@@ -7,7 +7,7 @@ export declare class Realtime {
      * 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
+     * (OpenAI Realtime, Gemini Live, xAI Grok Voice, Inworld) so the client sees a
      * single transport regardless of which backend is in use.
      */
     connect(params: RealtimeConnectParams): Promise<RealtimeSessionHandle>;

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

@@ -1 +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"}
+{"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;AAY3B,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;CA0B7E"}

package/dist/lib/resources/realtime.js

@@ -7,7 +7,7 @@ export class Realtime {
      * 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
+     * (OpenAI Realtime, Gemini Live, xAI Grok Voice, Inworld) so the client sees a
      * single transport regardless of which backend is in use.
      */
     async connect(params) {
@@ -26,18 +26,22 @@ export class Realtime {
             metadata: params.metadata,
             ttlSeconds: params.ttlSeconds,
         });
-        return new BrowserRealtimeHandle(response.sessionId, response.wsUrl, response.wsToken, response.expiresAt);
+        return new BrowserRealtimeHandle(response.sessionId, response.wsUrl, response.wsToken, response.expiresAt, response.inputSampleRate, response.outputSampleRate);
     }
 }
 class BrowserRealtimeHandle {
     sessionId;
     expiresAt;
+    inputSampleRate;
+    outputSampleRate;
     ws;
     handlers = new Set();
     closed = false;
-    constructor(sessionId, wsUrl, wsToken, expiresAt) {
+    constructor(sessionId, wsUrl, wsToken, expiresAt, inputSampleRate, outputSampleRate) {
         this.sessionId = sessionId;
         this.expiresAt = expiresAt;
+        this.inputSampleRate = inputSampleRate;
+        this.outputSampleRate = outputSampleRate;
         // 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.
@@ -134,6 +138,27 @@ class BrowserRealtimeHandle {
                     final: Boolean(parsed['final']),
                 });
                 break;
+            case 'ready':
+                this.emit({
+                    type: 'ready',
+                    inputSampleRate: Number(parsed['inputSampleRate'] ?? this.inputSampleRate),
+                    outputSampleRate: Number(parsed['outputSampleRate'] ?? this.outputSampleRate),
+                });
+                break;
+            case 'interruption':
+                this.emit({
+                    type: 'interruption',
+                    at: parsed['at'] === 'assistant' ? 'assistant' : 'user',
+                });
+                break;
+            case 'server_tool_call':
+                this.emit({
+                    type: 'server_tool_call',
+                    id: String(parsed['id'] ?? ''),
+                    name: String(parsed['name'] ?? ''),
+                    status: String(parsed['status'] ?? 'started'),
+                });
+                break;
             case 'tool_call':
                 this.emit({
                     type: 'tool_call',

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, optimizeFor)` and falls over automatically.
+     * for your `(language, region, 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`,

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,EAChB,sBAAsB,EACvB,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;IAiBtB,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,sBAAsB,CAAC;CAgCnC"}
+{"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,EAChB,sBAAsB,EACvB,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;IAiBtB,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,sBAAsB,CAAC;CAiCnC"}

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, optimizeFor)` and falls over automatically.
+     * for your `(language, region, 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`,
@@ -43,6 +43,8 @@ export class Synthesize {
         const body = { text, intent };
         if (options.voice !== undefined)
             body['voice'] = options.voice;
+        if (options.model !== undefined)
+            body['model'] = options.model;
         if (options.speed !== undefined)
             body['speed'] = options.speed;
         if (options.constraints !== undefined)

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

@@ -5,7 +5,7 @@ export declare class Transcribe {
     constructor(http: HttpClient);
     /**
      * Transcribe audio. The Speko router picks the best STT provider for
-     * your `(language, optimizeFor)` and falls over automatically.
+     * your `(language, region, optimizeFor)` and falls over automatically.
      *
      * @example
      * ```ts

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,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAG3B,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;IAsBrB,MAAM,CACX,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,qBAAqB,CAAC,qBAAqB,CAAC;CA+BhD"}
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/transcribe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEpG,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;IAsBrB,MAAM,CACX,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,qBAAqB,CAAC,qBAAqB,CAAC;CAkChD"}

package/dist/lib/resources/transcribe.js

@@ -6,7 +6,7 @@ export class Transcribe {
     }
     /**
      * Transcribe audio. The Speko router picks the best STT provider for
-     * your `(language, optimizeFor)` and falls over automatically.
+     * your `(language, region, optimizeFor)` and falls over automatically.
      *
      * @example
      * ```ts
@@ -58,7 +58,10 @@ export class Transcribe {
         }
         const stream = await this.http.requestRawSse('POST', '/v1/transcribe', audio, headers, abortSignal);
         for await (const event of stream) {
-            yield { ...event.data, type: event.event };
+            yield {
+                ...event.data,
+                type: event.event,
+            };
         }
     }
 }

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

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../http.js';
-import type { UsageSummary, UsageQueryParams } from '../types/index.js';
+import type { UsageQueryParams, UsageSummary } from '../types/index.js';
 export declare class Usage {
     private readonly http;
     constructor(http: HttpClient);

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

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;OAQG;IACG,GAAG,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CAU5D"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAExE,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;OAQG;IACG,GAAG,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CAQ5D"}

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

@@ -1,7 +1,7 @@
 import type { HttpClient } from '../http.js';
 import type { VoiceDialParams, VoiceDialResult } from '../types/index.js';
 /**
- * Outbound phone calls via Speko's Telnyx-backed gateway.
+ * Outbound phone calls via Speko's managed telephony gateway.
  *
  * @example
  * ```ts
@@ -19,10 +19,9 @@ export declare class Voice {
     /**
      * Place an outbound call. The destination's phone rings; once they pick
      * up, audio bridges to a Speko worker running the configured pipeline
-     * (STT→LLM→TTS) on a LiveKit room.
+     * (STT→LLM→TTS) on the media transport.
      *
-     * Lifecycle is observable via Telnyx webhooks (which Speko handles
-     * server-side) and reflected in the `voice_session` row's `status`.
+     * Lifecycle is reflected in the `voice_session` row's `status`.
      */
     dial(params: VoiceDialParams): Promise<VoiceDialResult>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;OAOG;IACG,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAG9D"}
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAG9D"}

package/dist/lib/resources/voice.js

@@ -1,5 +1,5 @@
 /**
- * Outbound phone calls via Speko's Telnyx-backed gateway.
+ * Outbound phone calls via Speko's managed telephony gateway.
  *
  * @example
  * ```ts
@@ -19,10 +19,9 @@ export class Voice {
     /**
      * Place an outbound call. The destination's phone rings; once they pick
      * up, audio bridges to a Speko worker running the configured pipeline
-     * (STT→LLM→TTS) on a LiveKit room.
+     * (STT→LLM→TTS) on the media transport.
      *
-     * Lifecycle is observable via Telnyx webhooks (which Speko handles
-     * server-side) and reflected in the `voice_session` row's `status`.
+     * Lifecycle is reflected in the `voice_session` row's `status`.
      */
     async dial(params) {
         return this.http.post('/v1/sessions/phone', params);

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

@@ -0,0 +1,27 @@
+import type { HttpClient } from '../http.js';
+import type { VoicesListParams, VoicesListResult } from '../types/index.js';
+/**
+ * Read-only TTS voice catalog. Use this to browse the curated list of
+ * voices per provider before calling `speko.synthesize` — handy for
+ * picking a voice id without reading each provider's API docs.
+ *
+ * ElevenLabs voices are account-scoped and are NOT returned by this
+ * endpoint; the response's `providers` array sets
+ * `voicesFetchedLive: true` on the elevenlabs entry as a signal to
+ * fetch them directly from ElevenLabs at runtime.
+ *
+ * @example
+ * ```ts
+ * // All voices, every provider:
+ * const { voices, providers } = await speko.voices.list();
+ *
+ * // Just Cartesia:
+ * const cartesia = await speko.voices.list({ provider: 'cartesia' });
+ * ```
+ */
+export declare class Voices {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: VoicesListParams): Promise<VoicesListResult>;
+}
+//# sourceMappingURL=voices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voices.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/voices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMjE"}

package/dist/lib/resources/voices.js

@@ -0,0 +1,32 @@
+/**
+ * Read-only TTS voice catalog. Use this to browse the curated list of
+ * voices per provider before calling `speko.synthesize` — handy for
+ * picking a voice id without reading each provider's API docs.
+ *
+ * ElevenLabs voices are account-scoped and are NOT returned by this
+ * endpoint; the response's `providers` array sets
+ * `voicesFetchedLive: true` on the elevenlabs entry as a signal to
+ * fetch them directly from ElevenLabs at runtime.
+ *
+ * @example
+ * ```ts
+ * // All voices, every provider:
+ * const { voices, providers } = await speko.voices.list();
+ *
+ * // Just Cartesia:
+ * const cartesia = await speko.voices.list({ provider: 'cartesia' });
+ * ```
+ */
+export class Voices {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list(params) {
+        const query = new URLSearchParams();
+        if (params?.provider)
+            query.set('provider', params.provider);
+        const qs = query.toString();
+        return this.http.get(`/v1/voices${qs ? `?${qs}` : ''}`);
+    }
+}