@optilogic/chat 1.0.0-beta.11 → 1.0.0-beta.13

package/dist/index.d.cts

@@ -101,6 +101,17 @@ interface MemoryItem {
     /** Nesting depth in agent hierarchy */
     depth?: number;
 }
+/**
+ * Potential response (sub-agent intermediate AI response)
+ */
+interface PotentialResponse {
+    id: string;
+    content: string;
+    timestamp: number;
+    agentName?: string | null;
+    parentAgent?: string | null;
+    depth?: number;
+}
 /**
  * Status update information from the agent
  */
@@ -162,6 +173,10 @@ interface AgentResponseState {
     memory: MemoryItem[];
     /** Status updates from the agent */
     statusUpdates: StatusItem[];
+    /** Potential responses (sub-agent intermediate AI responses) */
+    potentialResponses?: PotentialResponse[];
+    /** Custom timeline entries (consumer-provided) */
+    customTimelineEntries?: TimelineEntry[];
     /** Final response text */
     response: string;
     /** Timeline entries derived from all accumulator arrays (for AgentTimeline) */
@@ -177,7 +192,7 @@ interface AgentResponseState {
  * WebSocket message payload for agent responses
  */
 interface AgentMessage {
-    type: "status" | "thinking" | "tool_call" | "knowledge" | "memory" | "response" | "status_update";
+    type: "status" | "thinking" | "tool_call" | "knowledge" | "memory" | "response" | "status_update" | "potential_response";
     /** Message content - for simple string payloads */
     message?: string;
     /** Alternative content field */
@@ -369,6 +384,11 @@ interface AgentResponseProps extends React.HTMLAttributes<HTMLDivElement> {
      * />
      */
     renderThinkingMarkdown?: (content: string) => React.ReactNode;
+    /**
+     * Maximum height of the AgentTimeline scrollable container.
+     * Defaults to "300px". Set to "none" to disable the constraint.
+     */
+    timelineMaxHeight?: string;
 }
 /**
  * AgentResponse Component
@@ -893,4 +913,4 @@ declare function parseResponseSegments(text: string): ResponseSegment[];
  */
 declare const INLINE_ACTION_PROMPT = "\n<inline_actions>\nWhen your response should include interactive components (like query viewers,\ndata tables, or executable actions), embed them as fenced code blocks using\nthe `json:action` language tag:\n\n```json:action\n{\n  \"type\": \"action-type-here\",\n  ...action-specific fields\n}\n```\n\nRules:\n- Each block must contain valid JSON with a \"type\" field.\n- The \"type\" must match a registered action component on the frontend.\n- Multiple action blocks per response are allowed.\n- Surround action blocks with normal markdown text for user context.\n- The action block is rendered as an interactive component in the chat UI.\n- SQL strings inside JSON must be properly escaped (newlines as \\n, quotes as \\\").\n\nAvailable action types:\n\n- \"optimap-query\": Displays SQL queries with a button to execute them and\n  update the 3D globe map.\n  Required fields:\n    - type: \"optimap-query\"\n    - locations_sql: string (the validated locations SQL query)\n    - routes_sql: string (the validated routes SQL query)\n    - database_name: string (the target database name)\n</inline_actions>\n";
 
-export { ActionBar, type ActionBarProps, type ActionComponentRegistry, ActionMarkdownRenderer, type ActionMarkdownRendererProps, type ActionSegment, ActivityIndicators, type ActivityIndicatorsProps, type AgentMessage, AgentResponse, type AgentResponseProps, type AgentResponseState, type AgentResponseStatus, type AgentRun, AgentTimeline, type DisplayEntry, type FeedbackValue, type GenericWebSocketMessage, type HITLInteraction, HITLInteractionRecord, type HITLInteractionRecordProps, type HITLQuestion, HITLQuestionPanel, type HITLQuestionPanelProps, type HITLResponseData, HITLSection, type HITLSectionProps, INLINE_ACTION_PROMPT, type InlineActionProps, type KnowledgeItem, type MarkdownSegment, type MemoryItem, MetadataRow, type MetadataRowProps, type ResponseSegment, type StatusItem, type ThinkingContent, ThinkingSection, type ThinkingSectionProps, type ThinkingStep, type TimelineEntry, type TimelineEntryType, type TimelineUIState, type ToolCall, TruncatedMessage, type TruncatedMessageProps, type UseAgentResponseAccumulatorOptions, type UseAgentResponseAccumulatorReturn, type UseThinkingTimerOptions, UserPrompt, UserPromptInput, type UserPromptInputProps, type UserPromptInputRef, type UserPromptProps, buildResponseString, buildTimelineEntries, createTimelineUIState, deduplicateEntries, formatTime, formatTotalTime, groupIntoAgentRuns, initialAgentResponseState, parseResponseSegments, useAgentResponseAccumulator, useThinkingTimer };
+export { ActionBar, type ActionBarProps, type ActionComponentRegistry, ActionMarkdownRenderer, type ActionMarkdownRendererProps, type ActionSegment, ActivityIndicators, type ActivityIndicatorsProps, type AgentMessage, AgentResponse, type AgentResponseProps, type AgentResponseState, type AgentResponseStatus, type AgentRun, AgentTimeline, type DisplayEntry, type FeedbackValue, type GenericWebSocketMessage, type HITLInteraction, HITLInteractionRecord, type HITLInteractionRecordProps, type HITLQuestion, HITLQuestionPanel, type HITLQuestionPanelProps, type HITLResponseData, HITLSection, type HITLSectionProps, INLINE_ACTION_PROMPT, type InlineActionProps, type KnowledgeItem, type MarkdownSegment, type MemoryItem, MetadataRow, type MetadataRowProps, type PotentialResponse, type ResponseSegment, type StatusItem, type ThinkingContent, ThinkingSection, type ThinkingSectionProps, type ThinkingStep, type TimelineEntry, type TimelineEntryType, type TimelineUIState, type ToolCall, TruncatedMessage, type TruncatedMessageProps, type UseAgentResponseAccumulatorOptions, type UseAgentResponseAccumulatorReturn, type UseThinkingTimerOptions, UserPrompt, UserPromptInput, type UserPromptInputProps, type UserPromptInputRef, type UserPromptProps, buildResponseString, buildTimelineEntries, createTimelineUIState, deduplicateEntries, formatTime, formatTotalTime, groupIntoAgentRuns, initialAgentResponseState, parseResponseSegments, useAgentResponseAccumulator, useThinkingTimer };

package/dist/index.d.ts

@@ -101,6 +101,17 @@ interface MemoryItem {
     /** Nesting depth in agent hierarchy */
     depth?: number;
 }
+/**
+ * Potential response (sub-agent intermediate AI response)
+ */
+interface PotentialResponse {
+    id: string;
+    content: string;
+    timestamp: number;
+    agentName?: string | null;
+    parentAgent?: string | null;
+    depth?: number;
+}
 /**
  * Status update information from the agent
  */
@@ -162,6 +173,10 @@ interface AgentResponseState {
     memory: MemoryItem[];
     /** Status updates from the agent */
     statusUpdates: StatusItem[];
+    /** Potential responses (sub-agent intermediate AI responses) */
+    potentialResponses?: PotentialResponse[];
+    /** Custom timeline entries (consumer-provided) */
+    customTimelineEntries?: TimelineEntry[];
     /** Final response text */
     response: string;
     /** Timeline entries derived from all accumulator arrays (for AgentTimeline) */
@@ -177,7 +192,7 @@ interface AgentResponseState {
  * WebSocket message payload for agent responses
  */
 interface AgentMessage {
-    type: "status" | "thinking" | "tool_call" | "knowledge" | "memory" | "response" | "status_update";
+    type: "status" | "thinking" | "tool_call" | "knowledge" | "memory" | "response" | "status_update" | "potential_response";
     /** Message content - for simple string payloads */
     message?: string;
     /** Alternative content field */
@@ -369,6 +384,11 @@ interface AgentResponseProps extends React.HTMLAttributes<HTMLDivElement> {
      * />
      */
     renderThinkingMarkdown?: (content: string) => React.ReactNode;
+    /**
+     * Maximum height of the AgentTimeline scrollable container.
+     * Defaults to "300px". Set to "none" to disable the constraint.
+     */
+    timelineMaxHeight?: string;
 }
 /**
  * AgentResponse Component
@@ -893,4 +913,4 @@ declare function parseResponseSegments(text: string): ResponseSegment[];
  */
 declare const INLINE_ACTION_PROMPT = "\n<inline_actions>\nWhen your response should include interactive components (like query viewers,\ndata tables, or executable actions), embed them as fenced code blocks using\nthe `json:action` language tag:\n\n```json:action\n{\n  \"type\": \"action-type-here\",\n  ...action-specific fields\n}\n```\n\nRules:\n- Each block must contain valid JSON with a \"type\" field.\n- The \"type\" must match a registered action component on the frontend.\n- Multiple action blocks per response are allowed.\n- Surround action blocks with normal markdown text for user context.\n- The action block is rendered as an interactive component in the chat UI.\n- SQL strings inside JSON must be properly escaped (newlines as \\n, quotes as \\\").\n\nAvailable action types:\n\n- \"optimap-query\": Displays SQL queries with a button to execute them and\n  update the 3D globe map.\n  Required fields:\n    - type: \"optimap-query\"\n    - locations_sql: string (the validated locations SQL query)\n    - routes_sql: string (the validated routes SQL query)\n    - database_name: string (the target database name)\n</inline_actions>\n";
 
-export { ActionBar, type ActionBarProps, type ActionComponentRegistry, ActionMarkdownRenderer, type ActionMarkdownRendererProps, type ActionSegment, ActivityIndicators, type ActivityIndicatorsProps, type AgentMessage, AgentResponse, type AgentResponseProps, type AgentResponseState, type AgentResponseStatus, type AgentRun, AgentTimeline, type DisplayEntry, type FeedbackValue, type GenericWebSocketMessage, type HITLInteraction, HITLInteractionRecord, type HITLInteractionRecordProps, type HITLQuestion, HITLQuestionPanel, type HITLQuestionPanelProps, type HITLResponseData, HITLSection, type HITLSectionProps, INLINE_ACTION_PROMPT, type InlineActionProps, type KnowledgeItem, type MarkdownSegment, type MemoryItem, MetadataRow, type MetadataRowProps, type ResponseSegment, type StatusItem, type ThinkingContent, ThinkingSection, type ThinkingSectionProps, type ThinkingStep, type TimelineEntry, type TimelineEntryType, type TimelineUIState, type ToolCall, TruncatedMessage, type TruncatedMessageProps, type UseAgentResponseAccumulatorOptions, type UseAgentResponseAccumulatorReturn, type UseThinkingTimerOptions, UserPrompt, UserPromptInput, type UserPromptInputProps, type UserPromptInputRef, type UserPromptProps, buildResponseString, buildTimelineEntries, createTimelineUIState, deduplicateEntries, formatTime, formatTotalTime, groupIntoAgentRuns, initialAgentResponseState, parseResponseSegments, useAgentResponseAccumulator, useThinkingTimer };
+export { ActionBar, type ActionBarProps, type ActionComponentRegistry, ActionMarkdownRenderer, type ActionMarkdownRendererProps, type ActionSegment, ActivityIndicators, type ActivityIndicatorsProps, type AgentMessage, AgentResponse, type AgentResponseProps, type AgentResponseState, type AgentResponseStatus, type AgentRun, AgentTimeline, type DisplayEntry, type FeedbackValue, type GenericWebSocketMessage, type HITLInteraction, HITLInteractionRecord, type HITLInteractionRecordProps, type HITLQuestion, HITLQuestionPanel, type HITLQuestionPanelProps, type HITLResponseData, HITLSection, type HITLSectionProps, INLINE_ACTION_PROMPT, type InlineActionProps, type KnowledgeItem, type MarkdownSegment, type MemoryItem, MetadataRow, type MetadataRowProps, type PotentialResponse, type ResponseSegment, type StatusItem, type ThinkingContent, ThinkingSection, type ThinkingSectionProps, type ThinkingStep, type TimelineEntry, type TimelineEntryType, type TimelineUIState, type ToolCall, TruncatedMessage, type TruncatedMessageProps, type UseAgentResponseAccumulatorOptions, type UseAgentResponseAccumulatorReturn, type UseThinkingTimerOptions, UserPrompt, UserPromptInput, type UserPromptInputProps, type UserPromptInputRef, type UserPromptProps, buildResponseString, buildTimelineEntries, createTimelineUIState, deduplicateEntries, formatTime, formatTotalTime, groupIntoAgentRuns, initialAgentResponseState, parseResponseSegments, useAgentResponseAccumulator, useThinkingTimer };

package/dist/index.js

@@ -234,7 +234,7 @@ var ThinkingSection = React11.forwardRef(
         ref,
         className: cn("px-3 pb-3 border-t border-border", className),
         ...props,
-        children: /* @__PURE__ */ jsx("div", { className: "mt-2 max-h-[200px] overflow-y-auto scrollbar-thin", children: isStructured ? /* @__PURE__ */ jsx("div", { className: "space-y-0", children: content.map((step) => /* @__PURE__ */ jsx(
+        children: /* @__PURE__ */ jsx("div", { className: "mt-2 max-h-[200px] overflow-y-auto", children: isStructured ? /* @__PURE__ */ jsx("div", { className: "space-y-0", children: content.map((step) => /* @__PURE__ */ jsx(
           ThinkingStepItem,
           {
             step,
@@ -678,6 +678,8 @@ var initialAgentResponseState = {
   knowledge: [],
   memory: [],
   statusUpdates: [],
+  potentialResponses: [],
+  customTimelineEntries: [],
   response: "",
   thinkingStartTime: null,
   responseCompleteTime: null,
@@ -765,6 +767,24 @@ function buildTimelineEntries(state) {
       timestamp: item.timestamp
     });
   }
+  if (state.potentialResponses) {
+    let respIdx = 0;
+    for (const resp of state.potentialResponses) {
+      entries.push({
+        id: `tl-resp-${respIdx++}`,
+        type: "ai_response",
+        agentName: resp.agentName ?? null,
+        parentAgent: resp.parentAgent ?? null,
+        depth: resp.depth ?? 0,
+        content: resp.content,
+        title: null,
+        timestamp: resp.timestamp
+      });
+    }
+  }
+  if (state.customTimelineEntries) {
+    entries.push(...state.customTimelineEntries);
+  }
   entries.sort((a, b) => a.timestamp - b.timestamp);
   return entries;
 }
@@ -972,6 +992,27 @@ function useAgentResponseAccumulator(options) {
             }
             return { ...prev, status: newStatus, firstMessageTime };
           }
+          case "potential_response": {
+            const respContent = payload.message || payload.content || "";
+            if (respContent) {
+              const newResp = {
+                id: `resp-${Date.now()}`,
+                content: respContent,
+                timestamp: Date.now(),
+                agentName: payload.agentName,
+                parentAgent: payload.parentAgent,
+                depth: payload.depth
+              };
+              const next = {
+                ...prev,
+                status: newStatus,
+                potentialResponses: [...prev.potentialResponses || [], newResp],
+                firstMessageTime
+              };
+              return { ...next, timelineEntries: buildTimelineEntries(next) };
+            }
+            return { ...prev, status: newStatus, firstMessageTime };
+          }
           default:
             return { ...prev, status: newStatus, firstMessageTime };
         }
@@ -1183,7 +1224,7 @@ function AgentTimeline({ entries, renderMarkdown, uiState, maxHeight = "300px" }
     "div",
     {
       ref: containerRef,
-      className: `-mt-1 ${maxHeight !== "none" ? "overflow-y-auto scrollbar-thin" : ""}`,
+      className: maxHeight !== "none" ? "overflow-y-auto" : "",
       style: scrollStyle,
       children: [
         /* @__PURE__ */ jsxs("div", { className: "sticky top-0 z-10 bg-background flex items-center gap-1 py-1.5 mb-1 border-b border-border/50 flex-wrap", children: [
@@ -1282,6 +1323,7 @@ var AgentResponse = React11.forwardRef(
     statusContent,
     renderMarkdown,
     renderThinkingMarkdown,
+    timelineMaxHeight,
     className,
     ...props
   }, ref) => {
@@ -1343,12 +1385,13 @@ var AgentResponse = React11.forwardRef(
                   elapsedTime
                 }
               ),
-              hasTimelineEntries ? thinkingExpanded && /* @__PURE__ */ jsx("div", { className: "px-3 pb-3 border-t border-border mt-2", children: /* @__PURE__ */ jsx(
+              hasTimelineEntries ? thinkingExpanded && /* @__PURE__ */ jsx("div", { className: "pl-3 pb-3 border-t border-border", children: /* @__PURE__ */ jsx(
                 AgentTimeline,
                 {
                   entries: state.timelineEntries,
                   renderMarkdown: renderThinkingMarkdown,
-                  uiState: timelineUIStateRef.current
+                  uiState: timelineUIStateRef.current,
+                  maxHeight: timelineMaxHeight
                 }
               ) }) : /* @__PURE__ */ jsx(
                 ThinkingSection,