@effect/ai-anthropic 4.0.0-beta.8 → 4.0.0-beta.80

package/dist/AnthropicError.d.ts

@@ -4,13 +4,21 @@
  * Provides Anthropic-specific metadata fields for AI error types through module
  * augmentation, enabling typed access to Anthropic error details.
  *
- * @since 1.0.0
+ * @since 4.0.0
  */
 /**
  * Anthropic-specific error metadata fields.
  *
- * @since 1.0.0
+ * **Details**
+ *
+ * Contains the Anthropic error type and request identifier copied from provider
+ * error responses when available. Either field may be `null` when Anthropic
+ * does not include it or the response cannot be decoded.
+ *
+ * @see {@link AnthropicRateLimitMetadata} for rate-limit responses that also include parsed Anthropic rate-limit headers
+ *
  * @category models
+ * @since 4.0.0
  */
 export type AnthropicErrorMetadata = {
     /**
@@ -25,11 +33,12 @@ export type AnthropicErrorMetadata = {
 /**
  * Anthropic-specific rate limit metadata fields.
  *
- * Extends base error metadata with rate limit specific information from
- * Anthropic's rate limit headers.
+ * **Details**
+ *
+ * Extends base error metadata with rate limit-specific information from Anthropic's rate limit headers.
  *
- * @since 1.0.0
  * @category models
+ * @since 4.0.0
  */
 export type AnthropicRateLimitMetadata = AnthropicErrorMetadata & {
     /**
@@ -58,45 +67,135 @@ export type AnthropicRateLimitMetadata = AnthropicErrorMetadata & {
     readonly tokensReset: string | null;
 };
 declare module "effect/unstable/ai/AiError" {
-    interface RateLimitError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicRateLimitMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `RateLimitError` values.
+     *
+     * **Details**
+     *
+     * Includes request identifiers, Anthropic error types, and parsed request or token limit headers when the provider rejects a request due to rate limits.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface RateLimitErrorMetadata {
+        readonly anthropic?: AnthropicRateLimitMetadata | null;
     }
-    interface QuotaExhaustedError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `QuotaExhaustedError` values.
+     *
+     * **Details**
+     *
+     * Captures the Anthropic error type and request identifier for failures where the account or workspace has exhausted its available quota.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface QuotaExhaustedErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
+    }
+    /**
+     * Anthropic metadata attached to `AuthenticationError` values.
+     *
+     * **Details**
+     *
+     * Preserves Anthropic error details for missing, invalid, or unauthorized API credentials while keeping the error in the shared AI error model.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface AuthenticationErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
+    }
+    /**
+     * Anthropic metadata attached to `ContentPolicyError` values.
+     *
+     * **Details**
+     *
+     * Records Anthropic error details returned when a request or response is rejected by Anthropic safety or content policy enforcement.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface ContentPolicyErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
-    interface AuthenticationError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `InvalidRequestError` values.
+     *
+     * **Details**
+     *
+     * Provides the Anthropic error type and request identifier for malformed or unsupported requests rejected before model execution.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface InvalidRequestErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
-    interface ContentPolicyError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `InternalProviderError` values.
+     *
+     * **Details**
+     *
+     * Preserves Anthropic request correlation data for provider-side failures that should be reported or investigated with Anthropic support.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface InternalProviderErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
-    interface InvalidRequestError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `InvalidOutputError` values.
+     *
+     * **Details**
+     *
+     * Describes Anthropic-specific context for responses that could not be decoded or interpreted as valid AI output.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface InvalidOutputErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
-    interface InternalProviderError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `StructuredOutputError` values.
+     *
+     * **Details**
+     *
+     * Captures Anthropic error details for structured-output failures, including request correlation data useful when diagnosing schema-related responses.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface StructuredOutputErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
-    interface InvalidOutputError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `UnsupportedSchemaError` values.
+     *
+     * **Details**
+     *
+     * Provides Anthropic error details for schemas that cannot be represented by or submitted to the Anthropic API.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface UnsupportedSchemaErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
-    interface UnknownError {
-        readonly metadata: {
-            readonly anthropic?: AnthropicErrorMetadata | null;
-        };
+    /**
+     * Anthropic metadata attached to `UnknownError` values.
+     *
+     * **Details**
+     *
+     * Retains the Anthropic error type and request identifier when a provider response cannot be classified as a more specific AI error.
+     *
+     * @category configuration
+     * @since 4.0.0
+     */
+    interface UnknownErrorMetadata {
+        readonly anthropic?: AnthropicErrorMetadata | null;
     }
 }
 //# sourceMappingURL=AnthropicError.d.ts.map

package/dist/AnthropicError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnthropicError.d.ts","sourceRoot":"","sources":["../src/AnthropicError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,GAAG;IAChE;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,OAAO,QAAQ,4BAA4B,CAAC;IAC1C,UAAiB,cAAc;QAC7B,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAA;SACvD,CAAA;KACF;IAED,UAAiB,mBAAmB;QAClC,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;IAED,UAAiB,mBAAmB;QAClC,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;IAED,UAAiB,kBAAkB;QACjC,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;IAED,UAAiB,mBAAmB;QAClC,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;IAED,UAAiB,qBAAqB;QACpC,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;IAED,UAAiB,kBAAkB;QACjC,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;IAED,UAAiB,YAAY;QAC3B,QAAQ,CAAC,QAAQ,EAAE;YACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;SACnD,CAAA;KACF;CACF"}
+{"version":3,"file":"AnthropicError.d.ts","sourceRoot":"","sources":["../src/AnthropicError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,GAAG;IAChE;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,OAAO,QAAQ,4BAA4B,CAAC;IAC1C;;;;;;;;;OASG;IACH,UAAiB,sBAAsB;QACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAA;KACvD;IAED;;;;;;;;;OASG;IACH,UAAiB,2BAA2B;QAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,2BAA2B;QAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,0BAA0B;QACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,2BAA2B;QAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,6BAA6B;QAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,0BAA0B;QACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,6BAA6B;QAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,8BAA8B;QAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;IAED;;;;;;;;;OASG;IACH,UAAiB,oBAAoB;QACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;KACnD;CACF"}

package/dist/AnthropicError.js

@@ -4,7 +4,7 @@
  * Provides Anthropic-specific metadata fields for AI error types through module
  * augmentation, enabling typed access to Anthropic error details.
  *
- * @since 1.0.0
+ * @since 4.0.0
  */
 export {};
 //# sourceMappingURL=AnthropicError.js.map