@spekoai/sdk 0.4.1 → 0.4.3

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/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

@@ -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/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}` : ''}`);
+    }
+}