@distri/react 0.3.5 → 0.3.6

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Agent as Agent$1, DistriChatMessage, DistriBaseTool, ToolExecutionOptions, DistriMessage, DistriPart, AgentDefinition, DistriThread, ThreadListParams, AgentUsageInfo, DistriFnTool, ToolCall, ToolResult, PlanStep, TodoItem, DistriConfiguration, DistriClient, DistriClientConfig, SpeechToTextConfig, StreamingTranscriptionOptions, ConfigurationMeta, ConfigurationResponse, MessageReadStatus, MessageVoteSummary, MessageVote, DistriEvent, ImagePart } from '@distri/core';
+import { Agent as Agent$1, DistriChatMessage, DistriBaseTool, ToolExecutionOptions, DistriMessage, DistriPart, AgentDefinition, DistriThread, ThreadListParams, AgentUsageInfo, ProviderModelsStatus, DistriFnTool, ToolCall, ToolResult, PlanStep, TodoItem, DistriConfiguration, ContextHealth, DistriClient, DistriClientConfig, SpeechToTextConfig, StreamingTranscriptionOptions, ConfigurationMeta, ConfigurationResponse, MessageReadStatus, MessageVoteSummary, MessageVote, ContextCompactionEvent, WorkflowDefinition, StepResult, StepStatus, WorkflowRunnerOptions, WorkflowStep, ExecutionContext, WorkflowEvent, WorkflowStatus, DistriEvent, ImagePart } from '@distri/core';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import * as zustand from 'zustand';
@@ -103,6 +103,17 @@ interface UseThreadMessagesOptions {
     threadId: string | null;
 }
 
+interface UseModelsResult {
+    providers: ProviderModelsStatus[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to fetch available models grouped by provider with configuration status.
+ */
+declare function useModels(): UseModelsResult;
+
 type LoadingAnimationPreset = 'typing-dots' | 'pulse-ring' | 'teacher-typing' | 'spinner' | 'wave';
 interface LoadingAnimationConfig {
     /** Preset animation style */
@@ -167,9 +178,10 @@ interface ThinkingRendererProps {
     name?: string;
     thoughtText?: string;
 }
-declare const LoadingShimmer: ({ text, className }: {
+declare const LoadingShimmer: ({ text, className, showIcon }: {
     text: string;
     className?: string;
+    showIcon?: boolean;
 }) => react_jsx_runtime.JSX.Element;
 declare const ThinkingRenderer: React__default.FC<ThinkingRendererProps>;
 
@@ -231,6 +243,7 @@ interface ChatState {
     currentRunId?: string;
     currentTaskId?: string;
     currentPlanId?: string;
+    currentAgentId?: string;
     messages: DistriChatMessage[];
     streamingIndicator: StreamingIndicator | undefined;
     currentThought?: string;
@@ -554,6 +567,25 @@ interface AskFollowUpOutput {
 declare const ASK_FOLLOW_UP_TOOL_NAME = "ask_follow_up";
 declare function createAskFollowUpTool(): DistriUiTool;
 
+interface ContextIndicatorProps {
+    contextHealth: ContextHealth | null;
+    isCompacting?: boolean;
+    className?: string;
+}
+/**
+ * Visual indicator for context window health.
+ *
+ * Shows a progress bar representing context usage and compaction status.
+ * Can be placed in a chat header, sidebar, or status bar.
+ *
+ * Usage:
+ * ```tsx
+ * const { contextHealth, isCompacting } = useContextHealth();
+ * <ContextIndicator contextHealth={contextHealth} isCompacting={isCompacting} />
+ * ```
+ */
+declare function ContextIndicator({ contextHealth, isCompacting, className, }: ContextIndicatorProps): react_jsx_runtime.JSX.Element | null;
+
 interface DistriContextValue {
     client: DistriClient | null;
     error: Error | null;
@@ -808,6 +840,31 @@ interface UseMessageVotesResult {
  */
 declare function useMessageVotes(options: UseMessageVotesOptions): UseMessageVotesResult;
 
+/**
+ * Hook that tracks context health by listening for ContextCompaction events
+ * in the agent event stream.
+ *
+ * Usage:
+ * ```tsx
+ * const { contextHealth, lastCompaction, isCompacting } = useContextHealth();
+ * ```
+ *
+ * This hook maintains a running picture of context usage. It updates whenever
+ * a `context_compaction` event is received from the server event stream.
+ */
+declare function useContextHealth(): {
+    /** Current context health snapshot, or null if no compaction has occurred yet */
+    contextHealth: ContextHealth | null;
+    /** The most recent compaction event */
+    lastCompaction: ContextCompactionEvent | null;
+    /** Whether a compaction just occurred (true for ~1.5s after event) */
+    isCompacting: boolean;
+    /** Call with raw event objects from the stream to update health */
+    handleEvent: (event: Record<string, unknown>) => void;
+    /** Reset state (e.g., when switching threads) */
+    reset: () => void;
+};
+
 /**
  * Wraps a DistriFnTool as a DistriUiTool with DefaultToolActions component
  */
@@ -817,6 +874,85 @@ declare function wrapFnToolAsUiTool(fnTool: DistriFnTool, options?: ToolExecutio
  */
 declare function wrapTools(tools: (DistriFnTool | DistriUiTool)[], options?: ToolExecutionOptions): DistriUiTool[];
 
+/**
+ * useWorkflow — React hook for tracking and running workflows.
+ *
+ * Provides:
+ * - workflow state (steps, status, progress)
+ * - runNextStep() to advance the workflow
+ * - runAll() to run all remaining steps
+ * - isRunning flag
+ */
+
+interface UseWorkflowOptions {
+    /** Initial workflow definition */
+    workflow: WorkflowDefinition;
+    /** Called when a step needs to be executed. Returns the step result. */
+    onExecuteStep: (stepId: string, step: WorkflowDefinition['steps'][0], context: Record<string, unknown>) => Promise<StepResult>;
+    /** Called when workflow state changes (for persistence) */
+    onStateChange?: (workflow: WorkflowDefinition) => void;
+}
+interface UseWorkflowReturn {
+    /** Current workflow state */
+    workflow: WorkflowDefinition;
+    /** Whether any step is currently running */
+    isRunning: boolean;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Step counts by status */
+    counts: Record<StepStatus, number>;
+    /** Run the next pending step */
+    runNextStep: () => Promise<void>;
+    /** Run all remaining steps */
+    runAll: () => Promise<void>;
+    /** Update workflow state directly (e.g., from SSE events) */
+    updateWorkflow: (workflow: WorkflowDefinition) => void;
+}
+declare function useWorkflow({ workflow: initial, onExecuteStep, onStateChange }: UseWorkflowOptions): UseWorkflowReturn;
+
+/**
+ * useWorkflowRunner — React hook that runs workflows using DistriClient.
+ *
+ * Combines WorkflowRunner (from @distri/core) with React state management.
+ * Steps execute against distri-cloud APIs. Events update state in real-time.
+ *
+ * Usage:
+ *   const { run, status, events, steps, isRunning } = useWorkflowRunner()
+ *   await run(workflowDef, { doc_id: 'abc' })
+ */
+
+interface UseWorkflowRunnerOptions {
+    /** Hook to customize HTTP requests (add auth headers, base URL, etc.) */
+    buildRequest?: WorkflowRunnerOptions['buildRequest'];
+    /** Environment variables for {env.X} namespace */
+    env?: Record<string, unknown>;
+    /** Custom step executor override */
+    executeStep?: (step: WorkflowStep, resolvedInput: unknown, context: ExecutionContext) => Promise<StepResult>;
+    /** Called on each event */
+    onEvent?: (event: WorkflowEvent) => void;
+}
+interface UseWorkflowRunnerReturn {
+    /** Run a workflow with the given input. */
+    run: (workflow: WorkflowDefinition, input?: Record<string, unknown>) => Promise<WorkflowStatus>;
+    /** Whether a workflow is currently running. */
+    isRunning: boolean;
+    /** Current status (null if not started). */
+    status: WorkflowStatus | null;
+    /** All events emitted so far. */
+    events: WorkflowEvent[];
+    /** Stop the running workflow. */
+    stop: () => void;
+}
+declare function useWorkflowRunner(options?: UseWorkflowRunnerOptions): UseWorkflowRunnerReturn;
+
+interface WorkflowProgressProps {
+    workflow: WorkflowDefinition;
+    className?: string;
+    /** Show step details (kind, result preview) */
+    detailed?: boolean;
+}
+declare function WorkflowProgress({ workflow, className, detailed }: WorkflowProgressProps): react_jsx_runtime.JSX.Element;
+
 declare const buttonVariants: {
     variant: {
         default: string;
@@ -1129,4 +1265,4 @@ interface UserMessageRendererProps {
 }
 declare const UserMessageRenderer: React__default.FC<UserMessageRendererProps>;
 
-export { ASK_FOLLOW_UP_TOOL_NAME, AgentSelect, type AskFollowUpInput, type AskFollowUpOutput, AssistantMessageRenderer, type AssistantMessageRendererProps, type AttachedImage, AuthLoading, type AuthStatus, Badge, BrowserPreviewPanel, BrowserViewport, type BrowserViewportProps, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chat, type ChatContainerProps, type ChatCustomRenderers, type ChatEmptyStateCategory, type ChatEmptyStateController, type ChatEmptyStateOptions, type ChatEmptyStateStarter, ChatInner, ChatInput, type ChatInputProps, type ChatInstance, type ChatProps, type ChatState, type ChatStateStore, ConfigurationPanel, DialogRoot as Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger, type DistriAnyTool, DistriAuthProvider, DistriContext, DistriProvider, type DistriUiTool, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type ExtractedContent, type FollowUpQuestion, ImageRenderer, type ImageRendererProps, Input, LoadingAnimation, type LoadingAnimationConfig, type LoadingAnimationPreset, type LoadingAnimationProps, LoadingShimmer, MessageFeedback, type MessageFeedbackProps, MessageReadProvider, type MessageReadProviderProps, MessageReadTracker, type MessageReadTrackerProps, MessageRenderer, type MessageRendererProps, type ModelOption, type PlanState, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, StepBasedRenderer, type StepBasedRendererProps, type StepState, type StreamingIndicator, StreamingTextRenderer, type StreamingTtsOptions, type TaskState, Textarea, ThemeProvider, ThemeToggle, ThinkingRenderer, type ThinkingRendererProps, TodosDisplay, type TodosDisplayProps, type ToolCallState, type ToolCallStatus, type ToolRendererMap, type ToolRendererProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TtsConfig, type TtsRequest, TypingIndicator, type UiToolProps, type UseAgentOptions, type UseAgentResult, type UseAgentsByUsageOptions, type UseAgentsByUsageResult, type UseAgentsResult, type UseChatMessagesOptions, type UseChatMessagesReturn, type UseChatOptions, type UseChatReturn, type UseConfigurationResult, type UseMessageReadStatusOptions, type UseMessageReadStatusResult, type UseMessageVoteOptions, type UseMessageVoteResult, type UseMessageVotesOptions, type UseMessageVotesResult, type UseThreadMessagesOptions, type UseThreadReadStatusOptions, type UseThreadReadStatusResult, type UseThreadsOptions, type UseThreadsResult, UserMessageRenderer, type UserMessageRendererProps, VoiceInput, type VoiceInputProps, createAskFollowUpTool, extractContent, useAgent, useAgentDefinitions, useAgentsByUsage, useChat, useChatMessages, useChatStateStore, useConfiguration, useDistri, useDistriAuth, useDistriToken, useMessageReadContext, useMessageReadStatus, useMessageVote, useMessageVotes, useSidebar, useSpeechToText, useTheme, useThreadReadStatus, useThreads, useTts, useWorkspace, wrapFnToolAsUiTool, wrapTools };
+export { ASK_FOLLOW_UP_TOOL_NAME, AgentSelect, type AskFollowUpInput, type AskFollowUpOutput, AssistantMessageRenderer, type AssistantMessageRendererProps, type AttachedImage, AuthLoading, type AuthStatus, Badge, BrowserPreviewPanel, BrowserViewport, type BrowserViewportProps, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chat, type ChatContainerProps, type ChatCustomRenderers, type ChatEmptyStateCategory, type ChatEmptyStateController, type ChatEmptyStateOptions, type ChatEmptyStateStarter, ChatInner, ChatInput, type ChatInputProps, type ChatInstance, type ChatProps, type ChatState, type ChatStateStore, ConfigurationPanel, ContextIndicator, DialogRoot as Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger, type DistriAnyTool, DistriAuthProvider, DistriContext, DistriProvider, type DistriUiTool, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type ExtractedContent, type FollowUpQuestion, ImageRenderer, type ImageRendererProps, Input, LoadingAnimation, type LoadingAnimationConfig, type LoadingAnimationPreset, type LoadingAnimationProps, LoadingShimmer, MessageFeedback, type MessageFeedbackProps, MessageReadProvider, type MessageReadProviderProps, MessageReadTracker, type MessageReadTrackerProps, MessageRenderer, type MessageRendererProps, type ModelOption, type PlanState, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, StepBasedRenderer, type StepBasedRendererProps, type StepState, type StreamingIndicator, StreamingTextRenderer, type StreamingTtsOptions, type TaskState, Textarea, ThemeProvider, ThemeToggle, ThinkingRenderer, type ThinkingRendererProps, TodosDisplay, type TodosDisplayProps, type ToolCallState, type ToolCallStatus, type ToolRendererMap, type ToolRendererProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TtsConfig, type TtsRequest, TypingIndicator, type UiToolProps, type UseAgentOptions, type UseAgentResult, type UseAgentsByUsageOptions, type UseAgentsByUsageResult, type UseAgentsResult, type UseChatMessagesOptions, type UseChatMessagesReturn, type UseChatOptions, type UseChatReturn, type UseConfigurationResult, type UseMessageReadStatusOptions, type UseMessageReadStatusResult, type UseMessageVoteOptions, type UseMessageVoteResult, type UseMessageVotesOptions, type UseMessageVotesResult, type UseModelsResult, type UseThreadMessagesOptions, type UseThreadReadStatusOptions, type UseThreadReadStatusResult, type UseThreadsOptions, type UseThreadsResult, type UseWorkflowOptions, type UseWorkflowReturn, type UseWorkflowRunnerOptions, type UseWorkflowRunnerReturn, UserMessageRenderer, type UserMessageRendererProps, VoiceInput, type VoiceInputProps, WorkflowProgress, type WorkflowProgressProps, createAskFollowUpTool, extractContent, useAgent, useAgentDefinitions, useAgentsByUsage, useChat, useChatMessages, useChatStateStore, useConfiguration, useContextHealth, useDistri, useDistriAuth, useDistriToken, useMessageReadContext, useMessageReadStatus, useMessageVote, useMessageVotes, useModels, useSidebar, useSpeechToText, useTheme, useThreadReadStatus, useThreads, useTts, useWorkflow, useWorkflowRunner, useWorkspace, wrapFnToolAsUiTool, wrapTools };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Agent as Agent$1, DistriChatMessage, DistriBaseTool, ToolExecutionOptions, DistriMessage, DistriPart, AgentDefinition, DistriThread, ThreadListParams, AgentUsageInfo, DistriFnTool, ToolCall, ToolResult, PlanStep, TodoItem, DistriConfiguration, DistriClient, DistriClientConfig, SpeechToTextConfig, StreamingTranscriptionOptions, ConfigurationMeta, ConfigurationResponse, MessageReadStatus, MessageVoteSummary, MessageVote, DistriEvent, ImagePart } from '@distri/core';
+import { Agent as Agent$1, DistriChatMessage, DistriBaseTool, ToolExecutionOptions, DistriMessage, DistriPart, AgentDefinition, DistriThread, ThreadListParams, AgentUsageInfo, ProviderModelsStatus, DistriFnTool, ToolCall, ToolResult, PlanStep, TodoItem, DistriConfiguration, ContextHealth, DistriClient, DistriClientConfig, SpeechToTextConfig, StreamingTranscriptionOptions, ConfigurationMeta, ConfigurationResponse, MessageReadStatus, MessageVoteSummary, MessageVote, ContextCompactionEvent, WorkflowDefinition, StepResult, StepStatus, WorkflowRunnerOptions, WorkflowStep, ExecutionContext, WorkflowEvent, WorkflowStatus, DistriEvent, ImagePart } from '@distri/core';
 import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import * as zustand from 'zustand';
@@ -103,6 +103,17 @@ interface UseThreadMessagesOptions {
     threadId: string | null;
 }
 
+interface UseModelsResult {
+    providers: ProviderModelsStatus[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to fetch available models grouped by provider with configuration status.
+ */
+declare function useModels(): UseModelsResult;
+
 type LoadingAnimationPreset = 'typing-dots' | 'pulse-ring' | 'teacher-typing' | 'spinner' | 'wave';
 interface LoadingAnimationConfig {
     /** Preset animation style */
@@ -167,9 +178,10 @@ interface ThinkingRendererProps {
     name?: string;
     thoughtText?: string;
 }
-declare const LoadingShimmer: ({ text, className }: {
+declare const LoadingShimmer: ({ text, className, showIcon }: {
     text: string;
     className?: string;
+    showIcon?: boolean;
 }) => react_jsx_runtime.JSX.Element;
 declare const ThinkingRenderer: React__default.FC<ThinkingRendererProps>;
 
@@ -231,6 +243,7 @@ interface ChatState {
     currentRunId?: string;
     currentTaskId?: string;
     currentPlanId?: string;
+    currentAgentId?: string;
     messages: DistriChatMessage[];
     streamingIndicator: StreamingIndicator | undefined;
     currentThought?: string;
@@ -554,6 +567,25 @@ interface AskFollowUpOutput {
 declare const ASK_FOLLOW_UP_TOOL_NAME = "ask_follow_up";
 declare function createAskFollowUpTool(): DistriUiTool;
 
+interface ContextIndicatorProps {
+    contextHealth: ContextHealth | null;
+    isCompacting?: boolean;
+    className?: string;
+}
+/**
+ * Visual indicator for context window health.
+ *
+ * Shows a progress bar representing context usage and compaction status.
+ * Can be placed in a chat header, sidebar, or status bar.
+ *
+ * Usage:
+ * ```tsx
+ * const { contextHealth, isCompacting } = useContextHealth();
+ * <ContextIndicator contextHealth={contextHealth} isCompacting={isCompacting} />
+ * ```
+ */
+declare function ContextIndicator({ contextHealth, isCompacting, className, }: ContextIndicatorProps): react_jsx_runtime.JSX.Element | null;
+
 interface DistriContextValue {
     client: DistriClient | null;
     error: Error | null;
@@ -808,6 +840,31 @@ interface UseMessageVotesResult {
  */
 declare function useMessageVotes(options: UseMessageVotesOptions): UseMessageVotesResult;
 
+/**
+ * Hook that tracks context health by listening for ContextCompaction events
+ * in the agent event stream.
+ *
+ * Usage:
+ * ```tsx
+ * const { contextHealth, lastCompaction, isCompacting } = useContextHealth();
+ * ```
+ *
+ * This hook maintains a running picture of context usage. It updates whenever
+ * a `context_compaction` event is received from the server event stream.
+ */
+declare function useContextHealth(): {
+    /** Current context health snapshot, or null if no compaction has occurred yet */
+    contextHealth: ContextHealth | null;
+    /** The most recent compaction event */
+    lastCompaction: ContextCompactionEvent | null;
+    /** Whether a compaction just occurred (true for ~1.5s after event) */
+    isCompacting: boolean;
+    /** Call with raw event objects from the stream to update health */
+    handleEvent: (event: Record<string, unknown>) => void;
+    /** Reset state (e.g., when switching threads) */
+    reset: () => void;
+};
+
 /**
  * Wraps a DistriFnTool as a DistriUiTool with DefaultToolActions component
  */
@@ -817,6 +874,85 @@ declare function wrapFnToolAsUiTool(fnTool: DistriFnTool, options?: ToolExecutio
  */
 declare function wrapTools(tools: (DistriFnTool | DistriUiTool)[], options?: ToolExecutionOptions): DistriUiTool[];
 
+/**
+ * useWorkflow — React hook for tracking and running workflows.
+ *
+ * Provides:
+ * - workflow state (steps, status, progress)
+ * - runNextStep() to advance the workflow
+ * - runAll() to run all remaining steps
+ * - isRunning flag
+ */
+
+interface UseWorkflowOptions {
+    /** Initial workflow definition */
+    workflow: WorkflowDefinition;
+    /** Called when a step needs to be executed. Returns the step result. */
+    onExecuteStep: (stepId: string, step: WorkflowDefinition['steps'][0], context: Record<string, unknown>) => Promise<StepResult>;
+    /** Called when workflow state changes (for persistence) */
+    onStateChange?: (workflow: WorkflowDefinition) => void;
+}
+interface UseWorkflowReturn {
+    /** Current workflow state */
+    workflow: WorkflowDefinition;
+    /** Whether any step is currently running */
+    isRunning: boolean;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Step counts by status */
+    counts: Record<StepStatus, number>;
+    /** Run the next pending step */
+    runNextStep: () => Promise<void>;
+    /** Run all remaining steps */
+    runAll: () => Promise<void>;
+    /** Update workflow state directly (e.g., from SSE events) */
+    updateWorkflow: (workflow: WorkflowDefinition) => void;
+}
+declare function useWorkflow({ workflow: initial, onExecuteStep, onStateChange }: UseWorkflowOptions): UseWorkflowReturn;
+
+/**
+ * useWorkflowRunner — React hook that runs workflows using DistriClient.
+ *
+ * Combines WorkflowRunner (from @distri/core) with React state management.
+ * Steps execute against distri-cloud APIs. Events update state in real-time.
+ *
+ * Usage:
+ *   const { run, status, events, steps, isRunning } = useWorkflowRunner()
+ *   await run(workflowDef, { doc_id: 'abc' })
+ */
+
+interface UseWorkflowRunnerOptions {
+    /** Hook to customize HTTP requests (add auth headers, base URL, etc.) */
+    buildRequest?: WorkflowRunnerOptions['buildRequest'];
+    /** Environment variables for {env.X} namespace */
+    env?: Record<string, unknown>;
+    /** Custom step executor override */
+    executeStep?: (step: WorkflowStep, resolvedInput: unknown, context: ExecutionContext) => Promise<StepResult>;
+    /** Called on each event */
+    onEvent?: (event: WorkflowEvent) => void;
+}
+interface UseWorkflowRunnerReturn {
+    /** Run a workflow with the given input. */
+    run: (workflow: WorkflowDefinition, input?: Record<string, unknown>) => Promise<WorkflowStatus>;
+    /** Whether a workflow is currently running. */
+    isRunning: boolean;
+    /** Current status (null if not started). */
+    status: WorkflowStatus | null;
+    /** All events emitted so far. */
+    events: WorkflowEvent[];
+    /** Stop the running workflow. */
+    stop: () => void;
+}
+declare function useWorkflowRunner(options?: UseWorkflowRunnerOptions): UseWorkflowRunnerReturn;
+
+interface WorkflowProgressProps {
+    workflow: WorkflowDefinition;
+    className?: string;
+    /** Show step details (kind, result preview) */
+    detailed?: boolean;
+}
+declare function WorkflowProgress({ workflow, className, detailed }: WorkflowProgressProps): react_jsx_runtime.JSX.Element;
+
 declare const buttonVariants: {
     variant: {
         default: string;
@@ -1129,4 +1265,4 @@ interface UserMessageRendererProps {
 }
 declare const UserMessageRenderer: React__default.FC<UserMessageRendererProps>;
 
-export { ASK_FOLLOW_UP_TOOL_NAME, AgentSelect, type AskFollowUpInput, type AskFollowUpOutput, AssistantMessageRenderer, type AssistantMessageRendererProps, type AttachedImage, AuthLoading, type AuthStatus, Badge, BrowserPreviewPanel, BrowserViewport, type BrowserViewportProps, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chat, type ChatContainerProps, type ChatCustomRenderers, type ChatEmptyStateCategory, type ChatEmptyStateController, type ChatEmptyStateOptions, type ChatEmptyStateStarter, ChatInner, ChatInput, type ChatInputProps, type ChatInstance, type ChatProps, type ChatState, type ChatStateStore, ConfigurationPanel, DialogRoot as Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger, type DistriAnyTool, DistriAuthProvider, DistriContext, DistriProvider, type DistriUiTool, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type ExtractedContent, type FollowUpQuestion, ImageRenderer, type ImageRendererProps, Input, LoadingAnimation, type LoadingAnimationConfig, type LoadingAnimationPreset, type LoadingAnimationProps, LoadingShimmer, MessageFeedback, type MessageFeedbackProps, MessageReadProvider, type MessageReadProviderProps, MessageReadTracker, type MessageReadTrackerProps, MessageRenderer, type MessageRendererProps, type ModelOption, type PlanState, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, StepBasedRenderer, type StepBasedRendererProps, type StepState, type StreamingIndicator, StreamingTextRenderer, type StreamingTtsOptions, type TaskState, Textarea, ThemeProvider, ThemeToggle, ThinkingRenderer, type ThinkingRendererProps, TodosDisplay, type TodosDisplayProps, type ToolCallState, type ToolCallStatus, type ToolRendererMap, type ToolRendererProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TtsConfig, type TtsRequest, TypingIndicator, type UiToolProps, type UseAgentOptions, type UseAgentResult, type UseAgentsByUsageOptions, type UseAgentsByUsageResult, type UseAgentsResult, type UseChatMessagesOptions, type UseChatMessagesReturn, type UseChatOptions, type UseChatReturn, type UseConfigurationResult, type UseMessageReadStatusOptions, type UseMessageReadStatusResult, type UseMessageVoteOptions, type UseMessageVoteResult, type UseMessageVotesOptions, type UseMessageVotesResult, type UseThreadMessagesOptions, type UseThreadReadStatusOptions, type UseThreadReadStatusResult, type UseThreadsOptions, type UseThreadsResult, UserMessageRenderer, type UserMessageRendererProps, VoiceInput, type VoiceInputProps, createAskFollowUpTool, extractContent, useAgent, useAgentDefinitions, useAgentsByUsage, useChat, useChatMessages, useChatStateStore, useConfiguration, useDistri, useDistriAuth, useDistriToken, useMessageReadContext, useMessageReadStatus, useMessageVote, useMessageVotes, useSidebar, useSpeechToText, useTheme, useThreadReadStatus, useThreads, useTts, useWorkspace, wrapFnToolAsUiTool, wrapTools };
+export { ASK_FOLLOW_UP_TOOL_NAME, AgentSelect, type AskFollowUpInput, type AskFollowUpOutput, AssistantMessageRenderer, type AssistantMessageRendererProps, type AttachedImage, AuthLoading, type AuthStatus, Badge, BrowserPreviewPanel, BrowserViewport, type BrowserViewportProps, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chat, type ChatContainerProps, type ChatCustomRenderers, type ChatEmptyStateCategory, type ChatEmptyStateController, type ChatEmptyStateOptions, type ChatEmptyStateStarter, ChatInner, ChatInput, type ChatInputProps, type ChatInstance, type ChatProps, type ChatState, type ChatStateStore, ConfigurationPanel, ContextIndicator, DialogRoot as Dialog, DialogContent, DialogHeader, DialogTitle, DialogTrigger, type DistriAnyTool, DistriAuthProvider, DistriContext, DistriProvider, type DistriUiTool, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type ExtractedContent, type FollowUpQuestion, ImageRenderer, type ImageRendererProps, Input, LoadingAnimation, type LoadingAnimationConfig, type LoadingAnimationPreset, type LoadingAnimationProps, LoadingShimmer, MessageFeedback, type MessageFeedbackProps, MessageReadProvider, type MessageReadProviderProps, MessageReadTracker, type MessageReadTrackerProps, MessageRenderer, type MessageRendererProps, type ModelOption, type PlanState, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, StepBasedRenderer, type StepBasedRendererProps, type StepState, type StreamingIndicator, StreamingTextRenderer, type StreamingTtsOptions, type TaskState, Textarea, ThemeProvider, ThemeToggle, ThinkingRenderer, type ThinkingRendererProps, TodosDisplay, type TodosDisplayProps, type ToolCallState, type ToolCallStatus, type ToolRendererMap, type ToolRendererProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TtsConfig, type TtsRequest, TypingIndicator, type UiToolProps, type UseAgentOptions, type UseAgentResult, type UseAgentsByUsageOptions, type UseAgentsByUsageResult, type UseAgentsResult, type UseChatMessagesOptions, type UseChatMessagesReturn, type UseChatOptions, type UseChatReturn, type UseConfigurationResult, type UseMessageReadStatusOptions, type UseMessageReadStatusResult, type UseMessageVoteOptions, type UseMessageVoteResult, type UseMessageVotesOptions, type UseMessageVotesResult, type UseModelsResult, type UseThreadMessagesOptions, type UseThreadReadStatusOptions, type UseThreadReadStatusResult, type UseThreadsOptions, type UseThreadsResult, type UseWorkflowOptions, type UseWorkflowReturn, type UseWorkflowRunnerOptions, type UseWorkflowRunnerReturn, UserMessageRenderer, type UserMessageRendererProps, VoiceInput, type VoiceInputProps, WorkflowProgress, type WorkflowProgressProps, createAskFollowUpTool, extractContent, useAgent, useAgentDefinitions, useAgentsByUsage, useChat, useChatMessages, useChatStateStore, useConfiguration, useContextHealth, useDistri, useDistriAuth, useDistriToken, useMessageReadContext, useMessageReadStatus, useMessageVote, useMessageVotes, useModels, useSidebar, useSpeechToText, useTheme, useThreadReadStatus, useThreads, useTts, useWorkflow, useWorkflowRunner, useWorkspace, wrapFnToolAsUiTool, wrapTools };