@page-speed/agent-everywhere 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -2875,6 +2875,158 @@ interface AgentConversationProps {
  */
 declare function AgentConversation({ messages: messagesProp, isLoading: isLoadingProp, header, emptyState, showAvatars, renderMessage, onFeedback, onConfirmAction, autoScroll, className, contentClassName, }: AgentConversationProps): react.JSX.Element;
 
+interface AgentWorkspaceProps {
+    /** The host page content rendered in the center column. */
+    children: ReactNode;
+    leftPanel?: ReactNode;
+    rightPanel?: ReactNode;
+    /** Open width in px. Defaults: left 320, right 460. */
+    leftPanelWidth?: number;
+    rightPanelWidth?: number;
+    /** Initial open state for uncontrolled panels. Default true. */
+    defaultLeftPanelOpen?: boolean;
+    defaultRightPanelOpen?: boolean;
+    /** Controlled open state (pair with the change callback). */
+    leftPanelOpen?: boolean;
+    rightPanelOpen?: boolean;
+    onLeftPanelOpenChange?: (open: boolean) => void;
+    onRightPanelOpenChange?: (open: boolean) => void;
+    /**
+     * Render extra floating panel toggles in the top corners of the center
+     * column. Default false — the persistent workspace header already hosts a
+     * toggle at each end. Mount `<AgentWorkspacePanelToggle/>` in your own
+     * chrome for fully custom placement.
+     */
+    showPanelToggles?: boolean;
+    /**
+     * Show the workspace header bar: left panel toggle, icon + title + status
+     * on the left; `headerActions`, reset, the conversation chevron, and the
+     * right panel toggle on the right. Default true.
+     */
+    showHeader?: boolean;
+    /** @deprecated Use `showHeader`. Honored when `showHeader` is not set. */
+    showConversationHeader?: boolean;
+    /**
+     * Host actions rendered at the start of the header's right action group —
+     * e.g. a "+ New" button that mirrors the page's primary action.
+     */
+    headerActions?: ReactNode;
+    /**
+     * Status line under the title. Defaults to the shared session's
+     * error/status label; pass this when running disconnected (no provider).
+     */
+    headerStatus?: ReactNode;
+    /**
+     * Custom conversation node for the slide-in layer. Defaults to
+     * `<AgentConversation/>` bound to the shared session.
+     */
+    conversation?: ReactNode;
+    /** Controlled visibility for the conversation layer. */
+    conversationOpen?: boolean;
+    onConversationOpenChange?: (open: boolean) => void;
+    /** Title shown in the workspace header. Default "AI Assistant". */
+    conversationTitle?: ReactNode;
+    /**
+     * `false` removes the dock; a ReactNode replaces the default
+     * `<AgentWorkspaceComposer/>`; `true`/omitted renders the default.
+     */
+    composer?: boolean | ReactNode;
+    composerPlaceholder?: string;
+    /** Hint line centered under the input (e.g. grounding/compliance note). */
+    composerHint?: ReactNode;
+    /** Intercept dock submits (the conversation layer still auto-opens). */
+    onComposerSubmit?: (value: string) => void;
+    className?: string;
+    /** The scrollable center content region (under the conversation layer). */
+    contentClassName?: string;
+    conversationClassName?: string;
+    leftPanelClassName?: string;
+    rightPanelClassName?: string;
+    /** The composer dock container. */
+    composerClassName?: string;
+}
+/**
+ * The AI layout wrapper. Composes the native pieces (provider session,
+ * conversation, composer) into a page-level workspace with toggleable side
+ * panels and a sliding center conversation.
+ */
+declare function AgentWorkspace({ children, leftPanel, rightPanel, leftPanelWidth, rightPanelWidth, defaultLeftPanelOpen, defaultRightPanelOpen, leftPanelOpen: leftPanelOpenProp, rightPanelOpen: rightPanelOpenProp, onLeftPanelOpenChange, onRightPanelOpenChange, showPanelToggles, showHeader, showConversationHeader, headerActions, headerStatus, conversation, conversationOpen: conversationOpenProp, onConversationOpenChange, conversationTitle, composer, composerPlaceholder, composerHint, onComposerSubmit, className, contentClassName, conversationClassName, leftPanelClassName, rightPanelClassName, composerClassName, }: AgentWorkspaceProps): react.JSX.Element;
+
+interface AgentWorkspaceComposerProps {
+    /** Controlled draft value. Pair with `onChange` for caller-controlled editing. */
+    value?: string;
+    /** Draft change handler. Presence switches editing to caller-controlled. */
+    onChange?: (value: string) => void;
+    /** Submit handler, receives the current value. Overrides the shared `submit`. */
+    onSubmit?: (value: string) => void;
+    /** Loading state for the send affordance (blocks submit, keeps typing live). */
+    loading?: boolean;
+    /** Force-disable the input. */
+    disabled?: boolean;
+    placeholder?: string;
+    /** Renders a paperclip attach button left of the input when provided. */
+    onAttach?: () => void;
+    /** Custom node(s) left of the textarea. Takes precedence over `onAttach`. */
+    leftActions?: ReactNode;
+    /** Minimum visible rows. Default 1 (grows as the user types). */
+    minRows?: number;
+    /** Maximum rows before the textarea scrolls internally. Default 6. */
+    maxRows?: number;
+    autoFocus?: boolean;
+    className?: string;
+    inputClassName?: string;
+}
+/**
+ * The workspace prompt pill. Renders unpositioned — `<AgentWorkspace>` docks it
+ * at the bottom of the center column, but it works anywhere.
+ */
+declare function AgentWorkspaceComposer({ value: valueProp, onChange, onSubmit, loading: loadingProp, disabled, placeholder, onAttach, leftActions, minRows, maxRows, autoFocus, className, inputClassName, }: AgentWorkspaceComposerProps): react.JSX.Element;
+
+interface AgentWorkspacePanelToggleProps {
+    /** Which panel this button controls. */
+    side: 'left' | 'right';
+    /** Explicit open state (used outside an <AgentWorkspace>). */
+    open?: boolean;
+    /** Explicit toggle handler (used outside an <AgentWorkspace>). */
+    onToggle?: () => void;
+    className?: string;
+}
+/**
+ * Panel visibility toggle button. Place it anywhere inside the workspace (or
+ * pass `open`/`onToggle` to use it standalone).
+ */
+declare function AgentWorkspacePanelToggle({ side, open: openProp, onToggle, className, }: AgentWorkspacePanelToggleProps): react.JSX.Element | null;
+
+interface AgentWorkspaceContextValue {
+    /** Whether a left/right panel slot was provided to the workspace. */
+    hasLeftPanel: boolean;
+    hasRightPanel: boolean;
+    /** Current open state for each side panel. */
+    leftPanelOpen: boolean;
+    rightPanelOpen: boolean;
+    setLeftPanelOpen: (open: boolean) => void;
+    setRightPanelOpen: (open: boolean) => void;
+    toggleLeftPanel: () => void;
+    toggleRightPanel: () => void;
+    /**
+     * Whether the center conversation layer is shown over the page content.
+     * Opens automatically when the shared agent session activates (first submit
+     * or `activate()`), and can be driven programmatically from anywhere inside
+     * the workspace.
+     */
+    conversationOpen: boolean;
+    setConversationOpen: (open: boolean) => void;
+    openConversation: () => void;
+    closeConversation: () => void;
+}
+/**
+ * Workspace state + controls. Throws when used outside `<AgentWorkspace>` so a
+ * mis-mounted control fails loudly during development.
+ */
+declare function useAgentWorkspace(): AgentWorkspaceContextValue;
+/** Nullable variant for components that optionally live inside a workspace. */
+declare function useAgentWorkspaceOptional(): AgentWorkspaceContextValue | null;
+
 interface NativeSurfaceProps {
     /** Conversation content (typically a MessageList). */
     children: React.ReactNode;
@@ -2901,4 +3053,4 @@ interface NativeSurfaceProps {
 }
 declare function NativeSurface({ children, input, title, subtitle, icon, headerActions, suggestions, footer, isLoading, autoScroll, className, contentClassName, }: NativeSurfaceProps): react.JSX.Element;
 
-export { type AgendaItem, type AgendaItemAction, type AgendaItemState, type AgendaSlotOption, type AgentAction, type AgentAttachment, AgentAvatar, type AgentBackend, type AgentBlock, AgentComposer, type AgentComposerProps, type AgentConfig, type AgentContextValue, AgentConversation, type AgentConversationProps, type AgentEvent, type AgentEventType, type AgentFeatures, AgentHandoff, type AgentHandoffProps, type AgentMessage, type AgentPersona, AgentProvider, type AgentProviderProps, type AgentReport, type AgentState, type AgentStreamChunk, AgentSurface, type AgentSurfaceProps, AllocationBreakdown, type AllocationSegment, type AllocationSummaryStat, type AnalyticsBreakdownRow, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDistributionSegment, type AnalyticsHighlight, type AnalyticsMetric, type AnalyticsRankedRow, type AnalyticsRecentItem, type AnalyticsTrend, type AssistantMessageBlocksEnvelope, type AssistantMessageCompleteEnvelope, type AssistantMessageDeltaEnvelope, type AssistantMessageStartEnvelope, type AssistantMessageThinkingDeltaEnvelope, type Attachment, type AttachmentKind, type AttachmentMediaType, type AttachmentType, Avatar, AvatarFallback, AvatarImage, Badge, type BlockUpdateMode, Button, ChartContainer, type ChartData, type ChartDataPoint, type ChartType, type ChatMessageRole, ChatPanel, Collapsible, CollapsibleContent, CollapsibleTrigger, type ComponentCapability, type ComponentCategory, type ComponentManifestEntry, type ComponentSlot, type ConfirmationAction, type ConfirmationActionData, type ConfirmationData, ConfirmationPanel, type ConfirmationPanelProps, type ConnectionReadyEnvelope, type ConnectionState, type ConnectionStrategy, ControlGrid, type ControlTile, type ControlTileType, ConversationAnalytics, ConversationArtifact, type ConversationArtifactProps, type ConversationHistoryItem, type DataPayload, DataPayloadView, DataTable, DynamicRenderer, type EditorAdjustment, type EditorTool, type EmotionScore, type EntityAction, EntityCard, type EntityCardData, type EntityField, type ErrorEnvelope, type ExecutionStep, type ExecutionStepStatus, type FeedbackCategory, type FeedbackSentiment, FileDropZone, FloatingWidget, FullBleedSurface, type FullBleedSurfaceProps, FullscreenDashboard, type GenerateReportOptions, GuidedLessonFlow, type HandoffAction, type HandoffAgent, type HandoffCandidate, type HandoffStatus, type HandoffVariant, ImageGenerator, type InlineSuggestion, InlineSuggestionsInput, Input, type LayoutConfig, type LayoutMode, type LessonStep, type LibraryPrompt, type Listing, type ListingAction, ListingFeed, type ListingField, type ManifestPropSpec, MediaEditorCanvas, MediaGallery, type MediaItem, type MediaKind, MessageActions, MessageBubble, type MessageBubbleProps, MessageContainer, type MessageContainerProps, MessageContent, type MessageContentProps, type MessageFeedback, MessageList, type MessageListProps, type MessageMetadata, type MessageRole, MessageWithAttachments, MessageWithFeedback, MessageWithReasoning, MessageWithSteps, type MetricData, MetricsGrid, MobileShell, type MockBackendConfig, MultimodalInput, type NativeAgentContextValue, NativeAgentProvider, type NativeAgentProviderProps, type NativeAgentStatus, NativeSurface, type NativeSurfaceProps, OnboardingWizard, type OptionCardItem, OptionCards, type OrchestrationCommand, OverlayModal, PerformanceMetrics, PersonaSelector, Progress, ProgressTracker, PromptInput, PromptLibrary, type PromptTemplate, QuickReplies, type QuickReply, QuizCard, type QuizOption, type QuizQuestion, type QuizResult, type ReasoningStatus, type ReasoningStep, type Recommendation, type RecommendationAction, RecommendationCards, type RecommendationTone, type RenderInstruction, type ReportSection, ReportView, ScheduleTimeline, ScrollArea, ScrollBar, type SemanticBuilderChatMessage, SemanticBuilderSocketClient, type SendMessageOptions, type SendOptions, SentimentDisplay, type SentimentScore, type ServerEnvelope, type SettingControl, type SettingsGroup, SettingsPanel, SlotRenderer, type SocketClientOptions, type SocketSendPayload, type SocketUrlResolver, SplitView, StatusBadge, SystemMessage, type TableColumn, type TableData, TemplateSelector, type TemplateVariable, Textarea, type ThemeConfig, Timestamp, type ToolCall, type ToolDefinition, type ToolResult, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TrendDirection, type TrendTone, TypingIndicator, type UseSemanticBuilderOptions, type UseSemanticBuilderResult, type UserMessageEnvelope, type WidgetPosition, WritingAssistant, badgeVariants, buildSocketUrl, buttonVariants, calculatePercentage, cn, componentManifest, componentMap, componentRegistry, copyToClipboard, createMockBackend, debounce, delay, findComponentsByCapability, findComponentsByCategory, findComponentsBySurface, formatBytes, formatCurrency, formatNumber, formatRelativeTime, formatTime, generateId, getInitials, getManifestEntry, getSentimentBgColor, getSentimentColor, isBrowser, isInIframe, normalizeWebsiteId, parseTextWithBold, registerAllComponents, truncate, useAgent, useAgentBackend, useAgentInput, useAgentLayout, useAgentMessages, useNativeAgent, useNativeAgentOptional, useSemanticBuilder };
+export { type AgendaItem, type AgendaItemAction, type AgendaItemState, type AgendaSlotOption, type AgentAction, type AgentAttachment, AgentAvatar, type AgentBackend, type AgentBlock, AgentComposer, type AgentComposerProps, type AgentConfig, type AgentContextValue, AgentConversation, type AgentConversationProps, type AgentEvent, type AgentEventType, type AgentFeatures, AgentHandoff, type AgentHandoffProps, type AgentMessage, type AgentPersona, AgentProvider, type AgentProviderProps, type AgentReport, type AgentState, type AgentStreamChunk, AgentSurface, type AgentSurfaceProps, AgentWorkspace, AgentWorkspaceComposer, type AgentWorkspaceComposerProps, type AgentWorkspaceContextValue, AgentWorkspacePanelToggle, type AgentWorkspacePanelToggleProps, type AgentWorkspaceProps, AllocationBreakdown, type AllocationSegment, type AllocationSummaryStat, type AnalyticsBreakdownRow, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDistributionSegment, type AnalyticsHighlight, type AnalyticsMetric, type AnalyticsRankedRow, type AnalyticsRecentItem, type AnalyticsTrend, type AssistantMessageBlocksEnvelope, type AssistantMessageCompleteEnvelope, type AssistantMessageDeltaEnvelope, type AssistantMessageStartEnvelope, type AssistantMessageThinkingDeltaEnvelope, type Attachment, type AttachmentKind, type AttachmentMediaType, type AttachmentType, Avatar, AvatarFallback, AvatarImage, Badge, type BlockUpdateMode, Button, ChartContainer, type ChartData, type ChartDataPoint, type ChartType, type ChatMessageRole, ChatPanel, Collapsible, CollapsibleContent, CollapsibleTrigger, type ComponentCapability, type ComponentCategory, type ComponentManifestEntry, type ComponentSlot, type ConfirmationAction, type ConfirmationActionData, type ConfirmationData, ConfirmationPanel, type ConfirmationPanelProps, type ConnectionReadyEnvelope, type ConnectionState, type ConnectionStrategy, ControlGrid, type ControlTile, type ControlTileType, ConversationAnalytics, ConversationArtifact, type ConversationArtifactProps, type ConversationHistoryItem, type DataPayload, DataPayloadView, DataTable, DynamicRenderer, type EditorAdjustment, type EditorTool, type EmotionScore, type EntityAction, EntityCard, type EntityCardData, type EntityField, type ErrorEnvelope, type ExecutionStep, type ExecutionStepStatus, type FeedbackCategory, type FeedbackSentiment, FileDropZone, FloatingWidget, FullBleedSurface, type FullBleedSurfaceProps, FullscreenDashboard, type GenerateReportOptions, GuidedLessonFlow, type HandoffAction, type HandoffAgent, type HandoffCandidate, type HandoffStatus, type HandoffVariant, ImageGenerator, type InlineSuggestion, InlineSuggestionsInput, Input, type LayoutConfig, type LayoutMode, type LessonStep, type LibraryPrompt, type Listing, type ListingAction, ListingFeed, type ListingField, type ManifestPropSpec, MediaEditorCanvas, MediaGallery, type MediaItem, type MediaKind, MessageActions, MessageBubble, type MessageBubbleProps, MessageContainer, type MessageContainerProps, MessageContent, type MessageContentProps, type MessageFeedback, MessageList, type MessageListProps, type MessageMetadata, type MessageRole, MessageWithAttachments, MessageWithFeedback, MessageWithReasoning, MessageWithSteps, type MetricData, MetricsGrid, MobileShell, type MockBackendConfig, MultimodalInput, type NativeAgentContextValue, NativeAgentProvider, type NativeAgentProviderProps, type NativeAgentStatus, NativeSurface, type NativeSurfaceProps, OnboardingWizard, type OptionCardItem, OptionCards, type OrchestrationCommand, OverlayModal, PerformanceMetrics, PersonaSelector, Progress, ProgressTracker, PromptInput, PromptLibrary, type PromptTemplate, QuickReplies, type QuickReply, QuizCard, type QuizOption, type QuizQuestion, type QuizResult, type ReasoningStatus, type ReasoningStep, type Recommendation, type RecommendationAction, RecommendationCards, type RecommendationTone, type RenderInstruction, type ReportSection, ReportView, ScheduleTimeline, ScrollArea, ScrollBar, type SemanticBuilderChatMessage, SemanticBuilderSocketClient, type SendMessageOptions, type SendOptions, SentimentDisplay, type SentimentScore, type ServerEnvelope, type SettingControl, type SettingsGroup, SettingsPanel, SlotRenderer, type SocketClientOptions, type SocketSendPayload, type SocketUrlResolver, SplitView, StatusBadge, SystemMessage, type TableColumn, type TableData, TemplateSelector, type TemplateVariable, Textarea, type ThemeConfig, Timestamp, type ToolCall, type ToolDefinition, type ToolResult, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TrendDirection, type TrendTone, TypingIndicator, type UseSemanticBuilderOptions, type UseSemanticBuilderResult, type UserMessageEnvelope, type WidgetPosition, WritingAssistant, badgeVariants, buildSocketUrl, buttonVariants, calculatePercentage, cn, componentManifest, componentMap, componentRegistry, copyToClipboard, createMockBackend, debounce, delay, findComponentsByCapability, findComponentsByCategory, findComponentsBySurface, formatBytes, formatCurrency, formatNumber, formatRelativeTime, formatTime, generateId, getInitials, getManifestEntry, getSentimentBgColor, getSentimentColor, isBrowser, isInIframe, normalizeWebsiteId, parseTextWithBold, registerAllComponents, truncate, useAgent, useAgentBackend, useAgentInput, useAgentLayout, useAgentMessages, useAgentWorkspace, useAgentWorkspaceOptional, useNativeAgent, useNativeAgentOptional, useSemanticBuilder };

package/dist/index.d.ts

@@ -2875,6 +2875,158 @@ interface AgentConversationProps {
  */
 declare function AgentConversation({ messages: messagesProp, isLoading: isLoadingProp, header, emptyState, showAvatars, renderMessage, onFeedback, onConfirmAction, autoScroll, className, contentClassName, }: AgentConversationProps): react.JSX.Element;
 
+interface AgentWorkspaceProps {
+    /** The host page content rendered in the center column. */
+    children: ReactNode;
+    leftPanel?: ReactNode;
+    rightPanel?: ReactNode;
+    /** Open width in px. Defaults: left 320, right 460. */
+    leftPanelWidth?: number;
+    rightPanelWidth?: number;
+    /** Initial open state for uncontrolled panels. Default true. */
+    defaultLeftPanelOpen?: boolean;
+    defaultRightPanelOpen?: boolean;
+    /** Controlled open state (pair with the change callback). */
+    leftPanelOpen?: boolean;
+    rightPanelOpen?: boolean;
+    onLeftPanelOpenChange?: (open: boolean) => void;
+    onRightPanelOpenChange?: (open: boolean) => void;
+    /**
+     * Render extra floating panel toggles in the top corners of the center
+     * column. Default false — the persistent workspace header already hosts a
+     * toggle at each end. Mount `<AgentWorkspacePanelToggle/>` in your own
+     * chrome for fully custom placement.
+     */
+    showPanelToggles?: boolean;
+    /**
+     * Show the workspace header bar: left panel toggle, icon + title + status
+     * on the left; `headerActions`, reset, the conversation chevron, and the
+     * right panel toggle on the right. Default true.
+     */
+    showHeader?: boolean;
+    /** @deprecated Use `showHeader`. Honored when `showHeader` is not set. */
+    showConversationHeader?: boolean;
+    /**
+     * Host actions rendered at the start of the header's right action group —
+     * e.g. a "+ New" button that mirrors the page's primary action.
+     */
+    headerActions?: ReactNode;
+    /**
+     * Status line under the title. Defaults to the shared session's
+     * error/status label; pass this when running disconnected (no provider).
+     */
+    headerStatus?: ReactNode;
+    /**
+     * Custom conversation node for the slide-in layer. Defaults to
+     * `<AgentConversation/>` bound to the shared session.
+     */
+    conversation?: ReactNode;
+    /** Controlled visibility for the conversation layer. */
+    conversationOpen?: boolean;
+    onConversationOpenChange?: (open: boolean) => void;
+    /** Title shown in the workspace header. Default "AI Assistant". */
+    conversationTitle?: ReactNode;
+    /**
+     * `false` removes the dock; a ReactNode replaces the default
+     * `<AgentWorkspaceComposer/>`; `true`/omitted renders the default.
+     */
+    composer?: boolean | ReactNode;
+    composerPlaceholder?: string;
+    /** Hint line centered under the input (e.g. grounding/compliance note). */
+    composerHint?: ReactNode;
+    /** Intercept dock submits (the conversation layer still auto-opens). */
+    onComposerSubmit?: (value: string) => void;
+    className?: string;
+    /** The scrollable center content region (under the conversation layer). */
+    contentClassName?: string;
+    conversationClassName?: string;
+    leftPanelClassName?: string;
+    rightPanelClassName?: string;
+    /** The composer dock container. */
+    composerClassName?: string;
+}
+/**
+ * The AI layout wrapper. Composes the native pieces (provider session,
+ * conversation, composer) into a page-level workspace with toggleable side
+ * panels and a sliding center conversation.
+ */
+declare function AgentWorkspace({ children, leftPanel, rightPanel, leftPanelWidth, rightPanelWidth, defaultLeftPanelOpen, defaultRightPanelOpen, leftPanelOpen: leftPanelOpenProp, rightPanelOpen: rightPanelOpenProp, onLeftPanelOpenChange, onRightPanelOpenChange, showPanelToggles, showHeader, showConversationHeader, headerActions, headerStatus, conversation, conversationOpen: conversationOpenProp, onConversationOpenChange, conversationTitle, composer, composerPlaceholder, composerHint, onComposerSubmit, className, contentClassName, conversationClassName, leftPanelClassName, rightPanelClassName, composerClassName, }: AgentWorkspaceProps): react.JSX.Element;
+
+interface AgentWorkspaceComposerProps {
+    /** Controlled draft value. Pair with `onChange` for caller-controlled editing. */
+    value?: string;
+    /** Draft change handler. Presence switches editing to caller-controlled. */
+    onChange?: (value: string) => void;
+    /** Submit handler, receives the current value. Overrides the shared `submit`. */
+    onSubmit?: (value: string) => void;
+    /** Loading state for the send affordance (blocks submit, keeps typing live). */
+    loading?: boolean;
+    /** Force-disable the input. */
+    disabled?: boolean;
+    placeholder?: string;
+    /** Renders a paperclip attach button left of the input when provided. */
+    onAttach?: () => void;
+    /** Custom node(s) left of the textarea. Takes precedence over `onAttach`. */
+    leftActions?: ReactNode;
+    /** Minimum visible rows. Default 1 (grows as the user types). */
+    minRows?: number;
+    /** Maximum rows before the textarea scrolls internally. Default 6. */
+    maxRows?: number;
+    autoFocus?: boolean;
+    className?: string;
+    inputClassName?: string;
+}
+/**
+ * The workspace prompt pill. Renders unpositioned — `<AgentWorkspace>` docks it
+ * at the bottom of the center column, but it works anywhere.
+ */
+declare function AgentWorkspaceComposer({ value: valueProp, onChange, onSubmit, loading: loadingProp, disabled, placeholder, onAttach, leftActions, minRows, maxRows, autoFocus, className, inputClassName, }: AgentWorkspaceComposerProps): react.JSX.Element;
+
+interface AgentWorkspacePanelToggleProps {
+    /** Which panel this button controls. */
+    side: 'left' | 'right';
+    /** Explicit open state (used outside an <AgentWorkspace>). */
+    open?: boolean;
+    /** Explicit toggle handler (used outside an <AgentWorkspace>). */
+    onToggle?: () => void;
+    className?: string;
+}
+/**
+ * Panel visibility toggle button. Place it anywhere inside the workspace (or
+ * pass `open`/`onToggle` to use it standalone).
+ */
+declare function AgentWorkspacePanelToggle({ side, open: openProp, onToggle, className, }: AgentWorkspacePanelToggleProps): react.JSX.Element | null;
+
+interface AgentWorkspaceContextValue {
+    /** Whether a left/right panel slot was provided to the workspace. */
+    hasLeftPanel: boolean;
+    hasRightPanel: boolean;
+    /** Current open state for each side panel. */
+    leftPanelOpen: boolean;
+    rightPanelOpen: boolean;
+    setLeftPanelOpen: (open: boolean) => void;
+    setRightPanelOpen: (open: boolean) => void;
+    toggleLeftPanel: () => void;
+    toggleRightPanel: () => void;
+    /**
+     * Whether the center conversation layer is shown over the page content.
+     * Opens automatically when the shared agent session activates (first submit
+     * or `activate()`), and can be driven programmatically from anywhere inside
+     * the workspace.
+     */
+    conversationOpen: boolean;
+    setConversationOpen: (open: boolean) => void;
+    openConversation: () => void;
+    closeConversation: () => void;
+}
+/**
+ * Workspace state + controls. Throws when used outside `<AgentWorkspace>` so a
+ * mis-mounted control fails loudly during development.
+ */
+declare function useAgentWorkspace(): AgentWorkspaceContextValue;
+/** Nullable variant for components that optionally live inside a workspace. */
+declare function useAgentWorkspaceOptional(): AgentWorkspaceContextValue | null;
+
 interface NativeSurfaceProps {
     /** Conversation content (typically a MessageList). */
     children: React.ReactNode;
@@ -2901,4 +3053,4 @@ interface NativeSurfaceProps {
 }
 declare function NativeSurface({ children, input, title, subtitle, icon, headerActions, suggestions, footer, isLoading, autoScroll, className, contentClassName, }: NativeSurfaceProps): react.JSX.Element;
 
-export { type AgendaItem, type AgendaItemAction, type AgendaItemState, type AgendaSlotOption, type AgentAction, type AgentAttachment, AgentAvatar, type AgentBackend, type AgentBlock, AgentComposer, type AgentComposerProps, type AgentConfig, type AgentContextValue, AgentConversation, type AgentConversationProps, type AgentEvent, type AgentEventType, type AgentFeatures, AgentHandoff, type AgentHandoffProps, type AgentMessage, type AgentPersona, AgentProvider, type AgentProviderProps, type AgentReport, type AgentState, type AgentStreamChunk, AgentSurface, type AgentSurfaceProps, AllocationBreakdown, type AllocationSegment, type AllocationSummaryStat, type AnalyticsBreakdownRow, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDistributionSegment, type AnalyticsHighlight, type AnalyticsMetric, type AnalyticsRankedRow, type AnalyticsRecentItem, type AnalyticsTrend, type AssistantMessageBlocksEnvelope, type AssistantMessageCompleteEnvelope, type AssistantMessageDeltaEnvelope, type AssistantMessageStartEnvelope, type AssistantMessageThinkingDeltaEnvelope, type Attachment, type AttachmentKind, type AttachmentMediaType, type AttachmentType, Avatar, AvatarFallback, AvatarImage, Badge, type BlockUpdateMode, Button, ChartContainer, type ChartData, type ChartDataPoint, type ChartType, type ChatMessageRole, ChatPanel, Collapsible, CollapsibleContent, CollapsibleTrigger, type ComponentCapability, type ComponentCategory, type ComponentManifestEntry, type ComponentSlot, type ConfirmationAction, type ConfirmationActionData, type ConfirmationData, ConfirmationPanel, type ConfirmationPanelProps, type ConnectionReadyEnvelope, type ConnectionState, type ConnectionStrategy, ControlGrid, type ControlTile, type ControlTileType, ConversationAnalytics, ConversationArtifact, type ConversationArtifactProps, type ConversationHistoryItem, type DataPayload, DataPayloadView, DataTable, DynamicRenderer, type EditorAdjustment, type EditorTool, type EmotionScore, type EntityAction, EntityCard, type EntityCardData, type EntityField, type ErrorEnvelope, type ExecutionStep, type ExecutionStepStatus, type FeedbackCategory, type FeedbackSentiment, FileDropZone, FloatingWidget, FullBleedSurface, type FullBleedSurfaceProps, FullscreenDashboard, type GenerateReportOptions, GuidedLessonFlow, type HandoffAction, type HandoffAgent, type HandoffCandidate, type HandoffStatus, type HandoffVariant, ImageGenerator, type InlineSuggestion, InlineSuggestionsInput, Input, type LayoutConfig, type LayoutMode, type LessonStep, type LibraryPrompt, type Listing, type ListingAction, ListingFeed, type ListingField, type ManifestPropSpec, MediaEditorCanvas, MediaGallery, type MediaItem, type MediaKind, MessageActions, MessageBubble, type MessageBubbleProps, MessageContainer, type MessageContainerProps, MessageContent, type MessageContentProps, type MessageFeedback, MessageList, type MessageListProps, type MessageMetadata, type MessageRole, MessageWithAttachments, MessageWithFeedback, MessageWithReasoning, MessageWithSteps, type MetricData, MetricsGrid, MobileShell, type MockBackendConfig, MultimodalInput, type NativeAgentContextValue, NativeAgentProvider, type NativeAgentProviderProps, type NativeAgentStatus, NativeSurface, type NativeSurfaceProps, OnboardingWizard, type OptionCardItem, OptionCards, type OrchestrationCommand, OverlayModal, PerformanceMetrics, PersonaSelector, Progress, ProgressTracker, PromptInput, PromptLibrary, type PromptTemplate, QuickReplies, type QuickReply, QuizCard, type QuizOption, type QuizQuestion, type QuizResult, type ReasoningStatus, type ReasoningStep, type Recommendation, type RecommendationAction, RecommendationCards, type RecommendationTone, type RenderInstruction, type ReportSection, ReportView, ScheduleTimeline, ScrollArea, ScrollBar, type SemanticBuilderChatMessage, SemanticBuilderSocketClient, type SendMessageOptions, type SendOptions, SentimentDisplay, type SentimentScore, type ServerEnvelope, type SettingControl, type SettingsGroup, SettingsPanel, SlotRenderer, type SocketClientOptions, type SocketSendPayload, type SocketUrlResolver, SplitView, StatusBadge, SystemMessage, type TableColumn, type TableData, TemplateSelector, type TemplateVariable, Textarea, type ThemeConfig, Timestamp, type ToolCall, type ToolDefinition, type ToolResult, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TrendDirection, type TrendTone, TypingIndicator, type UseSemanticBuilderOptions, type UseSemanticBuilderResult, type UserMessageEnvelope, type WidgetPosition, WritingAssistant, badgeVariants, buildSocketUrl, buttonVariants, calculatePercentage, cn, componentManifest, componentMap, componentRegistry, copyToClipboard, createMockBackend, debounce, delay, findComponentsByCapability, findComponentsByCategory, findComponentsBySurface, formatBytes, formatCurrency, formatNumber, formatRelativeTime, formatTime, generateId, getInitials, getManifestEntry, getSentimentBgColor, getSentimentColor, isBrowser, isInIframe, normalizeWebsiteId, parseTextWithBold, registerAllComponents, truncate, useAgent, useAgentBackend, useAgentInput, useAgentLayout, useAgentMessages, useNativeAgent, useNativeAgentOptional, useSemanticBuilder };
+export { type AgendaItem, type AgendaItemAction, type AgendaItemState, type AgendaSlotOption, type AgentAction, type AgentAttachment, AgentAvatar, type AgentBackend, type AgentBlock, AgentComposer, type AgentComposerProps, type AgentConfig, type AgentContextValue, AgentConversation, type AgentConversationProps, type AgentEvent, type AgentEventType, type AgentFeatures, AgentHandoff, type AgentHandoffProps, type AgentMessage, type AgentPersona, AgentProvider, type AgentProviderProps, type AgentReport, type AgentState, type AgentStreamChunk, AgentSurface, type AgentSurfaceProps, AgentWorkspace, AgentWorkspaceComposer, type AgentWorkspaceComposerProps, type AgentWorkspaceContextValue, AgentWorkspacePanelToggle, type AgentWorkspacePanelToggleProps, type AgentWorkspaceProps, AllocationBreakdown, type AllocationSegment, type AllocationSummaryStat, type AnalyticsBreakdownRow, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDistributionSegment, type AnalyticsHighlight, type AnalyticsMetric, type AnalyticsRankedRow, type AnalyticsRecentItem, type AnalyticsTrend, type AssistantMessageBlocksEnvelope, type AssistantMessageCompleteEnvelope, type AssistantMessageDeltaEnvelope, type AssistantMessageStartEnvelope, type AssistantMessageThinkingDeltaEnvelope, type Attachment, type AttachmentKind, type AttachmentMediaType, type AttachmentType, Avatar, AvatarFallback, AvatarImage, Badge, type BlockUpdateMode, Button, ChartContainer, type ChartData, type ChartDataPoint, type ChartType, type ChatMessageRole, ChatPanel, Collapsible, CollapsibleContent, CollapsibleTrigger, type ComponentCapability, type ComponentCategory, type ComponentManifestEntry, type ComponentSlot, type ConfirmationAction, type ConfirmationActionData, type ConfirmationData, ConfirmationPanel, type ConfirmationPanelProps, type ConnectionReadyEnvelope, type ConnectionState, type ConnectionStrategy, ControlGrid, type ControlTile, type ControlTileType, ConversationAnalytics, ConversationArtifact, type ConversationArtifactProps, type ConversationHistoryItem, type DataPayload, DataPayloadView, DataTable, DynamicRenderer, type EditorAdjustment, type EditorTool, type EmotionScore, type EntityAction, EntityCard, type EntityCardData, type EntityField, type ErrorEnvelope, type ExecutionStep, type ExecutionStepStatus, type FeedbackCategory, type FeedbackSentiment, FileDropZone, FloatingWidget, FullBleedSurface, type FullBleedSurfaceProps, FullscreenDashboard, type GenerateReportOptions, GuidedLessonFlow, type HandoffAction, type HandoffAgent, type HandoffCandidate, type HandoffStatus, type HandoffVariant, ImageGenerator, type InlineSuggestion, InlineSuggestionsInput, Input, type LayoutConfig, type LayoutMode, type LessonStep, type LibraryPrompt, type Listing, type ListingAction, ListingFeed, type ListingField, type ManifestPropSpec, MediaEditorCanvas, MediaGallery, type MediaItem, type MediaKind, MessageActions, MessageBubble, type MessageBubbleProps, MessageContainer, type MessageContainerProps, MessageContent, type MessageContentProps, type MessageFeedback, MessageList, type MessageListProps, type MessageMetadata, type MessageRole, MessageWithAttachments, MessageWithFeedback, MessageWithReasoning, MessageWithSteps, type MetricData, MetricsGrid, MobileShell, type MockBackendConfig, MultimodalInput, type NativeAgentContextValue, NativeAgentProvider, type NativeAgentProviderProps, type NativeAgentStatus, NativeSurface, type NativeSurfaceProps, OnboardingWizard, type OptionCardItem, OptionCards, type OrchestrationCommand, OverlayModal, PerformanceMetrics, PersonaSelector, Progress, ProgressTracker, PromptInput, PromptLibrary, type PromptTemplate, QuickReplies, type QuickReply, QuizCard, type QuizOption, type QuizQuestion, type QuizResult, type ReasoningStatus, type ReasoningStep, type Recommendation, type RecommendationAction, RecommendationCards, type RecommendationTone, type RenderInstruction, type ReportSection, ReportView, ScheduleTimeline, ScrollArea, ScrollBar, type SemanticBuilderChatMessage, SemanticBuilderSocketClient, type SendMessageOptions, type SendOptions, SentimentDisplay, type SentimentScore, type ServerEnvelope, type SettingControl, type SettingsGroup, SettingsPanel, SlotRenderer, type SocketClientOptions, type SocketSendPayload, type SocketUrlResolver, SplitView, StatusBadge, SystemMessage, type TableColumn, type TableData, TemplateSelector, type TemplateVariable, Textarea, type ThemeConfig, Timestamp, type ToolCall, type ToolDefinition, type ToolResult, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TrendDirection, type TrendTone, TypingIndicator, type UseSemanticBuilderOptions, type UseSemanticBuilderResult, type UserMessageEnvelope, type WidgetPosition, WritingAssistant, badgeVariants, buildSocketUrl, buttonVariants, calculatePercentage, cn, componentManifest, componentMap, componentRegistry, copyToClipboard, createMockBackend, debounce, delay, findComponentsByCapability, findComponentsByCategory, findComponentsBySurface, formatBytes, formatCurrency, formatNumber, formatRelativeTime, formatTime, generateId, getInitials, getManifestEntry, getSentimentBgColor, getSentimentColor, isBrowser, isInIframe, normalizeWebsiteId, parseTextWithBold, registerAllComponents, truncate, useAgent, useAgentBackend, useAgentInput, useAgentLayout, useAgentMessages, useAgentWorkspace, useAgentWorkspaceOptional, useNativeAgent, useNativeAgentOptional, useSemanticBuilder };