art-framework 0.2.7 → 0.2.8

package/dist/index.d.cts

@@ -634,6 +634,8 @@ interface ThreadConfig {
     enabledTools: string[];
     /** The maximum number of past messages (`ConversationMessage` objects) to retrieve for context. */
     historyLimit: number;
+    /** Optional system prompt string to be used for this thread, overriding instance or agent defaults. */
+    systemPrompt?: string;
 }
 /**
  * Represents non-configuration state associated with an agent or thread.
@@ -692,6 +694,8 @@ interface AgentOptions {
     stream?: boolean;
     /** Override the prompt template used for this specific call. */
     promptTemplateId?: string;
+    /** Optional system prompt string to override thread, instance, or agent defaults for this specific call. */
+    systemPrompt?: string;
 }
 /**
  * The final structured response returned by the agent core after processing.
@@ -966,6 +970,11 @@ interface ArtInstanceConfig {
         /** Minimum log level to output. Defaults to 'info'. */
         level?: LogLevel;
     };
+    /**
+     * Optional default system prompt string to be used for the entire ART instance.
+     * This can be overridden at the thread level or at the individual call level.
+     */
+    defaultSystemPrompt?: string;
 }
 
 type StreamEventTypeFilter = StreamEvent['type'] | Array<StreamEvent['type']>;
@@ -1435,6 +1444,12 @@ declare function createArtInstance(config: ArtInstanceConfig): Promise<ArtInstan
 interface PESAgentDependencies {
     /** Manages thread configuration and state. */
     stateManager: StateManager;
+    /**
+     * 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.
+     */
+    instanceDefaultCustomSystemPrompt?: string;
     /** Manages conversation history. */
     conversationManager: ConversationManager;
     /** Registry for available tools. */
@@ -1468,7 +1483,13 @@ interface PESAgentDependencies {
  */
 declare class PESAgent implements IAgentCore {
     private readonly deps;
+    /** The base system prompt inherent to this agent. */
     private readonly defaultSystemPrompt;
+    /**
+     * Stores the instance-level default custom system prompt, passed during construction.
+     * Used in the system prompt hierarchy if no thread or call-level prompt is specified.
+     */
+    private readonly instanceDefaultCustomSystemPrompt?;
     /**
      * Creates an instance of the PESAgent.
      * @param dependencies - An object containing instances of all required subsystems (managers, registries, etc.).
@@ -1478,8 +1499,11 @@ declare class PESAgent implements IAgentCore {
      * Executes the full Plan-Execute-Synthesize cycle for a given user query.
      *
      * **Workflow:**
-     * 1.  **Initiation & Config:** Loads thread configuration and system prompt.
-     * 2.  **Data Gathering:** Gathers history, available tools, system prompt, and query.
+     * 1.  **Initiation & Config:** Loads thread configuration. Resolves the final system prompt based on a hierarchy:
+     *     Call-level (`AgentProps.options.systemPrompt`) > Thread-level (`ThreadConfig.systemPrompt`) >
+     *     Instance-level (`ArtInstanceConfig.defaultSystemPrompt` via constructor) > Agent's base prompt.
+     *     The resolved custom part is appended to the agent's base prompt.
+     * 2.  **Data Gathering:** Gathers history, available tools, the resolved system prompt, and query.
      * 3.  **Planning Prompt Construction:** Directly constructs the `ArtStandardPrompt` object/array for planning.
      * 4.  **Planning LLM Call:** Sends the planning prompt object to the `reasoningEngine` (requesting streaming). Consumes the `StreamEvent` stream, buffers the output text, and handles potential errors.
      * 5.  **Planning Output Parsing:** Parses the buffered planning output text to extract intent, plan, and tool calls using `outputParser.parsePlanningOutput`.
@@ -2123,6 +2147,6 @@ declare const generateUUID: () => string;
  */
 
 /** The current version of the ART Framework package. */
-declare const VERSION = "0.2.7";
+declare const VERSION = "0.2.8";
 
 export { ARTError, AdapterInstantiationError, type AgentFinalResponse, type AgentOptions, type AgentProps, type AgentState, AnthropicAdapter, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, type ConversationSocket, DeepSeekAdapter, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type IAgentCore, 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 ManagedAdapterAccessor, type MessageOptions, MessageRole, ModelCapability, type Observation, type ObservationFilter, type ObservationManager, type ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, OpenRouterAdapter, type OutputParser, PESAgent, type ParsedToolCall, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, type ReasoningEngine, type RuntimeProviderConfig, type StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type ThreadConfig, type ThreadContext, type ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, type UISystem, UnknownProviderError, type UnsubscribeFunction, VERSION, createArtInstance, generateUUID };

package/dist/index.d.ts

@@ -634,6 +634,8 @@ interface ThreadConfig {
     enabledTools: string[];
     /** The maximum number of past messages (`ConversationMessage` objects) to retrieve for context. */
     historyLimit: number;
+    /** Optional system prompt string to be used for this thread, overriding instance or agent defaults. */
+    systemPrompt?: string;
 }
 /**
  * Represents non-configuration state associated with an agent or thread.
@@ -692,6 +694,8 @@ interface AgentOptions {
     stream?: boolean;
     /** Override the prompt template used for this specific call. */
     promptTemplateId?: string;
+    /** Optional system prompt string to override thread, instance, or agent defaults for this specific call. */
+    systemPrompt?: string;
 }
 /**
  * The final structured response returned by the agent core after processing.
@@ -966,6 +970,11 @@ interface ArtInstanceConfig {
         /** Minimum log level to output. Defaults to 'info'. */
         level?: LogLevel;
     };
+    /**
+     * Optional default system prompt string to be used for the entire ART instance.
+     * This can be overridden at the thread level or at the individual call level.
+     */
+    defaultSystemPrompt?: string;
 }
 
 type StreamEventTypeFilter = StreamEvent['type'] | Array<StreamEvent['type']>;
@@ -1435,6 +1444,12 @@ declare function createArtInstance(config: ArtInstanceConfig): Promise<ArtInstan
 interface PESAgentDependencies {
     /** Manages thread configuration and state. */
     stateManager: StateManager;
+    /**
+     * 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.
+     */
+    instanceDefaultCustomSystemPrompt?: string;
     /** Manages conversation history. */
     conversationManager: ConversationManager;
     /** Registry for available tools. */
@@ -1468,7 +1483,13 @@ interface PESAgentDependencies {
  */
 declare class PESAgent implements IAgentCore {
     private readonly deps;
+    /** The base system prompt inherent to this agent. */
     private readonly defaultSystemPrompt;
+    /**
+     * Stores the instance-level default custom system prompt, passed during construction.
+     * Used in the system prompt hierarchy if no thread or call-level prompt is specified.
+     */
+    private readonly instanceDefaultCustomSystemPrompt?;
     /**
      * Creates an instance of the PESAgent.
      * @param dependencies - An object containing instances of all required subsystems (managers, registries, etc.).
@@ -1478,8 +1499,11 @@ declare class PESAgent implements IAgentCore {
      * Executes the full Plan-Execute-Synthesize cycle for a given user query.
      *
      * **Workflow:**
-     * 1.  **Initiation & Config:** Loads thread configuration and system prompt.
-     * 2.  **Data Gathering:** Gathers history, available tools, system prompt, and query.
+     * 1.  **Initiation & Config:** Loads thread configuration. Resolves the final system prompt based on a hierarchy:
+     *     Call-level (`AgentProps.options.systemPrompt`) > Thread-level (`ThreadConfig.systemPrompt`) >
+     *     Instance-level (`ArtInstanceConfig.defaultSystemPrompt` via constructor) > Agent's base prompt.
+     *     The resolved custom part is appended to the agent's base prompt.
+     * 2.  **Data Gathering:** Gathers history, available tools, the resolved system prompt, and query.
      * 3.  **Planning Prompt Construction:** Directly constructs the `ArtStandardPrompt` object/array for planning.
      * 4.  **Planning LLM Call:** Sends the planning prompt object to the `reasoningEngine` (requesting streaming). Consumes the `StreamEvent` stream, buffers the output text, and handles potential errors.
      * 5.  **Planning Output Parsing:** Parses the buffered planning output text to extract intent, plan, and tool calls using `outputParser.parsePlanningOutput`.
@@ -2123,6 +2147,6 @@ declare const generateUUID: () => string;
  */
 
 /** The current version of the ART Framework package. */
-declare const VERSION = "0.2.7";
+declare const VERSION = "0.2.8";
 
 export { ARTError, AdapterInstantiationError, type AgentFinalResponse, type AgentOptions, type AgentProps, type AgentState, AnthropicAdapter, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, type ConversationSocket, DeepSeekAdapter, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type IAgentCore, 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 ManagedAdapterAccessor, type MessageOptions, MessageRole, ModelCapability, type Observation, type ObservationFilter, type ObservationManager, type ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, OpenRouterAdapter, type OutputParser, PESAgent, type ParsedToolCall, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, type ReasoningEngine, type RuntimeProviderConfig, type StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type ThreadConfig, type ThreadContext, type ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, type UISystem, UnknownProviderError, type UnsubscribeFunction, VERSION, createArtInstance, generateUUID };