art-framework 0.3.7 → 0.3.9

package/dist/index.d.cts

@@ -2787,41 +2787,6 @@ interface ReasoningEngine {
      */
     call(prompt: FormattedPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
 }
-/**
- * Interface for the stateless prompt assembler.
- * Uses a blueprint (template) and context provided by Agent Logic
- * to create a standardized prompt format (`ArtStandardPrompt`).
- */
-interface PromptManager {
-    /**
-     * Retrieves a named prompt fragment (e.g., a piece of instruction text).
-     * Optionally allows for simple variable substitution if the fragment is a basic template.
-     *
-     * @param name - The unique identifier for the fragment.
-     * @param context - Optional data for simple variable substitution within the fragment.
-     * @returns The processed prompt fragment string.
-     * @throws {ARTError} If the fragment is not found.
-     */
-    getFragment(name: string, context?: Record<string, any>): string;
-    /**
-     * Validates a constructed prompt object against the standard schema.
-     *
-     * @param prompt - The ArtStandardPrompt object constructed by the agent.
-     * @returns The validated prompt object (potentially after normalization if the schema does that).
-     * @throws {ZodError} If validation fails (can be caught and wrapped in ARTError).
-     */
-    validatePrompt(prompt: ArtStandardPrompt): ArtStandardPrompt;
-    /**
-     * Assembles a prompt using a Mustache template (blueprint) and context data.
-     * Renders the template with the provided context and parses the result as an ArtStandardPrompt.
-     *
-     * @param blueprint - The Mustache template containing the prompt structure.
-     * @param context - The context data to inject into the template.
-     * @returns A promise resolving to the assembled ArtStandardPrompt.
-     * @throws {ARTError} If template rendering or JSON parsing fails.
-     */
-    assemblePrompt(blueprint: PromptBlueprint, context: PromptContext): Promise<ArtStandardPrompt>;
-}
 /**
  * Resolves the final system prompt from base + instance/thread/call overrides
  * using tag+variables and merge strategies.
@@ -3691,11 +3656,6 @@ declare class TaskDelegationService {
 interface PESAgentDependencies {
     /** Manages thread configuration and state. */
     stateManager: StateManager$1;
-    /**
-     * Optional default system prompt string provided at the ART instance level.
-     * This serves as a custom prompt part if no thread-specific or call-specific
-     * system prompt is provided. It's appended to the agent's base system prompt.
-     */
     /** Manages conversation history. */
     conversationManager: ConversationManager;
     /** Registry for available tools. */
@@ -3730,11 +3690,6 @@ interface PESAgentDependencies {
  *
  * It constructs standardized prompts (`ArtStandardPrompt`) directly as JavaScript objects
  * for the `ReasoningEngine`. It processes the `StreamEvent` output from the reasoning engine for both planning and synthesis.
- *
- * // @see {PromptManager} // Removed
- * @see {ReasoningEngine}
- * @see {ArtStandardPrompt}
- * @see {StreamEvent}
  */
 declare class PESAgent implements IAgentCore {
     private readonly deps;
@@ -3750,11 +3705,13 @@ declare class PESAgent implements IAgentCore {
      * **Workflow:**
      * 1.  **Initiation & Config:** Loads thread configuration and resolves system prompt
      * 2.  **Data Gathering:** Gathers history, available tools
-     * 3.  **Planning:** LLM call for planning and parsing
-     * 4.  **A2A Discovery & Delegation:** Identifies and delegates A2A tasks to remote agents
-     * 5.  **Tool Execution:** Executes identified local tool calls
-     * 6.  **Synthesis:** LLM call for final response generation including A2A results
-     * 7.  **Finalization:** Saves messages and cleanup
+     * 3.  **Loop (ReAct-like):**
+     *     - **Planning:** LLM call for planning and parsing (with access to history of previous steps).
+     *     - **A2A Discovery & Delegation:** Identifies and delegates A2A tasks.
+     *     - **Tool Execution:** Executes identified local tool calls.
+     *     - **Observation:** Results are fed back into the next iteration.
+     * 4.  **Synthesis:** LLM call for final response generation including all results
+     * 5.  **Finalization:** Saves messages and cleanup
      *
      * @param {AgentProps} props - The input properties containing the user query, threadId, userId, traceId, etc.
      * @returns {Promise<AgentFinalResponse>} A promise resolving to the final response, including the AI message and execution metadata.
@@ -3779,11 +3736,6 @@ 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;
     /**
@@ -3793,7 +3745,6 @@ declare class PESAgent implements IAgentCore {
     private _delegateA2ATasks;
     /**
      * Waits for A2A tasks to complete with configurable timeout.
-     * Polls task status periodically and updates local repository with results.
      * @private
      */
     private _waitForA2ACompletion;
@@ -4229,58 +4180,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;
 }
 
 /**
@@ -4330,9 +4300,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.
@@ -4369,28 +4342,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;
@@ -4398,34 +4356,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;
 }
 
@@ -5267,6 +5202,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.7";
+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 };
+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 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

@@ -2787,41 +2787,6 @@ interface ReasoningEngine {
      */
     call(prompt: FormattedPrompt, options: CallOptions): Promise<AsyncIterable<StreamEvent>>;
 }
-/**
- * Interface for the stateless prompt assembler.
- * Uses a blueprint (template) and context provided by Agent Logic
- * to create a standardized prompt format (`ArtStandardPrompt`).
- */
-interface PromptManager {
-    /**
-     * Retrieves a named prompt fragment (e.g., a piece of instruction text).
-     * Optionally allows for simple variable substitution if the fragment is a basic template.
-     *
-     * @param name - The unique identifier for the fragment.
-     * @param context - Optional data for simple variable substitution within the fragment.
-     * @returns The processed prompt fragment string.
-     * @throws {ARTError} If the fragment is not found.
-     */
-    getFragment(name: string, context?: Record<string, any>): string;
-    /**
-     * Validates a constructed prompt object against the standard schema.
-     *
-     * @param prompt - The ArtStandardPrompt object constructed by the agent.
-     * @returns The validated prompt object (potentially after normalization if the schema does that).
-     * @throws {ZodError} If validation fails (can be caught and wrapped in ARTError).
-     */
-    validatePrompt(prompt: ArtStandardPrompt): ArtStandardPrompt;
-    /**
-     * Assembles a prompt using a Mustache template (blueprint) and context data.
-     * Renders the template with the provided context and parses the result as an ArtStandardPrompt.
-     *
-     * @param blueprint - The Mustache template containing the prompt structure.
-     * @param context - The context data to inject into the template.
-     * @returns A promise resolving to the assembled ArtStandardPrompt.
-     * @throws {ARTError} If template rendering or JSON parsing fails.
-     */
-    assemblePrompt(blueprint: PromptBlueprint, context: PromptContext): Promise<ArtStandardPrompt>;
-}
 /**
  * Resolves the final system prompt from base + instance/thread/call overrides
  * using tag+variables and merge strategies.
@@ -3691,11 +3656,6 @@ declare class TaskDelegationService {
 interface PESAgentDependencies {
     /** Manages thread configuration and state. */
     stateManager: StateManager$1;
-    /**
-     * Optional default system prompt string provided at the ART instance level.
-     * This serves as a custom prompt part if no thread-specific or call-specific
-     * system prompt is provided. It's appended to the agent's base system prompt.
-     */
     /** Manages conversation history. */
     conversationManager: ConversationManager;
     /** Registry for available tools. */
@@ -3730,11 +3690,6 @@ interface PESAgentDependencies {
  *
  * It constructs standardized prompts (`ArtStandardPrompt`) directly as JavaScript objects
  * for the `ReasoningEngine`. It processes the `StreamEvent` output from the reasoning engine for both planning and synthesis.
- *
- * // @see {PromptManager} // Removed
- * @see {ReasoningEngine}
- * @see {ArtStandardPrompt}
- * @see {StreamEvent}
  */
 declare class PESAgent implements IAgentCore {
     private readonly deps;
@@ -3750,11 +3705,13 @@ declare class PESAgent implements IAgentCore {
      * **Workflow:**
      * 1.  **Initiation & Config:** Loads thread configuration and resolves system prompt
      * 2.  **Data Gathering:** Gathers history, available tools
-     * 3.  **Planning:** LLM call for planning and parsing
-     * 4.  **A2A Discovery & Delegation:** Identifies and delegates A2A tasks to remote agents
-     * 5.  **Tool Execution:** Executes identified local tool calls
-     * 6.  **Synthesis:** LLM call for final response generation including A2A results
-     * 7.  **Finalization:** Saves messages and cleanup
+     * 3.  **Loop (ReAct-like):**
+     *     - **Planning:** LLM call for planning and parsing (with access to history of previous steps).
+     *     - **A2A Discovery & Delegation:** Identifies and delegates A2A tasks.
+     *     - **Tool Execution:** Executes identified local tool calls.
+     *     - **Observation:** Results are fed back into the next iteration.
+     * 4.  **Synthesis:** LLM call for final response generation including all results
+     * 5.  **Finalization:** Saves messages and cleanup
      *
      * @param {AgentProps} props - The input properties containing the user query, threadId, userId, traceId, etc.
      * @returns {Promise<AgentFinalResponse>} A promise resolving to the final response, including the AI message and execution metadata.
@@ -3779,11 +3736,6 @@ 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;
     /**
@@ -3793,7 +3745,6 @@ declare class PESAgent implements IAgentCore {
     private _delegateA2ATasks;
     /**
      * Waits for A2A tasks to complete with configurable timeout.
-     * Polls task status periodically and updates local repository with results.
      * @private
      */
     private _waitForA2ACompletion;
@@ -4229,58 +4180,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;
 }
 
 /**
@@ -4330,9 +4300,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.
@@ -4369,28 +4342,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;
@@ -4398,34 +4356,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;
 }
 
@@ -5267,6 +5202,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.7";
+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 };
+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 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 };