art-framework 0.3.6 → 0.3.8

package/dist/index.d.cts

@@ -978,6 +978,8 @@ interface ConversationMessage {
 declare enum ObservationType {
     /** The user's inferred intent. */
     INTENT = "INTENT",
+    /** The generated concise thread title. */
+    TITLE = "TITLE",
     /** The agent's step-by-step plan to address the intent. */
     PLAN = "PLAN",
     /** The agent's internal monologue or reasoning process. */
@@ -1063,6 +1065,15 @@ interface Observation {
     title: string;
     /**
      * The main data payload of the observation, structure depends on the `type`.
+     *
+     * @remarks
+     * Common content shapes by `type`:
+     * - `TITLE`: `{ title: string }` — a concise thread title (<= 10 words)
+     * - `INTENT`: `{ intent: string }`
+     * - `PLAN`: `{ plan: string; rawOutput?: string }`
+     * - `TOOL_CALL`: `{ toolCalls: ParsedToolCall[] }`
+     * - `TOOL_EXECUTION`: `{ callId: string; toolName: string; status: 'success' | 'error'; output?: any; error?: string }`
+     * - `FINAL_RESPONSE`: `{ message: ConversationMessage; uiMetadata?: object }`
      * @property {any} content
      */
     content: any;
@@ -2834,10 +2845,25 @@ interface OutputParser {
      * @returns A promise resolving to an object containing the extracted intent, plan description, and an array of parsed tool calls.
      * @throws {ARTError} If the output cannot be parsed into the expected structure (typically code `OUTPUT_PARSING_FAILED`).
      */
+    /**
+     * Parses the raw planning LLM output into structured fields.
+     *
+     * @remarks
+     * This method should be resilient to provider-specific wrappers and formats.
+     * Implementations MUST attempt JSON-first parsing and then fall back to parsing
+     * labeled sections. Supported fields:
+     * - `title?`: A concise thread title (<= 10 words), derived from the user's intent and context.
+     * - `intent?`: A short summary of the user's goal.
+     * - `plan?`: A human-readable list/description of steps.
+     * - `toolCalls?`: Structured tool call intents parsed from the output.
+     * - `thoughts?`: Aggregated content extracted from <think> tags when present.
+     */
     parsePlanningOutput(output: string): Promise<{
+        title?: string;
         intent?: string;
         plan?: string;
         toolCalls?: ParsedToolCall[];
+        thoughts?: string;
     }>;
     /**
      * Parses the raw string output from the synthesis LLM call to extract the final, user-facing response content.
@@ -3753,6 +3779,11 @@ declare class PESAgent implements IAgentCore {
     /**
      * Performs the planning phase including LLM call and output parsing.
      * @private
+     *
+     * @remarks
+     * The planning prompt instructs the LLM to produce a concise `title` (<= 10 words)
+     * alongside `intent`, `plan`, and `toolCalls`. After parsing, a `TITLE` observation
+     * is emitted (if present) for UI components to subscribe via `ObservationSocket`.
      */
     private _performPlanning;
     /**
@@ -4198,58 +4229,77 @@ declare class GeminiAdapter implements ProviderAdapter {
 interface OpenAIAdapterOptions {
     /** Your OpenAI API key. Handle securely. */
     apiKey: string;
-    /** The default OpenAI model ID to use (e.g., 'gpt-4o', 'gpt-4o-mini'). Defaults to 'gpt-3.5-turbo' if not provided. */
+    /** The default OpenAI model ID to use (e.g., 'gpt-4o', 'gpt-5', 'gpt-5-mini'). */
     model?: string;
     /** Optional: Override the base URL for the OpenAI API (e.g., for Azure OpenAI or custom proxies). */
     apiBaseUrl?: string;
+    /** Optional: Default maximum tokens for responses. */
+    defaultMaxTokens?: number;
+    /** Optional: Default temperature for responses. */
+    defaultTemperature?: number;
 }
 /**
  * Implements the `ProviderAdapter` interface for interacting with OpenAI's
- * Chat Completions API (compatible models like GPT-3.5, GPT-4, GPT-4o).
+ * Responses API (supports reasoning models like GPT-5 family and other models).
  *
- * Handles formatting requests and parsing responses for OpenAI.
- * Uses raw `fetch` for now.
+ * Handles formatting requests, parsing responses, streaming, reasoning token detection, and tool use.
+ * Uses the official OpenAI SDK with the new Responses API for full reasoning model support.
  *
  * @see {@link ProviderAdapter} for the interface definition.
+ * @see {@link OpenAIAdapterOptions} for configuration options.
  */
 declare class OpenAIAdapter implements ProviderAdapter {
     readonly providerName = "openai";
-    private apiKey;
-    private model;
-    private apiBaseUrl;
+    private client;
+    private defaultModel;
+    private defaultMaxTokens;
+    private defaultTemperature;
     /**
      * Creates an instance of the OpenAIAdapter.
-     * @param {OpenAIAdapterOptions} options - Configuration options including the API key and optional model/baseURL overrides.
-     * @throws {Error} If the API key is missing.
-     * @see https://platform.openai.com/docs/api-reference
+     * @param options - Configuration options including the API key and optional model/baseURL/defaults.
+     * @throws {ARTError} If the API key is missing.
      */
     constructor(options: OpenAIAdapterOptions);
     /**
-     * Sends a request to the OpenAI Chat Completions API.
-     * Translates `ArtStandardPrompt` to the OpenAI format, handles streaming and non-streaming responses.
+     * Sends a request to the OpenAI Responses API.
+     * Translates `ArtStandardPrompt` to the Responses API format and handles streaming/reasoning.
      *
      * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
-     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream` preference, and any OpenAI-specific parameters (like `temperature`, `max_tokens`) passed through.
+     * @param {CallOptions} options - Call options, including streaming, reasoning options, and model parameters.
      * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects.
-     * @see https://platform.openai.com/docs/api-reference/chat/create
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
     /**
-      * Processes the Server-Sent Events (SSE) stream from OpenAI.
-      * @param stream - The ReadableStream from the fetch response.
-      * @param options - The original CallOptions containing threadId, traceId, sessionId, and callContext.
-      * @returns An AsyncIterable yielding StreamEvent objects.
-      */
-    private processStream;
+     * Optional: Method for graceful shutdown
+     */
+    shutdown(): Promise<void>;
     /**
-     * Translates the provider-agnostic `ArtStandardPrompt` into the OpenAI API's `OpenAIMessage[]` format.
+     * Translates the provider-agnostic `ArtStandardPrompt` into the OpenAI Responses API format.
+     * Extracts system prompt separately and formats messages as input array.
      *
      * @private
      * @param {ArtStandardPrompt} artPrompt - The input `ArtStandardPrompt` array.
-     * @returns {OpenAIMessage[]} The `OpenAIMessage[]` array formatted for the OpenAI API.
-     * @throws {ARTError} If translation encounters an issue (ErrorCode.PROMPT_TRANSLATION_FAILED).
+     * @returns {{ systemPrompt?: string; input: OpenAIResponsesInputMessage[] }} An object containing the extracted system prompt and the array of Responses API formatted input messages.
+     * @throws {ARTError} If translation encounters an issue.
      */
-    private translateToOpenAI;
+    private translateToResponsesFormat;
+    /**
+     * Maps a single `ArtStandardMessage` to OpenAI Responses API input format.
+     *
+     * @private
+     * @param {ArtStandardMessage} artMsg - The ART standard message to map.
+     * @returns {OpenAIResponsesInputMessage | null} The translated message for the Responses API, or null if should be skipped.
+     * @throws {ARTError} If tool call arguments are not valid JSON.
+     */
+    private mapArtMessageToResponsesContent;
+    /**
+     * Translates an array of `ToolSchema` from the ART framework format to OpenAI's Responses API tool format.
+     * @private
+     * @param {ToolSchema[]} artTools - An array of ART tool schemas.
+     * @returns {OpenAIResponsesTool[]} An array of tools formatted for the OpenAI Responses API.
+     * @throws {ARTError} If a tool's `inputSchema` is invalid.
+     */
+    private translateArtToolsToOpenAI;
 }
 
 /**
@@ -4299,9 +4349,12 @@ declare class AnthropicAdapter implements ProviderAdapter {
      * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects.
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
+    /**
+     * Optional: Method for graceful shutdown
+     */
+    shutdown(): Promise<void>;
     /**
      * Prepares request options, adding Anthropic beta headers if applicable for features like prompt caching.
-     * This allows opting into experimental features on a per-request basis.
      * @private
      * @param {string} modelId - The model ID being used for the request, to determine which beta features may apply.
      * @returns {Anthropic.RequestOptions} The request options object, potentially with custom headers.
@@ -4338,28 +4391,13 @@ declare class AnthropicAdapter implements ProviderAdapter {
     private translateArtToolsToAnthropic;
 }
 
-/**
- * Configuration options required for the `OpenRouterAdapter`.
- */
 interface OpenRouterAdapterOptions {
-    /** Your OpenRouter API key. Handle securely. */
     apiKey: string;
-    /** The required OpenRouter model identifier string (e.g., 'google/gemini-pro', 'anthropic/claude-3-haiku', 'openai/gpt-4o'). This specifies which underlying model OpenRouter should use. */
     model: string;
-    /** Optional: Override the base URL for the OpenRouter API. Defaults to 'https://openrouter.ai/api/v1'. */
     apiBaseUrl?: string;
-    /** Optional: Your application's site URL, sent as the 'HTTP-Referer' header (recommended by OpenRouter). */
     siteUrl?: string;
-    /** Optional: Your application's name, sent as the 'X-Title' header (recommended by OpenRouter). */
     appName?: string;
 }
-/**
- * This adapter provides a unified interface for various LLM providers through OpenRouter,
- * handling prompt conversion and response parsing into the ART `StreamEvent` format.
- *
- * @see {@link ProviderAdapter} for the interface it implements.
- * @see {@link OpenRouterAdapterOptions} for configuration options.
- */
 declare class OpenRouterAdapter implements ProviderAdapter {
     readonly providerName = "openrouter";
     private apiKey;
@@ -4367,34 +4405,11 @@ declare class OpenRouterAdapter implements ProviderAdapter {
     private apiBaseUrl;
     private siteUrl?;
     private appName?;
-    /**
-     * Creates an instance of the OpenRouterAdapter.
-     * @param {OpenRouterAdapterOptions} options - Configuration options including the API key, the specific OpenRouter model identifier, and optional headers/baseURL.
-     * @throws {Error} If the API key or model identifier is missing.
-     * @see https://openrouter.ai/docs
-     */
     constructor(options: OpenRouterAdapterOptions);
-    /**
-     * Sends a request to the OpenRouter Chat Completions API endpoint.
-     * Translates `ArtStandardPrompt` to the OpenAI-compatible format.
-     *
-     * **Note:** Streaming is **not yet implemented**.
-     *
-     * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
-     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream`, and any OpenAI-compatible 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.
-     * @see https://openrouter.ai/docs#api-reference-chat-completions
-     */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
-    /**
-     * Translates the provider-agnostic `ArtStandardPrompt` into the OpenAI API's `OpenAIMessage[]` format.
-     * (Copied from OpenAIAdapter - assumes OpenRouter compatibility)
-     *
-     * @private
-     * @param {ArtStandardPrompt} artPrompt - The input `ArtStandardPrompt` array.
-     * @returns {OpenAIMessage[]} The `OpenAIMessage[]` array formatted for the OpenAI API.
-     * @throws {ARTError} If translation encounters an issue (ErrorCode.PROMPT_TRANSLATION_FAILED).
-     */
+    private processStream;
+    private processNonStreamingResponse;
+    private translateArtToolsToOpenAI;
     private translateToOpenAI;
 }
 
@@ -5236,6 +5251,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.5";
+declare const VERSION = "0.3.8";
 
 export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, type AgentFinalResponse, type AgentOptions, type AgentPersona, type AgentProps, type AgentState, AnthropicAdapter, type AnthropicAdapterOptions, ApiKeyStrategy, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, AuthManager, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, ConversationSocket, type CreateA2ATaskRequest, DeepSeekAdapter, type DeepSeekAdapterOptions, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, type IA2ATaskRepository, type IAgentCore, type IAuthStrategy, type IConversationRepository, type IObservationRepository, type IProviderManager, type IStateRepository, type IToolExecutor, type ITypedSocket, InMemoryStorageAdapter, IndexedDBStorageAdapter, type JsonObjectSchema, type JsonSchema, type LLMMetadata, LLMStreamSocket, LocalInstanceBusyError, LocalProviderConflictError, LogLevel, Logger, type LoggerConfig, type ManagedAdapterAccessor, McpClientController, McpManager, type McpManagerConfig, McpProxyTool, type McpResource, type McpResourceTemplate, type McpServerConfig, type McpServerStatus, type McpToolDefinition, type MessageOptions, MessageRole, ModelCapability, type OAuthConfig, type Observation, type ObservationFilter, type ObservationManager, ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, type OpenAIAdapterOptions, OpenRouterAdapter, type OpenRouterAdapterOptions, type OutputParser, PESAgent, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type StreamEventTypeFilter, SupabaseStorageAdapter, type SystemPromptMergeStrategy, type SystemPromptOverride, type SystemPromptResolver, type SystemPromptSpec, type SystemPromptsRegistry, type TaskDelegationConfig, TaskDelegationService, type TaskStatusResponse, type ThreadConfig, type ThreadContext, ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, UISystem, UnknownProviderError, type UnsubscribeFunction, type UpdateA2ATaskRequest, VERSION, type ZyntopiaOAuthConfig, ZyntopiaOAuthStrategy, createArtInstance, generateUUID };

package/dist/index.d.ts

@@ -978,6 +978,8 @@ interface ConversationMessage {
 declare enum ObservationType {
     /** The user's inferred intent. */
     INTENT = "INTENT",
+    /** The generated concise thread title. */
+    TITLE = "TITLE",
     /** The agent's step-by-step plan to address the intent. */
     PLAN = "PLAN",
     /** The agent's internal monologue or reasoning process. */
@@ -1063,6 +1065,15 @@ interface Observation {
     title: string;
     /**
      * The main data payload of the observation, structure depends on the `type`.
+     *
+     * @remarks
+     * Common content shapes by `type`:
+     * - `TITLE`: `{ title: string }` — a concise thread title (<= 10 words)
+     * - `INTENT`: `{ intent: string }`
+     * - `PLAN`: `{ plan: string; rawOutput?: string }`
+     * - `TOOL_CALL`: `{ toolCalls: ParsedToolCall[] }`
+     * - `TOOL_EXECUTION`: `{ callId: string; toolName: string; status: 'success' | 'error'; output?: any; error?: string }`
+     * - `FINAL_RESPONSE`: `{ message: ConversationMessage; uiMetadata?: object }`
      * @property {any} content
      */
     content: any;
@@ -2834,10 +2845,25 @@ interface OutputParser {
      * @returns A promise resolving to an object containing the extracted intent, plan description, and an array of parsed tool calls.
      * @throws {ARTError} If the output cannot be parsed into the expected structure (typically code `OUTPUT_PARSING_FAILED`).
      */
+    /**
+     * Parses the raw planning LLM output into structured fields.
+     *
+     * @remarks
+     * This method should be resilient to provider-specific wrappers and formats.
+     * Implementations MUST attempt JSON-first parsing and then fall back to parsing
+     * labeled sections. Supported fields:
+     * - `title?`: A concise thread title (<= 10 words), derived from the user's intent and context.
+     * - `intent?`: A short summary of the user's goal.
+     * - `plan?`: A human-readable list/description of steps.
+     * - `toolCalls?`: Structured tool call intents parsed from the output.
+     * - `thoughts?`: Aggregated content extracted from <think> tags when present.
+     */
     parsePlanningOutput(output: string): Promise<{
+        title?: string;
         intent?: string;
         plan?: string;
         toolCalls?: ParsedToolCall[];
+        thoughts?: string;
     }>;
     /**
      * Parses the raw string output from the synthesis LLM call to extract the final, user-facing response content.
@@ -3753,6 +3779,11 @@ declare class PESAgent implements IAgentCore {
     /**
      * Performs the planning phase including LLM call and output parsing.
      * @private
+     *
+     * @remarks
+     * The planning prompt instructs the LLM to produce a concise `title` (<= 10 words)
+     * alongside `intent`, `plan`, and `toolCalls`. After parsing, a `TITLE` observation
+     * is emitted (if present) for UI components to subscribe via `ObservationSocket`.
      */
     private _performPlanning;
     /**
@@ -4198,58 +4229,77 @@ declare class GeminiAdapter implements ProviderAdapter {
 interface OpenAIAdapterOptions {
     /** Your OpenAI API key. Handle securely. */
     apiKey: string;
-    /** The default OpenAI model ID to use (e.g., 'gpt-4o', 'gpt-4o-mini'). Defaults to 'gpt-3.5-turbo' if not provided. */
+    /** The default OpenAI model ID to use (e.g., 'gpt-4o', 'gpt-5', 'gpt-5-mini'). */
     model?: string;
     /** Optional: Override the base URL for the OpenAI API (e.g., for Azure OpenAI or custom proxies). */
     apiBaseUrl?: string;
+    /** Optional: Default maximum tokens for responses. */
+    defaultMaxTokens?: number;
+    /** Optional: Default temperature for responses. */
+    defaultTemperature?: number;
 }
 /**
  * Implements the `ProviderAdapter` interface for interacting with OpenAI's
- * Chat Completions API (compatible models like GPT-3.5, GPT-4, GPT-4o).
+ * Responses API (supports reasoning models like GPT-5 family and other models).
  *
- * Handles formatting requests and parsing responses for OpenAI.
- * Uses raw `fetch` for now.
+ * Handles formatting requests, parsing responses, streaming, reasoning token detection, and tool use.
+ * Uses the official OpenAI SDK with the new Responses API for full reasoning model support.
  *
  * @see {@link ProviderAdapter} for the interface definition.
+ * @see {@link OpenAIAdapterOptions} for configuration options.
  */
 declare class OpenAIAdapter implements ProviderAdapter {
     readonly providerName = "openai";
-    private apiKey;
-    private model;
-    private apiBaseUrl;
+    private client;
+    private defaultModel;
+    private defaultMaxTokens;
+    private defaultTemperature;
     /**
      * Creates an instance of the OpenAIAdapter.
-     * @param {OpenAIAdapterOptions} options - Configuration options including the API key and optional model/baseURL overrides.
-     * @throws {Error} If the API key is missing.
-     * @see https://platform.openai.com/docs/api-reference
+     * @param options - Configuration options including the API key and optional model/baseURL/defaults.
+     * @throws {ARTError} If the API key is missing.
      */
     constructor(options: OpenAIAdapterOptions);
     /**
-     * Sends a request to the OpenAI Chat Completions API.
-     * Translates `ArtStandardPrompt` to the OpenAI format, handles streaming and non-streaming responses.
+     * Sends a request to the OpenAI Responses API.
+     * Translates `ArtStandardPrompt` to the Responses API format and handles streaming/reasoning.
      *
      * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
-     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream` preference, and any OpenAI-specific parameters (like `temperature`, `max_tokens`) passed through.
+     * @param {CallOptions} options - Call options, including streaming, reasoning options, and model parameters.
      * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects.
-     * @see https://platform.openai.com/docs/api-reference/chat/create
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
     /**
-      * Processes the Server-Sent Events (SSE) stream from OpenAI.
-      * @param stream - The ReadableStream from the fetch response.
-      * @param options - The original CallOptions containing threadId, traceId, sessionId, and callContext.
-      * @returns An AsyncIterable yielding StreamEvent objects.
-      */
-    private processStream;
+     * Optional: Method for graceful shutdown
+     */
+    shutdown(): Promise<void>;
     /**
-     * Translates the provider-agnostic `ArtStandardPrompt` into the OpenAI API's `OpenAIMessage[]` format.
+     * Translates the provider-agnostic `ArtStandardPrompt` into the OpenAI Responses API format.
+     * Extracts system prompt separately and formats messages as input array.
      *
      * @private
      * @param {ArtStandardPrompt} artPrompt - The input `ArtStandardPrompt` array.
-     * @returns {OpenAIMessage[]} The `OpenAIMessage[]` array formatted for the OpenAI API.
-     * @throws {ARTError} If translation encounters an issue (ErrorCode.PROMPT_TRANSLATION_FAILED).
+     * @returns {{ systemPrompt?: string; input: OpenAIResponsesInputMessage[] }} An object containing the extracted system prompt and the array of Responses API formatted input messages.
+     * @throws {ARTError} If translation encounters an issue.
      */
-    private translateToOpenAI;
+    private translateToResponsesFormat;
+    /**
+     * Maps a single `ArtStandardMessage` to OpenAI Responses API input format.
+     *
+     * @private
+     * @param {ArtStandardMessage} artMsg - The ART standard message to map.
+     * @returns {OpenAIResponsesInputMessage | null} The translated message for the Responses API, or null if should be skipped.
+     * @throws {ARTError} If tool call arguments are not valid JSON.
+     */
+    private mapArtMessageToResponsesContent;
+    /**
+     * Translates an array of `ToolSchema` from the ART framework format to OpenAI's Responses API tool format.
+     * @private
+     * @param {ToolSchema[]} artTools - An array of ART tool schemas.
+     * @returns {OpenAIResponsesTool[]} An array of tools formatted for the OpenAI Responses API.
+     * @throws {ARTError} If a tool's `inputSchema` is invalid.
+     */
+    private translateArtToolsToOpenAI;
 }
 
 /**
@@ -4299,9 +4349,12 @@ declare class AnthropicAdapter implements ProviderAdapter {
      * @returns {Promise<AsyncIterable<StreamEvent>>} A promise resolving to an AsyncIterable of StreamEvent objects.
      */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
+    /**
+     * Optional: Method for graceful shutdown
+     */
+    shutdown(): Promise<void>;
     /**
      * Prepares request options, adding Anthropic beta headers if applicable for features like prompt caching.
-     * This allows opting into experimental features on a per-request basis.
      * @private
      * @param {string} modelId - The model ID being used for the request, to determine which beta features may apply.
      * @returns {Anthropic.RequestOptions} The request options object, potentially with custom headers.
@@ -4338,28 +4391,13 @@ declare class AnthropicAdapter implements ProviderAdapter {
     private translateArtToolsToAnthropic;
 }
 
-/**
- * Configuration options required for the `OpenRouterAdapter`.
- */
 interface OpenRouterAdapterOptions {
-    /** Your OpenRouter API key. Handle securely. */
     apiKey: string;
-    /** The required OpenRouter model identifier string (e.g., 'google/gemini-pro', 'anthropic/claude-3-haiku', 'openai/gpt-4o'). This specifies which underlying model OpenRouter should use. */
     model: string;
-    /** Optional: Override the base URL for the OpenRouter API. Defaults to 'https://openrouter.ai/api/v1'. */
     apiBaseUrl?: string;
-    /** Optional: Your application's site URL, sent as the 'HTTP-Referer' header (recommended by OpenRouter). */
     siteUrl?: string;
-    /** Optional: Your application's name, sent as the 'X-Title' header (recommended by OpenRouter). */
     appName?: string;
 }
-/**
- * This adapter provides a unified interface for various LLM providers through OpenRouter,
- * handling prompt conversion and response parsing into the ART `StreamEvent` format.
- *
- * @see {@link ProviderAdapter} for the interface it implements.
- * @see {@link OpenRouterAdapterOptions} for configuration options.
- */
 declare class OpenRouterAdapter implements ProviderAdapter {
     readonly providerName = "openrouter";
     private apiKey;
@@ -4367,34 +4405,11 @@ declare class OpenRouterAdapter implements ProviderAdapter {
     private apiBaseUrl;
     private siteUrl?;
     private appName?;
-    /**
-     * Creates an instance of the OpenRouterAdapter.
-     * @param {OpenRouterAdapterOptions} options - Configuration options including the API key, the specific OpenRouter model identifier, and optional headers/baseURL.
-     * @throws {Error} If the API key or model identifier is missing.
-     * @see https://openrouter.ai/docs
-     */
     constructor(options: OpenRouterAdapterOptions);
-    /**
-     * Sends a request to the OpenRouter Chat Completions API endpoint.
-     * Translates `ArtStandardPrompt` to the OpenAI-compatible format.
-     *
-     * **Note:** Streaming is **not yet implemented**.
-     *
-     * @param {ArtStandardPrompt} prompt - The standardized prompt messages.
-     * @param {CallOptions} options - Call options, including `threadId`, `traceId`, `stream`, and any OpenAI-compatible 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.
-     * @see https://openrouter.ai/docs#api-reference-chat-completions
-     */
     call(prompt: ArtStandardPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
-    /**
-     * Translates the provider-agnostic `ArtStandardPrompt` into the OpenAI API's `OpenAIMessage[]` format.
-     * (Copied from OpenAIAdapter - assumes OpenRouter compatibility)
-     *
-     * @private
-     * @param {ArtStandardPrompt} artPrompt - The input `ArtStandardPrompt` array.
-     * @returns {OpenAIMessage[]} The `OpenAIMessage[]` array formatted for the OpenAI API.
-     * @throws {ARTError} If translation encounters an issue (ErrorCode.PROMPT_TRANSLATION_FAILED).
-     */
+    private processStream;
+    private processNonStreamingResponse;
+    private translateArtToolsToOpenAI;
     private translateToOpenAI;
 }
 
@@ -5236,6 +5251,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.5";
+declare const VERSION = "0.3.8";
 
 export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, type AgentFinalResponse, type AgentOptions, type AgentPersona, type AgentProps, type AgentState, AnthropicAdapter, type AnthropicAdapterOptions, ApiKeyStrategy, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, AuthManager, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, ConversationSocket, type CreateA2ATaskRequest, DeepSeekAdapter, type DeepSeekAdapterOptions, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, type IA2ATaskRepository, type IAgentCore, type IAuthStrategy, type IConversationRepository, type IObservationRepository, type IProviderManager, type IStateRepository, type IToolExecutor, type ITypedSocket, InMemoryStorageAdapter, IndexedDBStorageAdapter, type JsonObjectSchema, type JsonSchema, type LLMMetadata, LLMStreamSocket, LocalInstanceBusyError, LocalProviderConflictError, LogLevel, Logger, type LoggerConfig, type ManagedAdapterAccessor, McpClientController, McpManager, type McpManagerConfig, McpProxyTool, type McpResource, type McpResourceTemplate, type McpServerConfig, type McpServerStatus, type McpToolDefinition, type MessageOptions, MessageRole, ModelCapability, type OAuthConfig, type Observation, type ObservationFilter, type ObservationManager, ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, type OpenAIAdapterOptions, OpenRouterAdapter, type OpenRouterAdapterOptions, type OutputParser, PESAgent, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type StreamEventTypeFilter, SupabaseStorageAdapter, type SystemPromptMergeStrategy, type SystemPromptOverride, type SystemPromptResolver, type SystemPromptSpec, type SystemPromptsRegistry, type TaskDelegationConfig, TaskDelegationService, type TaskStatusResponse, type ThreadConfig, type ThreadContext, ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, UISystem, UnknownProviderError, type UnsubscribeFunction, type UpdateA2ATaskRequest, VERSION, type ZyntopiaOAuthConfig, ZyntopiaOAuthStrategy, createArtInstance, generateUUID };