@broberg/ai-sdk 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -107,12 +107,39 @@ interface ChatRequest {
     tools?: Tool[];
     maxTokens?: number;
     temperature?: number;
+    /** "json" → request JSON-object output where the provider supports it (F009). */
+    responseFormat?: "json" | "text";
 }
 interface ChatResult {
     text: string;
     toolCalls?: ToolCall[];
     usage: Usage;
 }
+/** A single event from `ai.chatStream` / `adapter.chatStream` (F8). A streamed
+ *  turn yields `text`/`tool_call` events as they arrive, one `usage` event when
+ *  the provider reports totals, and a terminal `finish` (or `error`). Tool calls
+ *  are emitted COMPLETE — accumulated across wire fragments, never partial. */
+type ChatStreamEvent = {
+    type: "text";
+    delta: string;
+} | {
+    type: "tool_call";
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "usage";
+    costUsd: number;
+    model: string;
+    usage: Usage;
+} | {
+    type: "finish";
+    reason: "end_turn" | "tool_calls" | "length" | "stop";
+} | {
+    type: "error";
+    message: string;
+    status?: number;
+};
 interface ImageRequest {
     prompt: string;
     spec: TierSpec;
@@ -152,6 +179,9 @@ interface ProviderAdapter {
      *  (e.g. fal does image only). The client guards each call and throws a clear
      *  "provider X does not support Y" when a capability is absent. */
     chat?(req: ChatRequest): Promise<ChatResult>;
+    /** Streaming chat (F8). Optional — absence is a typed "no streaming support".
+     *  Same request shape as chat; yields ChatStreamEvents as the turn unfolds. */
+    chatStream?(req: ChatRequest): AsyncIterable<ChatStreamEvent>;
     vision?(req: ChatRequest): Promise<ChatResult>;
     image?(req: ImageRequest): Promise<ImageResult>;
     embedding?(req: EmbeddingRequest): Promise<EmbeddingResult>;
@@ -441,6 +471,8 @@ declare const chatInputSchema: z.ZodObject<{
     }>, "many">>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
     temperature: z.ZodOptional<z.ZodNumber>;
+    /** "json" requests JSON-object output (OpenAI-compatible response_format). */
+    responseFormat: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
 }, "strip", z.ZodTypeAny, {
     system?: string | undefined;
     prompt?: string | undefined;
@@ -468,6 +500,7 @@ declare const chatInputSchema: z.ZodObject<{
     }[] | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
+    responseFormat?: "text" | "json" | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -507,6 +540,7 @@ declare const chatInputSchema: z.ZodObject<{
     }[] | undefined;
     temperature?: number | undefined;
     maxTokens?: number | undefined;
+    responseFormat?: "text" | "json" | undefined;
     tier?: "fast" | "smart" | "powerful" | "cheap" | "vision" | "embedding" | undefined;
     override?: {
         provider?: string | undefined;
@@ -902,6 +936,9 @@ type AiConfig = z.infer<typeof aiConfigSchema>;
 /** The public facade. Defined here because it depends on the derived inputs. */
 interface AiClient {
     chat(input: ChatInput): Promise<ChatResult>;
+    /** Streaming chat (F8) — same input as chat; yields ChatStreamEvents. The
+     *  caller owns the tool-loop (per-turn engine, not an agent runtime). */
+    chatStream(input: ChatInput): AsyncIterable<ChatStreamEvent>;
     vision(input: VisionInput): Promise<ChatResult>;
     translate(input: TranslateInput): Promise<TranslateResult>;
     image(input: ImageInput): Promise<ImageResult>;
@@ -927,6 +964,7 @@ declare function anthropicAdapter(config?: {
     apiKey?: string;
     baseUrl?: string;
     anthropicVersion?: string;
+    fetch?: typeof fetch;
 }): ProviderAdapter;
 
 declare function openaiAdapter(config?: {
@@ -938,6 +976,7 @@ declare function openaiAdapter(config?: {
 declare function geminiAdapter(config?: {
     apiKey?: string;
     baseUrl?: string;
+    fetch?: typeof fetch;
 }): ProviderAdapter;
 
 declare function deepinfraAdapter(config?: {
@@ -975,6 +1014,12 @@ interface OpenAICompatibleConfig {
     apiKey?: string;
     /** Extra headers (e.g. OpenRouter's HTTP-Referer / X-Title). */
     extraHeaders?: Record<string, string>;
+    /** Injectable fetch for the streaming path (tests). */
+    fetch?: typeof fetch;
+    /** OpenRouter ground-truth cost (F010): send `usage:{include:true}` and use the
+     *  response's `usage.cost` (USD) as costUsd, falling back to the pricing table.
+     *  Only OpenRouter returns this field — openai/deepinfra leave it false. */
+    costFromResponseField?: boolean;
 }
 declare function makeOpenAICompatibleAdapter(config: OpenAICompatibleConfig): ProviderAdapter;
 
@@ -993,8 +1038,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.2.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.2.0";
+declare const VERSION: "0.3.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.3.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
@@ -1170,4 +1215,21 @@ declare function httpTransport(req: TransportRequest): Promise<HttpResponse>;
 declare function parseClaudeCliJson(raw: string): SubprocessResponse;
 declare function subprocessTransport(req: TransportRequest): Promise<SubprocessResponse>;
 
-export { type AiClient, type AiConfig, type BudgetConfig, BudgetExceededError, BudgetGuard, type BudgetStore, type CallOptions, type Capability, type ChatInput, type ChatRequest, type ChatResult, type ClassifyInput, type ClassifyResult, type ContentPart, type Contracts, type CostSink, type CostSummary, DEFAULT_TIER_MAP, type DesignInput, type DesignResult, type DiscordSinkConfig, 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 OpenAICompatibleConfig, type PricingEntry, type ProviderAdapter, type RerankInput, type RerankResult, type Role, SDK_TAG, type SqliteBudgetStoreConfig, type SqliteSinkConfig, 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 UpmetricsSinkConfig, type Usage, VERSION, type VisionInput, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, chatInputSchema, computeCost, createAI, deepinfraAdapter, defaultProviders, discordSink, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, makeContracts, makeOpenAICompatibleAdapter, messageSchema, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, resolveTier, sqliteBudgetStore, sqliteSink, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };
+/** HTTP error from a streaming connect — carries `status` so the client's
+ *  pre-stream fallback can tell an eligible 429/5xx from a hard 4xx. */
+declare class StreamHttpError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+interface StreamTransportRequest extends TransportRequest {
+    /** Injectable fetch for tests. */
+    fetch?: typeof fetch;
+}
+/**
+ * Open an SSE stream and yield each event's `data:` payload as a raw string
+ * (the JSON after `data: `), skipping the `[DONE]` terminator and non-data
+ * lines. Throws StreamHttpError before the first yield on a non-2xx connect.
+ */
+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 DiscordSinkConfig, 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 OpenAICompatibleConfig, 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 UpmetricsSinkConfig, type Usage, VERSION, type VisionInput, aiConfigSchema, anthropicAdapter, anthropicApiAdapter, anthropicSubprocessAdapter, chatInputSchema, computeCost, createAI, deepinfraAdapter, defaultProviders, discordSink, embeddingInputSchema, falAdapter, falStubAdapter, freshUsage, fromProviderToolCall, geminiAdapter, getCostSummary, getPrice, httpTransport, imageInputSchema, makeContracts, makeOpenAICompatibleAdapter, messageSchema, multiSink, noopSink, openaiAdapter, openaiStubAdapter, openrouterAdapter, parseClaudeCliJson, parseJsonLoose, resolveTier, sqliteBudgetStore, sqliteSink, streamTransport, stubProviders, subprocessTransport, tierSpecSchema, toProviderTools, toolSchema, translateInputSchema, upmetricsSink, visionInputSchema };