@broberg/ai-sdk 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -229,6 +229,20 @@ interface TtsRequest {
     voiceId: string;
     spec: TierSpec;
 }
+interface BatchRequestItem {
+    customId: string;
+    prompt: string;
+}
+interface BatchJob {
+    jobId: string;
+    status: string;
+    total?: number;
+    completed?: number;
+}
+interface BatchResultItem {
+    customId: string;
+    text: string;
+}
 /** The thin contract every provider implements (F4). A provider need only
  *  support the capabilities it offers — `chat` is the baseline; vision/image/
  *  embedding are optional and absence is a typed capability gap. */
@@ -251,6 +265,19 @@ interface ProviderAdapter {
     dialogue?(req: DialogueRequest): Promise<PodcastResult>;
     /** Single-voice TTS (F020.4) → audio. ElevenLabs. */
     tts?(req: TtsRequest): Promise<PodcastResult>;
+    /** Batch (F016.1) — async chat-request processing at 50% cost. Mistral. */
+    batchSubmit?(req: {
+        items: BatchRequestItem[];
+        spec: TierSpec;
+    }): Promise<BatchJob>;
+    batchStatus?(req: {
+        jobId: string;
+        spec: TierSpec;
+    }): Promise<BatchJob>;
+    batchResults?(req: {
+        jobId: string;
+        spec: TierSpec;
+    }): Promise<BatchResultItem[]>;
 }
 interface TranslateResult {
     text: string;
@@ -565,6 +592,7 @@ declare const chatInputSchema: z.ZodObject<{
         parameters: Record<string, unknown>;
     }[] | undefined;
     temperature?: number | undefined;
+    purpose?: string | undefined;
     maxTokens?: number | undefined;
     responseFormat?: "text" | "json" | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
@@ -578,7 +606,6 @@ declare const chatInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     system?: string | undefined;
@@ -606,6 +633,7 @@ declare const chatInputSchema: z.ZodObject<{
         parameters: Record<string, unknown>;
     }[] | undefined;
     temperature?: number | undefined;
+    purpose?: string | undefined;
     maxTokens?: number | undefined;
     responseFormat?: "text" | "json" | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
@@ -619,7 +647,6 @@ declare const chatInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const visionInputSchema: z.ZodObject<{
@@ -659,6 +686,7 @@ declare const visionInputSchema: z.ZodObject<{
     image: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     mimeType?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -670,12 +698,12 @@ declare const visionInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     image: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     mimeType?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -687,7 +715,6 @@ declare const visionInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const videoInputSchema: z.ZodObject<{
@@ -727,6 +754,7 @@ declare const videoInputSchema: z.ZodObject<{
     video: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     mimeType?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -738,12 +766,12 @@ declare const videoInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     video: string | Uint8Array<ArrayBuffer>;
     prompt: string;
     mimeType?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -755,7 +783,6 @@ declare const videoInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const translateInputSchema: z.ZodObject<{
@@ -794,6 +821,7 @@ declare const translateInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     to: string;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -805,12 +833,12 @@ declare const translateInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     from?: string | undefined;
 }, {
     text: string;
     to: string;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -822,7 +850,6 @@ declare const translateInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     from?: string | undefined;
 }>;
@@ -861,6 +888,7 @@ declare const imageInputSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     prompt: string;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -872,12 +900,12 @@ declare const imageInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     width?: number | undefined;
     height?: number | undefined;
 }, {
     prompt: string;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -889,7 +917,6 @@ declare const imageInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     width?: number | undefined;
     height?: number | undefined;
@@ -927,6 +954,7 @@ declare const embeddingInputSchema: z.ZodObject<{
     text: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 }, "strip", z.ZodTypeAny, {
     text: string | string[];
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -938,10 +966,10 @@ declare const embeddingInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     text: string | string[];
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -953,7 +981,6 @@ declare const embeddingInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const transcribeInputSchema: z.ZodObject<{
@@ -994,6 +1021,7 @@ declare const transcribeInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     audio: string | Uint8Array<ArrayBuffer>;
     language?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1005,12 +1033,12 @@ declare const transcribeInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     durationSec?: number | undefined;
 }, {
     audio: string | Uint8Array<ArrayBuffer>;
     language?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1022,7 +1050,6 @@ declare const transcribeInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     durationSec?: number | undefined;
 }>;
@@ -1063,6 +1090,7 @@ declare const ocrInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     document: string | Uint8Array<ArrayBuffer>;
     mimeType?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1074,11 +1102,11 @@ declare const ocrInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     document: string | Uint8Array<ArrayBuffer>;
     mimeType?: string | undefined;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1090,7 +1118,6 @@ declare const ocrInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const moderationInputSchema: z.ZodObject<{
@@ -1126,6 +1153,7 @@ declare const moderationInputSchema: z.ZodObject<{
     input: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 }, "strip", z.ZodTypeAny, {
     input: string | string[];
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1137,10 +1165,10 @@ declare const moderationInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     input: string | string[];
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1152,7 +1180,6 @@ declare const moderationInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const podcastInputSchema: z.ZodObject<{
@@ -1203,6 +1230,7 @@ declare const podcastInputSchema: z.ZodObject<{
         speaker: string;
     }[];
     voices: Record<string, string>;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1214,7 +1242,6 @@ declare const podcastInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     format?: string | undefined;
 }, {
@@ -1223,6 +1250,7 @@ declare const podcastInputSchema: z.ZodObject<{
         speaker: string;
     }[];
     voices: Record<string, string>;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1234,7 +1262,6 @@ declare const podcastInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
     format?: string | undefined;
 }>;
@@ -1273,6 +1300,7 @@ declare const ttsInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     voice: string;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1284,11 +1312,11 @@ declare const ttsInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }, {
     text: string;
     voice: string;
+    purpose?: string | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "video" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -1300,7 +1328,6 @@ declare const ttsInputSchema: z.ZodObject<{
         model: string;
         transport: "http" | "subprocess";
     })[] | undefined;
-    purpose?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
 declare const aiConfigSchema: z.ZodObject<{
@@ -1387,6 +1414,15 @@ interface AiClient {
     podcast(input: PodcastInput): Promise<PodcastResult>;
     /** Single-voice TTS (F020.4) — text → audio. `voice` = curated name or voiceId. ElevenLabs. */
     tts(input: TtsInput): Promise<PodcastResult>;
+    /** Batch (F016.1) — submit many chat requests for async (≤24h) processing at 50% cost. Mistral. */
+    batch: {
+        submit(input: {
+            requests: BatchRequestItem[];
+            override?: TierSpec;
+        }): Promise<BatchJob>;
+        status(jobId: string, override?: TierSpec): Promise<BatchJob>;
+        results(jobId: string, override?: TierSpec): Promise<BatchResultItem[]>;
+    };
     /** Prompt-contract capabilities (F5.5) layered on chat/vision. */
     contracts: Contracts;
 }
@@ -1508,8 +1544,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.8.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.8.0";
+declare const VERSION: "0.9.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.9.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override. Model IDs are current at scaffold time; callers pin their
@@ -1702,4 +1738,4 @@ interface StreamTransportRequest extends TransportRequest {
  */
 declare function streamTransport(req: StreamTransportRequest): AsyncIterable<string>;
 
-export { type AiClient, type AiConfig, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostSink, type CostSummary, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DialogueRequest, type DialogueTurn, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, type EmbeddingRequest, type EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type HttpResponse, type ImageInput, type ImageRequest, type ImageResult, type Message, type MockupInput, type MockupResult, type ModerationInput, type ModerationItem, type ModerationRequest, type ModerationResult, type OcrInput, type OcrPage, type OcrRequest, type OcrResult, type OpenAICompatibleConfig, type PodcastInput, type PodcastResult, type PricingEntry, type ProviderAdapter, type RerankInput, type RerankResult, type Role, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, type Tier, type TierSpec, type Tool, type ToolCall, type TranscribeInput, type TranscribeRequest, type TranscribeResult, type TranslateInput, type TranslateResult, type Transport, type TransportRequest, type TransportResponse, type TtsInput, type TtsRequest, type UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, chatInputSchema, computeCost, createAI, deepinfraAdapter, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };
+export { type AiClient, type AiConfig, type BatchJob, type BatchRequestItem, type BatchResultItem, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ChatStreamEvent, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostSink, type CostSummary, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DialogueRequest, type DialogueTurn, type DiscordSinkConfig, ELEVENLABS_DANISH_VOICES, type EmbeddingInput, type EmbeddingRequest, type EmbeddingResult, type ExtractInput, type ExtractResult, type FalAdapterConfig, type HttpResponse, type ImageInput, type ImageRequest, type ImageResult, type Message, type MockupInput, type MockupResult, type ModerationInput, type ModerationItem, type ModerationRequest, type ModerationResult, type OcrInput, type OcrPage, type OcrRequest, type OcrResult, type OpenAICompatibleConfig, type PodcastInput, type PodcastResult, type PricingEntry, type ProviderAdapter, type RerankInput, type RerankResult, type Role, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, StreamHttpError, type SubprocessResponse, type Tier, type TierSpec, type Tool, type ToolCall, type TranscribeInput, type TranscribeRequest, type TranscribeResult, type TranslateInput, type TranslateResult, type Transport, type TransportRequest, type TransportResponse, type TtsInput, type TtsRequest, type UpmetricsSinkConfig, type Usage, VERSION, type VideoInput, type VisionInput, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, chatInputSchema, computeCost, createAI, deepinfraAdapter, defaultProviders, discordSink, elevenlabsAdapter, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, makeContracts, makeOpenAICompatibleAdapter, messageSchema, mistralAdapter, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, resolveTier, resolveVoice, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };

package/dist/index.js

@@ -280,7 +280,10 @@ var PRICING = {
   "mistral:codestral-latest": { inputPer1M: 0.3, outputPer1M: 0.9, version: MS },
   "mistral:open-mistral-nemo": { inputPer1M: 0.15, outputPer1M: 0.15, version: MS },
   // Moderation (F016.4) — per input token; output 0. (OCR is per-page in the adapter.)
-  "mistral:mistral-moderation-latest": { inputPer1M: 0.1, outputPer1M: 0, version: MS }
+  "mistral:mistral-moderation-latest": { inputPer1M: 0.1, outputPer1M: 0, version: MS },
+  // Embeddings (F016.5) — per input token.
+  "mistral:mistral-embed": { inputPer1M: 0.1, outputPer1M: 0, version: MS },
+  "mistral:codestral-embed": { inputPer1M: 0.15, outputPer1M: 0, version: MS }
 };
 function getPrice(provider, model) {
   const exact = PRICING[`${provider}:${model}`];
@@ -1028,6 +1031,11 @@ function openrouterAdapter(config = {}) {
 
 // src/providers/mistral.ts
 var MISTRAL_OCR_PRICE_PER_PAGE = 2e-3;
+var VOXTRAL_PRICE_PER_MIN = {
+  "voxtral-mini-latest": 2e-3,
+  "voxtral-mini-2507": 2e-3,
+  "voxtral-mini-2602": 2e-3
+};
 function mistralAdapter(config = {}) {
   const baseUrl = config.baseUrl ?? "https://api.mistral.ai/v1";
   const base = makeOpenAICompatibleAdapter({ name: "mistral", baseUrl, apiKey: config.apiKey });
@@ -1097,7 +1105,102 @@ function mistralAdapter(config = {}) {
     });
     return { results, usage };
   }
-  return { ...base, ocr, moderate };
+  async function embedding(req) {
+    const res = await fetchImpl(`${baseUrl}/embeddings`, {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${key()}` },
+      body: JSON.stringify({ model: req.spec.model, input: req.input })
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`mistral embeddings ${res.status}: ${body.slice(0, 300)}`);
+    }
+    const data = await res.json();
+    const vectors = (data.data ?? []).map((d) => d.embedding);
+    const usage = freshUsage({
+      provider: "mistral",
+      model: req.spec.model,
+      transport: "http",
+      capability: "embedding",
+      inputTokens: data.usage?.prompt_tokens ?? data.usage?.total_tokens ?? 0,
+      outputTokens: 0
+    });
+    return { vectors, usage };
+  }
+  async function transcribe(req) {
+    const form = new FormData();
+    form.append("file", new Blob([req.audio]), "audio");
+    form.append("model", req.spec.model);
+    if (req.language) form.append("language", req.language);
+    const res = await fetchImpl(`${baseUrl}/audio/transcriptions`, {
+      method: "POST",
+      headers: { authorization: `Bearer ${key()}` },
+      body: form
+    });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      throw new Error(`mistral transcribe ${res.status}: ${body.slice(0, 300)}`);
+    }
+    const data = await res.json();
+    const usage = freshUsage({
+      provider: "mistral",
+      model: req.spec.model,
+      transport: "http",
+      capability: "transcribe",
+      inputTokens: 0,
+      outputTokens: 0
+    });
+    if (req.durationSec !== void 0) {
+      usage.costUsd = req.durationSec / 60 * (VOXTRAL_PRICE_PER_MIN[req.spec.model] ?? 0);
+    }
+    return { text: data.text ?? "", usage };
+  }
+  async function batchSubmit(req) {
+    const jsonl = req.items.map(
+      (it) => JSON.stringify({
+        custom_id: it.customId,
+        body: { model: req.spec.model, messages: [{ role: "user", content: it.prompt }] }
+      })
+    ).join("\n");
+    const form = new FormData();
+    form.append("purpose", "batch");
+    form.append("file", new Blob([jsonl], { type: "application/jsonl" }), "batch.jsonl");
+    const up = await fetchImpl(`${baseUrl}/files`, {
+      method: "POST",
+      headers: { authorization: `Bearer ${key()}` },
+      body: form
+    });
+    if (!up.ok) throw new Error(`mistral batch upload ${up.status}: ${(await up.text().catch(() => "")).slice(0, 200)}`);
+    const fileId = (await up.json()).id;
+    const job = await fetchImpl(`${baseUrl}/batch/jobs`, {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${key()}` },
+      body: JSON.stringify({ input_files: [fileId], model: req.spec.model, endpoint: "/v1/chat/completions" })
+    });
+    if (!job.ok) throw new Error(`mistral batch job ${job.status}: ${(await job.text().catch(() => "")).slice(0, 200)}`);
+    const data = await job.json();
+    return { jobId: data.id ?? "", status: data.status ?? "queued", total: data.total_requests };
+  }
+  async function batchStatus(req) {
+    const res = await fetchImpl(`${baseUrl}/batch/jobs/${req.jobId}`, { headers: { authorization: `Bearer ${key()}` } });
+    if (!res.ok) throw new Error(`mistral batch status ${res.status}`);
+    const d = await res.json();
+    return { jobId: d.id ?? req.jobId, status: d.status ?? "unknown", total: d.total_requests, completed: d.succeeded_requests };
+  }
+  async function batchResults(req) {
+    const job = await fetchImpl(`${baseUrl}/batch/jobs/${req.jobId}`, { headers: { authorization: `Bearer ${key()}` } });
+    if (!job.ok) throw new Error(`mistral batch results ${job.status}`);
+    const outputFile = (await job.json()).output_file;
+    if (!outputFile) throw new Error("mistral batch: job has no output_file yet (not finished)");
+    const content = await fetchImpl(`${baseUrl}/files/${outputFile}/content`, { headers: { authorization: `Bearer ${key()}` } });
+    if (!content.ok) throw new Error(`mistral batch download ${content.status}`);
+    const lines = (await content.text()).trim().split("\n").filter(Boolean);
+    return lines.map((line) => {
+      const row = JSON.parse(line);
+      return { customId: row.custom_id ?? "", text: row.response?.body?.choices?.[0]?.message?.content ?? "" };
+    });
+  }
+  return { ...base, ocr, moderate, embedding, transcribe, batchSubmit, batchStatus, batchResults };
 }
 
 // src/providers/elevenlabs.ts
@@ -1618,6 +1721,7 @@ var DEFAULT_OCR_SPEC = { provider: "mistral", model: "mistral-ocr-latest", trans
 var DEFAULT_MODERATION_SPEC = { provider: "mistral", model: "mistral-moderation-latest", transport: "http" };
 var DEFAULT_PODCAST_SPEC = { provider: "elevenlabs", model: "eleven_v3", transport: "http" };
 var DEFAULT_TTS_SPEC = { provider: "elevenlabs", model: "eleven_multilingual_v2", transport: "http" };
+var DEFAULT_BATCH_SPEC = { provider: "mistral", model: "mistral-small-latest", transport: "http" };
 function createAI(config = {}) {
   const cfg = aiConfigSchema.parse(config);
   const providers = cfg.providers ?? defaultProviders;
@@ -1977,6 +2081,26 @@ function createAI(config = {}) {
         }
       });
     },
+    batch: {
+      async submit(input) {
+        const spec = { ...DEFAULT_BATCH_SPEC, ...input.override };
+        const adapter = pickProvider(spec.provider);
+        if (!adapter.batchSubmit) throw new Error(`createAI: provider "${spec.provider}" does not support batch`);
+        return adapter.batchSubmit({ items: input.requests, spec });
+      },
+      async status(jobId, override) {
+        const spec = { ...DEFAULT_BATCH_SPEC, ...override };
+        const adapter = pickProvider(spec.provider);
+        if (!adapter.batchStatus) throw new Error(`createAI: provider "${spec.provider}" does not support batch`);
+        return adapter.batchStatus({ jobId, spec });
+      },
+      async results(jobId, override) {
+        const spec = { ...DEFAULT_BATCH_SPEC, ...override };
+        const adapter = pickProvider(spec.provider);
+        if (!adapter.batchResults) throw new Error(`createAI: provider "${spec.provider}" does not support batch`);
+        return adapter.batchResults({ jobId, spec });
+      }
+    },
     // Replaced below with the real prompt-contracts (needs the client itself).
     contracts: void 0
   };
@@ -2065,8 +2189,8 @@ var stubProviders = {
 };
 
 // src/version.ts
-var VERSION = "0.8.0";
-var SDK_TAG = "@broberg/ai-sdk@0.8.0";
+var VERSION = "0.9.0";
+var SDK_TAG = "@broberg/ai-sdk@0.9.0";
 
 // src/cost/budget-store.ts
 function sqliteBudgetStore(config) {