@voltro/ai 0.83.0 → 0.84.0

package/dist/index.d.ts

@@ -1226,9 +1226,15 @@ export declare const embed: (text: string, config?: EmbeddingProviderConfig) =>
 
 export declare interface EmbeddingProviderConfig {
     readonly name: EmbeddingProviderName;
-    /** Model id. For 'openai': e.g. 'text-embedding-3-small'. Ignored by the
+    /** Model id. For 'openai': e.g. 'text-embedding-3-small'; for 'gateway' a
+     *  `creator/model` id, e.g. 'openai/text-embedding-3-small'. Ignored by the
      *  mock provider (which derives its output from `mockDim`). */
     readonly model: string;
+    /** 'gateway' only: the gateway key and endpoint for THIS call — the same
+     *  override the text-side `gateway` provider takes. Absent → the
+     *  `AI_GATEWAY_API_KEY` the gateway package reads itself. */
+    readonly apiKey?: string;
+    readonly baseURL?: string;
     /** Mock-only: the deterministic output-vector length. Default 8. */
     readonly mockDim?: number;
     /** Native SDK options, e.g. `{ openai: { dimensions: 512 } }` or
@@ -1242,13 +1248,13 @@ export declare interface EmbeddingProviderConfig {
 
 /**
  * Read the embedding-provider config from env:
- *   AI_EMBED_PROVIDER=mock|openai|voyage|cohere   (default: mock)
+ *   AI_EMBED_PROVIDER=mock|openai|voyage|cohere|gateway   (default: mock)
  *   AI_EMBED_MODEL=<model-id>                      (default per provider)
  *   AI_EMBED_MOCK_DIM=<n>                          (mock-only, default 8)
  */
 export declare const embeddingProviderFromEnv: (env?: Record<string, string | undefined>) => EmbeddingProviderConfig;
 
-export declare type EmbeddingProviderName = 'mock' | 'openai' | 'voyage' | 'cohere';
+export declare type EmbeddingProviderName = 'mock' | 'openai' | 'voyage' | 'cohere' | 'gateway';
 
 /**
  * Embed many strings in one batched call. Order-preserving: result[i] is the
@@ -1429,11 +1435,16 @@ export declare const fromRaw: (raw: RawGatewayModel) => GatewayModelInfo;
 
 /**
  * Pull the ACTUAL per-call cost (USD) out of an AI-SDK result's provider
- * metadata, when the Vercel AI Gateway reported it. The gateway attaches
- * `providerMetadata.gateway.cost` (a USD number or numeric string) to
- * generate/stream results; returns `undefined` when absent or invalid so the
- * caller falls back to the price table. Empty, negative and non-finite values
- * are not evidence of a charge. An explicit zero remains authoritative.
+ * metadata, when the Vercel AI Gateway reported it: what the gateway charged
+ * (`providerMetadata.gateway.cost`) plus, when the successful attempt ran on
+ * the team's own provider key (BYOK), what that provider bills for it
+ * (`marketCost`). The gateway charges a BYOK call nothing and reports the
+ * provider's bill separately, so `cost` alone recorded every BYOK call as $0 —
+ * in the ledger and in every budget. A BYOK receipt without a usable
+ * `marketCost` returns `undefined` rather than $0, so the caller falls back to
+ * the price table instead of recording a free call. Empty, negative and
+ * non-finite values are not evidence of a charge; an explicit zero remains
+ * authoritative.
  */
 export declare const gatewayCostUsd: (providerMetadata: unknown) => number | undefined;
 
@@ -2912,6 +2923,11 @@ export declare type ProviderConfig = {
     readonly model: GatewayModel;
     readonly apiKey?: string;
     readonly baseURL?: string;
+    /** Media calls only (image, video, speech, transcription): the largest
+     *  response read, in bytes — refused before reading when declared, cut
+     *  off while streaming otherwise. Default `VOLTRO_AI_MEDIA_MAX_RESPONSE_BYTES`,
+     *  else 128 MiB. */
+    readonly maxResponseBytes?: number;
 };
 
 /**