@providerprotocol/ai 0.0.22 → 0.0.24

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

@@ -7,6 +7,70 @@
  *
  * @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";
+    /** Reasoning/thinking content from extended thinking models */
+    readonly Reasoning: "reasoning";
+    /** 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.
  *
@@ -62,6 +126,26 @@ interface TextBlock {
     /** The text content */
     text: string;
 }
+/**
+ * Reasoning content block.
+ *
+ * Contains model reasoning/thinking from extended thinking or chain-of-thought.
+ * This content represents the model's internal reasoning process.
+ *
+ * @example
+ * ```typescript
+ * const reasoningBlock: ReasoningBlock = {
+ *   type: 'reasoning',
+ *   text: 'Let me think about this step by step...'
+ * };
+ * ```
+ */
+interface ReasoningBlock {
+    /** Discriminator for reasoning blocks */
+    type: 'reasoning';
+    /** The reasoning/thinking text */
+    text: string;
+}
 /**
  * Image content block.
  *
@@ -176,7 +260,7 @@ interface BinaryBlock {
  *
  * Used when a function or property can accept any type of content block.
  */
-type ContentBlock = TextBlock | ImageBlock | AudioBlock | VideoBlock | BinaryBlock;
+type ContentBlock = TextBlock | ReasoningBlock | ImageBlock | AudioBlock | VideoBlock | BinaryBlock;
 /**
  * Content types allowed in user messages.
  *
@@ -188,7 +272,7 @@ type UserContent = TextBlock | ImageBlock | AudioBlock | VideoBlock | BinaryBloc
  *
  * Assistants can generate text and media but not arbitrary binary data.
  */
-type AssistantContent = TextBlock | ImageBlock | AudioBlock | VideoBlock;
+type AssistantContent = TextBlock | ReasoningBlock | ImageBlock | AudioBlock | VideoBlock;
 /**
  * Creates a text content block from a string.
  *
@@ -202,6 +286,19 @@ type AssistantContent = TextBlock | ImageBlock | AudioBlock | VideoBlock;
  * ```
  */
 declare function text(content: string): TextBlock;
+/**
+ * Creates a reasoning content block from a string.
+ *
+ * @param content - The reasoning/thinking content
+ * @returns A ReasoningBlock containing the provided text
+ *
+ * @example
+ * ```typescript
+ * const block = reasoning('Let me think step by step...');
+ * // { type: 'reasoning', text: 'Let me think step by step...' }
+ * ```
+ */
+declare function reasoning(content: string): ReasoningBlock;
 /**
  * Type guard for TextBlock.
  *
@@ -216,6 +313,20 @@ declare function text(content: string): TextBlock;
  * ```
  */
 declare function isTextBlock(block: ContentBlock): block is TextBlock;
+/**
+ * Type guard for ReasoningBlock.
+ *
+ * @param block - The content block to check
+ * @returns True if the block is a ReasoningBlock
+ *
+ * @example
+ * ```typescript
+ * if (isReasoningBlock(block)) {
+ *   console.log(block.text);
+ * }
+ * ```
+ */
+declare function isReasoningBlock(block: ContentBlock): block is ReasoningBlock;
 /**
  * Type guard for ImageBlock.
  *
@@ -282,70 +393,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 +495,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 +1471,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 ImageCapabilities as $, type AssistantContent as A, type BoundEmbeddingModel as B, type ContentBlock as C, type RetryStrategy as D, type EmbeddingInput as E, type EmbeddingProvider as F, type ImageProvider as G, type EmbeddingRequest as H, type ImageOptions as I, type EmbeddingResponse as J, type KeyStrategy as K, type LLMProvider as L, type ModelReference as M, type EmbeddingVector as N, type ImageInput as O, type ProviderIdentity as P, type ImageEditInput as Q, type ReasoningBlock as R, type ImageGenerateOptions as S, type TextBlock as T, type UserContent as U, type VideoBlock as V, type GeneratedImage as W, type ImageUsage as X, type ImageResult as Y, type ImageStreamEvent as Z, type ImageStreamResult as _, type ProviderConfig as a, type ImageRequest as a0, type ImageEditRequest as a1, type ImageResponse as a2, type ImageProviderStreamResult as a3, type BoundImageModel as a4, type ImageHandler$1 as a5, type ImageModelInput as a6, 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, reasoning as s, text as t, isTextBlock as u, isReasoningBlock as v, isImageBlock as w, isAudioBlock as x, isVideoBlock as y, isBinaryBlock 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-x4RocsnK.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-ITNFNnO4.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-6AZVUI6H.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();