@framers/agentos 0.1.112 → 0.1.114

package/dist/core/llm/providers/errors/GeminiProviderError.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Custom error class for Google Gemini provider errors.
+ * Extends the base {@link ProviderError} with Gemini-specific fields
+ * such as HTTP status codes and Gemini API error details.
+ *
+ * @module backend/agentos/core/llm/providers/errors/GeminiProviderError
+ * @see {@link ProviderError}
+ */
+import { ProviderError } from './ProviderError';
+/**
+ * Represents an error originating from the Google Gemini provider.
+ *
+ * Includes additional context specific to the Gemini REST API, such as
+ * HTTP status codes and the `error.status` field from the Gemini error
+ * envelope (e.g., `"INVALID_ARGUMENT"`, `"PERMISSION_DENIED"`).
+ *
+ * @example
+ * try {
+ *   // Gemini API call
+ * } catch (error) {
+ *   if (error instanceof GeminiProviderError) {
+ *     console.error(`Gemini Error (HTTP ${error.httpStatus}): ${error.message}`);
+ *   }
+ * }
+ */
+export declare class GeminiProviderError extends ProviderError {
+    /** HTTP status code from the Gemini API response (e.g., 400, 403, 429, 500). */
+    readonly httpStatus?: number;
+    /**
+     * Gemini-specific error status string from the API response.
+     * Examples: `"INVALID_ARGUMENT"`, `"PERMISSION_DENIED"`, `"RESOURCE_EXHAUSTED"`.
+     */
+    readonly geminiErrorStatus?: string;
+    /**
+     * Creates an instance of GeminiProviderError.
+     *
+     * @param {string} message - Human-readable description of the error.
+     * @param {string} code - Internal AgentOS error code (e.g., 'API_REQUEST_FAILED').
+     * @param {number} [httpStatus] - HTTP status code from the API response.
+     * @param {string} [geminiErrorStatus] - Gemini-specific error status string.
+     * @param {unknown} [details] - Additional context or the original error object.
+     */
+    constructor(message: string, code: string, httpStatus?: number, geminiErrorStatus?: string, details?: unknown);
+}
+//# sourceMappingURL=GeminiProviderError.d.ts.map

package/dist/core/llm/providers/errors/GeminiProviderError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiProviderError.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/errors/GeminiProviderError.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,gFAAgF;IAChF,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,SAAgB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3C;;;;;;;;OAQG;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,OAAO;CAUpB"}

package/dist/core/llm/providers/errors/GeminiProviderError.js

@@ -0,0 +1,46 @@
+// File: backend/agentos/core/llm/providers/errors/GeminiProviderError.ts
+/**
+ * @fileoverview Custom error class for Google Gemini provider errors.
+ * Extends the base {@link ProviderError} with Gemini-specific fields
+ * such as HTTP status codes and Gemini API error details.
+ *
+ * @module backend/agentos/core/llm/providers/errors/GeminiProviderError
+ * @see {@link ProviderError}
+ */
+import { ProviderError } from './ProviderError.js';
+/**
+ * Represents an error originating from the Google Gemini provider.
+ *
+ * Includes additional context specific to the Gemini REST API, such as
+ * HTTP status codes and the `error.status` field from the Gemini error
+ * envelope (e.g., `"INVALID_ARGUMENT"`, `"PERMISSION_DENIED"`).
+ *
+ * @example
+ * try {
+ *   // Gemini API call
+ * } catch (error) {
+ *   if (error instanceof GeminiProviderError) {
+ *     console.error(`Gemini Error (HTTP ${error.httpStatus}): ${error.message}`);
+ *   }
+ * }
+ */
+export class GeminiProviderError extends ProviderError {
+    /**
+     * Creates an instance of GeminiProviderError.
+     *
+     * @param {string} message - Human-readable description of the error.
+     * @param {string} code - Internal AgentOS error code (e.g., 'API_REQUEST_FAILED').
+     * @param {number} [httpStatus] - HTTP status code from the API response.
+     * @param {string} [geminiErrorStatus] - Gemini-specific error status string.
+     * @param {unknown} [details] - Additional context or the original error object.
+     */
+    constructor(message, code, httpStatus, geminiErrorStatus, details) {
+        super(message, code, 'gemini', details);
+        this.name = 'GeminiProviderError';
+        this.httpStatus = httpStatus;
+        this.geminiErrorStatus = geminiErrorStatus;
+        // Preserve correct prototype chain for instanceof checks
+        Object.setPrototypeOf(this, GeminiProviderError.prototype);
+    }
+}
+//# sourceMappingURL=GeminiProviderError.js.map

package/dist/core/llm/providers/errors/GeminiProviderError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiProviderError.js","sourceRoot":"","sources":["../../../../../src/core/llm/providers/errors/GeminiProviderError.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAUpD;;;;;;;;OAQG;IACH,YACE,OAAe,EACf,IAAY,EACZ,UAAmB,EACnB,iBAA0B,EAC1B,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAE3C,yDAAyD;QACzD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/core/llm/providers/errors/OllamaProviderError.d.ts

@@ -2,7 +2,7 @@
  * @fileoverview Defines a custom error class for Ollama-specific provider errors.
  * This extends the base {@link ProviderError} to include details specific to Ollama API interactions.
  * @module backend/agentos/core/llm/providers/errors/OllamaProviderError
- * @see {@link ./ProviderError.ts}
+ * @see {@link ProviderError}
  */
 import { ProviderError } from './ProviderError';
 /**

package/dist/core/llm/providers/errors/OllamaProviderError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OllamaProviderError.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/errors/OllamaProviderError.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,oEAAoE;IACpE,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO;CAQpB"}
+{"version":3,"file":"OllamaProviderError.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/errors/OllamaProviderError.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,oEAAoE;IACpE,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAOlF"}

package/dist/core/llm/providers/errors/OllamaProviderError.js

@@ -3,7 +3,7 @@
  * @fileoverview Defines a custom error class for Ollama-specific provider errors.
  * This extends the base {@link ProviderError} to include details specific to Ollama API interactions.
  * @module backend/agentos/core/llm/providers/errors/OllamaProviderError
- * @see {@link ./ProviderError.ts}
+ * @see {@link ProviderError}
  */
 import { ProviderError } from './ProviderError.js';
 /**

package/dist/core/llm/providers/errors/OllamaProviderError.js.map

@@ -1 +1 @@
-{"version":3,"file":"OllamaProviderError.js","sourceRoot":"","sources":["../../../../../src/core/llm/providers/errors/OllamaProviderError.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD;;;;;;OAMG;IACH,YACE,OAAe,EACf,IAAY,EACZ,UAAmB,EACnB,OAAiB;QAEjB,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,yBAAyB;QAClE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF"}
+{"version":3,"file":"OllamaProviderError.js","sourceRoot":"","sources":["../../../../../src/core/llm/providers/errors/OllamaProviderError.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,IAAY,EAAE,UAAmB,EAAE,OAAiB;QAC/E,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,yBAAyB;QAClE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/core/llm/providers/errors/OpenAIProviderError.d.ts

@@ -2,7 +2,7 @@
  * @fileoverview Defines a custom error class for OpenAI-specific provider errors.
  * This extends the base {@link ProviderError} to include details specific to OpenAI API interactions.
  * @module backend/agentos/core/llm/providers/errors/OpenAIProviderError
- * @see {@link ./ProviderError.ts}
+ * @see {@link ProviderError}
  */
 import { ProviderError } from './ProviderError';
 /**

package/dist/core/llm/providers/errors/OpenAIProviderError.js

@@ -3,7 +3,7 @@
  * @fileoverview Defines a custom error class for OpenAI-specific provider errors.
  * This extends the base {@link ProviderError} to include details specific to OpenAI API interactions.
  * @module backend/agentos/core/llm/providers/errors/OpenAIProviderError
- * @see {@link ./ProviderError.ts}
+ * @see {@link ProviderError}
  */
 import { ProviderError } from './ProviderError.js';
 /**

package/dist/core/llm/providers/errors/OpenRouterProviderError.d.ts

@@ -2,7 +2,7 @@
  * @fileoverview Defines a custom error class for OpenRouter-specific provider errors.
  * This extends the base {@link ProviderError} to include details specific to OpenRouter API interactions.
  * @module backend/agentos/core/llm/providers/errors/OpenRouterProviderError
- * @see {@link ./ProviderError.ts}
+ * @see {@link ProviderError}
  */
 import { ProviderError } from './ProviderError';
 /**

package/dist/core/llm/providers/errors/OpenRouterProviderError.js

@@ -3,7 +3,7 @@
  * @fileoverview Defines a custom error class for OpenRouter-specific provider errors.
  * This extends the base {@link ProviderError} to include details specific to OpenRouter API interactions.
  * @module backend/agentos/core/llm/providers/errors/OpenRouterProviderError
- * @see {@link ./ProviderError.ts}
+ * @see {@link ProviderError}
  */
 import { ProviderError } from './ProviderError.js';
 /**

package/dist/core/llm/providers/implementations/AnthropicProvider.d.ts

@@ -0,0 +1,340 @@
+/**
+ * @fileoverview Implements the IProvider interface for Anthropic's Messages API.
+ * This provider offers native integration with Anthropic's API, including:
+ * - Chat completions via the Messages endpoint (streaming and non-streaming)
+ * - Tool/function calling with Anthropic's `input_schema` format
+ * - System prompt handling as a top-level field (not a message role)
+ * - Proper stop reason mapping (`end_turn` / `tool_use` → IProvider conventions)
+ *
+ * Key differences from OpenAI that this provider handles:
+ * - `system` is a top-level request field, NOT a message with role "system"
+ * - `max_tokens` is REQUIRED (Anthropic will reject requests without it)
+ * - Tool definitions use `input_schema` instead of `parameters`
+ * - Stop reason is `end_turn` (not `stop`) and `tool_use` (not `tool_calls`)
+ * - Streaming uses distinct SSE event types (`content_block_delta`, `message_delta`)
+ *
+ * @module backend/agentos/core/llm/providers/implementations/AnthropicProvider
+ * @implements {IProvider}
+ */
+import { IProvider, ChatMessage, ModelCompletionOptions, ModelCompletionResponse, ModelInfo, ProviderEmbeddingOptions, ProviderEmbeddingResponse } from '../IProvider';
+/**
+ * Configuration specific to the AnthropicProvider.
+ *
+ * @example
+ * const config: AnthropicProviderConfig = {
+ *   apiKey: process.env.ANTHROPIC_API_KEY!,
+ *   defaultModelId: 'claude-sonnet-4-20250514',
+ *   maxRetries: 3,
+ * };
+ */
+export interface AnthropicProviderConfig {
+    /**
+     * The API key for accessing Anthropic services.
+     * Typically sourced from the `ANTHROPIC_API_KEY` environment variable.
+     */
+    apiKey: string;
+    /**
+     * Base URL for the Anthropic API.
+     * @default "https://api.anthropic.com"
+     */
+    baseURL?: string;
+    /**
+     * Default model ID to use if not specified in a request.
+     * @example "claude-sonnet-4-20250514"
+     */
+    defaultModelId?: string;
+    /**
+     * Maximum number of retry attempts for failed API requests.
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Timeout for API requests in milliseconds.
+     * @default 120000 (120 seconds — Anthropic responses can be slow for large contexts)
+     */
+    requestTimeout?: number;
+    /**
+     * Default max_tokens value when the caller does not specify one.
+     * Anthropic requires max_tokens on every request.
+     * @default 4096
+     */
+    defaultMaxTokens?: number;
+}
+/**
+ * @class AnthropicProvider
+ * @implements {IProvider}
+ *
+ * Provides native integration with Anthropic's Messages API.
+ * Handles the significant structural differences between Anthropic's API
+ * and the OpenAI-style conventions used by IProvider, including system
+ * prompt extraction, tool schema remapping, and stop reason normalization.
+ *
+ * @example
+ * const provider = new AnthropicProvider();
+ * await provider.initialize({ apiKey: 'sk-ant-...' });
+ * const response = await provider.generateCompletion(
+ *   'claude-sonnet-4-20250514',
+ *   [{ role: 'user', content: 'Hello!' }],
+ *   { maxTokens: 1024 },
+ * );
+ */
+export declare class AnthropicProvider implements IProvider {
+    /** @inheritdoc */
+    readonly providerId: string;
+    /** @inheritdoc */
+    isInitialized: boolean;
+    /** @inheritdoc */
+    defaultModelId?: string;
+    private config;
+    constructor();
+    /**
+     * Initialize the Anthropic provider with the given configuration.
+     *
+     * Validates that an API key is present — Anthropic's API will reject
+     * unauthenticated requests. Does NOT make a network call on startup
+     * because Anthropic has no lightweight health endpoint like OpenAI's
+     * `/models` list.
+     *
+     * @param {AnthropicProviderConfig} config - Provider configuration.
+     * @returns {Promise<void>}
+     * @throws {AnthropicProviderError} If the API key is missing.
+     */
+    initialize(config: AnthropicProviderConfig): Promise<void>;
+    /**
+     * Generates a non-streaming chat completion via Anthropic's Messages API.
+     *
+     * Extracts system messages from the conversation and promotes them to the
+     * top-level `system` field, converts tool definitions from OpenAI format
+     * to Anthropic's `input_schema` format, and normalizes the response back
+     * to IProvider conventions.
+     *
+     * @param {string} modelId - The Anthropic model to use (e.g., "claude-sonnet-4-20250514").
+     * @param {ChatMessage[]} messages - Conversation messages. System-role messages are
+     *   extracted and sent as the top-level `system` parameter.
+     * @param {ModelCompletionOptions} options - Completion options. `maxTokens` is strongly
+     *   recommended; defaults to {@link AnthropicProviderConfig.defaultMaxTokens} if omitted.
+     * @returns {Promise<ModelCompletionResponse>} A normalized completion response.
+     * @throws {AnthropicProviderError} On authentication, validation, or network errors.
+     */
+    generateCompletion(modelId: string, messages: ChatMessage[], options: ModelCompletionOptions): Promise<ModelCompletionResponse>;
+    /**
+     * Generates a streaming chat completion via Anthropic's Messages API.
+     *
+     * Anthropic's streaming uses distinct SSE event types:
+     * - `message_start` — initial metadata and usage
+     * - `content_block_start` — beginning of a text or tool_use block
+     * - `content_block_delta` — incremental text or tool argument JSON
+     * - `content_block_stop` — end of a block
+     * - `message_delta` — final stop_reason and output token count
+     * - `message_stop` — terminal event
+     *
+     * This method normalizes all of the above into the IProvider streaming
+     * contract with `responseTextDelta`, `toolCallsDeltas`, and `isFinal`.
+     *
+     * @param {string} modelId - The Anthropic model to use.
+     * @param {ChatMessage[]} messages - Conversation messages.
+     * @param {ModelCompletionOptions} options - Completion options.
+     * @returns {AsyncGenerator<ModelCompletionResponse>} Incremental response chunks.
+     * @throws {AnthropicProviderError} On connection or stream errors.
+     */
+    generateCompletionStream(modelId: string, messages: ChatMessage[], options: ModelCompletionOptions): AsyncGenerator<ModelCompletionResponse, void, undefined>;
+    /**
+     * Anthropic does not offer an embeddings API. This method always throws.
+     *
+     * @param {string} _modelId - Unused.
+     * @param {string[]} _texts - Unused.
+     * @param {ProviderEmbeddingOptions} [_options] - Unused.
+     * @returns {Promise<ProviderEmbeddingResponse>} Never returns.
+     * @throws {AnthropicProviderError} Always — embeddings are not supported.
+     */
+    generateEmbeddings(_modelId: string, _texts: string[], _options?: ProviderEmbeddingOptions): Promise<ProviderEmbeddingResponse>;
+    /**
+     * Returns a static catalog of known Anthropic models.
+     *
+     * Anthropic does not expose a `/models` list endpoint, so this uses a
+     * hardcoded catalog that is kept up-to-date with major releases.
+     *
+     * @param {{ capability?: string }} [filter] - Optional capability filter.
+     * @returns {Promise<ModelInfo[]>} Array of known Anthropic models.
+     */
+    listAvailableModels(filter?: {
+        capability?: string;
+    }): Promise<ModelInfo[]>;
+    /**
+     * Retrieves metadata for a specific model from the static catalog.
+     *
+     * @param {string} modelId - Model identifier (e.g., "claude-sonnet-4-20250514").
+     * @returns {Promise<ModelInfo | undefined>} Model info or undefined if not found.
+     */
+    getModelInfo(modelId: string): Promise<ModelInfo | undefined>;
+    /**
+     * Performs a lightweight health check by sending a minimal Messages request.
+     *
+     * @returns {Promise<{ isHealthy: boolean; details?: unknown }>} Health status.
+     */
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: unknown;
+    }>;
+    /** @inheritdoc */
+    shutdown(): Promise<void>;
+    /**
+     * Guard that throws if the provider has not been initialized.
+     * @private
+     * @throws {AnthropicProviderError} If not initialized.
+     */
+    private ensureInitialized;
+    /**
+     * Builds the Anthropic Messages API request payload from IProvider inputs.
+     *
+     * The key transformation is extracting system-role messages from the
+     * conversation array and placing their content into the top-level `system`
+     * field, since Anthropic does not accept system as a message role.
+     *
+     * @param {string} modelId - Target model.
+     * @param {ChatMessage[]} messages - Conversation messages.
+     * @param {ModelCompletionOptions} options - Completion options.
+     * @param {boolean} stream - Whether to request streaming.
+     * @returns {Record<string, unknown>} The request body for Anthropic's API.
+     * @private
+     */
+    private buildRequestPayload;
+    /**
+     * Converts a single ChatMessage to Anthropic's message format.
+     *
+     * Handles three cases:
+     * 1. Assistant messages with tool_calls → content blocks with tool_use entries
+     * 2. Tool-role messages → content blocks with tool_result entries
+     * 3. Standard user/assistant text or multimodal messages
+     *
+     * @param {ChatMessage} msg - The source message.
+     * @returns {Record<string, unknown>} Anthropic-formatted message.
+     * @private
+     */
+    private toAnthropicMessage;
+    /**
+     * Converts OpenAI-style tool definitions to Anthropic's format.
+     *
+     * OpenAI uses `{ type: 'function', function: { name, description, parameters } }`
+     * while Anthropic uses `{ name, description, input_schema }`.
+     *
+     * @param {Array<Record<string, unknown>>} [tools] - OpenAI-formatted tool defs.
+     * @returns {AnthropicToolDef[]} Anthropic-formatted tool definitions.
+     * @private
+     */
+    private convertToolDefs;
+    /**
+     * Converts an OpenAI-style toolChoice value to Anthropic's tool_choice format.
+     *
+     * @param {string | Record<string, unknown>} choice - OpenAI tool choice.
+     * @returns {Record<string, unknown>} Anthropic tool_choice value.
+     * @private
+     */
+    private convertToolChoice;
+    /**
+     * Maps a non-streaming Anthropic Messages response to IProvider format.
+     *
+     * Extracts text content, tool_use blocks, and usage metrics, then normalizes
+     * the stop reason from Anthropic's vocabulary to IProvider conventions.
+     *
+     * @param {AnthropicMessagesResponse} apiResponse - Raw Anthropic response.
+     * @returns {ModelCompletionResponse} Normalized completion response.
+     * @private
+     */
+    private mapResponseToCompletion;
+    /**
+     * Maps Anthropic stop reasons to IProvider-convention finish reasons.
+     *
+     * - `end_turn` → `"stop"` (natural completion)
+     * - `tool_use` → `"tool_calls"` (model wants to invoke tools)
+     * - `max_tokens` → `"length"` (hit token limit)
+     * - `stop_sequence` → `"stop"` (hit a caller-specified stop sequence)
+     *
+     * @param {string | null} stopReason - Anthropic's stop_reason value.
+     * @returns {string} Normalized finish reason.
+     * @private
+     */
+    private mapStopReason;
+    /**
+     * Assembles completed tool calls from the streaming accumulator.
+     *
+     * @param {Map<number, { id: string; name: string; argsJson: string }>} accum - Tool call accumulators.
+     * @returns {NonNullable<ChatMessage['tool_calls']>} Assembled tool calls array.
+     * @private
+     */
+    private assembleToolCalls;
+    /**
+     * Estimates USD cost for a given model and token counts.
+     *
+     * Looks up pricing from the static model catalog. Returns undefined
+     * if the model is not found in the catalog.
+     *
+     * @param {number} inputTokens - Number of input tokens.
+     * @param {number} outputTokens - Number of output tokens.
+     * @param {string} modelId - Model identifier for pricing lookup.
+     * @returns {number | undefined} Estimated cost in USD.
+     * @private
+     */
+    private estimateCost;
+    /**
+     * Builds an abort chunk for early stream termination.
+     *
+     * @param {string} modelId - The model ID for the response.
+     * @returns {ModelCompletionResponse} A terminal chunk with abort error.
+     * @private
+     */
+    private buildAbortChunk;
+    /**
+     * Makes a non-streaming API request to Anthropic's API with retry logic.
+     *
+     * Uses the `x-api-key` header (Anthropic's auth mechanism) and the required
+     * `anthropic-version` header for API versioning.
+     *
+     * @template T The expected response type.
+     * @param {string} endpoint - API endpoint path (e.g., "/v1/messages").
+     * @param {'POST'} method - HTTP method (Anthropic Messages API is POST-only).
+     * @param {Record<string, unknown>} body - Request body.
+     * @returns {Promise<T>} Parsed JSON response.
+     * @throws {AnthropicProviderError} On authentication, validation, rate-limit, or network errors.
+     * @private
+     */
+    private makeApiRequest;
+    /**
+     * Makes a streaming API request and returns the raw ReadableStream.
+     *
+     * @param {string} endpoint - API endpoint.
+     * @param {Record<string, unknown>} body - Request body (must include `stream: true`).
+     * @returns {Promise<ReadableStream<Uint8Array>>} The response body stream.
+     * @throws {AnthropicProviderError} On connection errors.
+     * @private
+     */
+    private makeStreamRequest;
+    /**
+     * Builds the common headers for all Anthropic API requests.
+     *
+     * Includes the `x-api-key` authentication header and the required
+     * `anthropic-version` header that pins the API behavior.
+     *
+     * @returns {Record<string, string>} Request headers.
+     * @private
+     */
+    private buildHeaders;
+    /**
+     * Parses an SSE (Server-Sent Events) stream from Anthropic.
+     *
+     * Anthropic SSE events follow the format:
+     * ```
+     * event: <event_type>
+     * data: <json_payload>
+     * ```
+     *
+     * This parser extracts the `data:` line content for each event and yields
+     * the raw JSON strings for the caller to parse and dispatch.
+     *
+     * @param {ReadableStream<Uint8Array>} stream - The raw SSE byte stream.
+     * @returns {AsyncGenerator<string>} Yields JSON string payloads.
+     * @private
+     */
+    private parseSseStream;
+}
+//# sourceMappingURL=AnthropicProvider.d.ts.map

package/dist/core/llm/providers/implementations/AnthropicProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/implementations/AnthropicProvider.ts"],"names":[],"mappings":"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"}