@miiflow/assistant-ui 0.1.0

package/dist/streaming-CF63E6iS.d.ts

@@ -0,0 +1,426 @@
+/**
+ * Types for streaming message handling.
+ */
+interface StreamingState {
+    isStreaming: boolean;
+    streamingMessageId: string | null;
+    streamedContent: string;
+}
+interface StreamChunk {
+    type: "content" | "reasoning" | "tool_call" | "done" | "error";
+    content?: string;
+    messageId?: string;
+    error?: string;
+}
+interface StreamingOptions {
+    onChunk?: (chunk: StreamChunk) => void;
+    onComplete?: (finalContent: string) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Extended chunk types for agentic streaming
+ */
+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" | "subagent" | "file_operation" | "terminal" | "search_results" | "web_operation" | "claude_text" | "claude_thinking";
+/**
+ * Subtask data structure for Plan & Execute mode
+ */
+interface SubTaskData {
+    id: number;
+    description: string;
+    required_tools?: string[];
+    dependencies?: number[];
+    status: "pending" | "running" | "completed" | "failed";
+    result?: string;
+    error?: string;
+    execution_time?: number;
+}
+/**
+ * Plan data structure for Plan & Execute mode
+ */
+interface PlanData {
+    subtasks: SubTaskData[];
+    goal: string;
+    reasoning: string;
+    total_subtasks: number;
+    completed_subtasks: number;
+    failed_subtasks: number;
+    progress_percentage: number;
+}
+/**
+ * Progress data for streaming updates
+ */
+interface ProgressData {
+    completed: number;
+    failed?: number;
+    total: number;
+    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[];
+    context?: string;
+    allowFreeText?: boolean;
+    subtaskId?: number;
+    subtaskDescription?: string;
+    subagentName?: string;
+    subagentRole?: string;
+}
+type VisualizationType = "chart" | "table" | "card" | "kpi" | "code_preview" | "form";
+type ChartDataType = "line" | "bar" | "pie" | "area" | "scatter" | "composed";
+interface ChartSeries {
+    name: string;
+    data: Array<{
+        x: string | number;
+        y: number;
+    } | {
+        name: string;
+        value: number;
+    }>;
+    color?: string;
+}
+interface ChartAxis {
+    label?: string;
+    type?: "category" | "number" | "time";
+    min?: number;
+    max?: number;
+}
+interface ChartVisualizationData {
+    chartType: ChartDataType;
+    series: ChartSeries[];
+    xAxis?: ChartAxis;
+    yAxis?: ChartAxis;
+}
+type TableColumnType = "string" | "number" | "currency" | "date" | "badge" | "link" | "boolean" | "progress";
+interface TableColumn {
+    key: string;
+    label: string;
+    type?: TableColumnType;
+    align?: "left" | "center" | "right";
+    width?: string;
+}
+interface TableVisualizationData {
+    columns: TableColumn[];
+    rows: Record<string, unknown>[];
+}
+interface CardSection {
+    title?: string;
+    items?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    content?: string;
+}
+interface CardAction {
+    label: string;
+    action: string;
+    variant?: "primary" | "secondary" | "text";
+}
+interface CardVisualizationData {
+    subtitle?: string;
+    imageUrl?: string;
+    sections: CardSection[];
+    actions?: CardAction[];
+}
+interface KpiMetric {
+    label: string;
+    value: string | number;
+    unit?: string;
+    trend?: "up" | "down" | "neutral";
+    change?: string;
+    changeLabel?: string;
+    sparkline?: number[];
+    color?: string;
+}
+interface KpiVisualizationData {
+    metrics: KpiMetric[];
+    layout?: "row" | "grid";
+}
+interface CodePreviewVisualizationData {
+    code: string;
+    language: string;
+    lineNumbers?: boolean;
+    highlightLines?: number[];
+    startLine?: number;
+}
+type FormFieldType = "text" | "number" | "email" | "select" | "multiselect" | "checkbox" | "radio" | "textarea" | "date" | "datetime";
+interface FormField {
+    name: string;
+    type: FormFieldType;
+    label: string;
+    required?: boolean;
+    placeholder?: string;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    defaultValue?: unknown;
+    validation?: {
+        min?: number;
+        max?: number;
+        pattern?: string;
+        message?: string;
+    };
+}
+interface FormVisualizationData {
+    fields: FormField[];
+    submitAction?: string;
+}
+interface VisualizationConfig {
+    height?: number;
+    width?: string;
+    colors?: string[];
+    legend?: boolean;
+    grid?: boolean;
+    tooltip?: boolean;
+    animate?: boolean;
+    stacked?: boolean;
+    sortable?: boolean;
+    paginated?: boolean;
+    pageSize?: number;
+    filterable?: boolean;
+    selectable?: boolean;
+    collapsible?: boolean;
+    initiallyCollapsed?: boolean;
+    submitButtonText?: string;
+    cancelButtonText?: string;
+}
+interface VisualizationData {
+    id: string;
+    /** Built-in type or any custom type registered via `registerVisualization()`. */
+    type: VisualizationType | (string & {});
+    title?: string;
+    description?: string;
+    data: ChartVisualizationData | TableVisualizationData | CardVisualizationData | KpiVisualizationData | CodePreviewVisualizationData | FormVisualizationData | Record<string, unknown>;
+    config?: VisualizationConfig;
+}
+interface VisualizationChunkData extends VisualizationData {
+    context?: {
+        orchestratorType?: string;
+        toolName?: string;
+        subtaskId?: number;
+        subagentName?: string;
+    };
+}
+/**
+ * Extended streaming chunk with full agentic support
+ */
+interface StreamingChunk {
+    type: ChunkType;
+    content: string;
+    toolName?: string;
+    toolDescription?: string;
+    toolArgs?: Record<string, unknown>;
+    success?: boolean;
+    status?: "planned" | "executing" | "completed";
+    subtaskId?: number;
+    sequence?: number;
+    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";
+    parentSubtaskId?: number;
+    subagentData?: SubagentChunkData;
+    fileOperationData?: FileOperationChunkData;
+    terminalData?: TerminalChunkData;
+    searchResultsData?: SearchResultsChunkData;
+    webOperationData?: WebOperationChunkData;
+    claudeToolData?: ClaudeToolChunkData;
+    clarificationData?: ClarificationData;
+    visualizationData?: VisualizationChunkData;
+    toolUseId?: string;
+}
+/**
+ * Streaming message with chunks and metadata
+ */
+interface StreamingMessage {
+    id?: string;
+    textContent: string;
+    previousMessageId?: string;
+    chunks?: StreamingChunk[];
+    orchestratorType?: "react" | "plan_execute" | "claude_agent_sdk";
+    executionPlan?: PlanData;
+    isParallelExecution?: boolean;
+    waveData?: Record<number, WaveData>;
+    currentWaveNumber?: number;
+    suggestedActions?: FollowupAction[];
+    activeSubagents?: Map<string, SubagentChunkData>;
+    pendingClarification?: ClarificationData;
+    visualizations?: VisualizationChunkData[];
+}
+/**
+ * Follow-up action suggested by AI
+ */
+interface FollowupAction {
+    label: string;
+    action: string;
+    type: "send_message" | "navigate" | "copy_text" | "compose_email" | "search_emails" | "open_modal" | "api_call";
+    context: Record<string, unknown>;
+}
+type EventStatus = "pending" | "running" | "completed" | "failed";
+type EventType = "thinking" | "planning" | "tool" | "observation" | "subtask";
+interface BaseEvent {
+    id: string;
+    type: EventType;
+    status: EventStatus;
+    timestamp?: number;
+}
+interface ThinkingEvent extends BaseEvent {
+    type: "thinking";
+    content: string;
+}
+interface PlanningEvent extends BaseEvent {
+    type: "planning";
+    content: string;
+    isComplete?: boolean;
+}
+interface ToolEvent extends BaseEvent {
+    type: "tool";
+    toolName: string;
+    toolDescription?: string;
+    input?: unknown;
+}
+interface ObservationEvent extends BaseEvent {
+    type: "observation";
+    toolName: string;
+    content: string;
+    success?: boolean;
+}
+interface SubtaskEvent extends BaseEvent {
+    type: "subtask";
+    title: string;
+    description?: string;
+    executionTime?: number;
+    result?: string;
+    error?: string;
+    children?: Event[];
+}
+type Event = ThinkingEvent | PlanningEvent | ToolEvent | ObservationEvent | SubtaskEvent;
+type VisualizationActionEvent = {
+    type: "form_submit";
+    action: string;
+    data: Record<string, unknown>;
+} | {
+    type: "form_cancel";
+    action: string;
+} | {
+    type: "card_action";
+    action: string;
+};
+
+export type { VisualizationType as A, WebOperationChunkData as B, ClarificationData as C, Event as E, FormVisualizationData as F, KpiVisualizationData as K, 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 };