@erdoai/types 0.1.12 → 0.1.14

package/dist/index.d.cts

@@ -53,7 +53,7 @@ interface ContentItem {
     tableData?: unknown[];
     [key: string]: unknown;
 }
-type ContentType = 'text' | 'json' | 'code' | 'table' | 'image' | 'error';
+type ContentType = 'text' | 'json' | 'code' | 'table' | 'image' | 'error' | 'agent_invocation' | 'tool_invocation' | 'tool_result';
 type UIContentType = 'chart' | 'bar_chart' | 'line_chart' | 'pie_chart' | 'scatter_chart' | 'heatmap' | 'table' | 'markdown' | string;
 interface InvokeResult {
     /** Whether the invocation succeeded */
@@ -266,41 +266,73 @@ interface ListThreadMessagesResponse {
 }
 /** Step types: agent, LLM call, or tool call */
 type StepType = 'agent' | 'llm_call' | 'tool_call';
-/** A step in the execution tree */
-interface Step {
+/** The container — one per agent invocation */
+interface AgentStreamState {
+    /** All nodes ordered by event arrival — render from this */
+    nodes: AgentContent[];
+    /** Fast lookup for step nodes by step ID */
+    byStepId: Record<string, AgentStepNode>;
+    /** Fast lookup for content nodes by content ID */
+    byContentId: Record<string, AgentContentNode>;
+    /** Step tree structure: parent step ID → child step IDs */
+    childrenByParentId: Record<string, string[]>;
+    /** The first parentless step */
+    rootStepId: string | null;
+    /** Assistant message ID from `message created` event — used for anchoring */
+    messageId: string | null;
+    /** Whether the stream is still active */
+    isStreaming: boolean;
+}
+/** Union of all node types in the flat content model */
+type AgentContent = AgentStepNode | AgentContentNode | AgentStatusNode;
+/** Structural node — steps form the hierarchy, NO content on them */
+interface AgentStepNode {
+    kind: 'step';
     id: string;
-    parent_id: string | null;
+    parentId: string | null;
     type: StepType;
     name: string;
-    /** For agent steps: the agent key (e.g., "erdo.data-analyst"). Used for display label lookup. */
+    /** For agent steps: the agent key (e.g., "erdo.data-analyst") */
     key?: string;
     status: 'running' | 'completed' | 'error';
-    content: StepContentItem[];
     error?: string;
-    /** For llm_call steps: "text" (markdown) or "json" (structured output). Set from step_started. */
-    content_type?: string;
-    /** Human-readable label while step is running (e.g., "Searching datasets..."). Set from step_started. */
-    running_status?: string;
-    /** Human-readable label when step completes (e.g., "Searched datasets"). Set from step_started or step_finished. */
-    finished_status?: string;
-    /** If true, step should not be rendered in the UI. */
+    /** Response format hint: 'json' | 'text' */
+    contentType?: string;
+    /** Human-readable label while step is running */
+    runningStatus?: string;
+    /** Human-readable label when step completes */
+    finishedStatus?: string;
+    /** If true, step should not be rendered in the UI */
     hidden?: boolean;
-    /** Pre-parsed content chunks from parseMixedJson. Updated as text_delta accumulates. */
-    parsed_content?: Array<{
+}
+/** Content node — flat, with optional stepId for location */
+interface AgentContentNode {
+    kind: 'content';
+    /** Unique content ID (from message_content_id) */
+    id: string;
+    /** Location — null means root level */
+    stepId: string | null;
+    /** e.g. 'text', 'json', 'tool_invocation', 'tool_result' */
+    contentType: string;
+    /** e.g. 'markdown', 'codegen_json', 'ui_generation' */
+    uiContentType: string;
+    /** Accumulated text from deltas */
+    text: string;
+    /** Final result from message content result */
+    result?: unknown;
+    state: 'streaming' | 'completed';
+    /** For incremental JSON parsing (reuses existing parser infrastructure) */
+    parsedContent?: Array<{
         content: string | Record<string, unknown>;
         type: 'json' | 'text';
     }>;
 }
-/** One piece of content produced by a step */
-interface StepContentItem {
-    type: 'text_delta' | 'tool_input' | 'tool_result' | 'error' | 'status_update';
-    data: unknown;
-}
-/** State for step-based streaming */
-interface StepStreamState {
-    steps: Record<string, Step>;
-    rootStepId: string | null;
-    isStreaming: boolean;
+/** Status update node */
+interface AgentStatusNode {
+    kind: 'status';
+    /** Step this status belongs to (null = root level) */
+    stepId: string | null;
+    message: string;
 }
 
-export type { AxisConfig, BotInvocationInfo, ChartConfig, ChartContent, ChartSeriesConfig, ChartType, CodeExecOutputItem, ContentItem, ContentType, CreateThreadParams, CreateTokenParams, ErdoClient, ErdoClientConfig, InvocationMode, InvocationStatus, InvokeParams, InvokeResult, ListThreadMessagesResponse, ListThreadsResponse, LogEntry, LogLevel, Message, MessageContent, Result, ResultOutput, SSEEvent, SSEEventMetadata, SendMessageParams, SeriesConfig, Step, StepContentItem, StepInfo, StepStreamState, StepType, Thread, ThreadMessage, ThreadMessageContent, TokenResponse, ToolGroup, ToolInvocation, ToolResult, UIContentType, WebParseOutput, WebSearchOutput, WebSearchResult };
+export type { AgentContent, AgentContentNode, AgentStatusNode, AgentStepNode, AgentStreamState, AxisConfig, BotInvocationInfo, ChartConfig, ChartContent, ChartSeriesConfig, ChartType, CodeExecOutputItem, ContentItem, ContentType, CreateThreadParams, CreateTokenParams, ErdoClient, ErdoClientConfig, InvocationMode, InvocationStatus, InvokeParams, InvokeResult, ListThreadMessagesResponse, ListThreadsResponse, LogEntry, LogLevel, Message, MessageContent, Result, ResultOutput, SSEEvent, SSEEventMetadata, SendMessageParams, SeriesConfig, StepInfo, StepType, Thread, ThreadMessage, ThreadMessageContent, TokenResponse, ToolGroup, ToolInvocation, ToolResult, UIContentType, WebParseOutput, WebSearchOutput, WebSearchResult };

package/dist/index.d.ts

@@ -53,7 +53,7 @@ interface ContentItem {
     tableData?: unknown[];
     [key: string]: unknown;
 }
-type ContentType = 'text' | 'json' | 'code' | 'table' | 'image' | 'error';
+type ContentType = 'text' | 'json' | 'code' | 'table' | 'image' | 'error' | 'agent_invocation' | 'tool_invocation' | 'tool_result';
 type UIContentType = 'chart' | 'bar_chart' | 'line_chart' | 'pie_chart' | 'scatter_chart' | 'heatmap' | 'table' | 'markdown' | string;
 interface InvokeResult {
     /** Whether the invocation succeeded */
@@ -266,41 +266,73 @@ interface ListThreadMessagesResponse {
 }
 /** Step types: agent, LLM call, or tool call */
 type StepType = 'agent' | 'llm_call' | 'tool_call';
-/** A step in the execution tree */
-interface Step {
+/** The container — one per agent invocation */
+interface AgentStreamState {
+    /** All nodes ordered by event arrival — render from this */
+    nodes: AgentContent[];
+    /** Fast lookup for step nodes by step ID */
+    byStepId: Record<string, AgentStepNode>;
+    /** Fast lookup for content nodes by content ID */
+    byContentId: Record<string, AgentContentNode>;
+    /** Step tree structure: parent step ID → child step IDs */
+    childrenByParentId: Record<string, string[]>;
+    /** The first parentless step */
+    rootStepId: string | null;
+    /** Assistant message ID from `message created` event — used for anchoring */
+    messageId: string | null;
+    /** Whether the stream is still active */
+    isStreaming: boolean;
+}
+/** Union of all node types in the flat content model */
+type AgentContent = AgentStepNode | AgentContentNode | AgentStatusNode;
+/** Structural node — steps form the hierarchy, NO content on them */
+interface AgentStepNode {
+    kind: 'step';
     id: string;
-    parent_id: string | null;
+    parentId: string | null;
     type: StepType;
     name: string;
-    /** For agent steps: the agent key (e.g., "erdo.data-analyst"). Used for display label lookup. */
+    /** For agent steps: the agent key (e.g., "erdo.data-analyst") */
     key?: string;
     status: 'running' | 'completed' | 'error';
-    content: StepContentItem[];
     error?: string;
-    /** For llm_call steps: "text" (markdown) or "json" (structured output). Set from step_started. */
-    content_type?: string;
-    /** Human-readable label while step is running (e.g., "Searching datasets..."). Set from step_started. */
-    running_status?: string;
-    /** Human-readable label when step completes (e.g., "Searched datasets"). Set from step_started or step_finished. */
-    finished_status?: string;
-    /** If true, step should not be rendered in the UI. */
+    /** Response format hint: 'json' | 'text' */
+    contentType?: string;
+    /** Human-readable label while step is running */
+    runningStatus?: string;
+    /** Human-readable label when step completes */
+    finishedStatus?: string;
+    /** If true, step should not be rendered in the UI */
     hidden?: boolean;
-    /** Pre-parsed content chunks from parseMixedJson. Updated as text_delta accumulates. */
-    parsed_content?: Array<{
+}
+/** Content node — flat, with optional stepId for location */
+interface AgentContentNode {
+    kind: 'content';
+    /** Unique content ID (from message_content_id) */
+    id: string;
+    /** Location — null means root level */
+    stepId: string | null;
+    /** e.g. 'text', 'json', 'tool_invocation', 'tool_result' */
+    contentType: string;
+    /** e.g. 'markdown', 'codegen_json', 'ui_generation' */
+    uiContentType: string;
+    /** Accumulated text from deltas */
+    text: string;
+    /** Final result from message content result */
+    result?: unknown;
+    state: 'streaming' | 'completed';
+    /** For incremental JSON parsing (reuses existing parser infrastructure) */
+    parsedContent?: Array<{
         content: string | Record<string, unknown>;
         type: 'json' | 'text';
     }>;
 }
-/** One piece of content produced by a step */
-interface StepContentItem {
-    type: 'text_delta' | 'tool_input' | 'tool_result' | 'error' | 'status_update';
-    data: unknown;
-}
-/** State for step-based streaming */
-interface StepStreamState {
-    steps: Record<string, Step>;
-    rootStepId: string | null;
-    isStreaming: boolean;
+/** Status update node */
+interface AgentStatusNode {
+    kind: 'status';
+    /** Step this status belongs to (null = root level) */
+    stepId: string | null;
+    message: string;
 }
 
-export type { AxisConfig, BotInvocationInfo, ChartConfig, ChartContent, ChartSeriesConfig, ChartType, CodeExecOutputItem, ContentItem, ContentType, CreateThreadParams, CreateTokenParams, ErdoClient, ErdoClientConfig, InvocationMode, InvocationStatus, InvokeParams, InvokeResult, ListThreadMessagesResponse, ListThreadsResponse, LogEntry, LogLevel, Message, MessageContent, Result, ResultOutput, SSEEvent, SSEEventMetadata, SendMessageParams, SeriesConfig, Step, StepContentItem, StepInfo, StepStreamState, StepType, Thread, ThreadMessage, ThreadMessageContent, TokenResponse, ToolGroup, ToolInvocation, ToolResult, UIContentType, WebParseOutput, WebSearchOutput, WebSearchResult };
+export type { AgentContent, AgentContentNode, AgentStatusNode, AgentStepNode, AgentStreamState, AxisConfig, BotInvocationInfo, ChartConfig, ChartContent, ChartSeriesConfig, ChartType, CodeExecOutputItem, ContentItem, ContentType, CreateThreadParams, CreateTokenParams, ErdoClient, ErdoClientConfig, InvocationMode, InvocationStatus, InvokeParams, InvokeResult, ListThreadMessagesResponse, ListThreadsResponse, LogEntry, LogLevel, Message, MessageContent, Result, ResultOutput, SSEEvent, SSEEventMetadata, SendMessageParams, SeriesConfig, StepInfo, StepType, Thread, ThreadMessage, ThreadMessageContent, TokenResponse, ToolGroup, ToolInvocation, ToolResult, UIContentType, WebParseOutput, WebSearchOutput, WebSearchResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/types",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Erdo SDK shared types",
   "type": "module",
   "main": "./dist/index.js",