art-framework 0.2.5 → 0.2.6

package/dist/index.d.cts

@@ -1550,61 +1550,69 @@ declare class OpenAIAdapter implements ProviderAdapter {
 interface AnthropicAdapterOptions {
     /** Your Anthropic API key. Handle securely. */
     apiKey: string;
-    /** The default Anthropic model ID to use (e.g., 'claude-3-opus-20240229', 'claude-3-5-sonnet-20240620'). Defaults to 'claude-3-haiku-20240307' if not provided. */
+    /** The default Anthropic model ID to use (e.g., 'claude-3-opus-20240229', 'claude-3-5-sonnet-20240620'). */
     model?: string;
-    /** Optional: The Anthropic API version to target (e.g., '2023-06-01'). Defaults to '2023-06-01'. */
-    apiVersion?: string;
     /** Optional: Override the base URL for the Anthropic API. */
     apiBaseUrl?: string;
+    /** Optional: Default maximum tokens for responses. */
+    defaultMaxTokens?: number;
+    /** Optional: Default temperature for responses. */
+    defaultTemperature?: number;
 }
 /**
  * Implements the `ProviderAdapter` interface for interacting with Anthropic's
- * Messages API (Claude models).
+ * Messages API (Claude models) using the official SDK.
  *
- * Handles formatting requests and parsing responses for Anthropic.
- * Note: Streaming is **not yet implemented** for this adapter. Calls requesting streaming will yield an error and end.
+ * Handles formatting requests, parsing responses, streaming, and tool use.
  *
  * @implements {ProviderAdapter}
  */
 declare class AnthropicAdapter implements ProviderAdapter {
     readonly providerName = "anthropic";
-    private apiKey;
-    private model;
-    private apiVersion;
-    private apiBaseUrl;
+    private client;
+    private defaultModel;
     private defaultMaxTokens;
+    private defaultTemperature?;
     /**
      * Creates an instance of the AnthropicAdapter.
-     * @param options - Configuration options including the API key and optional model/apiVersion/baseURL overrides.
-     * @throws {Error} If the API key is missing.
+     * @param options - Configuration options including the API key and optional model/baseURL/defaults.
+     * @throws {ARTError} If the API key is missing.
      */
     constructor(options: AnthropicAdapterOptions);
     /**
      * Sends a request to the Anthropic Messages API.
-     * Translates `ArtStandardPrompt` to the Anthropic format.
-     *
-     * **Note:** Streaming is **not yet implemented**.
+     * Translates `ArtStandardPrompt` to the Anthropic format and handles streaming and tool use.
      *
      * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
-     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream`, and any Anthropic-specific generation parameters.
-     * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects. If streaming is requested, it yields an error event and ends.
-     * @throws {ARTError} If `max_tokens` is missing in options (required by Anthropic).
+     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream`, `callContext`,
+     *                                `model` (override), `tools` (available tools), and Anthropic-specific
+     *                                generation parameters from `providerConfig.adapterOptions`.
+     * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects.
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
     /**
-     * Translates the provider-agnostic `ArtStandardPrompt` into the Anthropic Messages API format.
+     * Prepares request options. Currently a placeholder for potential future additions
+     * like Anthropic beta headers for specific models or features (e.g., prompt caching).
+     * The user's example code shows more advanced beta header logic.
+     */
+    private getRequestOptions;
+    /**
+     * Translates the provider-agnostic `ArtStandardPrompt` into the Anthropic SDK Messages format.
      *
      * @private
      * @param {ArtStandardPrompt} artPrompt - The input `ArtStandardPrompt` array.
-     * @returns {{ systemPrompt?: string; messages: AnthropicMessage[] }} The system prompt string and the `AnthropicMessage[]` array.
-     * @throws {ARTError} If translation encounters an issue (ErrorCode.PROMPT_TRANSLATION_FAILED).
+     * @returns {{ systemPrompt?: string; messages: AnthropicSDKMessageParam[] }}
+     * @throws {ARTError} If translation encounters an issue.
      */
-    private translateToAnthropic;
+    private translateToAnthropicSdk;
     /**
-     * Helper to map ArtStandardMessage content/tool_calls to Anthropic Content Blocks.
-     * @private
+     * Maps a single ArtStandardMessage to Anthropic SDK's content format (string or AnthropicSDKContentBlockParam[]).
+     */
+    private mapArtMessageToAnthropicContent;
+    /**
+     * Translates ART ToolSchema array to Anthropic's tool format.
      */
-    private mapArtContentToAnthropicBlocks;
+    private translateArtToolsToAnthropic;
 }
 
 /**

package/dist/index.d.ts

@@ -1550,61 +1550,69 @@ declare class OpenAIAdapter implements ProviderAdapter {
 interface AnthropicAdapterOptions {
     /** Your Anthropic API key. Handle securely. */
     apiKey: string;
-    /** The default Anthropic model ID to use (e.g., 'claude-3-opus-20240229', 'claude-3-5-sonnet-20240620'). Defaults to 'claude-3-haiku-20240307' if not provided. */
+    /** The default Anthropic model ID to use (e.g., 'claude-3-opus-20240229', 'claude-3-5-sonnet-20240620'). */
     model?: string;
-    /** Optional: The Anthropic API version to target (e.g., '2023-06-01'). Defaults to '2023-06-01'. */
-    apiVersion?: string;
     /** Optional: Override the base URL for the Anthropic API. */
     apiBaseUrl?: string;
+    /** Optional: Default maximum tokens for responses. */
+    defaultMaxTokens?: number;
+    /** Optional: Default temperature for responses. */
+    defaultTemperature?: number;
 }
 /**
  * Implements the `ProviderAdapter` interface for interacting with Anthropic's
- * Messages API (Claude models).
+ * Messages API (Claude models) using the official SDK.
  *
- * Handles formatting requests and parsing responses for Anthropic.
- * Note: Streaming is **not yet implemented** for this adapter. Calls requesting streaming will yield an error and end.
+ * Handles formatting requests, parsing responses, streaming, and tool use.
  *
  * @implements {ProviderAdapter}
  */
 declare class AnthropicAdapter implements ProviderAdapter {
     readonly providerName = "anthropic";
-    private apiKey;
-    private model;
-    private apiVersion;
-    private apiBaseUrl;
+    private client;
+    private defaultModel;
     private defaultMaxTokens;
+    private defaultTemperature?;
     /**
      * Creates an instance of the AnthropicAdapter.
-     * @param options - Configuration options including the API key and optional model/apiVersion/baseURL overrides.
-     * @throws {Error} If the API key is missing.
+     * @param options - Configuration options including the API key and optional model/baseURL/defaults.
+     * @throws {ARTError} If the API key is missing.
      */
     constructor(options: AnthropicAdapterOptions);
     /**
      * Sends a request to the Anthropic Messages API.
-     * Translates `ArtStandardPrompt` to the Anthropic format.
-     *
-     * **Note:** Streaming is **not yet implemented**.
+     * Translates `ArtStandardPrompt` to the Anthropic format and handles streaming and tool use.
      *
      * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
-     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream`, and any Anthropic-specific generation parameters.
-     * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects. If streaming is requested, it yields an error event and ends.
-     * @throws {ARTError} If `max_tokens` is missing in options (required by Anthropic).
+     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream`, `callContext`,
+     *                                `model` (override), `tools` (available tools), and Anthropic-specific
+     *                                generation parameters from `providerConfig.adapterOptions`.
+     * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects.
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
     /**
-     * Translates the provider-agnostic `ArtStandardPrompt` into the Anthropic Messages API format.
+     * Prepares request options. Currently a placeholder for potential future additions
+     * like Anthropic beta headers for specific models or features (e.g., prompt caching).
+     * The user's example code shows more advanced beta header logic.
+     */
+    private getRequestOptions;
+    /**
+     * Translates the provider-agnostic `ArtStandardPrompt` into the Anthropic SDK Messages format.
      *
      * @private
      * @param {ArtStandardPrompt} artPrompt - The input `ArtStandardPrompt` array.
-     * @returns {{ systemPrompt?: string; messages: AnthropicMessage[] }} The system prompt string and the `AnthropicMessage[]` array.
-     * @throws {ARTError} If translation encounters an issue (ErrorCode.PROMPT_TRANSLATION_FAILED).
+     * @returns {{ systemPrompt?: string; messages: AnthropicSDKMessageParam[] }}
+     * @throws {ARTError} If translation encounters an issue.
      */
-    private translateToAnthropic;
+    private translateToAnthropicSdk;
     /**
-     * Helper to map ArtStandardMessage content/tool_calls to Anthropic Content Blocks.
-     * @private
+     * Maps a single ArtStandardMessage to Anthropic SDK's content format (string or AnthropicSDKContentBlockParam[]).
+     */
+    private mapArtMessageToAnthropicContent;
+    /**
+     * Translates ART ToolSchema array to Anthropic's tool format.
      */
-    private mapArtContentToAnthropicBlocks;
+    private translateArtToolsToAnthropic;
 }
 
 /**