@providerprotocol/ai 0.0.20 → 0.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@providerprotocol/ai",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "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-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":";AA0CO,IAAM,qBAAN,MAAkD;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWR,YAAY,UAKR,CAAC,GAAG;AACN,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,YAAY,QAAQ,aAAa;AACtC,SAAK,WAAW,QAAQ,YAAY;AACpC,SAAK,SAAS,QAAQ,UAAU;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,QAAQ,OAAiB,SAAgC;AACvD,QAAI,UAAU,KAAK,aAAa;AAC9B,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,KAAK,YAAY,KAAK,GAAG;AAC5B,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ,KAAK,YAAY,KAAK,IAAI,GAAG,UAAU,CAAC;AACpD,YAAQ,KAAK,IAAI,OAAO,KAAK,QAAQ;AAErC,QAAI,KAAK,QAAQ;AACf,cAAQ,SAAS,MAAM,KAAK,OAAO;AAAA,IACrC;AAEA,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,YAAY,OAA0B;AAC5C,WACE,MAAM,SAAS,kBACf,MAAM,SAAS,mBACf,MAAM,SAAS,aACf,MAAM,SAAS;AAAA,EAEnB;AACF;AAmCO,IAAM,gBAAN,MAA6C;AAAA,EAC1C;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASR,YAAY,UAGR,CAAC,GAAG;AACN,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,QAAQ,QAAQ,SAAS;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,QAAQ,OAAiB,SAAgC;AACvD,QAAI,UAAU,KAAK,aAAa;AAC9B,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,KAAK,YAAY,KAAK,GAAG;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,YAAY,OAA0B;AAC5C,WACE,MAAM,SAAS,kBACf,MAAM,SAAS,mBACf,MAAM,SAAS,aACf,MAAM,SAAS;AAAA,EAEnB;AACF;AAqBO,IAAM,UAAN,MAAuC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5C,UAAgB;AACd,WAAO;AAAA,EACT;AACF;AA0CO,IAAM,cAAN,MAA2C;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUR,YAAY,UAIR,CAAC,GAAG;AACN,SAAK,YAAY,QAAQ,aAAa;AACtC,SAAK,aAAa,QAAQ,cAAc;AACxC,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,SAAS,KAAK;AACnB,SAAK,aAAa,KAAK,IAAI;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,gBAAwB;AACtB,SAAK,OAAO;AAEZ,QAAI,KAAK,UAAU,GAAG;AACpB,WAAK,UAAU;AACf,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,MAAO,KAAK;AAC/B,WAAO,KAAK,KAAK,UAAU;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,QAAQ,OAAiB,SAAgC;AACvD,QAAI,UAAU,KAAK,aAAa;AAC9B,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,SAAS,gBAAgB;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,MAAO,KAAK;AAC/B,WAAO,KAAK,KAAK,aAAa,CAAC;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAc;AACZ,SAAK,SAAS,KAAK;AACnB,SAAK,aAAa,KAAK,IAAI;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKQ,SAAe;AACrB,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,WAAW,MAAM,KAAK,cAAc;AAC1C,UAAM,YAAY,UAAU,KAAK;AAEjC,SAAK,SAAS,KAAK,IAAI,KAAK,WAAW,KAAK,SAAS,SAAS;AAC9D,SAAK,aAAa;AAAA,EACpB;AACF;AAmCO,IAAM,qBAAN,MAAkD;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASR,YAAY,UAGR,CAAC,GAAG;AACN,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,gBAAgB,QAAQ,iBAAiB;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,cAAc,SAAuB;AACnC,SAAK,iBAAiB,UAAU;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,QAAQ,OAAiB,SAAgC;AACvD,QAAI,UAAU,KAAK,aAAa;AAC9B,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,SAAS,gBAAgB;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,QAAQ,KAAK,kBAAkB,KAAK;AAC1C,SAAK,iBAAiB;AACtB,WAAO;AAAA,EACT;AACF;","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":";AAwBO,SAAS,aAAqB;AACnC,MAAI,OAAO,WAAW,eAAe,OAAO,YAAY;AACtD,WAAO,OAAO,WAAW;AAAA,EAC3B;AAEA,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;;;ACkDO,IAAe,UAAf,MAAuB;AAAA;AAAA,EAEnB;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBT,YAAY,SAA0B;AACpC,SAAK,KAAK,SAAS,MAAM,WAAW;AACpC,SAAK,YAAY,oBAAI,KAAK;AAC1B,SAAK,WAAW,SAAS;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,OAAe;AACjB,WAAO,KAAK,WAAW,EACpB,OAAO,CAAC,UAA8B,MAAM,SAAS,MAAM,EAC3D,IAAI,CAAC,UAAU,MAAM,IAAI,EACzB,KAAK,MAAM;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,SAAuB;AACzB,WAAO,KAAK,WAAW,EAAE,OAAO,CAAC,UAA+B,MAAM,SAAS,OAAO;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAsB;AACxB,WAAO,KAAK,WAAW,EAAE,OAAO,CAAC,UAA+B,MAAM,SAAS,OAAO;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,QAAsB;AACxB,WAAO,KAAK,WAAW,EAAE,OAAO,CAAC,UAA+B,MAAM,SAAS,OAAO;AAAA,EACxF;AACF;AAoBO,IAAM,cAAN,cAA0B,QAAQ;AAAA;AAAA,EAE9B,OAAO;AAAA;AAAA,EAGP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,YAAY,SAAiC,SAA0B;AACrE,UAAM,OAAO;AACb,QAAI,OAAO,YAAY,UAAU;AAC/B,WAAK,UAAU,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,IACjD,OAAO;AACL,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA,EAEU,aAA6B;AACrC,WAAO,KAAK;AAAA,EACd;AACF;AAoBO,IAAM,mBAAN,cAA+B,QAAQ;AAAA;AAAA,EAEnC,OAAO;AAAA;AAAA,EAGP;AAAA;AAAA,EAGA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,YACE,SACA,WACA,SACA;AACA,UAAM,OAAO;AACb,QAAI,OAAO,YAAY,UAAU;AAC/B,WAAK,UAAU,CAAC,EAAE,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,IACjD,OAAO;AACL,WAAK,UAAU;AAAA,IACjB;AACA,SAAK,YAAY;AAAA,EACnB;AAAA,EAEU,aAA6B;AACrC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,eAAwB;AAC1B,WAAO,KAAK,cAAc,UAAa,KAAK,UAAU,SAAS;AAAA,EACjE;AACF;AAgBO,IAAM,oBAAN,cAAgC,QAAQ;AAAA;AAAA,EAEpC,OAAO;AAAA;AAAA,EAGP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,YAAY,SAAuB,SAA0B;AAC3D,UAAM,OAAO;AACb,SAAK,UAAU;AAAA,EACjB;AAAA,EAEU,aAA6B;AACrC,WAAO,KAAK,QAAQ,IAAI,CAAC,YAAY;AAAA,MACnC,MAAM;AAAA,MACN,MACE,OAAO,OAAO,WAAW,WACrB,OAAO,SACP,KAAK,UAAU,OAAO,MAAM;AAAA,IACpC,EAAE;AAAA,EACJ;AACF;AAeO,SAAS,cAAc,KAAkC;AAC9D,SAAO,IAAI,SAAS;AACtB;AAkBO,SAAS,mBAAmB,KAAuC;AACxE,SAAO,IAAI,SAAS;AACtB;AAiBO,SAAS,oBAAoB,KAAwC;AAC1E,SAAO,IAAI,SAAS;AACtB;","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 };