@core-ai/core-ai 0.21.0 → 0.23.0

package/dist/index.d.ts

@@ -34,12 +34,22 @@ type ImagePart = {
         type: 'url';
         url: string;
     };
+    /**
+     * Application-owned metadata for this part. Provider adapters ignore this
+     * field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type FilePart = {
     type: 'file';
     data: string;
     mimeType: string;
     filename?: string;
+    /**
+     * Application-owned metadata for this part. Provider adapters ignore this
+     * field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type AudioPart = {
     type: 'audio';
@@ -48,6 +58,11 @@ type AudioPart = {
         mediaType: string;
         data: string;
     };
+    /**
+     * Application-owned metadata for this part. Provider adapters ignore this
+     * field and never serialize it to provider APIs.
+     */
+    metadata?: Record<string, unknown>;
 };
 type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'max';
 type ReasoningConfig = {
@@ -452,14 +467,22 @@ declare class StreamAbortedError extends AbortedError {
 }
 type ProviderErrorOptions = {
     statusCode?: number;
+    /**
+     * Provider-specific error code or type as reported by the API, e.g.
+     * `insufficient_quota`, `invalid_request_error`, `RESOURCE_EXHAUSTED`.
+     * Stable machine-readable identifier for logging and classification
+     * where the message itself cannot be recorded.
+     */
+    code?: string;
     cause?: unknown;
 };
 declare class ProviderError extends CoreAIError {
     readonly statusCode?: number;
+    readonly code?: string;
     /**
      * @param message Human-readable error message (may include provider text).
      * @param provider Provider id (e.g. `'openai'`, `'anthropic'`).
-     * @param options Optional HTTP status and underlying cause.
+     * @param options Optional HTTP status, provider code, and underlying cause.
      */
     constructor(message: string, provider: string, options?: ProviderErrorOptions);
 }
@@ -622,9 +645,16 @@ declare function createObjectStream<TSchema extends z.ZodType>(source: AsyncIter
     signal?: AbortSignal;
 }): ObjectStream<TSchema>;
 
-declare function createChatStream(source: AsyncIterable<StreamEvent> | (() => Promise<AsyncIterable<StreamEvent>>), options?: {
+type CreateChatStreamOptions = {
     signal?: AbortSignal;
-}): ChatStream;
+    /**
+     * Maps errors raised while opening or iterating the source — including
+     * in-band SDK failures after HTTP 200 — onto a {@link CoreAIError}.
+     * Already-typed core-ai errors pass through unchanged.
+     */
+    mapError?: (error: unknown) => CoreAIError;
+};
+declare function createChatStream(source: AsyncIterable<StreamEvent> | (() => Promise<AsyncIterable<StreamEvent>>), options?: CreateChatStreamOptions): ChatStream;
 
 declare function wrapChatModel(config: {
     model: ChatModel;
@@ -653,4 +683,4 @@ type GenerateImageParams = ImageGenerateOptions & {
 };
 declare function generateImage(params: GenerateImageParams): Promise<ImageGenerateResult>;
 
-export { AbortedError, type AssistantContentPart, type AssistantMessage, type AssistantTextPart, type AudioPart, type BaseGenerateOptions, type ChatInputModality, type ChatInputTokenDetails, type ChatModel, type ChatModelMiddleware, type ChatOutputModality, type ChatOutputTokenDetails, type ChatStream, type ChatUsage, ContextLengthExceededError, type ContextLengthExceededErrorOptions, CoreAIError, type EmbedOptions, type EmbedProviderOptions, type EmbedResult, type EmbeddingModel, type EmbeddingModelMiddleware, type EmbeddingUsage, type FilePart, type FinishReason, type GenerateObjectOptions, type GenerateObjectResult, type GenerateOptions, type GenerateProviderOptions, type GenerateResult, type GeneratedImage, type ImageGenerateOptions, type ImageGenerateResult, type ImageModel, type ImageModelMiddleware, type ImagePart, type ImageProviderOptions, MULTIMODAL_INPUT_MODALITIES, type Message, type ModelCapabilities, type ModelCapabilitiesRegistry, ModelOverloadedError, type ModelOverloadedErrorOptions, type ObjectStream, type ObjectStreamEvent, ProviderError, type ProviderErrorOptions, RateLimitError, type RateLimitErrorOptions, type ReasoningConfig, type ReasoningEffort, type ReasoningPart, RetryableProviderError, ServiceUnavailableError, type ServiceUnavailableErrorOptions, StreamAbortedError, type StreamEvent, type StreamObjectOptions, StructuredOutputError, StructuredOutputNoObjectGeneratedError, StructuredOutputParseError, StructuredOutputValidationError, type SystemMessage, TEXT_ONLY_MODALITIES, type TextPart, type ToolCall, type ToolCallPart, type ToolChoice, type ToolDefinition, type ToolResultMessage, type ToolSet, UNKNOWN_MODEL, UnsupportedInputModalityError, type UnsupportedInputModalityErrorOptions, type UserContentPart, type UserMessage, type ValidateInputModalitiesOptions, ValidationError, asObject, asRecord, assistantMessage, clampReasoningEffort, createChatStream, createObjectStream, defineTool, embed, generate, generateImage, generateObject, getErrorMessage, getHttpStatusCode, getProviderMetadata, getRegisteredModelCapabilities, getRetryAfterSecondsFromError, getString, isAbortErrorByName, isRateLimitStatus, isTransientUnavailableStatus, parseRetryAfterSeconds, resultToMessage, safeParseJsonObject, stream, streamObject, stripModelDateSuffix, supportsInputModality, supportsOutputModality, validateInputModalities, wrapChatModel, wrapEmbeddingModel, wrapImageModel, zodSchemaToJsonSchema };
+export { AbortedError, type AssistantContentPart, type AssistantMessage, type AssistantTextPart, type AudioPart, type BaseGenerateOptions, type ChatInputModality, type ChatInputTokenDetails, type ChatModel, type ChatModelMiddleware, type ChatOutputModality, type ChatOutputTokenDetails, type ChatStream, type ChatUsage, ContextLengthExceededError, type ContextLengthExceededErrorOptions, CoreAIError, type CreateChatStreamOptions, type EmbedOptions, type EmbedProviderOptions, type EmbedResult, type EmbeddingModel, type EmbeddingModelMiddleware, type EmbeddingUsage, type FilePart, type FinishReason, type GenerateObjectOptions, type GenerateObjectResult, type GenerateOptions, type GenerateProviderOptions, type GenerateResult, type GeneratedImage, type ImageGenerateOptions, type ImageGenerateResult, type ImageModel, type ImageModelMiddleware, type ImagePart, type ImageProviderOptions, MULTIMODAL_INPUT_MODALITIES, type Message, type ModelCapabilities, type ModelCapabilitiesRegistry, ModelOverloadedError, type ModelOverloadedErrorOptions, type ObjectStream, type ObjectStreamEvent, ProviderError, type ProviderErrorOptions, RateLimitError, type RateLimitErrorOptions, type ReasoningConfig, type ReasoningEffort, type ReasoningPart, RetryableProviderError, ServiceUnavailableError, type ServiceUnavailableErrorOptions, StreamAbortedError, type StreamEvent, type StreamObjectOptions, StructuredOutputError, StructuredOutputNoObjectGeneratedError, StructuredOutputParseError, StructuredOutputValidationError, type SystemMessage, TEXT_ONLY_MODALITIES, type TextPart, type ToolCall, type ToolCallPart, type ToolChoice, type ToolDefinition, type ToolResultMessage, type ToolSet, UNKNOWN_MODEL, UnsupportedInputModalityError, type UnsupportedInputModalityErrorOptions, type UserContentPart, type UserMessage, type ValidateInputModalitiesOptions, ValidationError, asObject, asRecord, assistantMessage, clampReasoningEffort, createChatStream, createObjectStream, defineTool, embed, generate, generateImage, generateObject, getErrorMessage, getHttpStatusCode, getProviderMetadata, getRegisteredModelCapabilities, getRetryAfterSecondsFromError, getString, isAbortErrorByName, isRateLimitStatus, isTransientUnavailableStatus, parseRetryAfterSeconds, resultToMessage, safeParseJsonObject, stream, streamObject, stripModelDateSuffix, supportsInputModality, supportsOutputModality, validateInputModalities, wrapChatModel, wrapEmbeddingModel, wrapImageModel, zodSchemaToJsonSchema };

package/dist/index.js

@@ -49,15 +49,17 @@ var StreamAbortedError = class extends AbortedError {
 };
 var ProviderError = class extends CoreAIError {
   statusCode;
+  code;
   /**
    * @param message Human-readable error message (may include provider text).
    * @param provider Provider id (e.g. `'openai'`, `'anthropic'`).
-   * @param options Optional HTTP status and underlying cause.
+   * @param options Optional HTTP status, provider code, and underlying cause.
    */
   constructor(message, provider, options = {}) {
     super(message, options.cause, provider);
     this.name = "ProviderError";
     this.statusCode = options.statusCode;
+    this.code = options.code;
   }
 };
 var RetryableProviderError = class extends ProviderError {
@@ -72,6 +74,7 @@ var ContextLengthExceededError = class extends ProviderError {
   constructor(message, provider, options = {}) {
     super(message, provider, {
       statusCode: options.statusCode,
+      code: options.code,
       cause: options.cause
     });
     this.name = "ContextLengthExceededError";
@@ -84,6 +87,7 @@ var RateLimitError = class extends RetryableProviderError {
   constructor(message, provider, options = {}) {
     super(message, provider, {
       statusCode: options.statusCode ?? 429,
+      code: options.code,
       cause: options.cause
     });
     this.name = "RateLimitError";
@@ -648,12 +652,30 @@ function createObjectStream(source, options = {}) {
   });
 }
 
+// src/map-stream-errors.ts
+async function* mapStreamErrors(source, mapError) {
+  try {
+    for await (const event of source) {
+      yield event;
+    }
+  } catch (error) {
+    if (error instanceof CoreAIError || isLanguageError(error)) {
+      throw error;
+    }
+    throw mapError(error);
+  }
+}
+function isLanguageError(error) {
+  return error instanceof TypeError || error instanceof RangeError || error instanceof SyntaxError || error instanceof ReferenceError;
+}
+
 // src/stream.ts
 function createChatStream(source, options = {}) {
-  const { signal } = options;
+  const { signal, mapError } = options;
   const resolvedSource = typeof source === "function" ? (async function* () {
     yield* await source();
   })() : source;
+  const sourceWithMappedErrors = mapError ? mapStreamErrors(resolvedSource, mapError) : resolvedSource;
   const parts = [];
   let textBuffer = "";
   let textMetadata;
@@ -784,7 +806,7 @@ function createChatStream(source, options = {}) {
     };
   };
   return createStream({
-    source: resolvedSource,
+    source: sourceWithMappedErrors,
     signal,
     reduceEvent(event) {
       switch (event.type) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@core-ai/core-ai",
-    "version": "0.21.0",
+    "version": "0.23.0",
     "description": "Type-safe LLM abstraction layer over native provider SDKs",
     "license": "MIT",
     "author": "Omnifact (https://omnifact.ai)",