art-framework 0.4.7 → 0.4.10

package/dist/index.d.cts

@@ -477,6 +477,21 @@ interface PESAgentStateData {
         toolCall: ParsedToolCall;
         iterationState: ArtStandardPrompt;
     };
+    stepOutputs?: Record<string, StepOutputEntry>;
+}
+/**
+ * Structured entry for step output table.
+ * Persisted for resume capability and cross-step data access.
+ */
+interface StepOutputEntry {
+    stepId: string;
+    description: string;
+    stepType: 'tool' | 'reasoning';
+    status: TodoItemStatus;
+    completedAt?: number;
+    rawResult?: any;
+    toolResults?: ToolResult[];
+    summary?: string;
 }
 interface ExecutionOutput {
     thoughts?: string;
@@ -1658,6 +1673,12 @@ interface AgentOptions {
      * @property {Partial<AgentPersona>} [persona]
      */
     persona?: Partial<AgentPersona>;
+    /**
+     * Optional: Configuration for execution phase behavior (TAEF parameters) for this specific call.
+     * Overrides thread and instance-level execution config.
+     * @property {ExecutionConfig} [executionConfig]
+     */
+    executionConfig?: ExecutionConfig;
 }
 /**
  * The final structured response returned by the agent core after processing.
@@ -2134,6 +2155,11 @@ interface ArtInstanceConfig {
      * @property {AgentPersona} [persona]
      */
     persona?: AgentPersona;
+    /**
+     * Optional: Configuration for execution phase behavior (TAEF parameters).
+     * @property {ExecutionConfig} [execution]
+     */
+    execution?: ExecutionConfig;
     /**
      * Optional configuration for MCP (Model Context Protocol) manager.
      * Enables connection to external MCP servers for dynamic tool loading.
@@ -2585,6 +2611,40 @@ interface AgentPersona {
      */
     prompts: StageSpecificPrompts;
 }
+/**
+ * Configuration options for the execution phase of the PES Agent.
+ * Controls TAEF (Tool-Aware Execution Framework) behavior.
+ *
+ * @interface ExecutionConfig
+ */
+interface ExecutionConfig {
+    /**
+     * Maximum number of LLM iterations per todo item during execution.
+     * Default: 5
+     * @property {number} [maxIterations]
+     */
+    maxIterations?: number;
+    /**
+     * Maximum number of TAEF tool validation retries when required tools are not invoked.
+     * Default: 2
+     * @property {number} [taefMaxRetries]
+     */
+    taefMaxRetries?: number;
+    /**
+     * Maximum character length for tool result serialization in step context.
+     * Higher values preserve more data for the LLM but increase token usage.
+     * Default: 60000 (effectively no practical limit)
+     * @property {number} [toolResultMaxLength]
+     */
+    toolResultMaxLength?: number;
+    /**
+     * Whether to enable A2A (Agent-to-Agent) delegation during execution.
+     * When true, injects the delegate_to_agent tool into execution context.
+     * Default: false
+     * @property {boolean} [enableA2ADelegation]
+     */
+    enableA2ADelegation?: boolean;
+}
 /**
  * Defines stage-specific system prompts for planning and synthesis.
  *
@@ -2603,6 +2663,13 @@ interface StageSpecificPrompts {
      * @property {string} [synthesis]
      */
     synthesis?: string;
+    /**
+     * Custom system prompt template for tool execution steps.
+     * If provided, overrides the default execution prompt.
+     * Supports variable interpolation: ${item.description}, ${completedItemsContext}, etc.
+     * @property {string} [execution]
+     */
+    execution?: string;
 }
 
 /**
@@ -3884,6 +3951,7 @@ declare class PESAgent implements IAgentCore {
     /**
      * Builds execution prompt for TOOL-type steps.
      * Emphasizes tool invocation and explicitly names required tools.
+     * Includes Data Flow Directive to guide LLM in extracting data from previous results.
      */
     private _buildToolStepPrompt;
     /**
@@ -5418,6 +5486,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.4.7";
+declare const VERSION = "0.4.10";
 
-export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, AgentFactory, 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 ExecutionOutput, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, GroqAdapter, type GroqAdapterOptions, 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 PESAgentStateData, 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, type TodoItem, TodoItemStatus, 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, AgentFactory, 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 ExecutionConfig, type ExecutionContext, type ExecutionMetadata, type ExecutionOutput, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, GroqAdapter, type GroqAdapterOptions, 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 PESAgentStateData, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StepOutputEntry, 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, type TodoItem, TodoItemStatus, 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

@@ -477,6 +477,21 @@ interface PESAgentStateData {
         toolCall: ParsedToolCall;
         iterationState: ArtStandardPrompt;
     };
+    stepOutputs?: Record<string, StepOutputEntry>;
+}
+/**
+ * Structured entry for step output table.
+ * Persisted for resume capability and cross-step data access.
+ */
+interface StepOutputEntry {
+    stepId: string;
+    description: string;
+    stepType: 'tool' | 'reasoning';
+    status: TodoItemStatus;
+    completedAt?: number;
+    rawResult?: any;
+    toolResults?: ToolResult[];
+    summary?: string;
 }
 interface ExecutionOutput {
     thoughts?: string;
@@ -1658,6 +1673,12 @@ interface AgentOptions {
      * @property {Partial<AgentPersona>} [persona]
      */
     persona?: Partial<AgentPersona>;
+    /**
+     * Optional: Configuration for execution phase behavior (TAEF parameters) for this specific call.
+     * Overrides thread and instance-level execution config.
+     * @property {ExecutionConfig} [executionConfig]
+     */
+    executionConfig?: ExecutionConfig;
 }
 /**
  * The final structured response returned by the agent core after processing.
@@ -2134,6 +2155,11 @@ interface ArtInstanceConfig {
      * @property {AgentPersona} [persona]
      */
     persona?: AgentPersona;
+    /**
+     * Optional: Configuration for execution phase behavior (TAEF parameters).
+     * @property {ExecutionConfig} [execution]
+     */
+    execution?: ExecutionConfig;
     /**
      * Optional configuration for MCP (Model Context Protocol) manager.
      * Enables connection to external MCP servers for dynamic tool loading.
@@ -2585,6 +2611,40 @@ interface AgentPersona {
      */
     prompts: StageSpecificPrompts;
 }
+/**
+ * Configuration options for the execution phase of the PES Agent.
+ * Controls TAEF (Tool-Aware Execution Framework) behavior.
+ *
+ * @interface ExecutionConfig
+ */
+interface ExecutionConfig {
+    /**
+     * Maximum number of LLM iterations per todo item during execution.
+     * Default: 5
+     * @property {number} [maxIterations]
+     */
+    maxIterations?: number;
+    /**
+     * Maximum number of TAEF tool validation retries when required tools are not invoked.
+     * Default: 2
+     * @property {number} [taefMaxRetries]
+     */
+    taefMaxRetries?: number;
+    /**
+     * Maximum character length for tool result serialization in step context.
+     * Higher values preserve more data for the LLM but increase token usage.
+     * Default: 60000 (effectively no practical limit)
+     * @property {number} [toolResultMaxLength]
+     */
+    toolResultMaxLength?: number;
+    /**
+     * Whether to enable A2A (Agent-to-Agent) delegation during execution.
+     * When true, injects the delegate_to_agent tool into execution context.
+     * Default: false
+     * @property {boolean} [enableA2ADelegation]
+     */
+    enableA2ADelegation?: boolean;
+}
 /**
  * Defines stage-specific system prompts for planning and synthesis.
  *
@@ -2603,6 +2663,13 @@ interface StageSpecificPrompts {
      * @property {string} [synthesis]
      */
     synthesis?: string;
+    /**
+     * Custom system prompt template for tool execution steps.
+     * If provided, overrides the default execution prompt.
+     * Supports variable interpolation: ${item.description}, ${completedItemsContext}, etc.
+     * @property {string} [execution]
+     */
+    execution?: string;
 }
 
 /**
@@ -3884,6 +3951,7 @@ declare class PESAgent implements IAgentCore {
     /**
      * Builds execution prompt for TOOL-type steps.
      * Emphasizes tool invocation and explicitly names required tools.
+     * Includes Data Flow Directive to guide LLM in extracting data from previous results.
      */
     private _buildToolStepPrompt;
     /**
@@ -5418,6 +5486,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.4.7";
+declare const VERSION = "0.4.10";
 
-export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, AgentFactory, 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 ExecutionOutput, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, GroqAdapter, type GroqAdapterOptions, 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 PESAgentStateData, 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, type TodoItem, TodoItemStatus, 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, AgentFactory, 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 ExecutionConfig, type ExecutionContext, type ExecutionMetadata, type ExecutionOutput, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, GroqAdapter, type GroqAdapterOptions, 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 PESAgentStateData, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StepOutputEntry, 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, type TodoItem, TodoItemStatus, ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, UISystem, UnknownProviderError, type UnsubscribeFunction, type UpdateA2ATaskRequest, VERSION, type ZyntopiaOAuthConfig, ZyntopiaOAuthStrategy, createArtInstance, generateUUID };