@mcp-b/embedded-agent 0.0.4 → 0.0.6

package/dist/index.d.ts

@@ -2,48 +2,33 @@ import { AssistantRuntime, ThreadMessageLike, ToolCallMessagePartComponent } fro
 import { UIDataTypes, UIMessage, UITools } from "ai";
 import * as react0 from "react";
 import { ComponentPropsWithRef, FC, HTMLAttributes, ReactNode } from "react";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import * as react_jsx_runtime19 from "react/jsx-runtime";
 import { ClassValue } from "clsx";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { VariantProps } from "class-variance-authority";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
 import * as AvatarPrimitive from "@radix-ui/react-avatar";
 import * as DialogPrimitive from "@radix-ui/react-dialog";
-import * as TooltipPrimitive from "@radix-ui/react-tooltip";
-import { VariantProps } from "class-variance-authority";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import * as ScrollAreaPrimitive from "@radix-ui/react-scroll-area";
 import * as SeparatorPrimitive from "@radix-ui/react-separator";
-import * as class_variance_authority_types0 from "class-variance-authority/types";
 import { CallToolResult, GetPromptResult, MCPConnectionState, MCPSource, MCPSourceConfig, Prompt, ReadResourceResult, Resource, ResourceTemplate, SamplingHandler, Tool as Tool$1, ToolWithSource } from "@mcp-b/cloud-mirror-types";
+import * as class_variance_authority_types0 from "class-variance-authority/types";
 import { AgentChatState, PendingTool } from "@mcp-b/agents";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 
-//#region src/web-component.d.ts
+//#region src/core/providers/AgentProvider.d.ts
 
-/** View mode for the agent UI */
-type AgentViewMode = 'pill' | 'modal';
-/**
- * Props for the EmbeddedAgent React component
- *
- * These props map to HTML attributes in kebab-case when used as a web component:
- * - appId -> app-id
- * - apiBase -> api-base
- * - tokenEndpoint -> token-endpoint
- * - autoConnectLocal -> auto-connect-local
- * - viewMode -> view-mode
- */
-interface EmbeddedAgentProps {
-  /** Your app/workspace ID */
-  appId: string;
+interface AgentProviderProps {
+  children: ReactNode;
   /** API base URL for your WebMCP worker */
   apiBase?: string;
   /** Voice mode token endpoint (defaults to {apiBase}/api/realtime/session) */
   tokenEndpoint?: string;
   /** Auto-connect to local MCP source (default: true) */
   autoConnectLocal?: boolean;
-  /** UI view mode: 'pill' (action-first) or 'modal' (traditional chat) */
-  viewMode?: AgentViewMode;
-  /** Callback when tools are updated */
-  onToolsChange?: (tools: unknown[]) => void;
+  /** Callback when MCP tools change */
+  onToolsChange?: (tools: ToolWithSource[]) => void;
   /** Callback when voice mode errors */
   onVoiceError?: (error: string) => void;
   /** Callback when voice mode connects */
@@ -52,370 +37,136 @@ interface EmbeddedAgentProps {
   onVoiceDisconnect?: (duration: number) => void;
 }
 /**
- * EmbeddedAgent React Component
- *
- * A fully self-contained chat widget with MCP tool support and optional voice mode.
- * Supports two view modes:
- * - 'pill': Action-first compact UI (default)
- * - 'modal': Traditional chat modal
- *
- * Can be used as a React component or converted to a web component.
- */
-declare const EmbeddedAgent: FC<EmbeddedAgentProps>;
-/**
- * Web Component Definition
+ * Unified provider for all agent capabilities.
  *
- * Converts EmbeddedAgent to a custom element that can be used in any HTML page.
- * Attributes are automatically converted from kebab-case to camelCase props.
- */
-declare const WebMCPAgentElement: CustomElementConstructor;
-/**
- * Register the custom element
+ * Provides:
+ * - MCP tool registry and execution
+ * - Chat runtime (via @assistant-ui/react)
+ * - Voice mode (if tokenEndpoint is configured)
  *
- * Call this function to register the <webmcp-agent> custom element.
- * This is automatically called when importing the web-component entry point.
- * Styles are automatically injected into the document head.
+ * Use the `useAgent` hook to access agent state and capabilities.
  */
-declare function registerWebMCPAgent(tagName?: string): void;
-//#endregion
-//#region src/components/assistant-modal.d.ts
-declare const AssistantModal: FC;
-//#endregion
-//#region src/components/thread-with-voice.d.ts
-declare const ThreadWithVoice: FC;
+declare const AgentProvider: FC<AgentProviderProps>;
 //#endregion
-//#region src/components/Thread.d.ts
-declare const Thread: FC;
-//#endregion
-//#region src/components/pill/AgentPill.d.ts
-interface AgentPillProps {
-  /** Position of the pill on screen */
-  position?: 'bottom-center' | 'bottom-right';
-  /** Callback when history button is clicked */
-  onOpenHistory?: () => void;
-  /** Show voice button in composer */
-  showVoiceButton?: boolean;
-  /** Voice mode active state */
-  isVoiceActive?: boolean;
-  /** Voice toggle callback */
-  onVoiceToggle?: () => void;
-  /** Auto-collapse after inactivity (default: true) */
-  autoCollapse?: boolean;
-  /** Additional class name */
-  className?: string;
-}
+//#region src/providers/MCPToolsProvider.d.ts
+/** Well-known source IDs */
+declare const SOURCE_LOCAL = "local";
+declare const SOURCE_REMOTE = "remote";
 /**
- * Action-first agent pill UI.
- *
- * A compact, morphing interface that shows:
- * - Current activity when agent is working
- * - Action list (collapsible)
- * - Summary when complete
- * - Input composer
- *
- * Uses assistant-ui primitives for data binding.
+ * MCP Tools Context Value
  */
-declare const AgentPill: FC<AgentPillProps>;
-//#endregion
-//#region src/components/pill/PillContainer.d.ts
-type PillMode = 'collapsed' | 'hovered' | 'composing' | 'active' | 'expanded';
-interface PillContainerProps {
-  mode: PillMode;
+interface MCPToolsContextValue {
+  /** All tools from all sources, tagged with _sourceId */
+  tools: ToolWithSource[];
+  /** All sources and their states */
+  sources: Map<string, MCPSource>;
+  /** Add a new source */
+  addSource: (id: string, config: MCPSourceConfig) => Promise<void>;
+  /** Remove a source */
+  removeSource: (id: string) => Promise<void>;
+  /** Get a specific source */
+  getSource: (id: string) => MCPSource | undefined;
+  /** Check if a source is connected */
+  isConnected: (id: string) => boolean;
+  /** Call a tool (auto-routes based on tool name lookup) */
+  callTool: (name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
+  /** Call a tool on a specific source */
+  callToolOnSource: (sourceId: string, name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
+}
+interface MCPToolsProviderProps {
   children: ReactNode;
-  onModeChange?: (mode: PillMode) => void;
-  className?: string;
+  /** Auto-connect to same-tab source on mount (default: true) */
+  autoConnectLocal?: boolean;
+  /** Callback when tools change */
+  onToolsChange?: (tools: ToolWithSource[]) => void;
 }
+declare function MCPToolsProvider({
+  children,
+  autoConnectLocal,
+  onToolsChange
+}: MCPToolsProviderProps): react_jsx_runtime19.JSX.Element;
 /**
- * Morphing container that changes size and shape based on state.
- * Uses spring animations for smooth, natural transitions.
- *
- * States:
- * - collapsed: Tiny 4px tall bar (ambient)
- * - hovered: Medium pill with prompt
- * - composing: User is typing
- * - active: Agent is working
- * - expanded: Full panel with summary/forms
+ * Hook to access MCP Tools context
  */
-declare const PillContainer: FC<PillContainerProps>;
-//#endregion
-//#region src/components/pill/ToolStatusBorder.d.ts
-type ToolBorderStatus = 'idle' | 'calling' | 'success' | 'error';
-interface ToolStatusBorderProps {
-  status: ToolBorderStatus;
-  children: ReactNode;
-  className?: string;
-  borderRadius?: string;
-}
+declare function useMCPTools(): MCPToolsContextValue;
 /**
- * Minimal animated border for tool execution status.
- *
- * - idle/success: clean, no border (success is the default state)
- * - calling: subtle animated gradient
- * - error: brief red flash with shake
+ * Hook to optionally access MCP Tools context
  */
-declare const ToolStatusBorder: FC<ToolStatusBorderProps>;
+declare function useOptionalMCPTools(): MCPToolsContextValue | null;
 //#endregion
-//#region src/hooks/useActions.d.ts
+//#region src/services/realtime/types.d.ts
 /**
- * Represents a single action derived from a tool call
+ * Types for OpenAI Realtime API integration
  */
-interface Action {
-  id: string;
-  label: string;
+interface RealtimeConfig {
+  model?: string;
+  voice?: string;
+  apiUrl?: string;
+  tokenEndpoint?: string;
+}
+interface RealtimeSession {
+  pc: RTCPeerConnection;
+  dataChannel: RTCDataChannel;
+  audioElement: HTMLAudioElement;
+  localStream: MediaStream | null;
+  remoteStream: MediaStream | null;
+  cleanup: () => void;
+}
+type EventCallback = (data: unknown) => void;
+interface AudioLevelData {
+  micLevel: number;
+  micFrequency: number[];
+  speakerLevel: number;
+  speakerFrequency: number[];
+}
+interface TranscriptData {
+  type: 'user' | 'assistant';
+  text: string;
+  isDone: boolean;
+}
+interface ToolCallData {
+  status: 'started' | 'completed';
   toolName: string;
-  status: 'queued' | 'running' | 'success' | 'error';
-  args?: unknown;
-  result?: unknown;
   error?: string;
-  startedAt?: number;
-  duration?: number;
+}
+interface VoiceModeState {
+  isActive: boolean;
+  isConnecting: boolean;
+  isMuted: boolean;
+  isError: boolean;
+  connectionState: string;
+  audioLevel?: AudioLevelData;
+  transcript?: TranscriptData;
+  toolCall?: ToolCallData;
+  error?: string;
 }
 /**
- * Humanize a tool name for display
- * e.g., "search_files" -> "Searching files"
- * e.g., "readFile" -> "Reading file"
- */
-declare function humanizeToolName(toolName: string, isRunning?: boolean): string;
-/**
- * Hook to derive actions from the current thread's tool calls
- *
- * Actions are a view of tool calls - not separate state.
- * This maintains compatibility with assistant-ui's data model.
+ * Session state event data from the realtime service
  */
-declare function useActions(): Action[];
+interface SessionStateEventData {
+  state: 'connecting' | 'connected' | 'disconnected' | 'error';
+  isActive: boolean;
+  isMuted: boolean;
+  durationSeconds?: number;
+}
 /**
- * Hook to get the current running action (if any)
+ * User transcript event data
  */
-declare function useCurrentAction(): Action | null;
+interface UserTranscriptEventData {
+  text: string;
+}
 /**
- * Hook to get recently completed actions
+ * Assistant transcript streaming event data
  */
-declare function useRecentActions(limit?: number): Action[];
+interface AssistantTranscriptEventData {
+  delta?: string;
+  transcript?: string;
+}
 /**
- * Hook to get action summary stats
+ * Tool call started event data
  */
-declare function useActionStats(): {
-  total: number;
-  completed: number;
-  running: number;
-  failed: number;
-};
-//#endregion
-//#region src/components/pill/CurrentActivity.d.ts
-interface CurrentActivityProps {
-  currentAction: Action | null;
-  recentActions?: Action[];
-  showRecent?: boolean;
-  className?: string;
-}
-/**
- * Displays the current action the agent is performing,
- * with optional recent completed steps shown below.
- */
-declare const CurrentActivity: FC<CurrentActivityProps>;
-type ActionStatus = 'queued' | 'running' | 'success' | 'error';
-interface ActionStatusIconProps {
-  status: ActionStatus;
-  size?: 'sm' | 'md';
-  className?: string;
-}
-/**
- * Icon component for action status
- */
-declare const ActionStatusIcon: FC<ActionStatusIconProps>;
-/**
- * Idle state indicator when no actions are running
- */
-declare const IdleIndicator: FC<{
-  className?: string;
-}>;
-//#endregion
-//#region src/components/pill/ActionList.d.ts
-interface ActionListProps {
-  actions: Action[];
-  defaultCollapsed?: boolean;
-  className?: string;
-}
-/**
- * Collapsible list of all actions (tool calls) in the current conversation.
- * Shows count in header, expands to show full list with status icons.
- */
-declare const ActionList: FC<ActionListProps>;
-/**
- * Compact inline action summary (for collapsed pill states)
- */
-declare const ActionSummary: FC<{
-  actions: Action[];
-  className?: string;
-}>;
-//#endregion
-//#region src/components/pill/PillComposer.d.ts
-interface PillComposerProps {
-  placeholder?: string;
-  showVoiceButton?: boolean;
-  isVoiceActive?: boolean;
-  onVoiceToggle?: () => void;
-  showCharCount?: boolean;
-  className?: string;
-}
-/**
- * Compact composer for the pill UI.
- * Uses assistant-ui primitives for data binding.
- * Features auto-growing textarea and character count.
- */
-declare const PillComposer: FC<PillComposerProps>;
-/**
- * Minimal composer for collapsed/hovered states
- * Just shows a clickable prompt
- */
-declare const MinimalComposer: FC<{
-  onClick: () => void;
-  className?: string;
-}>;
-//#endregion
-//#region src/components/pill/SummaryBlock.d.ts
-interface SummaryBlockProps {
-  summary: string;
-  isSuccess?: boolean;
-  isError?: boolean;
-  actions?: QuickAction[];
-  className?: string;
-}
-interface QuickAction {
-  label: string;
-  onClick: () => void;
-  variant?: 'primary' | 'secondary';
-}
-/**
- * Summary block showing the agent's synthesized output.
- * Displayed after task completion instead of token streaming.
- */
-declare const SummaryBlock: FC<SummaryBlockProps>;
-/**
- * Welcome message for empty state
- */
-declare const WelcomeMessage: FC<{
-  className?: string;
-}>;
-//#endregion
-//#region src/components/pill/HistorySidebar.d.ts
-/**
- * Represents a conversation in history
- */
-interface Conversation {
-  id: string;
-  title: string;
-  preview: string;
-  timestamp: Date;
-  messageCount: number;
-}
-interface HistorySidebarProps {
-  isOpen: boolean;
-  onClose: () => void;
-  conversations?: Conversation[];
-  selectedId?: string | null;
-  onSelectConversation?: (id: string) => void;
-  className?: string;
-}
-/**
- * Sidebar panel showing conversation history and full thread view.
- * Opens from the right side of the screen.
- */
-declare const HistorySidebar: FC<HistorySidebarProps>;
-//#endregion
-//#region src/components/AssistantMessage.d.ts
-declare const AssistantMessage: FC;
-//#endregion
-//#region src/components/UserMessage.d.ts
-declare const UserMessage: FC;
-//#endregion
-//#region src/components/Composer.d.ts
-declare const Composer: FC;
-//#endregion
-//#region src/components/markdown-text.d.ts
-declare const MarkdownText: react0.MemoExoticComponent<() => react_jsx_runtime0.JSX.Element>;
-//#endregion
-//#region src/components/tool-fallback.d.ts
-declare const ToolFallback: ToolCallMessagePartComponent;
-//#endregion
-//#region src/components/attachment.d.ts
-declare const UserMessageAttachments: FC;
-declare const ComposerAttachments: FC;
-declare const ComposerAddAttachment: FC;
-//#endregion
-//#region src/services/realtime/types.d.ts
-/**
- * Types for OpenAI Realtime API integration
- */
-interface RealtimeConfig {
-  model?: string;
-  voice?: string;
-  apiUrl?: string;
-  tokenEndpoint?: string;
-}
-interface RealtimeSession {
-  pc: RTCPeerConnection;
-  dataChannel: RTCDataChannel;
-  audioElement: HTMLAudioElement;
-  localStream: MediaStream | null;
-  remoteStream: MediaStream | null;
-  cleanup: () => void;
-}
-type EventCallback = (data: unknown) => void;
-interface AudioLevelData {
-  micLevel: number;
-  micFrequency: number[];
-  speakerLevel: number;
-  speakerFrequency: number[];
-}
-interface TranscriptData {
-  type: 'user' | 'assistant';
-  text: string;
-  isDone: boolean;
-}
-interface ToolCallData {
-  status: 'started' | 'completed';
-  toolName: string;
-  error?: string;
-}
-interface VoiceModeState {
-  isActive: boolean;
-  isConnecting: boolean;
-  isMuted: boolean;
-  isError: boolean;
-  connectionState: string;
-  audioLevel?: AudioLevelData;
-  transcript?: TranscriptData;
-  toolCall?: ToolCallData;
-  error?: string;
-}
-/**
- * Session state event data from the realtime service
- */
-interface SessionStateEventData {
-  state: 'connecting' | 'connected' | 'disconnected' | 'error';
-  isActive: boolean;
-  isMuted: boolean;
-  durationSeconds?: number;
-}
-/**
- * User transcript event data
- */
-interface UserTranscriptEventData {
-  text: string;
-}
-/**
- * Assistant transcript streaming event data
- */
-interface AssistantTranscriptEventData {
-  delta?: string;
-  transcript?: string;
-}
-/**
- * Tool call started event data
- */
-interface ToolCallStartedEventData {
-  name: string;
+interface ToolCallStartedEventData {
+  name: string;
 }
 /**
  * Tool call completed event data
@@ -555,29 +306,536 @@ declare class OpenAIRealtimeService {
   private emitSessionState;
 }
 //#endregion
-//#region src/components/voice-indicator.d.ts
-interface VoiceIndicatorProps {
-  isActive: boolean;
-  isConnecting: boolean;
-  isMuted: boolean;
-  audioLevel?: AudioLevelData;
-  toolCall?: ToolCallData;
-  onStart: () => void;
-  onStop: () => void;
-  onToggleMute: () => void;
+//#region src/hooks/useVoiceMode.d.ts
+interface UseVoiceModeOptions {
+  /** Endpoint to get ephemeral tokens from */
+  tokenEndpoint: string;
+  /** Tools available for the voice session */
+  tools?: RegisteredTool[];
+  /** Tool executor function */
+  toolExecutor?: ToolExecutor;
+  /** Callback when session connects */
+  onConnect?: () => void;
+  /** Callback when session disconnects */
+  onDisconnect?: (durationSeconds: number) => void;
+  /** Callback when error occurs */
+  onError?: (error: string) => void;
+  /** Callback when user transcript is complete */
+  onUserTranscript?: (text: string) => void;
+  /** Callback when assistant transcript is complete */
+  onAssistantTranscript?: (text: string) => void;
+}
+interface UseVoiceModeReturn extends VoiceModeState {
+  /** Start voice session */
+  startSession: (config?: RealtimeConfig) => Promise<void>;
+  /** Stop voice session */
+  stopSession: () => void;
+  /** Toggle microphone mute */
+  toggleMute: (muted?: boolean) => void;
+  /** Send text message while in voice mode */
+  sendMessage: (text: string) => void;
+}
+declare function useVoiceMode(options: UseVoiceModeOptions): UseVoiceModeReturn;
+//#endregion
+//#region src/providers/VoiceModeProvider.d.ts
+/**
+ * Voice Mode Provider
+ *
+ * Provides voice mode state and controls to the component tree.
+ */
+interface VoiceModeContextValue extends UseVoiceModeReturn {
+  isSupported: boolean;
+}
+interface VoiceModeProviderProps {
+  children: ReactNode;
+  /** Backend endpoint for ephemeral tokens */
+  tokenEndpoint: string;
+  /** Tools available for voice mode */
+  tools?: RegisteredTool[];
+  /** Tool executor function */
+  toolExecutor?: ToolExecutor;
+  /** Callback when session connects */
+  onConnect?: () => void;
+  /** Callback when session disconnects */
+  onDisconnect?: (durationSeconds: number) => void;
+  /** Callback when error occurs */
+  onError?: (error: string) => void;
+  /** Callback when user transcript is complete */
+  onUserTranscript?: (text: string) => void;
+  /** Callback when assistant transcript is complete */
+  onAssistantTranscript?: (text: string) => void;
+}
+declare function VoiceModeProvider({
+  children,
+  tokenEndpoint,
+  tools,
+  toolExecutor,
+  onConnect,
+  onDisconnect,
+  onError,
+  onUserTranscript,
+  onAssistantTranscript
+}: VoiceModeProviderProps): react_jsx_runtime19.JSX.Element;
+/**
+ * Hook to access voice mode context
+ */
+declare function useVoiceModeContext(): VoiceModeContextValue;
+/**
+ * Hook to optionally access voice mode context (returns null if not in provider)
+ */
+declare function useOptionalVoiceModeContext(): VoiceModeContextValue | null;
+//#endregion
+//#region src/hooks/useActions.d.ts
+/**
+ * Represents a single action derived from a tool call
+ */
+interface Action {
+  id: string;
+  label: string;
+  toolName: string;
+  status: 'queued' | 'running' | 'success' | 'error';
+  args?: unknown;
+  result?: unknown;
+  error?: string;
+  startedAt?: number;
+  duration?: number;
+}
+/**
+ * Humanize a tool name for display
+ * e.g., "search_files" -> "Searching files"
+ * e.g., "readFile" -> "Reading file"
+ */
+declare function humanizeToolName(toolName: string, isRunning?: boolean): string;
+/**
+ * Hook to derive actions from the current thread's tool calls
+ *
+ * Actions are a view of tool calls - not separate state.
+ * This maintains compatibility with assistant-ui's data model.
+ */
+declare function useActions(): Action[];
+/**
+ * Hook to get the current running action (if any)
+ */
+declare function useCurrentAction(): Action | null;
+/**
+ * Hook to get recently completed actions
+ */
+declare function useRecentActions(limit?: number): Action[];
+/**
+ * Hook to get action summary stats
+ */
+declare function useActionStats(): {
+  total: number;
+  completed: number;
+  running: number;
+  failed: number;
+};
+//#endregion
+//#region src/hooks/useVoiceSummary.d.ts
+/**
+ * Voice Summary Hook
+ *
+ * Tracks the last assistant response from voice mode for display as a summary.
+ * Maintains the summary for a short time after the voice session ends.
+ */
+interface VoiceSummary {
+  text: string;
+  timestamp: number;
+}
+/**
+ * Hook to get the latest voice session summary
+ * Returns the last assistant transcript from the voice session
+ */
+declare function useVoiceSummary(): VoiceSummary | null;
+/**
+ * Hook to check if there's a recent voice summary to display
+ */
+declare function useHasVoiceSummary(): boolean;
+//#endregion
+//#region src/core/hooks/useAgent.d.ts
+/**
+ * Voice mode state and controls
+ */
+interface AgentVoice {
+  /** Whether voice session is active */
+  isActive: boolean;
+  /** Whether voice is connecting */
+  isConnecting: boolean;
+  /** Whether there's an error */
+  isError: boolean;
+  /** Whether microphone is muted */
+  isMuted: boolean;
+  /** Current error message */
+  error?: string;
+  /** Real-time audio levels (mic and speaker) */
+  audioLevel?: AudioLevelData;
+  /** Current transcript (user or assistant) */
+  transcript?: TranscriptData;
+  /** Current tool call being executed */
+  toolCall?: ToolCallData;
+  /** Start voice session */
+  start: () => Promise<void>;
+  /** Stop voice session */
+  stop: () => void;
+  /** Toggle microphone mute */
+  toggleMute: (muted?: boolean) => void;
+  /** Send text message while in voice mode */
+  sendMessage: (text: string) => void;
+}
+/**
+ * MCP tools state and controls
+ */
+interface AgentTools {
+  /** All available tools */
+  list: ToolWithSource[];
+  /** Call a tool by name */
+  call: (name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
+}
+/**
+ * Agent state and controls returned by useAgent
+ */
+interface AgentState {
+  /** All messages in the thread */
+  messages: ReadonlyArray<{
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: readonly unknown[];
+    status?: {
+      type: string;
+    };
+  }>;
+  /** Whether the agent is currently processing */
+  isRunning: boolean;
+  /** Whether thread has any messages */
+  hasMessages: boolean;
+  /** All actions derived from tool calls */
+  actions: Action[];
+  /** Currently running action (if any) */
+  currentAction: Action | null;
+  /** Recently completed actions */
+  recentActions: Action[];
+  /** Actions from voice mode (when voice is active) */
+  voiceActions: Action[];
+  /** Active actions - voice actions when voice is active, otherwise text actions */
+  activeActions: Action[];
+  /** Latest assistant summary (from text or voice) */
+  summary: string | null;
+  /** Voice summary (after voice session ends) */
+  voiceSummary: VoiceSummary | null;
+  voice: AgentVoice | null;
+  tools: AgentTools | null;
+  /** Whether voice mode is currently active */
+  isVoiceActive: boolean;
+}
+/**
+ * Main agent hook - provides unified access to all agent capabilities
+ */
+declare function useAgent(): AgentState;
+/**
+ * Hook to check if agent is available (inside AgentProvider)
+ */
+declare function useIsAgentAvailable(): boolean;
+//#endregion
+//#region src/hooks/useVoiceActions.d.ts
+declare function useVoiceActions(): Action[];
+/**
+ * Hook to get the current running voice action (if any)
+ */
+declare function useCurrentVoiceAction(): Action | null;
+/**
+ * Hook to get recently completed voice actions
+ */
+declare function useRecentVoiceActions(limit?: number): Action[];
+//#endregion
+//#region src/lib/constants.d.ts
+/**
+ * Shared Constants
+ *
+ * Centralized location for all magic numbers, timeouts, and configuration values.
+ * Having these in one place makes the codebase more maintainable and easier to tune.
+ */
+/** Maximum number of reconnection attempts before giving up */
+declare const MCP_MAX_RECONNECT_ATTEMPTS = 5;
+/** Base delay in milliseconds for exponential backoff reconnection */
+declare const MCP_BASE_RECONNECT_DELAY_MS = 1000;
+/** Maximum reconnect delay in milliseconds (caps exponential backoff) */
+declare const MCP_MAX_RECONNECT_DELAY_MS = 30000;
+/** Delay before auto-connecting to tab-based MCP sources (allows server initialization) */
+declare const MCP_TAB_CONNECT_DELAY_MS = 100;
+/** Number of frequency bins for audio visualization */
+declare const AUDIO_FREQUENCY_BINS = 32;
+/** Default OpenAI Realtime model */
+declare const REALTIME_DEFAULT_MODEL = "gpt-4o-realtime-preview-2024-12-17";
+/** Default voice for OpenAI Realtime */
+declare const REALTIME_DEFAULT_VOICE = "verse";
+/** Default OpenAI Realtime API URL */
+declare const REALTIME_DEFAULT_API_URL = "https://api.openai.com/v1/realtime";
+/** Duration to retain voice actions after session ends (for display) */
+declare const VOICE_ACTIONS_RETENTION_MS = 3000;
+/** Duration to retain voice summary after session ends */
+declare const VOICE_SUMMARY_RETENTION_MS = 30000;
+/**
+ * Enable debug logging for development.
+ * Can be enabled by setting window.__WEBMCP_DEBUG__ = true in the browser console.
+ * In production builds, this defaults to false.
+ */
+declare const DEBUG_LOGGING_ENABLED: boolean;
+/**
+ * Conditional debug logger that only logs when DEBUG_LOGGING_ENABLED is true.
+ * Can be enabled at runtime by setting window.__WEBMCP_DEBUG__ = true
+ *
+ * @param component - The component or service name for the log prefix
+ * @param message - The log message
+ * @param data - Optional data to include in the log
+ */
+declare function debugLog(component: string, message: string, data?: unknown): void;
+//#endregion
+//#region src/components/pill/AgentPill.d.ts
+/** Position of the pill on screen */
+type PillPosition = 'bottom-center' | 'bottom-right';
+interface AgentPillProps {
+  /** Position of the pill on screen */
+  position?: PillPosition;
+  /** Callback when history button is clicked */
+  onOpenHistory?: () => void;
+  /** Show voice button in composer */
+  showVoiceButton?: boolean;
+  /** Voice mode active state */
+  isVoiceActive?: boolean;
+  /** Voice toggle callback */
+  onVoiceToggle?: () => void;
+  /** Auto-collapse after inactivity (default: true) */
+  autoCollapse?: boolean;
+  /** Additional class name */
+  className?: string;
+}
+/**
+ * Action-first agent pill UI.
+ *
+ * A compact, morphing interface that shows:
+ * - Current activity when agent is working
+ * - Action list (collapsible)
+ * - Summary when complete
+ * - Input composer
+ *
+ * Uses assistant-ui primitives for data binding.
+ */
+declare const AgentPill: FC<AgentPillProps>;
+//#endregion
+//#region src/components/pill/PillContainer.d.ts
+type PillMode = 'collapsed' | 'hovered' | 'composing' | 'active' | 'expanded';
+interface PillContainerProps {
+  mode: PillMode;
+  children: ReactNode;
+  onModeChange?: (mode: PillMode) => void;
+  className?: string;
+}
+/**
+ * Morphing container that changes size and shape based on state.
+ * Uses spring animations for smooth, natural transitions.
+ *
+ * States:
+ * - collapsed: Tiny 4px tall bar (ambient)
+ * - hovered: Medium pill with prompt
+ * - composing: User is typing
+ * - active: Agent is working
+ * - expanded: Full panel with summary/forms
+ */
+declare const PillContainer: FC<PillContainerProps>;
+//#endregion
+//#region src/components/pill/PillComposer.d.ts
+interface PillComposerProps {
+  placeholder?: string;
+  showVoiceButton?: boolean;
+  isVoiceActive?: boolean;
+  onVoiceToggle?: () => void;
+  showCharCount?: boolean;
+  className?: string;
+}
+/**
+ * Compact composer for the pill UI.
+ * Uses assistant-ui primitives for data binding.
+ * Features auto-growing textarea and character count.
+ */
+declare const PillComposer: FC<PillComposerProps>;
+/**
+ * Minimal composer for collapsed/hovered states
+ * Just shows a clickable prompt
+ */
+declare const MinimalComposer: FC<{
+  onClick: () => void;
+  className?: string;
+}>;
+//#endregion
+//#region src/components/pill/ToolStatusBorder.d.ts
+type ToolBorderStatus = 'idle' | 'calling' | 'success' | 'error';
+interface ToolStatusBorderProps {
+  status: ToolBorderStatus;
+  children: ReactNode;
+  className?: string;
+  borderRadius?: string;
+}
+/**
+ * Minimal animated border for tool execution status.
+ *
+ * - idle/success: clean, no border (success is the default state)
+ * - calling: subtle animated gradient
+ * - error: brief red flash with shake
+ */
+declare const ToolStatusBorder: FC<ToolStatusBorderProps>;
+//#endregion
+//#region src/components/pill/PillVoice.d.ts
+interface PillVoiceProps {
+  /** Callback when voice mode ends */
+  onEnd?: () => void;
+  /** Whether to show a compact version */
+  compact?: boolean;
+  /** Additional class name */
+  className?: string;
+}
+/**
+ * Convert voice mode tool call status to border status
+ */
+
+/**
+ * Compact voice mode UI for the pill.
+ * Shows waveforms, controls, and transcript preview.
+ * Uses motion animations for smooth transitions.
+ */
+declare const PillVoice: FC<PillVoiceProps>;
+/**
+ * Hook to get voice border status for the pill container
+ */
+declare function useVoiceBorderStatus(): ToolBorderStatus;
+//#endregion
+//#region src/components/pill/HistorySidebar.d.ts
+/**
+ * Represents a conversation in history
+ */
+interface Conversation {
+  id: string;
+  title: string;
+  preview: string;
+  timestamp: Date;
+  messageCount: number;
+}
+interface HistorySidebarProps {
+  isOpen: boolean;
+  onClose: () => void;
+  conversations?: Conversation[];
+  selectedId?: string | null;
+  onSelectConversation?: (id: string) => void;
+  className?: string;
+}
+/**
+ * Sidebar panel showing conversation history and full thread view.
+ * Opens from the right side of the screen.
+ */
+declare const HistorySidebar: FC<HistorySidebarProps>;
+//#endregion
+//#region src/components/assistant-modal.d.ts
+declare const AssistantModal: FC;
+//#endregion
+//#region src/components/Thread.d.ts
+declare const Thread: FC;
+//#endregion
+//#region src/components/Composer.d.ts
+declare const Composer: FC;
+//#endregion
+//#region src/components/thread-with-voice.d.ts
+declare const ThreadWithVoice: FC;
+//#endregion
+//#region src/components/UserMessage.d.ts
+declare const UserMessage: FC;
+//#endregion
+//#region src/components/AssistantMessage.d.ts
+declare const AssistantMessage: FC;
+//#endregion
+//#region src/components/pill/ActionList.d.ts
+interface ActionListProps {
+  actions: Action[];
+  defaultCollapsed?: boolean;
+  className?: string;
+}
+/**
+ * Collapsible list of all actions (tool calls) in the current conversation.
+ * Shows count in header, expands to show full list with status icons.
+ */
+declare const ActionList: FC<ActionListProps>;
+/**
+ * Compact inline action summary (for collapsed pill states)
+ */
+declare const ActionSummary: FC<{
+  actions: Action[];
+  className?: string;
+}>;
+//#endregion
+//#region src/components/pill/CurrentActivity.d.ts
+interface CurrentActivityProps {
+  currentAction: Action | null;
+  recentActions?: Action[];
+  showRecent?: boolean;
+  className?: string;
+}
+/**
+ * Displays the current action the agent is performing,
+ * with optional recent completed steps shown below.
+ */
+declare const CurrentActivity: FC<CurrentActivityProps>;
+interface ActionStatusIconProps {
+  status: Action['status'];
+  size?: 'sm' | 'md';
+  className?: string;
+}
+/**
+ * Icon component for action status
+ */
+declare const ActionStatusIcon: FC<ActionStatusIconProps>;
+/**
+ * Idle state indicator when no actions are running
+ */
+declare const IdleIndicator: FC<{
+  className?: string;
+}>;
+//#endregion
+//#region src/components/pill/SummaryBlock.d.ts
+interface SummaryBlockProps {
+  summary: string;
+  isSuccess?: boolean;
+  isError?: boolean;
+  actions?: QuickAction[];
   className?: string;
 }
-declare function VoiceIndicator({
-  isActive,
-  isConnecting,
-  isMuted,
-  audioLevel,
-  toolCall,
-  onStart,
-  onStop,
-  onToggleMute,
-  className
-}: VoiceIndicatorProps): react_jsx_runtime0.JSX.Element;
+interface QuickAction {
+  label: string;
+  onClick: () => void;
+  variant?: 'primary' | 'secondary';
+}
+/**
+ * Summary block showing the agent's synthesized output.
+ * Displayed after task completion instead of token streaming.
+ * Uses compact styling with max-height and scrolling for long responses.
+ */
+declare const SummaryBlock: FC<SummaryBlockProps>;
+/**
+ * Hook to get the latest summary from the thread
+ * Returns the last text content from the last assistant message
+ */
+declare function useLatestSummary(): string | null;
+/**
+ * Welcome message for empty state
+ */
+declare const WelcomeMessage: FC<{
+  className?: string;
+}>;
+/**
+ * Wrapper for conditional content based on thread state
+ */
+declare const ThreadContent: FC<{
+  empty: ReactNode;
+  running: ReactNode;
+  complete: ReactNode;
+}>;
 //#endregion
 //#region src/components/live-waveform.d.ts
 type LiveWaveformProps = HTMLAttributes<HTMLDivElement> & {
@@ -611,7 +869,115 @@ declare const LiveWaveform: ({
   manualAudioLevel,
   className,
   ...props
-}: LiveWaveformProps) => react_jsx_runtime0.JSX.Element;
+}: LiveWaveformProps) => react_jsx_runtime19.JSX.Element;
+//#endregion
+//#region src/components/voice-indicator.d.ts
+interface VoiceIndicatorProps {
+  isActive: boolean;
+  isConnecting: boolean;
+  isMuted: boolean;
+  audioLevel?: AudioLevelData;
+  toolCall?: ToolCallData;
+  onStart: () => void;
+  onStop: () => void;
+  onToggleMute: () => void;
+  className?: string;
+}
+declare function VoiceIndicator({
+  isActive,
+  isConnecting,
+  isMuted,
+  audioLevel,
+  toolCall,
+  onStart,
+  onStop,
+  onToggleMute,
+  className
+}: VoiceIndicatorProps): react_jsx_runtime19.JSX.Element;
+//#endregion
+//#region src/components/pill/PillMarkdown.d.ts
+interface PillMarkdownProps {
+  content: string;
+  className?: string;
+  /** Compact mode uses smaller text and tighter spacing */
+  compact?: boolean;
+}
+/**
+ * Markdown component for rendering content within pill UI.
+ * Supports GitHub-flavored markdown with compact styling option.
+ */
+declare const PillMarkdown: FC<PillMarkdownProps>;
+//#endregion
+//#region src/web-component.d.ts
+/** View mode for the agent UI */
+type AgentViewMode = 'pill' | 'modal';
+/**
+ * Props for the EmbeddedAgent React component
+ *
+ * These props map to HTML attributes in kebab-case when used as a web component:
+ * - appId -> app-id
+ * - apiBase -> api-base
+ * - tokenEndpoint -> token-endpoint
+ * - autoConnectLocal -> auto-connect-local
+ * - viewMode -> view-mode
+ */
+interface EmbeddedAgentProps {
+  /** Your app/workspace ID */
+  appId: string;
+  /** API base URL for your WebMCP worker */
+  apiBase?: string;
+  /** Voice mode token endpoint (defaults to {apiBase}/api/realtime/session) */
+  tokenEndpoint?: string;
+  /** Auto-connect to local MCP source (default: true) */
+  autoConnectLocal?: boolean;
+  /** UI view mode: 'pill' (action-first) or 'modal' (traditional chat) */
+  viewMode?: AgentViewMode;
+  /** Callback when tools are updated */
+  onToolsChange?: (tools: unknown[]) => void;
+  /** Callback when voice mode errors */
+  onVoiceError?: (error: string) => void;
+  /** Callback when voice mode connects */
+  onVoiceConnect?: () => void;
+  /** Callback when voice mode disconnects */
+  onVoiceDisconnect?: (duration: number) => void;
+}
+/**
+ * EmbeddedAgent React Component
+ *
+ * A fully self-contained chat widget with MCP tool support and optional voice mode.
+ * Supports two view modes:
+ * - 'pill': Action-first compact UI (default)
+ * - 'modal': Traditional chat modal
+ *
+ * Can be used as a React component or converted to a web component.
+ */
+declare const EmbeddedAgent: FC<EmbeddedAgentProps>;
+/**
+ * Web Component Definition
+ *
+ * Converts EmbeddedAgent to a custom element that can be used in any HTML page.
+ * Attributes are automatically converted from kebab-case to camelCase props.
+ */
+declare const WebMCPAgentElement: CustomElementConstructor;
+/**
+ * Register the custom element
+ *
+ * Call this function to register the <webmcp-agent> custom element.
+ * This is automatically called when importing the web-component entry point.
+ * Styles are automatically injected into the document head.
+ */
+declare function registerWebMCPAgent(tagName?: string): void;
+//#endregion
+//#region src/components/markdown-text.d.ts
+declare const MarkdownText: react0.MemoExoticComponent<() => react_jsx_runtime19.JSX.Element>;
+//#endregion
+//#region src/components/tool-fallback.d.ts
+declare const ToolFallback: ToolCallMessagePartComponent;
+//#endregion
+//#region src/components/attachment.d.ts
+declare const UserMessageAttachments: FC;
+declare const ComposerAttachments: FC;
+declare const ComposerAddAttachment: FC;
 //#endregion
 //#region src/components/realtime-tool-card.d.ts
 interface RealtimeToolCardProps {
@@ -625,7 +991,7 @@ interface RealtimeToolCardProps {
 declare function RealtimeToolCard({
   toolCall,
   className
-}: RealtimeToolCardProps): react_jsx_runtime0.JSX.Element;
+}: RealtimeToolCardProps): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/MCPToolRegistry.d.ts
 /**
@@ -653,21 +1019,21 @@ declare function Button({
   ...props
 }: react0.ComponentProps<'button'> & VariantProps<typeof buttonVariants> & {
   asChild?: boolean;
-}): react_jsx_runtime0.JSX.Element;
+}): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/avatar.d.ts
 declare function Avatar({
   className,
   ...props
-}: react0.ComponentProps<typeof AvatarPrimitive.Root>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof AvatarPrimitive.Root>): react_jsx_runtime19.JSX.Element;
 declare function AvatarImage({
   className,
   ...props
-}: react0.ComponentProps<typeof AvatarPrimitive.Image>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof AvatarPrimitive.Image>): react_jsx_runtime19.JSX.Element;
 declare function AvatarFallback({
   className,
   ...props
-}: react0.ComponentProps<typeof AvatarPrimitive.Fallback>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof AvatarPrimitive.Fallback>): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/badge.d.ts
 declare const badgeVariants: (props?: ({
@@ -678,25 +1044,25 @@ declare function Badge({
   className,
   variant,
   ...props
-}: BadgeProps): react_jsx_runtime0.JSX.Element;
+}: BadgeProps): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/dialog.d.ts
 declare function Dialog({
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Root>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Root>): react_jsx_runtime19.JSX.Element;
 declare function DialogTrigger({
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Trigger>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Trigger>): react_jsx_runtime19.JSX.Element;
 declare function DialogPortal({
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Portal>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Portal>): react_jsx_runtime19.JSX.Element;
 declare function DialogClose({
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Close>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Close>): react_jsx_runtime19.JSX.Element;
 declare function DialogOverlay({
   className,
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Overlay>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Overlay>): react_jsx_runtime19.JSX.Element;
 declare function DialogContent({
   className,
   children,
@@ -704,35 +1070,35 @@ declare function DialogContent({
   ...props
 }: react0.ComponentProps<typeof DialogPrimitive.Content> & {
   showCloseButton?: boolean;
-}): react_jsx_runtime0.JSX.Element;
+}): react_jsx_runtime19.JSX.Element;
 declare function DialogHeader({
   className,
   ...props
-}: react0.ComponentProps<'div'>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<'div'>): react_jsx_runtime19.JSX.Element;
 declare function DialogFooter({
   className,
   ...props
-}: react0.ComponentProps<'div'>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<'div'>): react_jsx_runtime19.JSX.Element;
 declare function DialogTitle({
   className,
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Title>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Title>): react_jsx_runtime19.JSX.Element;
 declare function DialogDescription({
   className,
   ...props
-}: react0.ComponentProps<typeof DialogPrimitive.Description>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof DialogPrimitive.Description>): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/scroll-area.d.ts
 declare function ScrollArea({
   className,
   children,
   ...props
-}: react0.ComponentProps<typeof ScrollAreaPrimitive.Root>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof ScrollAreaPrimitive.Root>): react_jsx_runtime19.JSX.Element;
 declare function ScrollBar({
   className,
   orientation,
   ...props
-}: react0.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/separator.d.ts
 declare function Separator({
@@ -740,25 +1106,25 @@ declare function Separator({
   orientation,
   decorative,
   ...props
-}: react0.ComponentProps<typeof SeparatorPrimitive.Root>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof SeparatorPrimitive.Root>): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/tooltip.d.ts
 declare function TooltipProvider({
   delayDuration,
   ...props
-}: react0.ComponentProps<typeof TooltipPrimitive.Provider>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof TooltipPrimitive.Provider>): react_jsx_runtime19.JSX.Element;
 declare function Tooltip({
   ...props
-}: react0.ComponentProps<typeof TooltipPrimitive.Root>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof TooltipPrimitive.Root>): react_jsx_runtime19.JSX.Element;
 declare function TooltipTrigger({
   ...props
-}: react0.ComponentProps<typeof TooltipPrimitive.Trigger>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof TooltipPrimitive.Trigger>): react_jsx_runtime19.JSX.Element;
 declare function TooltipContent({
   className,
   sideOffset,
   children,
   ...props
-}: react0.ComponentProps<typeof TooltipPrimitive.Content>): react_jsx_runtime0.JSX.Element;
+}: react0.ComponentProps<typeof TooltipPrimitive.Content>): react_jsx_runtime19.JSX.Element;
 //#endregion
 //#region src/components/tooltip-icon-button.d.ts
 type TooltipIconButtonProps = ComponentPropsWithRef<typeof Button> & {
@@ -767,59 +1133,13 @@ type TooltipIconButtonProps = ComponentPropsWithRef<typeof Button> & {
 };
 declare const TooltipIconButton: react0.ForwardRefExoticComponent<Omit<TooltipIconButtonProps, "ref"> & react0.RefAttributes<HTMLButtonElement>>;
 //#endregion
-//#region src/providers/MCPToolsProvider.d.ts
-/** Well-known source IDs */
-declare const SOURCE_LOCAL = "local";
-declare const SOURCE_REMOTE = "remote";
-/**
- * MCP Tools Context Value
- */
-interface MCPToolsContextValue {
-  /** All tools from all sources, tagged with _sourceId */
-  tools: ToolWithSource[];
-  /** All sources and their states */
-  sources: Map<string, MCPSource>;
-  /** Add a new source */
-  addSource: (id: string, config: MCPSourceConfig) => Promise<void>;
-  /** Remove a source */
-  removeSource: (id: string) => Promise<void>;
-  /** Get a specific source */
-  getSource: (id: string) => MCPSource | undefined;
-  /** Check if a source is connected */
-  isConnected: (id: string) => boolean;
-  /** Call a tool (auto-routes based on tool name lookup) */
-  callTool: (name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
-  /** Call a tool on a specific source */
-  callToolOnSource: (sourceId: string, name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
-}
-interface MCPToolsProviderProps {
-  children: ReactNode;
-  /** Auto-connect to same-tab source on mount (default: true) */
-  autoConnectLocal?: boolean;
-  /** Callback when tools change */
-  onToolsChange?: (tools: ToolWithSource[]) => void;
-}
-declare function MCPToolsProvider({
-  children,
-  autoConnectLocal,
-  onToolsChange
-}: MCPToolsProviderProps): react_jsx_runtime0.JSX.Element;
-/**
- * Hook to access MCP Tools context
- */
-declare function useMCPTools(): MCPToolsContextValue;
-/**
- * Hook to optionally access MCP Tools context
- */
-declare function useOptionalMCPTools(): MCPToolsContextValue | null;
-//#endregion
-//#region src/hooks/useVoiceMode.d.ts
-interface UseVoiceModeOptions {
+//#region src/hooks/useAgentSdkVoiceMode.d.ts
+interface UseAgentSdkVoiceModeOptions {
   /** Endpoint to get ephemeral tokens from */
   tokenEndpoint: string;
-  /** Tools available for the voice session */
+  /** Tools available for the voice session (MCP format with JSON Schema) */
   tools?: RegisteredTool[];
-  /** Tool executor function */
+  /** Tool executor function that routes calls to MCP */
   toolExecutor?: ToolExecutor;
   /** Callback when session connects */
   onConnect?: () => void;
@@ -832,9 +1152,9 @@ interface UseVoiceModeOptions {
   /** Callback when assistant transcript is complete */
   onAssistantTranscript?: (text: string) => void;
 }
-interface UseVoiceModeReturn extends VoiceModeState {
+interface UseAgentSdkVoiceModeReturn extends VoiceModeState {
   /** Start voice session */
-  startSession: (config?: RealtimeConfig) => Promise<void>;
+  startSession: () => Promise<void>;
   /** Stop voice session */
   stopSession: () => void;
   /** Toggle microphone mute */
@@ -842,22 +1162,17 @@ interface UseVoiceModeReturn extends VoiceModeState {
   /** Send text message while in voice mode */
   sendMessage: (text: string) => void;
 }
-declare function useVoiceMode(options: UseVoiceModeOptions): UseVoiceModeReturn;
+declare function useAgentSdkVoiceMode(options: UseAgentSdkVoiceModeOptions): UseAgentSdkVoiceModeReturn;
 //#endregion
-//#region src/providers/VoiceModeProvider.d.ts
-/**
- * Voice Mode Provider
- *
- * Provides voice mode state and controls to the component tree.
- */
-interface VoiceModeContextValue extends UseVoiceModeReturn {
+//#region src/providers/AgentSdkVoiceModeProvider.d.ts
+interface AgentSdkVoiceModeContextValue extends UseAgentSdkVoiceModeReturn {
   isSupported: boolean;
 }
-interface VoiceModeProviderProps {
+interface AgentSdkVoiceModeProviderProps {
   children: ReactNode;
   /** Backend endpoint for ephemeral tokens */
   tokenEndpoint: string;
-  /** Tools available for voice mode */
+  /** Tools available for voice mode (MCP format) */
   tools?: RegisteredTool[];
   /** Tool executor function */
   toolExecutor?: ToolExecutor;
@@ -872,7 +1187,7 @@ interface VoiceModeProviderProps {
   /** Callback when assistant transcript is complete */
   onAssistantTranscript?: (text: string) => void;
 }
-declare function VoiceModeProvider({
+declare function AgentSdkVoiceModeProvider({
   children,
   tokenEndpoint,
   tools,
@@ -882,15 +1197,31 @@ declare function VoiceModeProvider({
   onError,
   onUserTranscript,
   onAssistantTranscript
-}: VoiceModeProviderProps): react_jsx_runtime0.JSX.Element;
+}: AgentSdkVoiceModeProviderProps): react_jsx_runtime19.JSX.Element;
 /**
- * Hook to access voice mode context
+ * Hook to access Agent SDK voice mode context
  */
-declare function useVoiceModeContext(): VoiceModeContextValue;
+declare function useAgentSdkVoiceModeContext(): AgentSdkVoiceModeContextValue;
 /**
- * Hook to optionally access voice mode context (returns null if not in provider)
+ * Hook to optionally access Agent SDK voice mode context (returns null if not in provider)
  */
-declare function useOptionalVoiceModeContext(): VoiceModeContextValue | null;
+declare function useOptionalAgentSdkVoiceModeContext(): AgentSdkVoiceModeContextValue | null;
+//#endregion
+//#region src/providers/AgentSdkVoiceMCPBridge.d.ts
+interface AgentSdkVoiceMCPBridgeProps {
+  children: ReactNode;
+  tokenEndpoint: string;
+  onError?: (error: string) => void;
+  onConnect?: () => void;
+  onDisconnect?: (duration: number) => void;
+  onUserTranscript?: (text: string) => void;
+  onAssistantTranscript?: (text: string) => void;
+}
+/**
+ * Bridge component that connects MCP tools to AgentSdkVoiceModeProvider.
+ * Uses the MCP context and provides tools + executor to the SDK-based voice mode.
+ */
+declare const AgentSdkVoiceMCPBridge: FC<AgentSdkVoiceMCPBridgeProps>;
 //#endregion
 //#region src/providers/ChatRuntimeProvider.d.ts
 interface ChatRuntimeProviderProps {
@@ -1268,45 +1599,6 @@ declare function shouldFallbackToSSE(error: Error): boolean;
  */
 declare function calculateReconnectDelay(attempt: number, baseDelay: number, maxDelay: number): number;
 //#endregion
-//#region src/lib/constants.d.ts
-/**
- * Shared Constants
- *
- * Centralized location for all magic numbers, timeouts, and configuration values.
- * Having these in one place makes the codebase more maintainable and easier to tune.
- */
-/** Maximum number of reconnection attempts before giving up */
-declare const MCP_MAX_RECONNECT_ATTEMPTS = 5;
-/** Base delay in milliseconds for exponential backoff reconnection */
-declare const MCP_BASE_RECONNECT_DELAY_MS = 1000;
-/** Maximum reconnect delay in milliseconds (caps exponential backoff) */
-declare const MCP_MAX_RECONNECT_DELAY_MS = 30000;
-/** Delay before auto-connecting to tab-based MCP sources (allows server initialization) */
-declare const MCP_TAB_CONNECT_DELAY_MS = 100;
-/** Number of frequency bins for audio visualization */
-declare const AUDIO_FREQUENCY_BINS = 32;
-/** Default OpenAI Realtime model */
-declare const REALTIME_DEFAULT_MODEL = "gpt-4o-realtime-preview-2024-12-17";
-/** Default voice for OpenAI Realtime */
-declare const REALTIME_DEFAULT_VOICE = "verse";
-/** Default OpenAI Realtime API URL */
-declare const REALTIME_DEFAULT_API_URL = "https://api.openai.com/v1/realtime";
-/**
- * Enable debug logging for development.
- * Can be enabled by setting window.__WEBMCP_DEBUG__ = true in the browser console.
- * In production builds, this defaults to false.
- */
-declare const DEBUG_LOGGING_ENABLED: boolean;
-/**
- * Conditional debug logger that only logs when DEBUG_LOGGING_ENABLED is true.
- * Can be enabled at runtime by setting window.__WEBMCP_DEBUG__ = true
- *
- * @param component - The component or service name for the log prefix
- * @param message - The log message
- * @param data - Optional data to include in the log
- */
-declare function debugLog(component: string, message: string, data?: unknown): void;
-//#endregion
 //#region src/embed.d.ts
 /**
  * WebMCP Embedded Agent - Intercom-style Installation
@@ -1394,5 +1686,5 @@ declare global {
   }
 }
 //#endregion
-export { AUDIO_FREQUENCY_BINS, type Action, ActionList, ActionStatusIcon, ActionSummary, AgentPill, type AgentViewMode, AssistantMessage, AssistantModal, type AssistantTranscriptEventData, type AudioLevelData, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, ChatRuntimeProvider, type ChatRuntimeProviderProps, Composer, ComposerAddAttachment, ComposerAttachments, type Conversation, CurrentActivity, DEBUG_LOGGING_ENABLED, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, EmbeddedAgent, type EmbeddedAgentProps, type ErrorEventData, HistorySidebar, IdleIndicator, LiveWaveform, MCPToolRegistry, type MCPToolsContextValue, MCPToolsProvider, type MCPToolsProviderProps, MCP_BASE_RECONNECT_DELAY_MS, MCP_MAX_RECONNECT_ATTEMPTS, MCP_MAX_RECONNECT_DELAY_MS, MCP_TAB_CONNECT_DELAY_MS, MarkdownText, MinimalComposer, OpenAIRealtimeService, PillComposer, PillContainer, type PillMode, REALTIME_DEFAULT_API_URL, REALTIME_DEFAULT_MODEL, REALTIME_DEFAULT_VOICE, type RealtimeConfig, type RealtimeSession, RealtimeToolCard, type RegisteredTool, RemoteMCPSettings, SOURCE_LOCAL, SOURCE_REMOTE, ScrollArea, ScrollBar, Separator, type SessionStateEventData, SummaryBlock, Thread, ThreadWithVoice, type ToolBorderStatus, type ToolCallCompletedEventData, type ToolCallData, type ToolCallStartedEventData, type ToolExecutor, ToolFallback, ToolStatusBorder, Tooltip, TooltipContent, TooltipIconButton, TooltipProvider, TooltipTrigger, type TranscriptData, type TransportType, type UseAgentChatOptions, type UseAgentChatReturn, type UseMCPSourceOptions, type UseMCPSourceReturn, type UseVoiceModeOptions, type UseVoiceModeReturn, UserMessage, UserMessageAttachments, type UserTranscriptEventData, VoiceIndicator, VoiceModeProvider, type VoiceModeProviderProps, type VoiceModeState, WebMCPAgentElement, type WebMCPBootOptions, type WebMCPFunction, type WebMCPMethod, type WebMCPSettings, WelcomeMessage, badgeVariants, buttonVariants, calculateReconnectDelay, cn, convertAssistantUIMessage, convertToAssistantUiMessages, createMCPTransport, debugLog, humanizeToolName, isAssistantTranscriptEventData, isAudioLevelData, isErrorEventData, isSessionStateEventData, isToolCallCompletedEventData, isToolCallStartedEventData, isUserTranscriptEventData, registerWebMCPAgent, shouldFallbackToSSE, useActionStats, useActions, useAgentChat, useAssistantMCP, useCloudflareRuntime, useCurrentAction, useMCPSource, useMCPTools, useOptionalMCPTools, useOptionalVoiceModeContext, useRecentActions, useVoiceMode, useVoiceModeContext };
+export { AUDIO_FREQUENCY_BINS, type Action, ActionList, ActionStatusIcon, ActionSummary, AgentPill, type AgentPillProps, AgentProvider, type AgentProviderProps, AgentSdkVoiceMCPBridge, type AgentSdkVoiceMCPBridgeProps, AgentSdkVoiceModeProvider, type AgentSdkVoiceModeProviderProps, type AgentState, type AgentTools, type AgentViewMode, type AgentVoice, AssistantMessage, AssistantModal, type AssistantTranscriptEventData, type AudioLevelData, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, ChatRuntimeProvider, type ChatRuntimeProviderProps, Composer, ComposerAddAttachment, ComposerAttachments, type Conversation, CurrentActivity, DEBUG_LOGGING_ENABLED, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, EmbeddedAgent, type EmbeddedAgentProps, type ErrorEventData, HistorySidebar, IdleIndicator, LiveWaveform, MCPToolRegistry, type MCPToolsContextValue, MCPToolsProvider, type MCPToolsProviderProps, MCP_BASE_RECONNECT_DELAY_MS, MCP_MAX_RECONNECT_ATTEMPTS, MCP_MAX_RECONNECT_DELAY_MS, MCP_TAB_CONNECT_DELAY_MS, MarkdownText, MinimalComposer, OpenAIRealtimeService, PillComposer, PillContainer, PillMarkdown, type PillMode, type PillPosition, PillVoice, REALTIME_DEFAULT_API_URL, REALTIME_DEFAULT_MODEL, REALTIME_DEFAULT_VOICE, type RealtimeConfig, type RealtimeSession, RealtimeToolCard, type RegisteredTool, RemoteMCPSettings, SOURCE_LOCAL, SOURCE_REMOTE, ScrollArea, ScrollBar, Separator, type SessionStateEventData, SummaryBlock, Thread, ThreadContent, ThreadWithVoice, type ToolBorderStatus, type ToolCallCompletedEventData, type ToolCallData, type ToolCallStartedEventData, type ToolExecutor, ToolFallback, ToolStatusBorder, Tooltip, TooltipContent, TooltipIconButton, TooltipProvider, TooltipTrigger, type TranscriptData, type TransportType, type UseAgentChatOptions, type UseAgentChatReturn, type UseAgentSdkVoiceModeOptions, type UseAgentSdkVoiceModeReturn, type UseMCPSourceOptions, type UseMCPSourceReturn, type UseVoiceModeOptions, type UseVoiceModeReturn, UserMessage, UserMessageAttachments, type UserTranscriptEventData, VOICE_ACTIONS_RETENTION_MS, VOICE_SUMMARY_RETENTION_MS, VoiceIndicator, VoiceModeProvider, type VoiceModeProviderProps, type VoiceModeState, type VoiceSummary, WebMCPAgentElement, type WebMCPBootOptions, type WebMCPFunction, type WebMCPMethod, type WebMCPSettings, WelcomeMessage, badgeVariants, buttonVariants, calculateReconnectDelay, cn, convertAssistantUIMessage, convertToAssistantUiMessages, createMCPTransport, debugLog, humanizeToolName, isAssistantTranscriptEventData, isAudioLevelData, isErrorEventData, isSessionStateEventData, isToolCallCompletedEventData, isToolCallStartedEventData, isUserTranscriptEventData, registerWebMCPAgent, shouldFallbackToSSE, useActionStats, useActions, useAgent, useAgentChat, useAgentSdkVoiceMode, useAgentSdkVoiceModeContext, useAssistantMCP, useCloudflareRuntime, useCurrentAction, useCurrentVoiceAction, useHasVoiceSummary, useIsAgentAvailable, useLatestSummary, useMCPSource, useMCPTools, useOptionalAgentSdkVoiceModeContext, useOptionalMCPTools, useOptionalVoiceModeContext, useRecentActions, useRecentVoiceActions, useVoiceActions, useVoiceBorderStatus, useVoiceMode, useVoiceModeContext, useVoiceSummary };
 //# sourceMappingURL=index.d.ts.map