art-framework 0.3.8 → 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;
@@ -5253,4 +5204,4 @@ declare const generateUUID: () => string;
  */
 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;
@@ -5253,4 +5204,4 @@ declare const generateUUID: () => string;
  */
 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 };