@providerprotocol/ai 0.0.20 → 0.0.22

package/dist/chunk-RS7C25LS.js.map

@@ -0,0 +1 @@
+{"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(_error: UPPError, _attempt: number): 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  private lock: Promise<void>;\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    this.lock = Promise.resolve();\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   * This method may allow tokens to go negative to reserve future capacity\n   * and avoid concurrent callers oversubscribing the same refill.\n   *\n   * @returns Delay in milliseconds before the request can proceed\n   */\n  beforeRequest(): Promise<number> {\n    return this.withLock(() => {\n      this.refill();\n\n      if (this.tokens >= 1) {\n        this.tokens -= 1;\n        return 0;\n      }\n\n      const deficit = 1 - this.tokens;\n      const msPerToken = 1000 / this.refillRate;\n      this.tokens -= 1;\n      return Math.ceil(deficit * msPerToken);\n    });\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    void this.withLock(() => {\n      this.tokens = this.maxTokens;\n      this.lastRefill = Date.now();\n    });\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  private async withLock<T>(fn: () => T | Promise<T>): Promise<T> {\n    const next = this.lock.then(fn, fn);\n    this.lock = next.then(() => undefined, () => undefined);\n    return next;\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   * Creates a request-scoped copy of this strategy.\n   */\n  fork(): RetryAfterStrategy {\n    return new RetryAfterStrategy({\n      maxAttempts: this.maxAttempts,\n      fallbackDelay: this.fallbackDelay,\n    });\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/google/index.d.ts

@@ -1,4 +1,4 @@
-import { d as Provider } from '../provider-BBMBZuGn.js';
+import { a as ProviderConfig, g as Provider } from '../provider-DWEAzeM5.js';
 
 /**
  * Provider-specific parameters for Google Gemini API requests.
@@ -98,7 +98,7 @@ interface GoogleLLMParams {
      * const model = llm({
      *   model: google('gemini-2.5-flash'),
      *   params: {
-     *     builtInTools: [
+     *     tools: [
      *       tools.googleSearch(),
      *       tools.codeExecution(),
      *     ],
@@ -106,14 +106,14 @@ interface GoogleLLMParams {
      * });
      * ```
      */
-    builtInTools?: GoogleBuiltInTool[];
+    tools?: GoogleBuiltInTool[];
     /**
      * Tool configuration for retrieval (e.g., user location for Maps).
      *
      * @example
      * ```typescript
      * const params: GoogleLLMParams = {
-     *   builtInTools: [tools.googleMaps()],
+     *   tools: [tools.googleMaps()],
      *   toolConfig: {
      *     retrievalConfig: {
      *       latLng: { latitude: 40.758896, longitude: -73.985130 },
@@ -633,7 +633,7 @@ declare function fileSearchTool(options: {
  * const model = llm({
  *   model: google('gemini-2.5-flash'),
  *   params: {
- *     builtInTools: [
+ *     tools: [
  *       tools.googleSearch(),
  *       tools.codeExecution(),
  *     ],
@@ -671,6 +671,10 @@ declare const tools: {
 interface CacheCreateOptions {
     /** API key for authentication */
     apiKey: string;
+    /** Provider configuration (timeout, retry strategy, custom fetch) */
+    config?: ProviderConfig;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
     /** Model to associate with this cache (e.g., "gemini-3-flash-preview") */
     model: string;
     /** Optional display name for the cache (max 128 chars) */
@@ -692,6 +696,10 @@ interface CacheCreateOptions {
 interface CacheListOptions {
     /** API key for authentication */
     apiKey: string;
+    /** Provider configuration (timeout, retry strategy, custom fetch) */
+    config?: ProviderConfig;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
     /** Maximum number of caches to return per page */
     pageSize?: number;
     /** Token for fetching the next page of results */
@@ -736,6 +744,8 @@ declare function create(options: CacheCreateOptions): Promise<GoogleCacheRespons
  *
  * @param name - The cache name (format: "cachedContents/{id}")
  * @param apiKey - API key for authentication
+ * @param config - Provider configuration (timeout, retry strategy, custom fetch)
+ * @param signal - Abort signal for cancellation
  * @returns The cache entry details
  *
  * @example
@@ -744,7 +754,7 @@ declare function create(options: CacheCreateOptions): Promise<GoogleCacheRespons
  * console.log(`Cache expires at: ${cache.expireTime}`);
  * ```
  */
-declare function get(name: string, apiKey: string): Promise<GoogleCacheResponse>;
+declare function get(name: string, apiKey: string, config?: ProviderConfig, signal?: AbortSignal): Promise<GoogleCacheResponse>;
 /**
  * Lists all cached content entries.
  *
@@ -771,8 +781,10 @@ declare function list(options: CacheListOptions): Promise<GoogleCacheListRespons
  * (contents, systemInstruction, tools) are immutable after creation.
  *
  * @param name - The cache name (format: "cachedContents/{id}")
- * @param update - The update to apply (ttl or expireTime)
+ * @param update - The update to apply (exactly one of ttl or expireTime)
  * @param apiKey - API key for authentication
+ * @param config - Provider configuration (timeout, retry strategy, custom fetch)
+ * @param signal - Abort signal for cancellation
  * @returns The updated cache entry
  *
  * @example
@@ -785,19 +797,21 @@ declare function list(options: CacheListOptions): Promise<GoogleCacheListRespons
  * );
  * ```
  */
-declare function update(name: string, updateRequest: GoogleCacheUpdateRequest, apiKey: string): Promise<GoogleCacheResponse>;
+declare function update(name: string, updateRequest: GoogleCacheUpdateRequest, apiKey: string, config?: ProviderConfig, signal?: AbortSignal): Promise<GoogleCacheResponse>;
 /**
  * Deletes a cached content entry.
  *
  * @param name - The cache name (format: "cachedContents/{id}")
  * @param apiKey - API key for authentication
+ * @param config - Provider configuration (timeout, retry strategy, custom fetch)
+ * @param signal - Abort signal for cancellation
  *
  * @example
  * ```typescript
  * await google.cache.delete('cachedContents/abc123', apiKey);
  * ```
  */
-declare function deleteCache(name: string, apiKey: string): Promise<void>;
+declare function deleteCache(name: string, apiKey: string, config?: ProviderConfig, signal?: AbortSignal): Promise<void>;
 /**
  * Cache utilities namespace.
  *
@@ -878,25 +892,20 @@ interface GoogleEmbedParams {
  * @example
  * ```typescript
  * import { google } from './providers/google';
+ * import { llm } from './core/llm';
  *
- * // Create a model instance
- * const gemini = google.llm.bind('gemini-1.5-pro');
- *
- * // Simple completion
- * const response = await gemini.complete({
- *   messages: [{ role: 'user', content: [{ type: 'text', text: 'Hello!' }] }],
+ * const gemini = llm({
+ *   model: google('gemini-1.5-pro'),
  *   config: { apiKey: process.env.GOOGLE_API_KEY },
  * });
  *
- * // Streaming completion
- * const stream = gemini.stream({
- *   messages: [{ role: 'user', content: [{ type: 'text', text: 'Tell me a story' }] }],
- *   config: { apiKey: process.env.GOOGLE_API_KEY },
- * });
+ * const turn = await gemini.generate('Hello!');
+ * console.log(turn.response.text);
  *
+ * const stream = gemini.stream('Tell me a story');
  * for await (const event of stream) {
  *   if (event.type === 'text_delta') {
- *     process.stdout.write(event.delta.text);
+ *     process.stdout.write(event.delta.text ?? '');
  *   }
  * }
  * ```
@@ -913,12 +922,14 @@ interface GoogleEmbedParams {
  * });
  *
  * // Use cache in requests
- * const response = await gemini.complete({
- *   messages: [userMessage('Review this function')],
+ * const cachedModel = llm({
+ *   model: google('gemini-3-flash-preview'),
  *   config: { apiKey: process.env.GOOGLE_API_KEY },
  *   params: { cachedContent: cacheEntry.name },
  * });
  *
+ * const response = await cachedModel.generate('Review this function');
+ *
  * // Manage caches
  * await google.cache.update(cacheEntry.name, { ttl: '7200s' }, apiKey);
  * await google.cache.delete(cacheEntry.name, apiKey);
@@ -933,7 +944,7 @@ declare const google: Provider<unknown> & {
         get: typeof get;
         list: typeof list;
         update: typeof update;
-        delete: (name: string, apiKey: string) => Promise<void>;
+        delete: (name: string, apiKey: string, config?: ProviderConfig, signal?: AbortSignal) => Promise<void>;
     };
 };