@providerprotocol/ai 0.0.22 → 0.0.23

package/dist/{provider-DWEAzeM5.d.ts → provider-DR1yins0.d.ts}

@@ -7,6 +7,68 @@
  *
  * @module types/content
  */
+/**
+ * Content block type constants.
+ *
+ * Use these constants instead of raw strings for type-safe content handling:
+ *
+ * @example
+ * ```typescript
+ * import { ContentBlockType } from 'upp';
+ *
+ * if (block.type === ContentBlockType.Text) {
+ *   console.log(block.text);
+ * } else if (block.type === ContentBlockType.Image) {
+ *   console.log(block.mimeType);
+ * }
+ * ```
+ */
+declare const ContentBlockType: {
+    /** Text content */
+    readonly Text: "text";
+    /** Image content */
+    readonly Image: "image";
+    /** Audio content */
+    readonly Audio: "audio";
+    /** Video content */
+    readonly Video: "video";
+    /** Binary/arbitrary data content */
+    readonly Binary: "binary";
+};
+/**
+ * Content block type discriminator union.
+ *
+ * This type is derived from {@link ContentBlockType} constants.
+ */
+type ContentBlockType = (typeof ContentBlockType)[keyof typeof ContentBlockType];
+/**
+ * Image source type constants.
+ *
+ * @example
+ * ```typescript
+ * import { ImageSourceType } from 'upp';
+ *
+ * if (source.type === ImageSourceType.Base64) {
+ *   // Handle base64 encoded image
+ * } else if (source.type === ImageSourceType.Url) {
+ *   // Handle URL reference
+ * }
+ * ```
+ */
+declare const ImageSourceType: {
+    /** Base64-encoded image data */
+    readonly Base64: "base64";
+    /** URL reference to image */
+    readonly Url: "url";
+    /** Raw bytes image data */
+    readonly Bytes: "bytes";
+};
+/**
+ * Image source type discriminator union.
+ *
+ * This type is derived from {@link ImageSourceType} constants.
+ */
+type ImageSourceType = (typeof ImageSourceType)[keyof typeof ImageSourceType];
 /**
  * Image source variants for ImageBlock.
  *
@@ -282,70 +344,100 @@ declare function isBinaryBlock(block: ContentBlock): block is BinaryBlock;
  * @module types/errors
  */
 /**
- * Normalized error codes for cross-provider error handling.
+ * Error code constants for cross-provider error handling.
  *
- * These codes provide a consistent way to identify and handle errors
- * regardless of which AI provider generated them.
+ * Use these constants instead of raw strings for type-safe error handling:
  *
  * @example
  * ```typescript
+ * import { ErrorCode } from 'upp';
+ *
  * try {
  *   await llm.generate('Hello');
  * } catch (error) {
  *   if (error instanceof UPPError) {
  *     switch (error.code) {
- *       case 'RATE_LIMITED':
+ *       case ErrorCode.RateLimited:
  *         await delay(error.retryAfter);
  *         break;
- *       case 'AUTHENTICATION_FAILED':
+ *       case ErrorCode.AuthenticationFailed:
  *         throw new Error('Invalid API key');
  *     }
  *   }
  * }
  * ```
  */
-type ErrorCode = 
-/** API key is invalid or expired */
-'AUTHENTICATION_FAILED'
-/** Rate limit exceeded, retry after delay */
- | 'RATE_LIMITED'
-/** Input exceeds model's context window */
- | 'CONTEXT_LENGTH_EXCEEDED'
-/** Requested model does not exist */
- | 'MODEL_NOT_FOUND'
-/** Request parameters are malformed */
- | 'INVALID_REQUEST'
-/** Provider returned an unexpected response format */
- | 'INVALID_RESPONSE'
-/** Content was blocked by safety filters */
- | 'CONTENT_FILTERED'
-/** Account quota or credits exhausted */
- | 'QUOTA_EXCEEDED'
-/** Provider-specific error not covered by other codes */
- | 'PROVIDER_ERROR'
-/** Network connectivity issue */
- | 'NETWORK_ERROR'
-/** Request exceeded timeout limit */
- | 'TIMEOUT'
-/** Request was cancelled via AbortSignal */
- | 'CANCELLED';
-/**
- * Modality types supported by UPP.
- *
- * Each modality represents a different type of AI capability that
- * can be provided by a UPP-compatible provider.
- */
-type Modality = 
-/** Large language model for text generation */
-'llm'
-/** Text/image embedding model */
- | 'embedding'
-/** Image generation model */
- | 'image'
-/** Audio processing/generation model */
- | 'audio'
-/** Video processing/generation model */
- | 'video';
+declare const ErrorCode: {
+    /** API key is invalid or expired */
+    readonly AuthenticationFailed: "AUTHENTICATION_FAILED";
+    /** Rate limit exceeded, retry after delay */
+    readonly RateLimited: "RATE_LIMITED";
+    /** Input exceeds model's context window */
+    readonly ContextLengthExceeded: "CONTEXT_LENGTH_EXCEEDED";
+    /** Requested model does not exist */
+    readonly ModelNotFound: "MODEL_NOT_FOUND";
+    /** Request parameters are malformed */
+    readonly InvalidRequest: "INVALID_REQUEST";
+    /** Provider returned an unexpected response format */
+    readonly InvalidResponse: "INVALID_RESPONSE";
+    /** Content was blocked by safety filters */
+    readonly ContentFiltered: "CONTENT_FILTERED";
+    /** Account quota or credits exhausted */
+    readonly QuotaExceeded: "QUOTA_EXCEEDED";
+    /** Provider-specific error not covered by other codes */
+    readonly ProviderError: "PROVIDER_ERROR";
+    /** Network connectivity issue */
+    readonly NetworkError: "NETWORK_ERROR";
+    /** Request exceeded timeout limit */
+    readonly Timeout: "TIMEOUT";
+    /** Request was cancelled via AbortSignal */
+    readonly Cancelled: "CANCELLED";
+};
+/**
+ * Error code discriminator union.
+ *
+ * This type is derived from {@link ErrorCode} constants. Use `ErrorCode.RateLimited`
+ * for constants or `type MyCode = ErrorCode` for type annotations.
+ */
+type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Modality type discriminator union.
+ *
+ * This type is derived from {@link ModalityType} constants. The name `Modality`
+ * is kept for backward compatibility; `ModalityType` works as both the const
+ * object and this type.
+ */
+type Modality = (typeof ModalityType)[keyof typeof ModalityType];
+/**
+ * Modality type constants.
+ *
+ * Use these constants for type-safe modality handling:
+ *
+ * @example
+ * ```typescript
+ * import { ModalityType } from 'upp';
+ *
+ * if (provider.modality === ModalityType.LLM) {
+ *   // Handle LLM provider
+ * }
+ * ```
+ */
+declare const ModalityType: {
+    /** Large language model for text generation */
+    readonly LLM: "llm";
+    /** Text/image embedding model */
+    readonly Embedding: "embedding";
+    /** Image generation model */
+    readonly Image: "image";
+    /** Audio processing/generation model */
+    readonly Audio: "audio";
+    /** Video processing/generation model */
+    readonly Video: "video";
+};
+/**
+ * Type alias for Modality, allowing `ModalityType` to work as both const and type.
+ */
+type ModalityType = Modality;
 /**
  * Unified Provider Protocol Error.
  *
@@ -354,26 +446,30 @@ type Modality =
  *
  * @example
  * ```typescript
+ * import { ErrorCode, ModalityType } from 'upp';
+ *
  * throw new UPPError(
  *   'API key is invalid',
- *   'AUTHENTICATION_FAILED',
+ *   ErrorCode.AuthenticationFailed,
  *   'openai',
- *   'llm',
+ *   ModalityType.LLM,
  *   401
  * );
  * ```
  *
  * @example
  * ```typescript
+ * import { ErrorCode, ModalityType } from 'upp';
+ *
  * // Wrapping a provider error
  * try {
  *   await openai.chat.completions.create({ ... });
  * } catch (err) {
  *   throw new UPPError(
  *     'OpenAI request failed',
- *     'PROVIDER_ERROR',
+ *     ErrorCode.ProviderError,
  *     'openai',
- *     'llm',
+ *     ModalityType.LLM,
  *     err.status,
  *     err
  *   );
@@ -1326,4 +1422,4 @@ type ImageProvider<TParams = unknown, TOptions = unknown> = Provider<TOptions> &
     readonly __params?: TParams;
 };
 
-export { type ImageHandler$1 as $, type AssistantContent as A, type BoundEmbeddingModel as B, type ContentBlock as C, type ImageInput as D, type EmbeddingInput as E, type ImageEditInput as F, type ImageGenerateOptions as G, type GeneratedImage as H, type ImageOptions as I, type ImageUsage as J, type KeyStrategy as K, type LLMProvider as L, type ModelReference as M, type ImageResult as N, type ImageStreamEvent as O, type ProviderIdentity as P, type ImageStreamResult as Q, type RetryStrategy as R, type ImageCapabilities as S, type TextBlock as T, type UserContent as U, type VideoBlock as V, type ImageRequest as W, type ImageEditRequest as X, type ImageResponse as Y, type ImageProviderStreamResult as Z, type BoundImageModel as _, type ProviderConfig as a, type ImageModelInput as a0, type EmbeddingUsage as b, type ImageInstance as c, type LLMHandler as d, type EmbeddingHandler as e, type ImageHandler as f, type Provider as g, Image as h, UPPError as i, type ErrorCode as j, type Modality as k, type ImageBlock as l, type AudioBlock as m, type BinaryBlock as n, type ImageSource as o, isTextBlock as p, isImageBlock as q, isAudioBlock as r, isVideoBlock as s, text as t, isBinaryBlock as u, type EmbeddingProvider as v, type ImageProvider as w, type EmbeddingRequest as x, type EmbeddingResponse as y, type EmbeddingVector as z };
+export { type ImageResponse as $, type AssistantContent as A, type BoundEmbeddingModel as B, type ContentBlock as C, type EmbeddingRequest as D, type EmbeddingInput as E, type EmbeddingResponse as F, type EmbeddingVector as G, type ImageInput as H, type ImageOptions as I, type ImageEditInput as J, type KeyStrategy as K, type LLMProvider as L, type ModelReference as M, type ImageGenerateOptions as N, type GeneratedImage as O, type ProviderIdentity as P, type ImageUsage as Q, type RetryStrategy as R, type ImageResult as S, type TextBlock as T, type UserContent as U, type VideoBlock as V, type ImageStreamEvent as W, type ImageStreamResult as X, type ImageCapabilities as Y, type ImageRequest as Z, type ImageEditRequest as _, type ProviderConfig as a, type ImageProviderStreamResult as a0, type BoundImageModel as a1, type ImageHandler$1 as a2, type ImageModelInput as a3, type EmbeddingUsage as b, type ImageInstance as c, type LLMHandler as d, type EmbeddingHandler as e, type ImageHandler as f, type Provider as g, Image as h, UPPError as i, ErrorCode as j, ModalityType as k, type Modality as l, type ImageBlock as m, type AudioBlock as n, type BinaryBlock as o, type ImageSource as p, ContentBlockType as q, ImageSourceType as r, isTextBlock as s, text as t, isImageBlock as u, isAudioBlock as v, isVideoBlock as w, isBinaryBlock as x, type EmbeddingProvider as y, type ImageProvider as z };

package/dist/proxy/index.d.ts

@@ -1,5 +1,5 @@
-import { g as Provider, M as ModelReference } from '../provider-DWEAzeM5.js';
-import { M as Message, b as MessageJSON, T as Turn, H as TurnJSON, f as StreamEvent, S as StreamResult, J as JSONSchema, k as ToolMetadata, c as Tool } from '../stream-DbkLOIbJ.js';
+import { g as Provider, M as ModelReference } from '../provider-DR1yins0.js';
+import { M as Message, b as MessageJSON, T as Turn, I as TurnJSON, f as StreamEvent, S as StreamResult, J as JSONSchema, k as ToolMetadata, c as Tool } from '../stream-BuTrqt_j.js';
 
 /**
  * @fileoverview Proxy provider types.

package/dist/proxy/index.js

@@ -3,20 +3,22 @@ import {
 } from "../chunk-MKDLXV4O.js";
 import {
   parseJsonResponse
-} from "../chunk-I2VHCGQE.js";
+} from "../chunk-Z6DKC37J.js";
 import {
   AssistantMessage,
   ToolResultMessage,
   UserMessage,
   createProvider
-} from "../chunk-M4BMM5IB.js";
+} from "../chunk-MF5ETY5O.js";
 import {
+  ErrorCode,
+  ModalityType,
   UPPError,
   doFetch,
   doStreamFetch,
   normalizeHttpError,
   toError
-} from "../chunk-RFWLEFAB.js";
+} from "../chunk-QNJO7DSD.js";
 
 // src/providers/proxy/serialization.ts
 function serializeMessage(m) {
@@ -56,9 +58,9 @@ function deserializeMessage(json) {
     default:
       throw new UPPError(
         `Unknown message type: ${json.type}`,
-        "INVALID_RESPONSE",
+        ErrorCode.InvalidResponse,
         "proxy",
-        "llm"
+        ModalityType.LLM
       );
   }
 }
@@ -118,9 +120,9 @@ function createLLMHandler(options) {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider().",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "proxy",
-          "llm"
+          ModalityType.LLM
         );
       }
       const model = {
@@ -184,9 +186,9 @@ function createLLMHandler(options) {
               if (!response.body) {
                 throw new UPPError(
                   "Response body is null",
-                  "PROVIDER_ERROR",
+                  ErrorCode.ProviderError,
                   "proxy",
-                  "llm"
+                  ModalityType.LLM
                 );
               }
               const reader = response.body.getReader();