@providerprotocol/ai 0.0.20 → 0.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@providerprotocol/ai",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "UPP: Unified Provider Protocol for AI inference",
   "license": "MIT",
   "homepage": "https://providerprotocol.org",
@@ -100,6 +100,9 @@
     "openrouter",
     "xai",
     "grok",
+    "vertex",
+    "deepseek",
+    "mistral",
     "provider",
     "protocol",
     "unified"

package/dist/chunk-MSR5P65T.js

@@ -1,39 +0,0 @@
-// src/core/provider.ts
-function createProvider(options) {
-  const fn = function(modelId, _options) {
-    return { modelId, provider };
-  };
-  Object.defineProperties(fn, {
-    name: {
-      value: options.name,
-      writable: false,
-      configurable: true
-    },
-    version: {
-      value: options.version,
-      writable: false,
-      configurable: true
-    },
-    modalities: {
-      value: options.modalities,
-      writable: false,
-      configurable: true
-    }
-  });
-  const provider = fn;
-  if (options.modalities.llm?._setProvider) {
-    options.modalities.llm._setProvider(provider);
-  }
-  if (options.modalities.embedding?._setProvider) {
-    options.modalities.embedding._setProvider(provider);
-  }
-  if (options.modalities.image?._setProvider) {
-    options.modalities.image._setProvider(provider);
-  }
-  return provider;
-}
-
-export {
-  createProvider
-};
-//# sourceMappingURL=chunk-MSR5P65T.js.map

package/dist/chunk-MSR5P65T.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/provider.ts"],"sourcesContent":["/**\n * @fileoverview Base provider interface and factory for the Universal Provider Protocol.\n *\n * This module provides the foundation for creating AI providers that conform to the\n * UPP specification. Providers are callable functions that create model references\n * and expose modality handlers (LLM, embedding, image).\n *\n * @module core/provider\n */\n\nimport type {\n  Provider,\n  ModelReference,\n  LLMHandler,\n  EmbeddingHandler,\n  ImageHandler,\n  LLMProvider,\n  EmbeddingProvider,\n  ImageProvider,\n} from '../types/provider.ts';\n\n/**\n * Configuration options for creating a new provider.\n *\n * @example\n * ```typescript\n * const options: CreateProviderOptions = {\n *   name: 'my-provider',\n *   version: '1.0.0',\n *   modalities: {\n *     llm: createLLMHandler(),\n *     embedding: createEmbeddingHandler(),\n *   },\n * };\n * ```\n */\nexport interface CreateProviderOptions {\n  /** Unique identifier for the provider */\n  name: string;\n  /** Semantic version string for the provider implementation */\n  version: string;\n  /** Handlers for supported modalities (LLM, embedding, image generation) */\n  modalities: {\n    /** Handler for language model completions */\n    llm?: LLMHandler;\n    /** Handler for text embeddings */\n    embedding?: EmbeddingHandler;\n    /** Handler for image generation */\n    image?: ImageHandler;\n  };\n}\n\n/**\n * Creates a provider factory function with attached modality handlers.\n *\n * The returned provider is a callable function that creates model references\n * when invoked with a model ID. It also exposes `name`, `version`, and\n * `modalities` properties for introspection.\n *\n * @typeParam TOptions - Provider-specific options type (defaults to unknown)\n * @param options - Provider configuration including name, version, and handlers\n * @returns A callable Provider with modalities attached\n *\n * @example\n * ```typescript\n * // Create a basic provider\n * const anthropic = createProvider({\n *   name: 'anthropic',\n *   version: '1.0.0',\n *   modalities: { llm: createLLMHandler() },\n * });\n *\n * // Use the provider to create a model reference\n * const model = anthropic('claude-sonnet-4-20250514');\n *\n * // Provider with custom options type\n * interface MyOptions { apiVersion?: 'v1' | 'v2' }\n * const myProvider = createProvider<MyOptions>({\n *   name: 'my-provider',\n *   version: '1.0.0',\n *   modalities: { llm: handler },\n * });\n * ```\n */\nexport function createProvider<TOptions = unknown>(\n  options: CreateProviderOptions\n): Provider<TOptions> {\n  const fn = function (modelId: string, _options?: TOptions): ModelReference<TOptions> {\n    return { modelId, provider };\n  };\n\n  Object.defineProperties(fn, {\n    name: {\n      value: options.name,\n      writable: false,\n      configurable: true,\n    },\n    version: {\n      value: options.version,\n      writable: false,\n      configurable: true,\n    },\n    modalities: {\n      value: options.modalities,\n      writable: false,\n      configurable: true,\n    },\n  });\n\n  const provider = fn as Provider<TOptions>;\n\n  if (options.modalities.llm?._setProvider) {\n    options.modalities.llm._setProvider(provider as unknown as LLMProvider);\n  }\n  if (options.modalities.embedding?._setProvider) {\n    options.modalities.embedding._setProvider(provider as unknown as EmbeddingProvider);\n  }\n  if (options.modalities.image?._setProvider) {\n    options.modalities.image._setProvider(provider as unknown as ImageProvider);\n  }\n\n  return provider;\n}\n"],"mappings":";AAoFO,SAAS,eACd,SACoB;AACpB,QAAM,KAAK,SAAU,SAAiB,UAA+C;AACnF,WAAO,EAAE,SAAS,SAAS;AAAA,EAC7B;AAEA,SAAO,iBAAiB,IAAI;AAAA,IAC1B,MAAM;AAAA,MACJ,OAAO,QAAQ;AAAA,MACf,UAAU;AAAA,MACV,cAAc;AAAA,IAChB;AAAA,IACA,SAAS;AAAA,MACP,OAAO,QAAQ;AAAA,MACf,UAAU;AAAA,MACV,cAAc;AAAA,IAChB;AAAA,IACA,YAAY;AAAA,MACV,OAAO,QAAQ;AAAA,MACf,UAAU;AAAA,MACV,cAAc;AAAA,IAChB;AAAA,EACF,CAAC;AAED,QAAM,WAAW;AAEjB,MAAI,QAAQ,WAAW,KAAK,cAAc;AACxC,YAAQ,WAAW,IAAI,aAAa,QAAkC;AAAA,EACxE;AACA,MAAI,QAAQ,WAAW,WAAW,cAAc;AAC9C,YAAQ,WAAW,UAAU,aAAa,QAAwC;AAAA,EACpF;AACA,MAAI,QAAQ,WAAW,OAAO,cAAc;AAC1C,YAAQ,WAAW,MAAM,aAAa,QAAoC;AAAA,EAC5E;AAEA,SAAO;AACT;","names":[]}

package/dist/chunk-SKY2JLA7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/turn.ts"],"sourcesContent":["/**\n * @fileoverview Turn types for inference results.\n *\n * A Turn represents the complete result of one inference call, including\n * all messages produced during tool execution loops, token usage, and\n * optional structured output data.\n *\n * @module types/turn\n */\n\nimport type { Message, AssistantMessage } from './messages.ts';\nimport type { ToolExecution } from './tool.ts';\nimport type { MessageJSON } from './thread.ts';\n\n/**\n * Token usage information for an inference request.\n *\n * Tracks input and output tokens across all inference cycles,\n * with optional per-cycle breakdown and cache metrics.\n *\n * @example\n * ```typescript\n * const usage: TokenUsage = {\n *   inputTokens: 150,\n *   outputTokens: 50,\n *   totalTokens: 200,\n *   cacheReadTokens: 100,\n *   cacheWriteTokens: 50,\n *   cycles: [\n *     { inputTokens: 100, outputTokens: 30, cacheReadTokens: 0, cacheWriteTokens: 50 },\n *     { inputTokens: 50, outputTokens: 20, cacheReadTokens: 100, cacheWriteTokens: 0 }\n *   ]\n * };\n * ```\n */\nexport interface TokenUsage {\n  /** Total input tokens across all cycles */\n  inputTokens: number;\n\n  /** Total output tokens across all cycles */\n  outputTokens: number;\n\n  /** Sum of input and output tokens */\n  totalTokens: number;\n\n  /**\n   * Tokens read from cache (cache hits).\n   * Returns 0 for providers that don't support or report cache metrics.\n   */\n  cacheReadTokens: number;\n\n  /**\n   * Tokens written to cache (cache misses that were cached).\n   * Only Anthropic reports this metric; returns 0 for other providers.\n   */\n  cacheWriteTokens: number;\n\n  /** Per-cycle token breakdown (if multiple cycles occurred) */\n  cycles?: Array<{\n    inputTokens: number;\n    outputTokens: number;\n    cacheReadTokens: number;\n    cacheWriteTokens: number;\n  }>;\n}\n\n/**\n * A Turn represents the complete result of one inference call.\n *\n * Includes all messages produced during tool execution loops,\n * the final assistant response, token usage, and optional\n * structured output data.\n *\n * @typeParam TData - Type of the structured output data\n *\n * @example\n * ```typescript\n * const turn = await instance.generate('Hello');\n * console.log(turn.response.text);\n * console.log(`Used ${turn.usage.totalTokens} tokens in ${turn.cycles} cycles`);\n *\n * // With structured output\n * interface WeatherData { temperature: number; conditions: string; }\n * const turn = await instance.generate<WeatherData>('Get weather');\n * console.log(turn.data?.temperature);\n * ```\n */\nexport interface Turn<TData = unknown> {\n  /**\n   * All messages produced during this inference, in chronological order.\n   * Includes UserMessage, AssistantMessage (may include toolCalls), and ToolResultMessage.\n   */\n  readonly messages: Message[];\n\n  /** The final assistant response (last AssistantMessage in the turn) */\n  readonly response: AssistantMessage;\n\n  /** Tool executions that occurred during this turn */\n  readonly toolExecutions: ToolExecution[];\n\n  /** Aggregate token usage for the entire turn */\n  readonly usage: TokenUsage;\n\n  /** Total number of inference cycles (1 + number of tool rounds) */\n  readonly cycles: number;\n\n  /**\n   * Structured output data (if a structure schema was provided).\n   * Type is inferred from the schema when using TypeScript.\n   */\n  readonly data?: TData;\n}\n\n/**\n * Turn serialized to JSON format.\n * Messages are converted to MessageJSON, response is omitted (computed from messages).\n */\nexport type TurnJSON = Omit<Turn, 'messages' | 'response'> & {\n  messages: MessageJSON[];\n};\n\n/**\n * Creates a Turn from accumulated inference data.\n *\n * @typeParam TData - Type of the structured output data\n * @param messages - All messages produced during the inference\n * @param toolExecutions - Record of all tool executions\n * @param usage - Aggregate token usage\n * @param cycles - Number of inference cycles\n * @param data - Optional structured output data\n * @returns A complete Turn object\n * @throws Error if no assistant message is found in the messages\n *\n * @example\n * ```typescript\n * const turn = createTurn(\n *   [userMsg, assistantMsg],\n *   [],\n *   { inputTokens: 100, outputTokens: 50, totalTokens: 150 },\n *   1\n * );\n * ```\n */\nexport function createTurn<TData = unknown>(\n  messages: Message[],\n  toolExecutions: ToolExecution[],\n  usage: TokenUsage,\n  cycles: number,\n  data?: TData\n): Turn<TData> {\n  const response = messages\n    .filter((m): m is AssistantMessage => m.type === 'assistant')\n    .pop();\n\n  if (!response) {\n    throw new Error('Turn must contain at least one assistant message');\n  }\n\n  return {\n    messages,\n    response,\n    toolExecutions,\n    usage,\n    cycles,\n    data,\n  };\n}\n\n/**\n * Creates an empty TokenUsage object.\n *\n * @returns A TokenUsage with all values set to zero\n *\n * @example\n * ```typescript\n * const usage = emptyUsage();\n * // { inputTokens: 0, outputTokens: 0, totalTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, cycles: [] }\n * ```\n */\nexport function emptyUsage(): TokenUsage {\n  return {\n    inputTokens: 0,\n    outputTokens: 0,\n    totalTokens: 0,\n    cacheReadTokens: 0,\n    cacheWriteTokens: 0,\n    cycles: [],\n  };\n}\n\n/**\n * Aggregates token usage from multiple inference cycles.\n *\n * @param usages - Array of TokenUsage objects to aggregate\n * @returns Combined TokenUsage with per-cycle breakdown\n *\n * @example\n * ```typescript\n * const cycle1 = { inputTokens: 100, outputTokens: 30, totalTokens: 130, cacheReadTokens: 50, cacheWriteTokens: 0 };\n * const cycle2 = { inputTokens: 150, outputTokens: 40, totalTokens: 190, cacheReadTokens: 100, cacheWriteTokens: 0 };\n * const total = aggregateUsage([cycle1, cycle2]);\n * // { inputTokens: 250, outputTokens: 70, totalTokens: 320, cacheReadTokens: 150, cacheWriteTokens: 0, cycles: [...] }\n * ```\n */\nexport function aggregateUsage(usages: TokenUsage[]): TokenUsage {\n  const cycles: TokenUsage['cycles'] = [];\n  let inputTokens = 0;\n  let outputTokens = 0;\n  let cacheReadTokens = 0;\n  let cacheWriteTokens = 0;\n\n  for (const usage of usages) {\n    inputTokens += usage.inputTokens;\n    outputTokens += usage.outputTokens;\n    cacheReadTokens += usage.cacheReadTokens;\n    cacheWriteTokens += usage.cacheWriteTokens;\n    cycles.push({\n      inputTokens: usage.inputTokens,\n      outputTokens: usage.outputTokens,\n      cacheReadTokens: usage.cacheReadTokens,\n      cacheWriteTokens: usage.cacheWriteTokens,\n    });\n  }\n\n  return {\n    inputTokens,\n    outputTokens,\n    totalTokens: inputTokens + outputTokens,\n    cacheReadTokens,\n    cacheWriteTokens,\n    cycles,\n  };\n}\n"],"mappings":";AA+IO,SAAS,WACd,UACA,gBACA,OACA,QACA,MACa;AACb,QAAM,WAAW,SACd,OAAO,CAAC,MAA6B,EAAE,SAAS,WAAW,EAC3D,IAAI;AAEP,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAaO,SAAS,aAAyB;AACvC,SAAO;AAAA,IACL,aAAa;AAAA,IACb,cAAc;AAAA,IACd,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,kBAAkB;AAAA,IAClB,QAAQ,CAAC;AAAA,EACX;AACF;AAgBO,SAAS,eAAe,QAAkC;AAC/D,QAAM,SAA+B,CAAC;AACtC,MAAI,cAAc;AAClB,MAAI,eAAe;AACnB,MAAI,kBAAkB;AACtB,MAAI,mBAAmB;AAEvB,aAAW,SAAS,QAAQ;AAC1B,mBAAe,MAAM;AACrB,oBAAgB,MAAM;AACtB,uBAAmB,MAAM;AACzB,wBAAoB,MAAM;AAC1B,WAAO,KAAK;AAAA,MACV,aAAa,MAAM;AAAA,MACnB,cAAc,MAAM;AAAA,MACpB,iBAAiB,MAAM;AAAA,MACvB,kBAAkB,MAAM;AAAA,IAC1B,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,cAAc;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-U3FZWV4U.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/errors.ts","../src/http/errors.ts","../src/http/fetch.ts"],"sourcesContent":["/**\n * @fileoverview Error types for the Unified Provider Protocol.\n *\n * Provides normalized error codes and a unified error class for handling\n * errors across different AI providers in a consistent manner.\n *\n * @module types/errors\n */\n\n/**\n * Normalized error codes for cross-provider error handling.\n *\n * These codes provide a consistent way to identify and handle errors\n * regardless of which AI provider generated them.\n *\n * @example\n * ```typescript\n * try {\n *   await llm.generate('Hello');\n * } catch (error) {\n *   if (error instanceof UPPError) {\n *     switch (error.code) {\n *       case 'RATE_LIMITED':\n *         await delay(error.retryAfter);\n *         break;\n *       case 'AUTHENTICATION_FAILED':\n *         throw new Error('Invalid API key');\n *     }\n *   }\n * }\n * ```\n */\nexport type ErrorCode =\n  /** API key is invalid or expired */\n  | 'AUTHENTICATION_FAILED'\n  /** Rate limit exceeded, retry after delay */\n  | 'RATE_LIMITED'\n  /** Input exceeds model's context window */\n  | 'CONTEXT_LENGTH_EXCEEDED'\n  /** Requested model does not exist */\n  | 'MODEL_NOT_FOUND'\n  /** Request parameters are malformed */\n  | 'INVALID_REQUEST'\n  /** Provider returned an unexpected response format */\n  | 'INVALID_RESPONSE'\n  /** Content was blocked by safety filters */\n  | 'CONTENT_FILTERED'\n  /** Account quota or credits exhausted */\n  | 'QUOTA_EXCEEDED'\n  /** Provider-specific error not covered by other codes */\n  | 'PROVIDER_ERROR'\n  /** Network connectivity issue */\n  | 'NETWORK_ERROR'\n  /** Request exceeded timeout limit */\n  | 'TIMEOUT'\n  /** Request was cancelled via AbortSignal */\n  | 'CANCELLED';\n\n/**\n * Modality types supported by UPP.\n *\n * Each modality represents a different type of AI capability that\n * can be provided by a UPP-compatible provider.\n */\nexport type Modality =\n  /** Large language model for text generation */\n  | 'llm'\n  /** Text/image embedding model */\n  | 'embedding'\n  /** Image generation model */\n  | 'image'\n  /** Audio processing/generation model */\n  | 'audio'\n  /** Video processing/generation model */\n  | 'video';\n\n/**\n * Unified Provider Protocol Error.\n *\n * All provider-specific errors are normalized to this type, providing\n * a consistent interface for error handling across different AI providers.\n *\n * @example\n * ```typescript\n * throw new UPPError(\n *   'API key is invalid',\n *   'AUTHENTICATION_FAILED',\n *   'openai',\n *   'llm',\n *   401\n * );\n * ```\n *\n * @example\n * ```typescript\n * // Wrapping a provider error\n * try {\n *   await openai.chat.completions.create({ ... });\n * } catch (err) {\n *   throw new UPPError(\n *     'OpenAI request failed',\n *     'PROVIDER_ERROR',\n *     'openai',\n *     'llm',\n *     err.status,\n *     err\n *   );\n * }\n * ```\n */\nexport class UPPError extends Error {\n  /** Normalized error code for programmatic handling */\n  readonly code: ErrorCode;\n\n  /** Name of the provider that generated the error */\n  readonly provider: string;\n\n  /** The modality that was being used when the error occurred */\n  readonly modality: Modality;\n\n  /** HTTP status code from the provider's response, if available */\n  readonly statusCode?: number;\n\n  /** The original error that caused this UPPError, if wrapping another error */\n  override readonly cause?: Error;\n\n  /** Error class name, always 'UPPError' */\n  override readonly name = 'UPPError';\n\n  /**\n   * Creates a new UPPError instance.\n   *\n   * @param message - Human-readable error description\n   * @param code - Normalized error code for programmatic handling\n   * @param provider - Name of the provider that generated the error\n   * @param modality - The modality that was being used\n   * @param statusCode - HTTP status code from the provider's response\n   * @param cause - The original error being wrapped\n   */\n  constructor(\n    message: string,\n    code: ErrorCode,\n    provider: string,\n    modality: Modality,\n    statusCode?: number,\n    cause?: Error\n  ) {\n    super(message);\n    this.code = code;\n    this.provider = provider;\n    this.modality = modality;\n    this.statusCode = statusCode;\n    this.cause = cause;\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, UPPError);\n    }\n  }\n\n  /**\n   * Creates a string representation of the error.\n   *\n   * @returns Formatted error string including code, message, provider, and modality\n   */\n  override toString(): string {\n    let str = `UPPError [${this.code}]: ${this.message}`;\n    str += ` (provider: ${this.provider}, modality: ${this.modality}`;\n    if (this.statusCode) {\n      str += `, status: ${this.statusCode}`;\n    }\n    str += ')';\n    return str;\n  }\n\n  /**\n   * Converts the error to a JSON-serializable object.\n   *\n   * @returns Plain object representation suitable for logging or transmission\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      provider: this.provider,\n      modality: this.modality,\n      statusCode: this.statusCode,\n      cause: this.cause?.message,\n    };\n  }\n}\n","/**\n * HTTP error handling and normalization utilities.\n * @module http/errors\n */\n\nimport { UPPError, type ErrorCode, type Modality } from '../types/errors.ts';\n\n/**\n * Maps HTTP status codes to standardized UPP error codes.\n *\n * This function provides consistent error categorization across all providers:\n * - 400 -> INVALID_REQUEST (bad request format or parameters)\n * - 401, 403 -> AUTHENTICATION_FAILED (invalid or missing credentials)\n * - 404 -> MODEL_NOT_FOUND (requested model does not exist)\n * - 408 -> TIMEOUT (request timed out)\n * - 413 -> CONTEXT_LENGTH_EXCEEDED (input too long)\n * - 429 -> RATE_LIMITED (too many requests)\n * - 5xx -> PROVIDER_ERROR (server-side issues)\n *\n * @param status - HTTP status code from the response\n * @returns The corresponding UPP ErrorCode\n *\n * @example\n * ```typescript\n * const errorCode = statusToErrorCode(429);\n * // Returns 'RATE_LIMITED'\n *\n * const serverError = statusToErrorCode(503);\n * // Returns 'PROVIDER_ERROR'\n * ```\n */\nexport function statusToErrorCode(status: number): ErrorCode {\n  switch (status) {\n    case 400:\n      return 'INVALID_REQUEST';\n    case 401:\n    case 403:\n      return 'AUTHENTICATION_FAILED';\n    case 404:\n      return 'MODEL_NOT_FOUND';\n    case 408:\n      return 'TIMEOUT';\n    case 413:\n      return 'CONTEXT_LENGTH_EXCEEDED';\n    case 429:\n      return 'RATE_LIMITED';\n    case 500:\n    case 502:\n    case 503:\n    case 504:\n      return 'PROVIDER_ERROR';\n    default:\n      return 'PROVIDER_ERROR';\n  }\n}\n\n/**\n * Normalizes HTTP error responses into standardized UPPError objects.\n *\n * This function performs several operations:\n * 1. Maps the HTTP status code to an appropriate ErrorCode\n * 2. Attempts to extract a meaningful error message from the response body\n * 3. Handles various provider-specific error response formats\n *\n * Supported error message formats:\n * - `{ error: { message: \"...\" } }` (OpenAI, Anthropic)\n * - `{ message: \"...\" }` (simple format)\n * - `{ error: { error: { message: \"...\" } } }` (nested format)\n * - `{ detail: \"...\" }` (FastAPI style)\n * - Plain text body (if under 200 characters)\n *\n * @param response - The HTTP Response object with non-2xx status\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with normalized code and message\n *\n * @example\n * ```typescript\n * if (!response.ok) {\n *   const error = await normalizeHttpError(response, 'openai', 'llm');\n *   // error.code might be 'RATE_LIMITED' for 429\n *   // error.message contains provider's error message\n *   throw error;\n * }\n * ```\n */\nexport async function normalizeHttpError(\n  response: Response,\n  provider: string,\n  modality: Modality\n): Promise<UPPError> {\n  const code = statusToErrorCode(response.status);\n  let message = `HTTP ${response.status}: ${response.statusText}`;\n\n  try {\n    const body = await response.text();\n    if (body) {\n      try {\n        const json = JSON.parse(body);\n        const extractedMessage =\n          json.error?.message ||\n          json.message ||\n          json.error?.error?.message ||\n          json.detail;\n\n        if (extractedMessage) {\n          message = extractedMessage;\n        }\n      } catch {\n        if (body.length < 200) {\n          message = body;\n        }\n      }\n    }\n  } catch {\n  }\n\n  return new UPPError(message, code, provider, modality, response.status);\n}\n\n/**\n * Creates a UPPError for network failures (DNS, connection, etc.).\n *\n * Use this when the request fails before receiving any HTTP response,\n * such as DNS resolution failures, connection refused, or network unreachable.\n *\n * @param error - The underlying Error that caused the failure\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with NETWORK_ERROR code and the original error attached\n */\nexport function networkError(\n  error: Error,\n  provider: string,\n  modality: Modality\n): UPPError {\n  return new UPPError(\n    `Network error: ${error.message}`,\n    'NETWORK_ERROR',\n    provider,\n    modality,\n    undefined,\n    error\n  );\n}\n\n/**\n * Creates a UPPError for request timeout.\n *\n * Use this when the request exceeds the configured timeout duration\n * and is aborted by the AbortController.\n *\n * @param timeout - The timeout duration in milliseconds that was exceeded\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with TIMEOUT code\n */\nexport function timeoutError(\n  timeout: number,\n  provider: string,\n  modality: Modality\n): UPPError {\n  return new UPPError(\n    `Request timed out after ${timeout}ms`,\n    'TIMEOUT',\n    provider,\n    modality\n  );\n}\n\n/**\n * Creates a UPPError for user-initiated request cancellation.\n *\n * Use this when the request is aborted via a user-provided AbortSignal,\n * distinct from timeout-based cancellation.\n *\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns A UPPError with CANCELLED code\n */\nexport function cancelledError(provider: string, modality: Modality): UPPError {\n  return new UPPError('Request was cancelled', 'CANCELLED', provider, modality);\n}\n","/**\n * HTTP fetch utilities with retry, timeout, and error normalization.\n * @module http/fetch\n */\n\nimport type { ProviderConfig } from '../types/provider.ts';\nimport type { Modality } from '../types/errors.ts';\nimport { UPPError } from '../types/errors.ts';\nimport {\n  normalizeHttpError,\n  networkError,\n  timeoutError,\n  cancelledError,\n} from './errors.ts';\n\n/** Default request timeout in milliseconds (2 minutes). */\nconst DEFAULT_TIMEOUT = 120000;\n\n/**\n * Executes an HTTP fetch request with automatic retry, timeout handling, and error normalization.\n *\n * This function wraps the standard fetch API with additional capabilities:\n * - Configurable timeout with automatic request cancellation\n * - Retry strategy support (exponential backoff, linear, token bucket, etc.)\n * - Pre-request delay support for rate limiting strategies\n * - Automatic Retry-After header parsing and handling\n * - Error normalization to UPPError format\n *\n * @param url - The URL to fetch\n * @param init - Standard fetch RequestInit options (method, headers, body, etc.)\n * @param config - Provider configuration containing fetch customization, timeout, and retry strategy\n * @param provider - Provider identifier for error context (e.g., 'openai', 'anthropic')\n * @param modality - Request modality for error context (e.g., 'llm', 'embedding', 'image')\n * @returns The successful Response object\n *\n * @throws {UPPError} RATE_LIMITED - When rate limited and retries exhausted\n * @throws {UPPError} NETWORK_ERROR - When a network failure occurs\n * @throws {UPPError} TIMEOUT - When the request times out\n * @throws {UPPError} CANCELLED - When the request is aborted via signal\n * @throws {UPPError} Various codes based on HTTP status (see statusToErrorCode)\n *\n * @example\n * ```typescript\n * const response = await doFetch(\n *   'https://api.openai.com/v1/chat/completions',\n *   {\n *     method: 'POST',\n *     headers: { 'Authorization': 'Bearer sk-...' },\n *     body: JSON.stringify({ model: 'gpt-4', messages: [] })\n *   },\n *   { timeout: 30000, retryStrategy: new ExponentialBackoff() },\n *   'openai',\n *   'llm'\n * );\n * ```\n */\nexport async function doFetch(\n  url: string,\n  init: RequestInit,\n  config: ProviderConfig,\n  provider: string,\n  modality: Modality\n): Promise<Response> {\n  const fetchFn = config.fetch ?? fetch;\n  const timeout = config.timeout ?? DEFAULT_TIMEOUT;\n  const strategy = config.retryStrategy;\n\n  if (strategy?.beforeRequest) {\n    const delay = await strategy.beforeRequest();\n    if (delay > 0) {\n      await sleep(delay);\n    }\n  }\n\n  let lastError: UPPError | undefined;\n  let attempt = 0;\n\n  while (true) {\n    attempt++;\n\n    try {\n      const response = await fetchWithTimeout(\n        fetchFn,\n        url,\n        init,\n        timeout,\n        provider,\n        modality\n      );\n\n      if (!response.ok) {\n        const error = await normalizeHttpError(response, provider, modality);\n\n        const retryAfter = response.headers.get('Retry-After');\n        if (retryAfter && strategy) {\n          const seconds = parseInt(retryAfter, 10);\n          if (!isNaN(seconds) && 'setRetryAfter' in strategy) {\n            (strategy as { setRetryAfter: (s: number) => void }).setRetryAfter(\n              seconds\n            );\n          }\n        }\n\n        if (strategy) {\n          const delay = await strategy.onRetry(error, attempt);\n          if (delay !== null) {\n            await sleep(delay);\n            lastError = error;\n            continue;\n          }\n        }\n\n        throw error;\n      }\n\n      strategy?.reset?.();\n\n      return response;\n    } catch (error) {\n      if (error instanceof UPPError) {\n        if (strategy) {\n          const delay = await strategy.onRetry(error, attempt);\n          if (delay !== null) {\n            await sleep(delay);\n            lastError = error;\n            continue;\n          }\n        }\n        throw error;\n      }\n\n      const uppError = networkError(error as Error, provider, modality);\n\n      if (strategy) {\n        const delay = await strategy.onRetry(uppError, attempt);\n        if (delay !== null) {\n          await sleep(delay);\n          lastError = uppError;\n          continue;\n        }\n      }\n\n      throw uppError;\n    }\n  }\n}\n\n/**\n * Executes a fetch request with configurable timeout.\n *\n * Creates an AbortController to cancel the request if it exceeds the timeout.\n * Properly handles both user-provided abort signals and timeout-based cancellation,\n * throwing appropriate error types for each case.\n *\n * @param fetchFn - The fetch function to use (allows custom implementations)\n * @param url - The URL to fetch\n * @param init - Standard fetch RequestInit options\n * @param timeout - Maximum time in milliseconds before aborting\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns The Response from the fetch call\n *\n * @throws {UPPError} TIMEOUT - When the timeout is exceeded\n * @throws {UPPError} CANCELLED - When cancelled via user-provided signal\n * @throws {Error} Network errors are passed through unchanged\n */\nasync function fetchWithTimeout(\n  fetchFn: typeof fetch,\n  url: string,\n  init: RequestInit,\n  timeout: number,\n  provider: string,\n  modality: Modality\n): Promise<Response> {\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n  const existingSignal = init.signal;\n  if (existingSignal) {\n    existingSignal.addEventListener('abort', () => controller.abort());\n  }\n\n  try {\n    const response = await fetchFn(url, {\n      ...init,\n      signal: controller.signal,\n    });\n    return response;\n  } catch (error) {\n    if ((error as Error).name === 'AbortError') {\n      if (existingSignal?.aborted) {\n        throw cancelledError(provider, modality);\n      }\n      throw timeoutError(timeout, provider, modality);\n    }\n    throw error;\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n\n/**\n * Delays execution for a specified duration.\n *\n * @param ms - Duration to sleep in milliseconds\n * @returns Promise that resolves after the specified delay\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Executes an HTTP fetch request for streaming responses.\n *\n * Unlike {@link doFetch}, this function returns the response immediately without\n * checking the HTTP status. This is necessary for Server-Sent Events (SSE) and\n * other streaming protocols where error information may be embedded in the stream.\n *\n * The caller is responsible for:\n * - Checking response.ok and handling HTTP errors\n * - Parsing the response stream (e.g., using parseSSEStream)\n * - Handling stream-specific error conditions\n *\n * Retries are not performed for streaming requests since partial data may have\n * already been consumed by the caller.\n *\n * @param url - The URL to fetch\n * @param init - Standard fetch RequestInit options\n * @param config - Provider configuration containing fetch customization and timeout\n * @param provider - Provider identifier for error context\n * @param modality - Request modality for error context\n * @returns The Response object (may have non-2xx status)\n *\n * @throws {UPPError} NETWORK_ERROR - When a network failure occurs\n * @throws {UPPError} TIMEOUT - When the request times out\n * @throws {UPPError} CANCELLED - When the request is aborted via signal\n *\n * @example\n * ```typescript\n * const response = await doStreamFetch(\n *   'https://api.openai.com/v1/chat/completions',\n *   {\n *     method: 'POST',\n *     headers: { 'Authorization': 'Bearer sk-...' },\n *     body: JSON.stringify({ model: 'gpt-4', messages: [], stream: true })\n *   },\n *   { timeout: 120000 },\n *   'openai',\n *   'llm'\n * );\n *\n * if (!response.ok) {\n *   throw await normalizeHttpError(response, 'openai', 'llm');\n * }\n *\n * for await (const event of parseSSEStream(response.body!)) {\n *   console.log(event);\n * }\n * ```\n */\nexport async function doStreamFetch(\n  url: string,\n  init: RequestInit,\n  config: ProviderConfig,\n  provider: string,\n  modality: Modality\n): Promise<Response> {\n  const fetchFn = config.fetch ?? fetch;\n  const timeout = config.timeout ?? DEFAULT_TIMEOUT;\n  const strategy = config.retryStrategy;\n\n  if (strategy?.beforeRequest) {\n    const delay = await strategy.beforeRequest();\n    if (delay > 0) {\n      await sleep(delay);\n    }\n  }\n\n  try {\n    const response = await fetchWithTimeout(\n      fetchFn,\n      url,\n      init,\n      timeout,\n      provider,\n      modality\n    );\n    return response;\n  } catch (error) {\n    if (error instanceof UPPError) {\n      throw error;\n    }\n    throw networkError(error as Error, provider, modality);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-U4JJC2YX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/http/retry.ts"],"sourcesContent":["/**\n * Retry strategies for handling transient failures in HTTP requests.\n * @module http/retry\n */\n\nimport type { RetryStrategy } from '../types/provider.ts';\nimport type { UPPError } from '../types/errors.ts';\n\n/**\n * Implements exponential backoff with optional jitter for retry delays.\n *\n * The delay between retries doubles with each attempt, helping to:\n * - Avoid overwhelming servers during outages\n * - Reduce thundering herd effects when many clients retry simultaneously\n * - Give transient issues time to resolve\n *\n * Delay formula: min(baseDelay * 2^(attempt-1), maxDelay)\n * With jitter: delay * random(0.5, 1.0)\n *\n * Only retries on transient errors: RATE_LIMITED, NETWORK_ERROR, TIMEOUT, PROVIDER_ERROR\n *\n * @implements {RetryStrategy}\n *\n * @example\n * ```typescript\n * // Default configuration (3 retries, 1s base, 30s max, jitter enabled)\n * const retry = new ExponentialBackoff();\n *\n * // Custom configuration\n * const customRetry = new ExponentialBackoff({\n *   maxAttempts: 5,     // Up to 5 retry attempts\n *   baseDelay: 500,     // Start with 500ms delay\n *   maxDelay: 60000,    // Cap at 60 seconds\n *   jitter: false       // Disable random jitter\n * });\n *\n * // Use with provider\n * const provider = createOpenAI({\n *   retryStrategy: customRetry\n * });\n * ```\n */\nexport class ExponentialBackoff implements RetryStrategy {\n  private maxAttempts: number;\n  private baseDelay: number;\n  private maxDelay: number;\n  private jitter: boolean;\n\n  /**\n   * Creates a new ExponentialBackoff instance.\n   *\n   * @param options - Configuration options\n   * @param options.maxAttempts - Maximum number of retry attempts (default: 3)\n   * @param options.baseDelay - Initial delay in milliseconds (default: 1000)\n   * @param options.maxDelay - Maximum delay cap in milliseconds (default: 30000)\n   * @param options.jitter - Whether to add random jitter to delays (default: true)\n   */\n  constructor(options: {\n    maxAttempts?: number;\n    baseDelay?: number;\n    maxDelay?: number;\n    jitter?: boolean;\n  } = {}) {\n    this.maxAttempts = options.maxAttempts ?? 3;\n    this.baseDelay = options.baseDelay ?? 1000;\n    this.maxDelay = options.maxDelay ?? 30000;\n    this.jitter = options.jitter ?? true;\n  }\n\n  /**\n   * Determines whether to retry and calculates the delay.\n   *\n   * @param error - The error that triggered the retry\n   * @param attempt - Current attempt number (1-indexed)\n   * @returns Delay in milliseconds before next retry, or null to stop retrying\n   */\n  onRetry(error: UPPError, attempt: number): number | null {\n    if (attempt > this.maxAttempts) {\n      return null;\n    }\n\n    if (!this.isRetryable(error)) {\n      return null;\n    }\n\n    let delay = this.baseDelay * Math.pow(2, attempt - 1);\n    delay = Math.min(delay, this.maxDelay);\n\n    if (this.jitter) {\n      delay = delay * (0.5 + Math.random());\n    }\n\n    return Math.floor(delay);\n  }\n\n  /**\n   * Checks if an error is eligible for retry.\n   *\n   * @param error - The error to evaluate\n   * @returns True if the error is transient and retryable\n   */\n  private isRetryable(error: UPPError): boolean {\n    return (\n      error.code === 'RATE_LIMITED' ||\n      error.code === 'NETWORK_ERROR' ||\n      error.code === 'TIMEOUT' ||\n      error.code === 'PROVIDER_ERROR'\n    );\n  }\n}\n\n/**\n * Implements linear backoff where delays increase proportionally with each attempt.\n *\n * Unlike exponential backoff, linear backoff increases delays at a constant rate:\n * - Attempt 1: delay * 1 (e.g., 1000ms)\n * - Attempt 2: delay * 2 (e.g., 2000ms)\n * - Attempt 3: delay * 3 (e.g., 3000ms)\n *\n * This strategy is simpler and more predictable than exponential backoff,\n * suitable for scenarios where gradual delay increase is preferred over\n * aggressive backoff.\n *\n * Only retries on transient errors: RATE_LIMITED, NETWORK_ERROR, TIMEOUT, PROVIDER_ERROR\n *\n * @implements {RetryStrategy}\n *\n * @example\n * ```typescript\n * // Default configuration (3 retries, 1s delay increment)\n * const retry = new LinearBackoff();\n *\n * // Custom configuration\n * const customRetry = new LinearBackoff({\n *   maxAttempts: 4,  // Up to 4 retry attempts\n *   delay: 2000      // 2s, 4s, 6s, 8s delays\n * });\n *\n * // Use with provider\n * const provider = createAnthropic({\n *   retryStrategy: customRetry\n * });\n * ```\n */\nexport class LinearBackoff implements RetryStrategy {\n  private maxAttempts: number;\n  private delay: number;\n\n  /**\n   * Creates a new LinearBackoff instance.\n   *\n   * @param options - Configuration options\n   * @param options.maxAttempts - Maximum number of retry attempts (default: 3)\n   * @param options.delay - Base delay multiplier in milliseconds (default: 1000)\n   */\n  constructor(options: {\n    maxAttempts?: number;\n    delay?: number;\n  } = {}) {\n    this.maxAttempts = options.maxAttempts ?? 3;\n    this.delay = options.delay ?? 1000;\n  }\n\n  /**\n   * Determines whether to retry and calculates the linear delay.\n   *\n   * @param error - The error that triggered the retry\n   * @param attempt - Current attempt number (1-indexed)\n   * @returns Delay in milliseconds (delay * attempt), or null to stop retrying\n   */\n  onRetry(error: UPPError, attempt: number): number | null {\n    if (attempt > this.maxAttempts) {\n      return null;\n    }\n\n    if (!this.isRetryable(error)) {\n      return null;\n    }\n\n    return this.delay * attempt;\n  }\n\n  /**\n   * Checks if an error is eligible for retry.\n   *\n   * @param error - The error to evaluate\n   * @returns True if the error is transient and retryable\n   */\n  private isRetryable(error: UPPError): boolean {\n    return (\n      error.code === 'RATE_LIMITED' ||\n      error.code === 'NETWORK_ERROR' ||\n      error.code === 'TIMEOUT' ||\n      error.code === 'PROVIDER_ERROR'\n    );\n  }\n}\n\n/**\n * Disables all retry behavior, failing immediately on any error.\n *\n * Use this strategy when:\n * - Retries are handled at a higher level in your application\n * - You want immediate failure feedback\n * - The operation is not idempotent\n * - Time sensitivity requires fast failure\n *\n * @implements {RetryStrategy}\n *\n * @example\n * ```typescript\n * // Disable retries for time-sensitive operations\n * const provider = createOpenAI({\n *   retryStrategy: new NoRetry()\n * });\n * ```\n */\nexport class NoRetry implements RetryStrategy {\n  /**\n   * Always returns null to indicate no retry should be attempted.\n   *\n   * @returns Always returns null\n   */\n  onRetry(): null {\n    return null;\n  }\n}\n\n/**\n * Implements token bucket rate limiting with automatic refill.\n *\n * The token bucket algorithm provides smooth rate limiting by:\n * - Maintaining a bucket of tokens that replenish over time\n * - Consuming one token per request\n * - Delaying requests when the bucket is empty\n * - Allowing burst traffic up to the bucket capacity\n *\n * This is particularly useful for:\n * - Client-side rate limiting to avoid hitting API rate limits\n * - Smoothing request patterns to maintain consistent throughput\n * - Preventing accidental API abuse\n *\n * Unlike other retry strategies, TokenBucket implements {@link beforeRequest}\n * to proactively delay requests before they are made.\n *\n * @implements {RetryStrategy}\n *\n * @example\n * ```typescript\n * // Allow 10 requests burst, refill 1 token per second\n * const bucket = new TokenBucket({\n *   maxTokens: 10,    // Burst capacity\n *   refillRate: 1,    // Tokens per second\n *   maxAttempts: 3    // Retry attempts on rate limit\n * });\n *\n * // Aggressive rate limiting: 5 req/s sustained\n * const strictBucket = new TokenBucket({\n *   maxTokens: 5,\n *   refillRate: 5\n * });\n *\n * // Use with provider\n * const provider = createOpenAI({\n *   retryStrategy: bucket\n * });\n * ```\n */\nexport class TokenBucket implements RetryStrategy {\n  private tokens: number;\n  private maxTokens: number;\n  private refillRate: number;\n  private lastRefill: number;\n  private maxAttempts: number;\n\n  /**\n   * Creates a new TokenBucket instance.\n   *\n   * @param options - Configuration options\n   * @param options.maxTokens - Maximum bucket capacity (default: 10)\n   * @param options.refillRate - Tokens added per second (default: 1)\n   * @param options.maxAttempts - Maximum retry attempts on rate limit (default: 3)\n   */\n  constructor(options: {\n    maxTokens?: number;\n    refillRate?: number;\n    maxAttempts?: number;\n  } = {}) {\n    this.maxTokens = options.maxTokens ?? 10;\n    this.refillRate = options.refillRate ?? 1;\n    this.maxAttempts = options.maxAttempts ?? 3;\n    this.tokens = this.maxTokens;\n    this.lastRefill = Date.now();\n  }\n\n  /**\n   * Called before each request to consume a token or calculate wait time.\n   *\n   * Refills the bucket based on elapsed time, then either:\n   * - Returns 0 if a token is available (consumed immediately)\n   * - Returns the wait time in milliseconds until the next token\n   *\n   * @returns Delay in milliseconds before the request can proceed\n   */\n  beforeRequest(): number {\n    this.refill();\n\n    if (this.tokens >= 1) {\n      this.tokens -= 1;\n      return 0;\n    }\n\n    const msPerToken = 1000 / this.refillRate;\n    return Math.ceil(msPerToken);\n  }\n\n  /**\n   * Handles retry logic for rate-limited requests.\n   *\n   * Only retries on RATE_LIMITED errors, waiting for bucket refill.\n   *\n   * @param error - The error that triggered the retry\n   * @param attempt - Current attempt number (1-indexed)\n   * @returns Delay in milliseconds (time for 2 tokens), or null to stop\n   */\n  onRetry(error: UPPError, attempt: number): number | null {\n    if (attempt > this.maxAttempts) {\n      return null;\n    }\n\n    if (error.code !== 'RATE_LIMITED') {\n      return null;\n    }\n\n    const msPerToken = 1000 / this.refillRate;\n    return Math.ceil(msPerToken * 2);\n  }\n\n  /**\n   * Resets the bucket to full capacity.\n   *\n   * Called automatically on successful requests to restore available tokens.\n   */\n  reset(): void {\n    this.tokens = this.maxTokens;\n    this.lastRefill = Date.now();\n  }\n\n  /**\n   * Refills the bucket based on elapsed time since last refill.\n   */\n  private refill(): void {\n    const now = Date.now();\n    const elapsed = (now - this.lastRefill) / 1000;\n    const newTokens = elapsed * this.refillRate;\n\n    this.tokens = Math.min(this.maxTokens, this.tokens + newTokens);\n    this.lastRefill = now;\n  }\n}\n\n/**\n * Respects server-provided Retry-After headers for optimal retry timing.\n *\n * When servers return a 429 (Too Many Requests) response, they often include\n * a Retry-After header indicating when the client should retry. This strategy\n * uses that information for precise retry timing.\n *\n * Benefits over fixed backoff strategies:\n * - Follows server recommendations for optimal retry timing\n * - Avoids retrying too early and wasting requests\n * - Adapts to dynamic rate limit windows\n *\n * If no Retry-After header is provided, falls back to a configurable delay.\n * Only retries on RATE_LIMITED errors.\n *\n * @implements {RetryStrategy}\n *\n * @example\n * ```typescript\n * // Use server-recommended retry timing\n * const retryAfter = new RetryAfterStrategy({\n *   maxAttempts: 5,       // Retry up to 5 times\n *   fallbackDelay: 10000  // 10s fallback if no header\n * });\n *\n * // The doFetch function automatically calls setRetryAfter\n * // when a Retry-After header is present in the response\n *\n * const provider = createOpenAI({\n *   retryStrategy: retryAfter\n * });\n * ```\n */\nexport class RetryAfterStrategy implements RetryStrategy {\n  private maxAttempts: number;\n  private fallbackDelay: number;\n  private lastRetryAfter?: number;\n\n  /**\n   * Creates a new RetryAfterStrategy instance.\n   *\n   * @param options - Configuration options\n   * @param options.maxAttempts - Maximum number of retry attempts (default: 3)\n   * @param options.fallbackDelay - Delay in ms when no Retry-After header (default: 5000)\n   */\n  constructor(options: {\n    maxAttempts?: number;\n    fallbackDelay?: number;\n  } = {}) {\n    this.maxAttempts = options.maxAttempts ?? 3;\n    this.fallbackDelay = options.fallbackDelay ?? 5000;\n  }\n\n  /**\n   * Sets the retry delay from a Retry-After header value.\n   *\n   * Called by doFetch when a Retry-After header is present in the response.\n   * The value is used for the next onRetry call and then cleared.\n   *\n   * @param seconds - The Retry-After value in seconds\n   */\n  setRetryAfter(seconds: number): void {\n    this.lastRetryAfter = seconds * 1000;\n  }\n\n  /**\n   * Determines retry delay using Retry-After header or fallback.\n   *\n   * @param error - The error that triggered the retry\n   * @param attempt - Current attempt number (1-indexed)\n   * @returns Delay from Retry-After header or fallback, null to stop\n   */\n  onRetry(error: UPPError, attempt: number): number | null {\n    if (attempt > this.maxAttempts) {\n      return null;\n    }\n\n    if (error.code !== 'RATE_LIMITED') {\n      return null;\n    }\n\n    const delay = this.lastRetryAfter ?? this.fallbackDelay;\n    this.lastRetryAfter = undefined;\n    return delay;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-UMKWXGO3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/id.ts","../src/types/messages.ts"],"sourcesContent":["/**\n * @fileoverview ID generation utilities for the Universal Provider Protocol.\n *\n * Provides functions for generating unique identifiers used throughout UPP,\n * including message IDs, tool call IDs, and other internal references.\n *\n * @module utils/id\n */\n\n/**\n * Generates a unique UUID v4 identifier.\n *\n * Uses the native `crypto.randomUUID()` when available for cryptographically\n * secure randomness. Falls back to a Math.random-based implementation for\n * environments without Web Crypto API support.\n *\n * @returns A UUID v4 string in the format `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`\n *\n * @example\n * ```typescript\n * const messageId = generateId();\n * // => \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n * ```\n */\nexport function generateId(): string {\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Generates a short alphanumeric identifier.\n *\n * Creates a 12-character random string using alphanumeric characters (a-z, A-Z, 0-9).\n * Useful for tool call IDs and other cases where a full UUID is not required.\n *\n * @param prefix - Optional prefix to prepend to the generated ID\n * @returns A string containing the prefix followed by 12 random alphanumeric characters\n *\n * @example\n * ```typescript\n * const toolCallId = generateShortId('call_');\n * // => \"call_aB3xY9mK2pQr\"\n *\n * const simpleId = generateShortId();\n * // => \"Tz4wN8vL1sHj\"\n * ```\n */\nexport function generateShortId(prefix = ''): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let result = prefix;\n  for (let i = 0; i < 12; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n","/**\n * @fileoverview Message types for conversation history.\n *\n * Defines the message classes used to represent conversation turns\n * between users and assistants, including support for multimodal\n * content and tool calls.\n *\n * @module types/messages\n */\n\nimport { generateId } from '../utils/id.ts';\nimport type {\n  ContentBlock,\n  TextBlock,\n  ImageBlock,\n  AudioBlock,\n  VideoBlock,\n  UserContent,\n  AssistantContent,\n} from './content.ts';\nimport type { ToolCall, ToolResult } from './tool.ts';\n\n/**\n * Message serialized to JSON format.\n * Picks common fields from Message, converts timestamp to string.\n */\nexport type MessageJSON = Pick<Message, 'id' | 'type' | 'metadata'> & {\n  timestamp: string;\n  content: ContentBlock[];\n  toolCalls?: ToolCall[];\n  results?: ToolResult[];\n};\n\n/**\n * Message type discriminator.\n *\n * Used to distinguish between different message types in a conversation.\n */\nexport type MessageType = 'user' | 'assistant' | 'tool_result';\n\n/**\n * Provider-namespaced metadata for messages.\n *\n * Each provider can attach its own metadata under its namespace,\n * preventing conflicts between different providers.\n *\n * @example\n * ```typescript\n * const metadata: MessageMetadata = {\n *   openai: { model: 'gpt-4', finishReason: 'stop' },\n *   anthropic: { model: 'claude-3', stopReason: 'end_turn' }\n * };\n * ```\n */\nexport interface MessageMetadata {\n  [provider: string]: Record<string, unknown> | undefined;\n}\n\n/**\n * Options for constructing messages.\n */\nexport interface MessageOptions {\n  /** Custom message ID (auto-generated if not provided) */\n  id?: string;\n\n  /** Provider-specific metadata */\n  metadata?: MessageMetadata;\n}\n\n/**\n * Abstract base class for all message types.\n *\n * Provides common functionality for user, assistant, and tool result\n * messages, including content accessors and metadata handling.\n *\n * @example\n * ```typescript\n * // Access text content from any message\n * const text = message.text;\n *\n * // Access images\n * const images = message.images;\n * ```\n */\nexport abstract class Message {\n  /** Unique message identifier */\n  readonly id: string;\n\n  /** Timestamp when the message was created */\n  readonly timestamp: Date;\n\n  /** Provider-specific metadata, namespaced by provider name */\n  readonly metadata?: MessageMetadata;\n\n  /** Message type discriminator (implemented by subclasses) */\n  abstract readonly type: MessageType;\n\n  /**\n   * Returns the content blocks for this message.\n   * Implemented by subclasses to provide type-specific content.\n   */\n  protected abstract getContent(): ContentBlock[];\n\n  /**\n   * Creates a new message instance.\n   *\n   * @param options - Optional message ID and metadata\n   */\n  constructor(options?: MessageOptions) {\n    this.id = options?.id ?? generateId();\n    this.timestamp = new Date();\n    this.metadata = options?.metadata;\n  }\n\n  /**\n   * Concatenated text content from all text blocks.\n   * Blocks are joined with double newlines.\n   */\n  get text(): string {\n    return this.getContent()\n      .filter((block): block is TextBlock => block.type === 'text')\n      .map((block) => block.text)\n      .join('\\n\\n');\n  }\n\n  /**\n   * All image content blocks in this message.\n   */\n  get images(): ImageBlock[] {\n    return this.getContent().filter((block): block is ImageBlock => block.type === 'image');\n  }\n\n  /**\n   * All audio content blocks in this message.\n   */\n  get audio(): AudioBlock[] {\n    return this.getContent().filter((block): block is AudioBlock => block.type === 'audio');\n  }\n\n  /**\n   * All video content blocks in this message.\n   */\n  get video(): VideoBlock[] {\n    return this.getContent().filter((block): block is VideoBlock => block.type === 'video');\n  }\n}\n\n/**\n * User input message.\n *\n * Represents a message from the user, which can contain text and/or\n * multimodal content like images, audio, or video.\n *\n * @example\n * ```typescript\n * // Simple text message\n * const msg = new UserMessage('Hello, world!');\n *\n * // Multimodal message\n * const msg = new UserMessage([\n *   { type: 'text', text: 'What is in this image?' },\n *   { type: 'image', source: { type: 'url', url: '...' }, mimeType: 'image/png' }\n * ]);\n * ```\n */\nexport class UserMessage extends Message {\n  /** Message type discriminator */\n  readonly type = 'user' as const;\n\n  /** Content blocks in this message */\n  readonly content: UserContent[];\n\n  /**\n   * Creates a new user message.\n   *\n   * @param content - String (converted to TextBlock) or array of content blocks\n   * @param options - Optional message ID and metadata\n   */\n  constructor(content: string | UserContent[], options?: MessageOptions) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n}\n\n/**\n * Assistant response message.\n *\n * Represents a response from the AI assistant, which may contain\n * text, media content, and/or tool call requests.\n *\n * @example\n * ```typescript\n * // Simple text response\n * const msg = new AssistantMessage('Hello! How can I help?');\n *\n * // Response with tool calls\n * const msg = new AssistantMessage(\n *   'Let me check the weather...',\n *   [{ toolCallId: 'call_1', toolName: 'get_weather', arguments: { location: 'NYC' } }]\n * );\n * ```\n */\nexport class AssistantMessage extends Message {\n  /** Message type discriminator */\n  readonly type = 'assistant' as const;\n\n  /** Content blocks in this message */\n  readonly content: AssistantContent[];\n\n  /** Tool calls requested by the model (if any) */\n  readonly toolCalls?: ToolCall[];\n\n  /**\n   * Creates a new assistant message.\n   *\n   * @param content - String (converted to TextBlock) or array of content blocks\n   * @param toolCalls - Tool calls requested by the model\n   * @param options - Optional message ID and metadata\n   */\n  constructor(\n    content: string | AssistantContent[],\n    toolCalls?: ToolCall[],\n    options?: MessageOptions\n  ) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n    this.toolCalls = toolCalls;\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n\n  /**\n   * Whether this message contains tool call requests.\n   */\n  get hasToolCalls(): boolean {\n    return this.toolCalls !== undefined && this.toolCalls.length > 0;\n  }\n}\n\n/**\n * Tool execution result message.\n *\n * Contains the results of executing one or more tool calls,\n * sent back to the model for further processing.\n *\n * @example\n * ```typescript\n * const msg = new ToolResultMessage([\n *   { toolCallId: 'call_1', result: { temperature: 72, conditions: 'sunny' } },\n *   { toolCallId: 'call_2', result: 'File not found', isError: true }\n * ]);\n * ```\n */\nexport class ToolResultMessage extends Message {\n  /** Message type discriminator */\n  readonly type = 'tool_result' as const;\n\n  /** Results from tool executions */\n  readonly results: ToolResult[];\n\n  /**\n   * Creates a new tool result message.\n   *\n   * @param results - Array of tool execution results\n   * @param options - Optional message ID and metadata\n   */\n  constructor(results: ToolResult[], options?: MessageOptions) {\n    super(options);\n    this.results = results;\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.results.map((result) => ({\n      type: 'text' as const,\n      text:\n        typeof result.result === 'string'\n          ? result.result\n          : JSON.stringify(result.result),\n    }));\n  }\n}\n\n/**\n * Type guard for UserMessage.\n *\n * @param msg - The message to check\n * @returns True if the message is a UserMessage\n *\n * @example\n * ```typescript\n * if (isUserMessage(msg)) {\n *   console.log('User said:', msg.text);\n * }\n * ```\n */\nexport function isUserMessage(msg: Message): msg is UserMessage {\n  return msg.type === 'user';\n}\n\n/**\n * Type guard for AssistantMessage.\n *\n * @param msg - The message to check\n * @returns True if the message is an AssistantMessage\n *\n * @example\n * ```typescript\n * if (isAssistantMessage(msg)) {\n *   console.log('Assistant said:', msg.text);\n *   if (msg.hasToolCalls) {\n *     console.log('Tool calls:', msg.toolCalls);\n *   }\n * }\n * ```\n */\nexport function isAssistantMessage(msg: Message): msg is AssistantMessage {\n  return msg.type === 'assistant';\n}\n\n/**\n * Type guard for ToolResultMessage.\n *\n * @param msg - The message to check\n * @returns True if the message is a ToolResultMessage\n *\n * @example\n * ```typescript\n * if (isToolResultMessage(msg)) {\n *   for (const result of msg.results) {\n *     console.log(`Tool ${result.toolCallId}:`, result.result);\n *   }\n * }\n * ```\n */\nexport function isToolResultMessage(msg: Message): msg is ToolResultMessage {\n  return msg.type === 'tool_result';\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-Z7RBRCRN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/http/sse.ts"],"sourcesContent":["/**\n * Server-Sent Events (SSE) stream parsing utilities.\n * @module http/sse\n */\n\n/**\n * Parses a Server-Sent Events stream into JSON objects.\n *\n * This async generator handles the standard SSE wire format:\n * - Lines prefixed with \"data:\" contain event data\n * - Lines prefixed with \"event:\" specify event types\n * - Lines prefixed with \":\" are comments (used for keep-alive)\n * - Events are separated by double newlines\n * - Stream terminates on \"[DONE]\" message (OpenAI convention)\n *\n * Also handles non-standard formats used by some providers:\n * - Raw JSON without \"data:\" prefix (Google)\n * - Multi-line data fields\n *\n * @param body - ReadableStream from fetch response body\n * @yields Parsed JSON objects from each SSE event\n *\n * @example\n * ```typescript\n * const response = await doStreamFetch(url, init, config, 'openai', 'llm');\n *\n * for await (const event of parseSSEStream(response.body!)) {\n *   // event is parsed JSON from each SSE data field\n *   const chunk = event as OpenAIStreamChunk;\n *   const delta = chunk.choices[0]?.delta?.content;\n *   if (delta) {\n *     process.stdout.write(delta);\n *   }\n * }\n * ```\n */\nexport async function* parseSSEStream(\n  body: ReadableStream<Uint8Array>\n): AsyncGenerator<unknown, void, unknown> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\n      if (done) {\n        // Process any remaining data in buffer\n        if (buffer.trim()) {\n          const event = parseSSEEvent(buffer);\n          if (event !== null && event !== undefined) {\n            yield event;\n          }\n        }\n        break;\n      }\n\n      buffer += decoder.decode(value, { stream: true });\n\n      // Process complete events (separated by double newlines or \\r\\n\\r\\n)\n      const events = buffer.split(/\\r?\\n\\r?\\n/);\n\n      // Keep the last partial event in the buffer\n      buffer = events.pop() ?? '';\n\n      for (const eventText of events) {\n        if (!eventText.trim()) continue;\n\n        const event = parseSSEEvent(eventText);\n        if (event === 'DONE') {\n          return;\n        }\n        if (event !== null && event !== undefined) {\n          yield event;\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * Parses a single SSE event block into a JSON object.\n *\n * Handles the following line prefixes:\n * - \"data:\" - Event data (multiple data lines are concatenated)\n * - \"event:\" - Event type (added to result as _eventType)\n * - \":\" - Comment (ignored, often used for keep-alive)\n * - Raw JSON starting with { or [ (provider-specific fallback)\n *\n * @param eventText - Raw text of a single SSE event block\n * @returns Parsed JSON object, 'DONE' for termination signal, or null for invalid/empty events\n */\nfunction parseSSEEvent(eventText: string): unknown | 'DONE' | null {\n  const lines = eventText.split('\\n');\n  let data = '';\n  let eventType = '';\n\n  for (const line of lines) {\n    const trimmedLine = line.trim();\n    if (trimmedLine.startsWith('event:')) {\n      eventType = trimmedLine.slice(6).trim();\n    } else if (trimmedLine.startsWith('data:')) {\n      const lineData = trimmedLine.slice(5).trim();\n      data += (data ? '\\n' : '') + lineData;\n    } else if (trimmedLine.startsWith(':')) {\n      continue;\n    } else if (trimmedLine.startsWith('{') || trimmedLine.startsWith('[')) {\n      data += (data ? '\\n' : '') + trimmedLine;\n    }\n  }\n\n  if (!data) {\n    return null;\n  }\n\n  if (data === '[DONE]') {\n    return 'DONE';\n  }\n\n  try {\n    const parsed = JSON.parse(data);\n\n    if (eventType) {\n      return { _eventType: eventType, ...parsed };\n    }\n\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parses a simple text stream without SSE formatting.\n *\n * This is a simpler alternative to {@link parseSSEStream} for providers\n * that stream raw text deltas without SSE event wrappers. Each chunk\n * from the response body is decoded and yielded as-is.\n *\n * Use this for:\n * - Plain text streaming responses\n * - Providers with custom streaming formats\n * - Testing and debugging stream handling\n *\n * @param body - ReadableStream from fetch response body\n * @yields Decoded text strings from each stream chunk\n *\n * @example\n * ```typescript\n * const response = await doStreamFetch(url, init, config, 'custom', 'llm');\n *\n * for await (const text of parseSimpleTextStream(response.body!)) {\n *   process.stdout.write(text);\n * }\n * ```\n */\nexport async function* parseSimpleTextStream(\n  body: ReadableStream<Uint8Array>\n): AsyncGenerator<string, void, unknown> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\n      if (done) break;\n\n      const text = decoder.decode(value, { stream: true });\n      if (text) {\n        yield text;\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n"],"mappings":";AAoCA,gBAAuB,eACrB,MACwC;AACxC,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,SAAS;AAEb,MAAI;AACF,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAE1C,UAAI,MAAM;AAER,YAAI,OAAO,KAAK,GAAG;AACjB,gBAAM,QAAQ,cAAc,MAAM;AAClC,cAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,kBAAM;AAAA,UACR;AAAA,QACF;AACA;AAAA,MACF;AAEA,gBAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AAGhD,YAAM,SAAS,OAAO,MAAM,YAAY;AAGxC,eAAS,OAAO,IAAI,KAAK;AAEzB,iBAAW,aAAa,QAAQ;AAC9B,YAAI,CAAC,UAAU,KAAK,EAAG;AAEvB,cAAM,QAAQ,cAAc,SAAS;AACrC,YAAI,UAAU,QAAQ;AACpB;AAAA,QACF;AACA,YAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF,UAAE;AACA,WAAO,YAAY;AAAA,EACrB;AACF;AAcA,SAAS,cAAc,WAA4C;AACjE,QAAM,QAAQ,UAAU,MAAM,IAAI;AAClC,MAAI,OAAO;AACX,MAAI,YAAY;AAEhB,aAAW,QAAQ,OAAO;AACxB,UAAM,cAAc,KAAK,KAAK;AAC9B,QAAI,YAAY,WAAW,QAAQ,GAAG;AACpC,kBAAY,YAAY,MAAM,CAAC,EAAE,KAAK;AAAA,IACxC,WAAW,YAAY,WAAW,OAAO,GAAG;AAC1C,YAAM,WAAW,YAAY,MAAM,CAAC,EAAE,KAAK;AAC3C,eAAS,OAAO,OAAO,MAAM;AAAA,IAC/B,WAAW,YAAY,WAAW,GAAG,GAAG;AACtC;AAAA,IACF,WAAW,YAAY,WAAW,GAAG,KAAK,YAAY,WAAW,GAAG,GAAG;AACrE,eAAS,OAAO,OAAO,MAAM;AAAA,IAC/B;AAAA,EACF;AAEA,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,UAAU;AACrB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,IAAI;AAE9B,QAAI,WAAW;AACb,aAAO,EAAE,YAAY,WAAW,GAAG,OAAO;AAAA,IAC5C;AAEA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA0BA,gBAAuB,sBACrB,MACuC;AACvC,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAU,IAAI,YAAY;AAEhC,MAAI;AACF,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAE1C,UAAI,KAAM;AAEV,YAAM,OAAO,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AACnD,UAAI,MAAM;AACR,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF,UAAE;AACA,WAAO,YAAY;AAAA,EACrB;AACF;","names":[]}

package/dist/content-DEl3z_W2.d.ts

@@ -1,276 +0,0 @@
-/**
- * @fileoverview Content block types for multimodal messages.
- *
- * Defines the various content block types that can be included in
- * user and assistant messages, supporting text, images, audio, video,
- * and arbitrary binary data.
- *
- * @module types/content
- */
-/**
- * Image source variants for ImageBlock.
- *
- * Images can be provided as base64-encoded strings, URLs, or raw bytes.
- *
- * @example
- * ```typescript
- * // Base64 encoded image
- * const base64Source: ImageSource = {
- *   type: 'base64',
- *   data: 'iVBORw0KGgo...'
- * };
- *
- * // URL reference
- * const urlSource: ImageSource = {
- *   type: 'url',
- *   url: 'https://example.com/image.png'
- * };
- *
- * // Raw bytes
- * const bytesSource: ImageSource = {
- *   type: 'bytes',
- *   data: new Uint8Array([...])
- * };
- * ```
- */
-type ImageSource = {
-    type: 'base64';
-    data: string;
-} | {
-    type: 'url';
-    url: string;
-} | {
-    type: 'bytes';
-    data: Uint8Array;
-};
-/**
- * Text content block.
- *
- * The most common content block type, containing plain text content.
- *
- * @example
- * ```typescript
- * const textBlock: TextBlock = {
- *   type: 'text',
- *   text: 'Hello, world!'
- * };
- * ```
- */
-interface TextBlock {
-    /** Discriminator for text blocks */
-    type: 'text';
-    /** The text content */
-    text: string;
-}
-/**
- * Image content block.
- *
- * Contains an image with its source data and metadata.
- *
- * @example
- * ```typescript
- * const imageBlock: ImageBlock = {
- *   type: 'image',
- *   source: { type: 'url', url: 'https://example.com/photo.jpg' },
- *   mimeType: 'image/jpeg',
- *   width: 1920,
- *   height: 1080
- * };
- * ```
- */
-interface ImageBlock {
-    /** Discriminator for image blocks */
-    type: 'image';
-    /** The image data source */
-    source: ImageSource;
-    /** MIME type of the image (e.g., 'image/png', 'image/jpeg') */
-    mimeType: string;
-    /** Image width in pixels */
-    width?: number;
-    /** Image height in pixels */
-    height?: number;
-}
-/**
- * Audio content block.
- *
- * Contains audio data with its metadata.
- *
- * @example
- * ```typescript
- * const audioBlock: AudioBlock = {
- *   type: 'audio',
- *   data: audioBytes,
- *   mimeType: 'audio/mp3',
- *   duration: 120.5
- * };
- * ```
- */
-interface AudioBlock {
-    /** Discriminator for audio blocks */
-    type: 'audio';
-    /** Raw audio data */
-    data: Uint8Array;
-    /** MIME type of the audio (e.g., 'audio/mp3', 'audio/wav') */
-    mimeType: string;
-    /** Duration in seconds */
-    duration?: number;
-}
-/**
- * Video content block.
- *
- * Contains video data with its metadata.
- *
- * @example
- * ```typescript
- * const videoBlock: VideoBlock = {
- *   type: 'video',
- *   data: videoBytes,
- *   mimeType: 'video/mp4',
- *   duration: 30,
- *   width: 1920,
- *   height: 1080
- * };
- * ```
- */
-interface VideoBlock {
-    /** Discriminator for video blocks */
-    type: 'video';
-    /** Raw video data */
-    data: Uint8Array;
-    /** MIME type of the video (e.g., 'video/mp4', 'video/webm') */
-    mimeType: string;
-    /** Duration in seconds */
-    duration?: number;
-    /** Video width in pixels */
-    width?: number;
-    /** Video height in pixels */
-    height?: number;
-}
-/**
- * Binary content block for arbitrary data.
- *
- * A generic block type for data that doesn't fit other categories.
- *
- * @example
- * ```typescript
- * const binaryBlock: BinaryBlock = {
- *   type: 'binary',
- *   data: pdfBytes,
- *   mimeType: 'application/pdf',
- *   metadata: { filename: 'document.pdf', pages: 10 }
- * };
- * ```
- */
-interface BinaryBlock {
-    /** Discriminator for binary blocks */
-    type: 'binary';
-    /** Raw binary data */
-    data: Uint8Array;
-    /** MIME type of the data */
-    mimeType: string;
-    /** Additional metadata about the binary content */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Union of all content block types.
- *
- * Used when a function or property can accept any type of content block.
- */
-type ContentBlock = TextBlock | ImageBlock | AudioBlock | VideoBlock | BinaryBlock;
-/**
- * Content types allowed in user messages.
- *
- * Users can send any type of content block including binary data.
- */
-type UserContent = TextBlock | ImageBlock | AudioBlock | VideoBlock | BinaryBlock;
-/**
- * Content types allowed in assistant messages.
- *
- * Assistants can generate text and media but not arbitrary binary data.
- */
-type AssistantContent = TextBlock | ImageBlock | AudioBlock | VideoBlock;
-/**
- * Creates a text content block from a string.
- *
- * @param content - The text content
- * @returns A TextBlock containing the provided text
- *
- * @example
- * ```typescript
- * const block = text('Hello, world!');
- * // { type: 'text', text: 'Hello, world!' }
- * ```
- */
-declare function text(content: string): TextBlock;
-/**
- * Type guard for TextBlock.
- *
- * @param block - The content block to check
- * @returns True if the block is a TextBlock
- *
- * @example
- * ```typescript
- * if (isTextBlock(block)) {
- *   console.log(block.text);
- * }
- * ```
- */
-declare function isTextBlock(block: ContentBlock): block is TextBlock;
-/**
- * Type guard for ImageBlock.
- *
- * @param block - The content block to check
- * @returns True if the block is an ImageBlock
- *
- * @example
- * ```typescript
- * if (isImageBlock(block)) {
- *   console.log(block.mimeType, block.width, block.height);
- * }
- * ```
- */
-declare function isImageBlock(block: ContentBlock): block is ImageBlock;
-/**
- * Type guard for AudioBlock.
- *
- * @param block - The content block to check
- * @returns True if the block is an AudioBlock
- *
- * @example
- * ```typescript
- * if (isAudioBlock(block)) {
- *   console.log(block.mimeType, block.duration);
- * }
- * ```
- */
-declare function isAudioBlock(block: ContentBlock): block is AudioBlock;
-/**
- * Type guard for VideoBlock.
- *
- * @param block - The content block to check
- * @returns True if the block is a VideoBlock
- *
- * @example
- * ```typescript
- * if (isVideoBlock(block)) {
- *   console.log(block.mimeType, block.duration);
- * }
- * ```
- */
-declare function isVideoBlock(block: ContentBlock): block is VideoBlock;
-/**
- * Type guard for BinaryBlock.
- *
- * @param block - The content block to check
- * @returns True if the block is a BinaryBlock
- *
- * @example
- * ```typescript
- * if (isBinaryBlock(block)) {
- *   console.log(block.mimeType, block.metadata);
- * }
- * ```
- */
-declare function isBinaryBlock(block: ContentBlock): block is BinaryBlock;
-
-export { type AssistantContent as A, type BinaryBlock as B, type ContentBlock as C, type ImageBlock as I, type TextBlock as T, type UserContent as U, type VideoBlock as V, type AudioBlock as a, type ImageSource as b, isImageBlock as c, isAudioBlock as d, isVideoBlock as e, isBinaryBlock as f, isTextBlock as i, text as t };