@broberg/ai-sdk 0.25.0 → 0.26.0

package/dist/index.d.ts

@@ -1353,7 +1353,9 @@ declare const transcribeInputSchema: z.ZodObject<{
     /** Bias toward brand/jargon terms (Azure phraseList, F029.3); others ignore it. */
     phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Opt-in timestamps (F036) — a single granularity or an array. Omit → the
-     *  current { text, usage } shape, unchanged. Pass ["word","segment"] for both. */
+     *  current { text, usage } shape, unchanged. Pass ["word","segment"] for both.
+     *  Supported by Whisper (openai) + Azure fast-transcription (F036.1); other
+     *  adapters (Voxtral/mistral) ignore it and return text only. */
     timestamps: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["word", "segment"]>, z.ZodArray<z.ZodEnum<["word", "segment"]>, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     audio: string | Uint8Array<ArrayBuffer>;
@@ -1695,7 +1697,10 @@ declare const aiConfigSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     }>>>;
     providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ProviderAdapter, z.ZodTypeDef, ProviderAdapter>>>;
-    costSink: z.ZodOptional<z.ZodType<CostSink, z.ZodTypeDef, CostSink>>;
+    /** Omit → cost-tracking auto-wires from the upmetrics env (F034). Pass `null`
+     *  to opt OUT explicitly — for a consumer that already reports its own costs
+     *  and would otherwise be counted twice (F034.3). An object is used as-is. */
+    costSink: z.ZodOptional<z.ZodNullable<z.ZodType<CostSink, z.ZodTypeDef, CostSink>>>;
     budget: z.ZodOptional<z.ZodObject<{
         perCallUsd: z.ZodOptional<z.ZodNumber>;
         rollingUsd: z.ZodOptional<z.ZodNumber>;
@@ -1723,7 +1728,7 @@ declare const aiConfigSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     }>> | undefined;
     providers?: Record<string, ProviderAdapter> | undefined;
-    costSink?: CostSink | undefined;
+    costSink?: CostSink | null | undefined;
     budget?: {
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
@@ -1739,7 +1744,7 @@ declare const aiConfigSchema: z.ZodObject<{
         transport: "http" | "subprocess";
     }>> | undefined;
     providers?: Record<string, ProviderAdapter> | undefined;
-    costSink?: CostSink | undefined;
+    costSink?: CostSink | null | undefined;
     budget?: {
         perCallUsd?: number | undefined;
         rollingUsd?: number | undefined;
@@ -2043,8 +2048,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.25.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.25.0";
+declare const VERSION: "0.26.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.26.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.

package/dist/index.js

@@ -1534,7 +1534,26 @@ function azureAdapter(config = {}) {
       outputTokens: 0
     });
     usage.costUsd = minutes * (config.sttPricePerMin ?? AZURE_STT_PRICE_PER_MIN);
-    return { text, usage };
+    const result = { text, usage };
+    if (req.timestamps && req.timestamps.length > 0 && data.phrases) {
+      const toSec = (ms) => (ms ?? 0) / 1e3;
+      if (req.timestamps.includes("word")) {
+        const words = data.phrases.flatMap((p) => p.words ?? []);
+        if (words.length > 0) {
+          result.words = words.map((w) => ({
+            word: w.text ?? "",
+            start: toSec(w.offsetMilliseconds),
+            end: toSec((w.offsetMilliseconds ?? 0) + (w.durationMilliseconds ?? 0))
+          }));
+        }
+      }
+      result.segments = data.phrases.map((p) => ({
+        text: p.text ?? "",
+        start: toSec(p.offsetMilliseconds),
+        end: toSec((p.offsetMilliseconds ?? 0) + (p.durationMilliseconds ?? 0))
+      }));
+    }
+    return result;
   }
   return { name: "azure", tts, transcribe };
 }
@@ -2538,7 +2557,9 @@ var transcribeInputSchema = z.object({
   /** Bias toward brand/jargon terms (Azure phraseList, F029.3); others ignore it. */
   phrases: z.array(z.string()).optional(),
   /** Opt-in timestamps (F036) — a single granularity or an array. Omit → the
-   *  current { text, usage } shape, unchanged. Pass ["word","segment"] for both. */
+   *  current { text, usage } shape, unchanged. Pass ["word","segment"] for both.
+   *  Supported by Whisper (openai) + Azure fast-transcription (F036.1); other
+   *  adapters (Voxtral/mistral) ignore it and return text only. */
   timestamps: z.union([z.enum(["word", "segment"]), z.array(z.enum(["word", "segment"]))]).optional(),
   ...callOptions
 });
@@ -2580,14 +2601,17 @@ var aiConfigSchema = z.object({
   // Functions can't be deeply validated — z.custom asserts the TS type and
   // passes the value through untouched.
   providers: z.record(z.string(), z.custom()).optional(),
-  costSink: z.custom().optional(),
+  /** Omit → cost-tracking auto-wires from the upmetrics env (F034). Pass `null`
+   *  to opt OUT explicitly — for a consumer that already reports its own costs
+   *  and would otherwise be counted twice (F034.3). An object is used as-is. */
+  costSink: z.custom().nullable().optional(),
   budget: budgetSchema.optional(),
   availability: availabilitySchema.optional()
 });
 
 // src/version.ts
-var VERSION = "0.25.0";
-var SDK_TAG = "@broberg/ai-sdk@0.25.0";
+var VERSION = "0.26.0";
+var SDK_TAG = "@broberg/ai-sdk@0.26.0";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {
@@ -2707,7 +2731,7 @@ function defaultCostSink() {
 function createAI(config = {}) {
   const cfg = aiConfigSchema.parse(config);
   const providers = cfg.providers ?? defaultProviders;
-  const costSink = cfg.costSink ?? defaultCostSink();
+  const costSink = cfg.costSink === void 0 ? defaultCostSink() : cfg.costSink ?? void 0;
   const budget = cfg.budget ? new BudgetGuard(cfg.budget) : void 0;
   const estTokens = (s) => Math.ceil(s.length / 4);
   async function preflight(spec, estInTokens, estOutTokens) {