@spekoai/sdk 0.3.0 → 0.4.1

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

@@ -1,8 +1,7 @@
 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.
+ * Prepaid credit balance + append-only ledger. Balance is reported in USD.
  */
 export declare class Credits {
     private readonly http;

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

@@ -1 +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"}
+{"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;;GAEG;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;CAQvE"}

package/dist/lib/resources/credits.js

@@ -1,6 +1,5 @@
 /**
- * Prepaid credit balance + append-only ledger. Balance is reported in
- * micro-USD (`1_000_000` µ$ = $1) alongside a float USD helper.
+ * Prepaid credit balance + append-only ledger. Balance is reported in USD.
  */
 export class Credits {
     http;

package/dist/lib/resources/knowledge-bases.d.ts

@@ -0,0 +1,60 @@
+import type { HttpClient } from '../http.js';
+import type { KnowledgeBaseCreateParams, KnowledgeBaseDocumentCreateParams, KnowledgeBaseDocumentCreateResult, KnowledgeBaseDocumentPollOptions, KnowledgeBaseDocumentRow, KnowledgeBaseDocumentUploadParams, KnowledgeBaseListParams, KnowledgeBaseRow } from '../types/index.js';
+/**
+ * Per-agent knowledge bases. Each KB owns documents that get embedded
+ * into a Chroma collection so the agent can retrieve relevant chunks
+ * during a call. Every agent created via {@link Agents.create}
+ * auto-provisions a `Default` KB; additional KBs can be created
+ * explicitly with {@link KnowledgeBases.create}.
+ *
+ * @example
+ * ```ts
+ * const kb = await speko.knowledgeBases.create({
+ *   agentId: agent.id,
+ *   name: 'Product FAQ',
+ * });
+ *
+ * const doc = await speko.knowledgeBases.uploadDocument(kb.id, {
+ *   filename: 'faq.md',
+ *   contentType: 'text/markdown',
+ *   data: await readFile('faq.md'),
+ * });
+ *
+ * const ready = await speko.knowledgeBases.pollDocumentReady(kb.id, doc.id);
+ * ```
+ */
+export declare class KnowledgeBases {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: KnowledgeBaseCreateParams): Promise<KnowledgeBaseRow>;
+    list(params?: KnowledgeBaseListParams): Promise<KnowledgeBaseRow[]>;
+    get(kbId: string): Promise<KnowledgeBaseRow>;
+    delete(kbId: string): Promise<{
+        deleted: boolean;
+    }>;
+    listDocuments(kbId: string): Promise<KnowledgeBaseDocumentRow[]>;
+    getDocument(kbId: string, docId: string): Promise<KnowledgeBaseDocumentRow>;
+    createDocument(kbId: string, params: KnowledgeBaseDocumentCreateParams): Promise<KnowledgeBaseDocumentCreateResult>;
+    finalizeDocument(kbId: string, docId: string): Promise<KnowledgeBaseDocumentRow>;
+    deleteDocument(kbId: string, docId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Convenience wrapper: register a document, upload its bytes to the
+     * signed PUT URL the server mints, then call finalize. Returns the
+     * document with status flipped to `processing`. Call
+     * {@link pollDocumentReady} to wait for ingest completion.
+     *
+     * The server's signed upload URL expires 600 seconds after issuance,
+     * so do not hold the result of {@link createDocument} for long before
+     * uploading. This wrapper performs all three steps back-to-back.
+     */
+    uploadDocument(kbId: string, params: KnowledgeBaseDocumentUploadParams): Promise<KnowledgeBaseDocumentRow>;
+    /**
+     * Poll a document until it reaches `ready` or `failed` status, or the
+     * timeout elapses. Throws {@link SpekoApiError} on `failed` (with the
+     * server's `errorMessage`) or on timeout.
+     */
+    pollDocumentReady(kbId: string, docId: string, opts?: KnowledgeBaseDocumentPollOptions): Promise<KnowledgeBaseDocumentRow>;
+}
+//# sourceMappingURL=knowledge-bases.d.ts.map

package/dist/lib/resources/knowledge-bases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bases.d.ts","sourceRoot":"","sources":["../../../src/lib/resources/knowledge-bases.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,gCAAgC,EAChC,wBAAwB,EACxB,iCAAiC,EACjC,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIpE,IAAI,CAAC,MAAM,GAAE,uBAA4B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAOvE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAMnD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAMhE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAM3E,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,iCAAiC,CAAC;IAO7C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOhF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAM1E;;;;;;;;;OASG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,wBAAwB,CAAC;IA4BpC;;;;OAIG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,gCAAqC,GAC1C,OAAO,CAAC,wBAAwB,CAAC;CAwBrC"}

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

@@ -0,0 +1,138 @@
+import { SpekoApiError } from '../errors.js';
+const DEFAULT_POLL_INTERVAL_MS = 2_000;
+const DEFAULT_POLL_TIMEOUT_MS = 120_000;
+/**
+ * Per-agent knowledge bases. Each KB owns documents that get embedded
+ * into a Chroma collection so the agent can retrieve relevant chunks
+ * during a call. Every agent created via {@link Agents.create}
+ * auto-provisions a `Default` KB; additional KBs can be created
+ * explicitly with {@link KnowledgeBases.create}.
+ *
+ * @example
+ * ```ts
+ * const kb = await speko.knowledgeBases.create({
+ *   agentId: agent.id,
+ *   name: 'Product FAQ',
+ * });
+ *
+ * const doc = await speko.knowledgeBases.uploadDocument(kb.id, {
+ *   filename: 'faq.md',
+ *   contentType: 'text/markdown',
+ *   data: await readFile('faq.md'),
+ * });
+ *
+ * const ready = await speko.knowledgeBases.pollDocumentReady(kb.id, doc.id);
+ * ```
+ */
+export class KnowledgeBases {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(params) {
+        return this.http.post('/v1/knowledge-bases', params);
+    }
+    list(params = {}) {
+        const query = new URLSearchParams();
+        if (params.agentId)
+            query.set('agentId', params.agentId);
+        const qs = query.toString();
+        return this.http.get(`/v1/knowledge-bases${qs ? `?${qs}` : ''}`);
+    }
+    get(kbId) {
+        return this.http.get(`/v1/knowledge-bases/${encodeURIComponent(kbId)}`);
+    }
+    delete(kbId) {
+        return this.http.delete(`/v1/knowledge-bases/${encodeURIComponent(kbId)}`);
+    }
+    listDocuments(kbId) {
+        return this.http.get(`/v1/knowledge-bases/${encodeURIComponent(kbId)}/documents`);
+    }
+    getDocument(kbId, docId) {
+        return this.http.get(`/v1/knowledge-bases/${encodeURIComponent(kbId)}/documents/${encodeURIComponent(docId)}`);
+    }
+    createDocument(kbId, params) {
+        return this.http.post(`/v1/knowledge-bases/${encodeURIComponent(kbId)}/documents`, params);
+    }
+    finalizeDocument(kbId, docId) {
+        return this.http.post(`/v1/knowledge-bases/${encodeURIComponent(kbId)}/documents/${encodeURIComponent(docId)}/finalize`, {});
+    }
+    deleteDocument(kbId, docId) {
+        return this.http.delete(`/v1/knowledge-bases/${encodeURIComponent(kbId)}/documents/${encodeURIComponent(docId)}`);
+    }
+    /**
+     * Convenience wrapper: register a document, upload its bytes to the
+     * signed PUT URL the server mints, then call finalize. Returns the
+     * document with status flipped to `processing`. Call
+     * {@link pollDocumentReady} to wait for ingest completion.
+     *
+     * The server's signed upload URL expires 600 seconds after issuance,
+     * so do not hold the result of {@link createDocument} for long before
+     * uploading. This wrapper performs all three steps back-to-back.
+     */
+    async uploadDocument(kbId, params) {
+        const sizeBytes = byteLengthOf(params.data);
+        const { document, upload } = await this.createDocument(kbId, {
+            filename: params.filename,
+            contentType: params.contentType,
+            sizeBytes,
+            metadata: params.metadata,
+        });
+        const putResponse = await fetch(upload.url, {
+            method: upload.method,
+            headers: upload.headers,
+            body: toBodyInit(params.data),
+        });
+        if (!putResponse.ok) {
+            const text = await safeReadText(putResponse);
+            throw new SpekoApiError(`Document upload failed: ${putResponse.status} ${text || putResponse.statusText}`, putResponse.status, 'DOCUMENT_UPLOAD_FAILED');
+        }
+        return this.finalizeDocument(kbId, document.id);
+    }
+    /**
+     * Poll a document until it reaches `ready` or `failed` status, or the
+     * timeout elapses. Throws {@link SpekoApiError} on `failed` (with the
+     * server's `errorMessage`) or on timeout.
+     */
+    async pollDocumentReady(kbId, docId, opts = {}) {
+        const intervalMs = opts.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const doc = await this.getDocument(kbId, docId);
+            if (doc.status === 'ready')
+                return doc;
+            if (doc.status === 'failed') {
+                throw new SpekoApiError(doc.errorMessage ?? 'Document ingest failed', 500, 'DOCUMENT_INGEST_FAILED');
+            }
+            await delay(intervalMs);
+        }
+        throw new SpekoApiError(`Document ingest timed out after ${timeoutMs}ms`, 408, 'DOCUMENT_INGEST_TIMEOUT');
+    }
+}
+function byteLengthOf(data) {
+    if (data instanceof Blob)
+        return data.size;
+    if (data instanceof Uint8Array)
+        return data.byteLength;
+    return data.byteLength;
+}
+function toBodyInit(data) {
+    if (data instanceof Blob)
+        return data;
+    if (data instanceof Uint8Array) {
+        return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+    }
+    return data;
+}
+async function safeReadText(r) {
+    try {
+        return await r.text();
+    }
+    catch {
+        return '';
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

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,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,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;CAGnD"}

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

@@ -1,11 +1,11 @@
 import type { HttpClient } from '../http.js';
-import type { SynthesizeOptions, SynthesizeResult } from '../types/index.js';
+import type { SynthesizeOptions, SynthesizeResult, SynthesizeStreamResult } from '../types/index.js';
 export declare class Synthesize {
     private readonly http;
     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`,
@@ -20,5 +20,6 @@ export declare class Synthesize {
      * ```
      */
     call(text: string, options: SynthesizeOptions, abortSignal?: AbortSignal): Promise<SynthesizeResult>;
+    stream(text: string, options: SynthesizeOptions, abortSignal?: AbortSignal): Promise<SynthesizeStreamResult>;
 }
 //# sourceMappingURL=synthesize.d.ts.map

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;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;CA4B7B"}
+{"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"}

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`,
@@ -20,6 +20,21 @@ export class Synthesize {
      * ```
      */
     async call(text, options, abortSignal) {
+        const streamed = await this.stream(text, options, abortSignal);
+        const chunks = [];
+        for await (const chunk of streamed) {
+            chunks.push(chunk);
+        }
+        return {
+            audio: concatChunks(chunks),
+            contentType: streamed.contentType,
+            provider: streamed.provider,
+            model: streamed.model,
+            failoverCount: streamed.failoverCount,
+            scoresRunId: streamed.scoresRunId,
+        };
+    }
+    async stream(text, options, abortSignal) {
         const intent = {
             language: options.language,
             ...(options.region !== undefined && { region: options.region }),
@@ -32,14 +47,27 @@ export class Synthesize {
             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,
+        const { chunks, headers } = await this.http.requestBinaryStream('POST', '/v1/synthesize', body, abortSignal);
+        const result = {
             contentType: headers['content-type'] ?? 'application/octet-stream',
             provider: headers['x-speko-provider'] ?? 'unknown',
             model: headers['x-speko-model'] ?? 'unknown',
             failoverCount: parseInt(headers['x-speko-failover-count'] ?? '0', 10),
             scoresRunId: headers['x-speko-scores-run-id'] || null,
+            [Symbol.asyncIterator]() {
+                return chunks;
+            },
         };
+        return result;
+    }
+}
+function concatChunks(chunks) {
+    const total = chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
     }
+    return out;
 }

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

@@ -1,11 +1,11 @@
 import type { HttpClient } from '../http.js';
-import type { TranscribeOptions, TranscribeResult } from '../types/index.js';
+import type { TranscribeOptions, TranscribeResult, TranscribeStreamEvent } from '../types/index.js';
 export declare class Transcribe {
     private readonly http;
     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
@@ -16,5 +16,6 @@ export declare class Transcribe {
      * ```
      */
     call(audio: Uint8Array, options: TranscribeOptions, abortSignal?: AbortSignal): Promise<TranscribeResult>;
+    stream(audio: Uint8Array, options: TranscribeOptions, abortSignal?: AbortSignal): AsyncIterableIterator<TranscribeStreamEvent>;
 }
 //# sourceMappingURL=transcribe.d.ts.map

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;;;;;;;;;;;OAWG;IACG,IAAI,CACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,gBAAgB,CAAC;CAuB7B"}
+{"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

@@ -1,3 +1,4 @@
+import { SpekoApiError } from '../errors.js';
 export class Transcribe {
     http;
     constructor(http) {
@@ -5,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
@@ -16,6 +17,28 @@ export class Transcribe {
      * ```
      */
     async call(audio, options, abortSignal) {
+        let done;
+        for await (const event of this.stream(audio, options, abortSignal)) {
+            if (event.type === 'done') {
+                done = {
+                    text: event.text,
+                    provider: event.provider,
+                    model: event.model,
+                    confidence: event.confidence,
+                    failoverCount: event.failoverCount,
+                    scoresRunId: event.scoresRunId,
+                };
+            }
+            else if (event.type === 'error') {
+                throw new SpekoApiError(event.error, 200, event.code);
+            }
+        }
+        if (!done) {
+            throw new SpekoApiError('Transcribe stream ended without a done event', 200, 'STREAM_ENDED');
+        }
+        return done;
+    }
+    async *stream(audio, options, abortSignal) {
         const intent = {
             language: options.language,
             ...(options.region !== undefined && { region: options.region }),
@@ -28,6 +51,17 @@ export class Transcribe {
         if (options.constraints) {
             headers['X-Speko-Constraints'] = JSON.stringify(options.constraints);
         }
-        return this.http.requestRaw('POST', '/v1/transcribe', audio, headers, abortSignal);
+        if (options.keywords && options.keywords.length > 0) {
+            headers['X-Speko-Stt-Options'] = JSON.stringify({
+                keywords: [...options.keywords],
+            });
+        }
+        const stream = await this.http.requestRawSse('POST', '/v1/transcribe', audio, headers, abortSignal);
+        for await (const event of stream) {
+            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"}