@miiflow/assistant-ui 0.5.2 → 0.9.0

package/dist/{streaming-Q8hp5ev4.d.ts → streaming-B_u_jno6.d.ts}

@@ -18,9 +18,14 @@ interface StreamingOptions {
     onError?: (error: Error) => void;
 }
 /**
- * Extended chunk types for agentic streaming
+ * Extended chunk types for agentic streaming.
+ *
+ * `subtask` / `progress` / structured `planning` chunks are retained for
+ * historical messages persisted before the unified-ReAct migration. New
+ * streams emit `planning` only as plain text (enter_plan_mode / exit_plan_mode)
+ * and route sub-agent work through the `subagent` chunk type.
  */
-type ChunkType = "content" | "thinking" | "tool" | "observation" | "answer" | "planning" | "subtask" | "progress" | "wave_start" | "wave_complete" | "parallel_subtask_start" | "parallel_subtask_complete" | "multi_agent_planning" | "multi_agent_planning_complete" | "subagent_start" | "subagent_complete" | "subagent_failed" | "synthesis" | "clarification_needed" | "visualization" | "media" | "subagent" | "file_operation" | "terminal" | "search_results" | "web_operation" | "claude_text" | "claude_thinking";
+type ChunkType = "content" | "thinking" | "tool" | "observation" | "answer" | "planning" | "subtask" | "progress" | "clarification_needed" | "tool_approval_needed" | "visualization" | "media" | "artifact" | "subagent" | "suggested_action_created";
 /**
  * Subtask data structure for Plan & Execute mode
  */
@@ -56,105 +61,15 @@ interface ProgressData {
     percentage: number;
     waveNumber?: number;
 }
-interface WaveData {
-    waveNumber: number;
-    subtaskIds: number[];
-    parallelCount: number;
-    totalWaves: number;
-    startTime?: number;
-    executionTime?: number;
-    success?: boolean;
-    completedIds?: number[];
-}
-interface ParallelSubtaskData {
-    subtaskId: number;
-    waveNumber: number;
-    description?: string;
-    success?: boolean;
-    result?: string;
-    error?: string;
-    executionTime?: number;
-}
-interface SubagentInfo {
-    id?: string;
-    name: string;
-    role?: string;
-    task?: string;
-    status: "pending" | "running" | "completed" | "failed";
-    result?: string;
-    error?: string;
-    executionTime?: number;
-}
-interface SearchResultItem {
-    filePath: string;
-    lineNumber?: number;
-    snippet?: string;
-}
 interface SubagentChunkData {
     subagentId: string;
     subagentType: string;
-    description: string;
     prompt?: string;
     status: "running" | "completed" | "failed";
     result?: string;
     durationMs?: number;
     nestedChunks: StreamingChunk[];
 }
-interface FileOperationChunkData {
-    toolUseId: string;
-    operation: "read" | "write" | "edit";
-    filePath: string;
-    status: "pending" | "completed" | "error";
-    content?: string;
-    totalLines?: number;
-    language?: string;
-    oldString?: string;
-    newString?: string;
-    error?: string;
-    durationMs?: number;
-}
-interface TerminalChunkData {
-    toolUseId: string;
-    command: string;
-    description?: string;
-    status: "running" | "completed" | "failed";
-    stdout?: string;
-    stderr?: string;
-    exitCode?: number;
-    durationMs?: number;
-}
-interface SearchResultsChunkData {
-    toolUseId: string;
-    tool: "glob" | "grep";
-    pattern: string;
-    path?: string;
-    status: "pending" | "completed" | "error";
-    results: SearchResultItem[];
-    totalCount: number;
-    error?: string;
-    durationMs?: number;
-}
-interface WebOperationChunkData {
-    toolUseId: string;
-    operation: "search" | "fetch";
-    query?: string;
-    url?: string;
-    status: "pending" | "completed" | "error";
-    results?: string;
-    content?: string;
-    error?: string;
-    durationMs?: number;
-}
-interface ClaudeToolChunkData {
-    toolUseId: string;
-    toolName: string;
-    toolDescription?: string;
-    toolInput?: Record<string, unknown>;
-    status: "pending" | "completed" | "error";
-    content?: string;
-    isError?: boolean;
-    durationMs?: number;
-}
 interface ClarificationData {
     question: string;
     options?: string[];
@@ -166,6 +81,15 @@ interface ClarificationData {
     subagentRole?: string;
     toolCallId?: string;
 }
+interface ToolApprovalData {
+    toolName: string;
+    toolDescription: string;
+    toolInputs: Record<string, unknown>;
+    toolSchema?: Record<string, unknown>;
+    toolCallId?: string;
+    /** Human-readable tool identity surfaced in the approval eyebrow (e.g. "Yahoo Finance · Stock Basic Info"). Falls back to toolName when omitted. */
+    toolLabel?: string;
+}
 type VisualizationType = "chart" | "table" | "card" | "kpi" | "code_preview" | "form";
 type ChartDataType = "line" | "bar" | "pie" | "area" | "scatter" | "composed";
 interface ChartSeries {
@@ -191,7 +115,7 @@ interface ChartVisualizationData {
     xAxis?: ChartAxis;
     yAxis?: ChartAxis;
 }
-type TableColumnType = "string" | "number" | "currency" | "date" | "badge" | "link" | "boolean" | "progress";
+type TableColumnType = "string" | "number" | "currency" | "date" | "badge" | "link" | "boolean" | "progress" | "media";
 interface TableColumn {
     key: string;
     label: string;
@@ -227,14 +151,15 @@ interface KpiMetric {
     value: string | number;
     unit?: string;
     trend?: "up" | "down" | "neutral";
-    change?: string;
+    change?: string | number;
     changeLabel?: string;
     sparkline?: number[];
     color?: string;
+    prominence?: "primary" | "secondary";
 }
 interface KpiVisualizationData {
     metrics: KpiMetric[];
-    layout?: "row" | "grid";
+    layout?: "row" | "grid" | "bento";
 }
 interface CodePreviewVisualizationData {
     code: string;
@@ -312,6 +237,37 @@ interface MediaChunkData {
         toolName?: string;
     };
 }
+/**
+ * Artifact chunk — a tool-produced file (PDF, HTML, ...) persisted server-side.
+ *
+ * The backend emits the chunk twice per artifact: first with
+ * `status: "pending"` (before rendering) so the frontend can show a skeleton
+ * card, then again with `status: "ready"` (URL + size populated) or
+ * `status: "failed"` (errorMessage populated). Consumers should key by `id`
+ * and replace state on the second chunk.
+ *
+ * `url` is a stable proxy URL (`/assistant/artifacts/<id>/download/`) — the
+ * backend re-signs on every request, so it does not expire mid-session. It is
+ * `null` while status is pending/failed.
+ */
+type ArtifactStatus = "pending" | "ready" | "failed";
+interface ArtifactChunkData {
+    id: string;
+    kind: "pdf" | "html" | string;
+    title: string;
+    description?: string;
+    status?: ArtifactStatus;
+    url: string | null;
+    mimetype?: string;
+    sizeBytes?: number;
+    pageCount?: number;
+    createdAt?: string;
+    errorMessage?: string;
+    context?: {
+        orchestratorType?: string;
+        toolName?: string;
+    };
+}
 /**
  * Extended streaming chunk with full agentic support
  */
@@ -328,33 +284,14 @@ interface StreamingChunk {
     subtaskData?: SubTaskData;
     planData?: PlanData;
     progress?: ProgressData;
-    isReplan?: boolean;
-    waveData?: WaveData;
-    parallelSubtaskData?: ParallelSubtaskData;
-    waveNumber?: number;
-    isParallel?: boolean;
-    isMultiAgent?: boolean;
-    subagentInfo?: SubagentInfo;
-    subagentAllocations?: {
-        name: string;
-        focus: string;
-        query?: string;
-    }[];
-    replanAttempt?: number;
-    maxReplans?: number;
-    failureReason?: string;
-    isSynthesis?: boolean;
-    orchestrator?: "react" | "plan_execute" | "claude_agent_sdk";
+    orchestrator?: "react" | "plan_execute";
     parentSubtaskId?: number;
     subagentData?: SubagentChunkData;
-    fileOperationData?: FileOperationChunkData;
-    terminalData?: TerminalChunkData;
-    searchResultsData?: SearchResultsChunkData;
-    webOperationData?: WebOperationChunkData;
-    claudeToolData?: ClaudeToolChunkData;
     clarificationData?: ClarificationData;
+    toolApprovalData?: ToolApprovalData;
     visualizationData?: VisualizationChunkData;
     mediaData?: MediaChunkData;
+    artifactData?: ArtifactChunkData;
     toolUseId?: string;
 }
 /**
@@ -365,16 +302,15 @@ interface StreamingMessage {
     textContent: string;
     previousMessageId?: string;
     chunks?: StreamingChunk[];
-    orchestratorType?: "react" | "plan_execute" | "claude_agent_sdk";
+    orchestratorType?: "react" | "plan_execute";
     executionPlan?: PlanData;
-    isParallelExecution?: boolean;
-    waveData?: Record<number, WaveData>;
-    currentWaveNumber?: number;
     suggestedActions?: FollowupAction[];
     activeSubagents?: Map<string, SubagentChunkData>;
     pendingClarification?: ClarificationData;
+    pendingToolApproval?: ToolApprovalData;
     visualizations?: VisualizationChunkData[];
     medias?: MediaChunkData[];
+    artifacts?: ArtifactChunkData[];
 }
 /**
  * Follow-up action suggested by AI
@@ -386,12 +322,19 @@ interface FollowupAction {
     context: Record<string, unknown>;
 }
 type EventStatus = "pending" | "running" | "completed" | "failed";
-type EventType = "thinking" | "planning" | "tool" | "observation" | "subtask";
+type EventType = "thinking" | "planning" | "tool" | "observation" | "subtask" | "subagent";
 interface BaseEvent {
     id: string;
     type: EventType;
     status: EventStatus;
     timestamp?: number;
+    /**
+     * Elapsed wall-clock duration for this event in seconds. Populated by
+     * `convertTimelineToEvents` from pairwise timeline timestamps; left
+     * undefined for live streaming chunks (no per-chunk arrival time is
+     * carried through the stream).
+     */
+    durationSeconds?: number;
 }
 interface ThinkingEvent extends BaseEvent {
     type: "thinking";
@@ -423,7 +366,17 @@ interface SubtaskEvent extends BaseEvent {
     error?: string;
     children?: Event[];
 }
-type Event = ThinkingEvent | PlanningEvent | ToolEvent | ObservationEvent | SubtaskEvent;
+/**
+ * Sub-assistant dispatch event. Rendered inline in the parent's reasoning
+ * timeline at the position the dispatch was issued. Carries the full
+ * SubagentChunkData so the renderer can show name, status, and the
+ * streaming result without a separate lookup.
+ */
+interface SubagentEvent extends BaseEvent {
+    type: "subagent";
+    subagentData: SubagentChunkData;
+}
+type Event = ThinkingEvent | PlanningEvent | ToolEvent | ObservationEvent | SubtaskEvent | SubagentEvent;
 type VisualizationActionEvent = {
     type: "form_submit";
     action: string;
@@ -436,4 +389,4 @@ type VisualizationActionEvent = {
     action: string;
 };
 
-export type { VisualizationType as A, WebOperationChunkData as B, ClarificationData as C, Event as E, FormVisualizationData as F, KpiVisualizationData as K, MediaChunkData as M, ObservationEvent as O, PlanData as P, StreamingChunk as S, TableVisualizationData as T, VisualizationChunkData as V, WaveData as W, StreamChunk as a, StreamingOptions as b, StreamingState as c, VisualizationActionEvent as d, ChartVisualizationData as e, VisualizationConfig as f, CardVisualizationData as g, CodePreviewVisualizationData as h, EventStatus as i, ChunkType as j, ClaudeToolChunkData as k, EventType as l, FileOperationChunkData as m, FollowupAction as n, ParallelSubtaskData as o, PlanningEvent as p, ProgressData as q, SearchResultsChunkData as r, StreamingMessage as s, SubTaskData as t, SubagentChunkData as u, SubagentInfo as v, SubtaskEvent as w, TerminalChunkData as x, ThinkingEvent as y, ToolEvent as z };
+export type { ArtifactChunkData as A, CardVisualizationData as C, Event as E, FollowupAction as F, KpiVisualizationData as K, MediaChunkData as M, ObservationEvent as O, PlanData as P, StreamChunk as S, TableVisualizationData as T, VisualizationActionEvent as V, ArtifactStatus as a, ChartVisualizationData as b, ChunkType as c, ClarificationData as d, CodePreviewVisualizationData as e, EventStatus as f, EventType as g, FormVisualizationData as h, PlanningEvent as i, ProgressData as j, StreamingChunk as k, StreamingMessage as l, StreamingOptions as m, StreamingState as n, SubTaskData as o, SubagentChunkData as p, SubtaskEvent as q, ThinkingEvent as r, ToolApprovalData as s, ToolEvent as t, VisualizationChunkData as u, VisualizationConfig as v, VisualizationType as w };