art-framework 0.3.5 → 0.3.7

package/dist/index.d.cts

@@ -978,6 +978,8 @@ interface ConversationMessage {
 declare enum ObservationType {
     /** The user's inferred intent. */
     INTENT = "INTENT",
+    /** The generated concise thread title. */
+    TITLE = "TITLE",
     /** The agent's step-by-step plan to address the intent. */
     PLAN = "PLAN",
     /** The agent's internal monologue or reasoning process. */
@@ -1063,6 +1065,15 @@ interface Observation {
     title: string;
     /**
      * The main data payload of the observation, structure depends on the `type`.
+     *
+     * @remarks
+     * Common content shapes by `type`:
+     * - `TITLE`: `{ title: string }` — a concise thread title (<= 10 words)
+     * - `INTENT`: `{ intent: string }`
+     * - `PLAN`: `{ plan: string; rawOutput?: string }`
+     * - `TOOL_CALL`: `{ toolCalls: ParsedToolCall[] }`
+     * - `TOOL_EXECUTION`: `{ callId: string; toolName: string; status: 'success' | 'error'; output?: any; error?: string }`
+     * - `FINAL_RESPONSE`: `{ message: ConversationMessage; uiMetadata?: object }`
      * @property {any} content
      */
     content: any;
@@ -2834,10 +2845,25 @@ interface OutputParser {
      * @returns A promise resolving to an object containing the extracted intent, plan description, and an array of parsed tool calls.
      * @throws {ARTError} If the output cannot be parsed into the expected structure (typically code `OUTPUT_PARSING_FAILED`).
      */
+    /**
+     * Parses the raw planning LLM output into structured fields.
+     *
+     * @remarks
+     * This method should be resilient to provider-specific wrappers and formats.
+     * Implementations MUST attempt JSON-first parsing and then fall back to parsing
+     * labeled sections. Supported fields:
+     * - `title?`: A concise thread title (<= 10 words), derived from the user's intent and context.
+     * - `intent?`: A short summary of the user's goal.
+     * - `plan?`: A human-readable list/description of steps.
+     * - `toolCalls?`: Structured tool call intents parsed from the output.
+     * - `thoughts?`: Aggregated content extracted from <think> tags when present.
+     */
     parsePlanningOutput(output: string): Promise<{
+        title?: string;
         intent?: string;
         plan?: string;
         toolCalls?: ParsedToolCall[];
+        thoughts?: string;
     }>;
     /**
      * Parses the raw string output from the synthesis LLM call to extract the final, user-facing response content.
@@ -3753,6 +3779,11 @@ declare class PESAgent implements IAgentCore {
     /**
      * Performs the planning phase including LLM call and output parsing.
      * @private
+     *
+     * @remarks
+     * The planning prompt instructs the LLM to produce a concise `title` (<= 10 words)
+     * alongside `intent`, `plan`, and `toolCalls`. After parsing, a `TITLE` observation
+     * is emitted (if present) for UI components to subscribe via `ObservationSocket`.
      */
     private _performPlanning;
     /**
@@ -5236,6 +5267,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.3";
+declare const VERSION = "0.3.7";
 
 export { type A2AAgentInfo, type A2ATask, type A2ATaskEvent, type A2ATaskFilter, type A2ATaskMetadata, A2ATaskPriority, type A2ATaskResult, A2ATaskSocket, A2ATaskStatus, ARTError, AdapterInstantiationError, type AgentDiscoveryConfig, AgentDiscoveryService, type AgentFinalResponse, type AgentOptions, type AgentPersona, type AgentProps, type AgentState, AnthropicAdapter, type AnthropicAdapterOptions, ApiKeyStrategy, ApiQueueTimeoutError, type ArtInstance, type ArtInstanceConfig, type ArtStandardMessage, type ArtStandardMessageRole, ArtStandardMessageSchema, type ArtStandardPrompt, ArtStandardPromptSchema, AuthManager, type AvailableProviderEntry, CalculatorTool, type CallOptions, type ConversationManager, type ConversationMessage, ConversationSocket, type CreateA2ATaskRequest, DeepSeekAdapter, type DeepSeekAdapterOptions, ErrorCode, type ExecutionContext, type ExecutionMetadata, type FilterOptions, type FormattedPrompt, GeminiAdapter, type GeminiAdapterOptions, GenericOAuthStrategy, type IA2ATaskRepository, type IAgentCore, type IAuthStrategy, type IConversationRepository, type IObservationRepository, type IProviderManager, type IStateRepository, type IToolExecutor, type ITypedSocket, InMemoryStorageAdapter, IndexedDBStorageAdapter, type JsonObjectSchema, type JsonSchema, type LLMMetadata, LLMStreamSocket, LocalInstanceBusyError, LocalProviderConflictError, LogLevel, Logger, type LoggerConfig, type ManagedAdapterAccessor, McpClientController, McpManager, type McpManagerConfig, McpProxyTool, type McpResource, type McpResourceTemplate, type McpServerConfig, type McpServerStatus, type McpToolDefinition, type MessageOptions, MessageRole, ModelCapability, type OAuthConfig, type Observation, type ObservationFilter, type ObservationManager, ObservationSocket, ObservationType, OllamaAdapter, type OllamaAdapterOptions, OpenAIAdapter, type OpenAIAdapterOptions, OpenRouterAdapter, type OpenRouterAdapterOptions, type OutputParser, PESAgent, type PKCEOAuthConfig, PKCEOAuthStrategy, type ParsedToolCall, type PromptBlueprint, type PromptContext, type PromptManager, type ProviderAdapter, type ProviderManagerConfig, ProviderManagerImpl, type ReasoningEngine, type RuntimeProviderConfig, type StageSpecificPrompts, StateManager, type StateSavingStrategy, type StorageAdapter, type StreamEvent, type StreamEventTypeFilter, SupabaseStorageAdapter, type SystemPromptMergeStrategy, type SystemPromptOverride, type SystemPromptResolver, type SystemPromptSpec, type SystemPromptsRegistry, type TaskDelegationConfig, TaskDelegationService, type TaskStatusResponse, type ThreadConfig, type ThreadContext, ToolRegistry, type ToolResult, type ToolSchema, type ToolSystem, TypedSocket, UISystem, UnknownProviderError, type UnsubscribeFunction, type UpdateA2ATaskRequest, VERSION, type ZyntopiaOAuthConfig, ZyntopiaOAuthStrategy, createArtInstance, generateUUID };

package/dist/index.d.ts

@@ -978,6 +978,8 @@ interface ConversationMessage {
 declare enum ObservationType {
     /** The user's inferred intent. */
     INTENT = "INTENT",
+    /** The generated concise thread title. */
+    TITLE = "TITLE",
     /** The agent's step-by-step plan to address the intent. */
     PLAN = "PLAN",
     /** The agent's internal monologue or reasoning process. */
@@ -1063,6 +1065,15 @@ interface Observation {
     title: string;
     /**
      * The main data payload of the observation, structure depends on the `type`.
+     *
+     * @remarks
+     * Common content shapes by `type`:
+     * - `TITLE`: `{ title: string }` — a concise thread title (<= 10 words)
+     * - `INTENT`: `{ intent: string }`
+     * - `PLAN`: `{ plan: string; rawOutput?: string }`
+     * - `TOOL_CALL`: `{ toolCalls: ParsedToolCall[] }`
+     * - `TOOL_EXECUTION`: `{ callId: string; toolName: string; status: 'success' | 'error'; output?: any; error?: string }`
+     * - `FINAL_RESPONSE`: `{ message: ConversationMessage; uiMetadata?: object }`
      * @property {any} content
      */
     content: any;
@@ -2834,10 +2845,25 @@ interface OutputParser {
      * @returns A promise resolving to an object containing the extracted intent, plan description, and an array of parsed tool calls.
      * @throws {ARTError} If the output cannot be parsed into the expected structure (typically code `OUTPUT_PARSING_FAILED`).
      */
+    /**
+     * Parses the raw planning LLM output into structured fields.
+     *
+     * @remarks
+     * This method should be resilient to provider-specific wrappers and formats.
+     * Implementations MUST attempt JSON-first parsing and then fall back to parsing
+     * labeled sections. Supported fields:
+     * - `title?`: A concise thread title (<= 10 words), derived from the user's intent and context.
+     * - `intent?`: A short summary of the user's goal.
+     * - `plan?`: A human-readable list/description of steps.
+     * - `toolCalls?`: Structured tool call intents parsed from the output.
+     * - `thoughts?`: Aggregated content extracted from <think> tags when present.
+     */
     parsePlanningOutput(output: string): Promise<{
+        title?: string;
         intent?: string;
         plan?: string;
         toolCalls?: ParsedToolCall[];
+        thoughts?: string;
     }>;
     /**
      * Parses the raw string output from the synthesis LLM call to extract the final, user-facing response content.
@@ -3753,6 +3779,11 @@ declare class PESAgent implements IAgentCore {
     /**
      * Performs the planning phase including LLM call and output parsing.
      * @private
+     *
+     * @remarks
+     * The planning prompt instructs the LLM to produce a concise `title` (<= 10 words)
+     * alongside `intent`, `plan`, and `toolCalls`. After parsing, a `TITLE` observation
+     * is emitted (if present) for UI components to subscribe via `ObservationSocket`.
      */
     private _performPlanning;
     /**
@@ -5236,6 +5267,6 @@ declare const generateUUID: () => string;
 /**
  * The current version of the ART Framework package.
  */
-declare const VERSION = "0.3.3";
+declare const VERSION = "0.3.7";
 
 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 };