@ai-matrx/media 0.15.48 → 0.15.49

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-matrx/media
 
+## 0.15.49
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/media/v0.15.48..npm/media/v0.15.49 -- apps/shared/media`).
+No source changes intended and no consumer action required.
+
 ## 0.15.48
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/speech.cjs

@@ -809,6 +809,8 @@ var init_cartesia_socket = __esm({
       #listeners = /* @__PURE__ */ new Map();
       /** Set when the provider refused this account and reconnecting cannot help. */
       #refused = null;
+      /** Sends accepted per context, for the usage idempotency key. */
+      #sendCounts = /* @__PURE__ */ new Map();
       constructor(native, options) {
         this.#native = native;
         this.#options = options;
@@ -878,7 +880,7 @@ var init_cartesia_socket = __esm({
           source = new CartesiaAudioSource(this.#options.sampleRate);
           this.#sources.set(contextId, source);
         }
-        await this.#native.send({
+        const sent = this.#native.send({
           context_id: contextId,
           model_id: request.modelId,
           transcript: request.transcript,
@@ -895,6 +897,8 @@ var init_cartesia_socket = __esm({
           max_buffer_delay_ms: request.maxBufferDelayMs,
           generation_config: request.generationConfig
         });
+        await sent;
+        this.#reportUsage(contextId, request);
         return {
           source,
           on: (_event, listener) => {
@@ -904,6 +908,25 @@ var init_cartesia_socket = __esm({
           }
         };
       }
+      /**
+       * Cartesia bills the characters it is sent. Report each accepted send once: the context id plus a
+       * per-context sequence is the idempotency key, so the host's retries can never double-bill.
+       */
+      #reportUsage(contextId, request) {
+        const characters = request.transcript?.length ?? 0;
+        if (characters <= 0) return;
+        const sequence = (this.#sendCounts.get(contextId) ?? 0) + 1;
+        this.#sendCounts.set(contextId, sequence);
+        try {
+          speechPorts().reportProviderUsage?.({
+            provider: "cartesia",
+            model: request.modelId,
+            usage_id: `${contextId}:${sequence}`,
+            characters
+          });
+        } catch {
+        }
+      }
       continue(request) {
         return this.send(request);
       }