@invergent/agent-chat-react 2.14.3 → 2.15.0

package/dist/index.d.cts

@@ -66,6 +66,13 @@ interface AgentChatMessage {
     errorInfo?: AgentChatErrorInfo;
     images?: AgentChatImageAttachment[];
     attachments?: AgentChatDisplayAttachment[];
+    /**
+     * The per-turn metadata the user message was sent with, as stored on
+     * its event. The whiteboard resolves relational anchors ("latest",
+     * "selection") from the `whiteboard` block at fold time, so it must
+     * survive replay from the event log, not just the live send.
+     */
+    metadata?: Record<string, unknown>;
     llmResponseEventId?: number;
     userFeedback?: {
         rating: "up" | "down";
@@ -458,7 +465,15 @@ interface AgentChatState {
      *  results.  Deduped by sourceId on insertion. */
     researchSources: AgentChatResearchSource[];
 }
-type AgentChatViewMode = "simple" | "expert";
+/**
+ * How the conversation is shown.
+ *
+ * `whiteboard` is a *view* of the same session, not a different kind of
+ * session: the agent gets the draw tool on any turn sent from the
+ * canvas, so switching here never leaves you on a board the agent
+ * cannot draw on.
+ */
+type AgentChatViewMode = "simple" | "expert" | "whiteboard";
 type AgentChatArtifactKind = "markdown" | "table" | "chart" | "html" | "svg" | "image" | "video";
 interface AgentChatArtifactMeta {
     artifact_id: string;
@@ -901,7 +916,9 @@ interface AgentChatRuntimeApi {
     tokenUsage: AgentChatTokenUsage;
     retryIndicator: AgentChatRetryIndicator | null;
     workspaceRefreshKey: number;
-    send(content: string, images?: AgentChatImageAttachment[], attachments?: AgentChatPendingAttachment[]): Promise<void>;
+    send(content: string, images?: AgentChatImageAttachment[], attachments?: AgentChatPendingAttachment[], 
+    /** Free-form per-turn metadata, forwarded verbatim to the adapter. */
+    metadata?: Record<string, unknown>): Promise<void>;
     stop(): Promise<void>;
     retry(): Promise<void>;
     markSending(content: string): void;
@@ -998,6 +1015,14 @@ interface AgentChatProps {
      * Like `deepResearchEnabled`, the host owns the capability gate.
      */
     codeAgentsEnabled?: boolean;
+    /**
+     * Whether this agent may draw on a canvas.
+     *
+     * One half of the gate on the composer's Whiteboard segment; the other
+     * is the session having been created as a board. Like
+     * `deepResearchEnabled`, the host owns this half.
+     */
+    whiteboardEnabled?: boolean;
     /**
      * Slash-command capability group (per-agent). These gate the always-on
      * lightweight builtins and default to shown when omitted, so a host that
@@ -1022,7 +1047,151 @@ interface AgentChatProps {
      */
     onOpenBilling?: () => void;
 }
-declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, browserProfileId, onSelectBrowserProfile, browserProfilesEnabled, deepResearchEnabled, researchEnabled, codeAgentsEnabled, loopsEnabled, missionsEnabled, goalsEnabled, compressEnabled, onOpenIntegrations, onOpenBilling, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, browserProfileId, onSelectBrowserProfile, browserProfilesEnabled, deepResearchEnabled, researchEnabled, codeAgentsEnabled, whiteboardEnabled, loopsEnabled, missionsEnabled, goalsEnabled, compressEnabled, onOpenIntegrations, onOpenBilling, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+
+type WbTool = "pen" | "eraser" | "text" | "slot" | "select" | "pan";
+
+interface AgentWhiteboardProps {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    sessionId: string | null;
+    onSessionChange?: (sessionId: string) => void;
+    /**
+     * Navigate to a session-less board. Without it "New board" cannot
+     * clear the session id, which only the host's router owns.
+     */
+    onNewBoard?: () => void;
+    disabled?: boolean;
+    /**
+     * View-mode switch, when the board is hosted inside `AgentChat`. The
+     * control lives in the chat composer, so without it here the board is
+     * a room with no door back.
+     */
+    viewMode?: AgentChatViewMode;
+    onViewModeChange?: (mode: AgentChatViewMode) => void;
+}
+/**
+ * The board over an existing runtime.
+ *
+ * Split from the standalone export so `AgentChat` can host it on the
+ * runtime it already has: two `useAgentChatRuntime` calls for one
+ * session would open two event streams and double every applied event.
+ */
+interface WhiteboardSurfaceProps extends Omit<AgentWhiteboardProps, "adapter" | "agentId"> {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    runtime: AgentChatRuntimeApi;
+}
+/** The board, standalone: owns its runtime. */
+declare function AgentWhiteboard(props: AgentWhiteboardProps): react_jsx_runtime.JSX.Element;
+declare function WhiteboardSurface({ adapter, agentId, sessionId, onSessionChange, onNewBoard, disabled, viewMode, onViewModeChange, runtime, }: WhiteboardSurfaceProps): react_jsx_runtime.JSX.Element;
+
+interface WbBase {
+    id: string;
+    /**
+     * Source tool-call id, or "local" for the user's own edits. Folding is
+     * keyed on this so a re-delivered event cannot duplicate objects: the
+     * SSE stream and the reconciliation poll both replay the same calls.
+     */
+    origin: string;
+    selected: boolean;
+}
+type WbObject = WbBase & ({
+    kind: "ink";
+    pts: number[];
+    width: number;
+    color: string;
+} | {
+    kind: "draw";
+    origin_: [number, number];
+    types: string[];
+    items: number[][];
+    width?: number;
+    tension?: number;
+    closed?: number[];
+    fill?: number[];
+    arrows?: number[];
+} | {
+    kind: "text";
+    x: number;
+    y: number;
+    text: string;
+    fontSize: number;
+    maxWidth: number;
+    lineHeight: number;
+} | {
+    kind: "formula";
+    x: number;
+    y: number;
+    latex: string;
+    fontSize: number;
+} | {
+    kind: "artifact";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    artifactId: string;
+    version?: number;
+} | {
+    /**
+     * Empty space the user reserved for the answer. The universal
+     * "where": maths (`∫…dx = [slot]`), text (`H [slot] USE`), a
+     * drawing ("the cat goes here"). Filling it removes it.
+     */
+    kind: "slot";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** What the user typed about what belongs here, if anything. */
+    hint?: string;
+} | {
+    kind: "erase";
+    mode: "rect" | "path";
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+    points?: number[][];
+    size?: number;
+});
+/**
+ * What a cluster of the user's ink says, read once and kept.
+ *
+ * Keyed by the exact strokes it covers (see `readingKey`), so adding a
+ * stroke to an expression changes its key and it reads as new -- which
+ * it is: the meaning changed. A reading the user corrected outranks any
+ * the agent produces later.
+ */
+interface WbReading {
+    text: string;
+    source: "agent" | "user";
+    strokeIds: string[];
+}
+interface WbDoc {
+    version: 1;
+    objects: WbObject[];
+    /**
+     * Transcriptions of the user's ink by cluster key. Optional so boards
+     * saved before readings existed still load; absent means "none".
+     */
+    readings?: Record<string, WbReading>;
+    /**
+     * Highest event id folded in. The persistence layer replays only tool
+     * calls newer than this after loading the saved document.
+     */
+    lastEventId: number;
+    /**
+     * Ids of the `whiteboard_draw` calls already applied.
+     *
+     * Kept explicitly rather than derived from the surviving objects'
+     * origins: deleting an object would otherwise erase the only record
+     * that its call had been consumed, and the next load would draw it
+     * again. A deletion has to outlive the thing deleted.
+     */
+    folded: string[];
+}
 
 interface AgentChatAdapterContextValue {
     adapter: AgentChatAdapter;
@@ -1035,6 +1204,20 @@ interface AgentChatAdapterContextValue {
 declare const AgentChatAdapterProvider: react.Provider<AgentChatAdapterContextValue | null>;
 declare function useAgentChatAdapterContext(): AgentChatAdapterContextValue;
 
+/**
+ * Record the Simple/Advanced preference the chat surface reads on mount.
+ *
+ * Exported for hosts that leave the chat surface entirely — the
+ * standalone whiteboard route has no runtime to call `setViewMode` on,
+ * so without this its Simple and Advanced buttons would both land on
+ * whichever mode the chat page happened to be in last, and read as two
+ * buttons doing the same thing.
+ *
+ * Takes only the two transcript modes on purpose: "whiteboard" is a
+ * per-surface choice, not a stored preference, which is why
+ * `readPersistedViewMode` ignores it too.
+ */
+declare function persistChatViewMode(mode: "simple" | "expert"): void;
 declare function useChatViewMode(): "simple" | "expert";
 interface UseAgentChatRuntimeInput {
     adapter: AgentChatAdapter;
@@ -1451,4 +1634,4 @@ interface SessionTreePanelProps {
 }
 declare function SessionTreePanel({ adapter, sessionId, activeSessionId, agentId, title, sessionListLimit, hideRoot, hideHeader, loadList, onSessionSelect, onSessionDelete, }: SessionTreePanelProps): react_jsx_runtime.JSX.Element | null;
 
-export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatBrowserProfile, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatEventsPage, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatIdeaNode, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionEvent, type AgentChatMissionEventSession, type AgentChatMissionEventsPage, type AgentChatMissionList, type AgentChatMissionResearch, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatPolledEvent, type AgentChatProps, type AgentChatResearchRun, type AgentChatResearchSource, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type BorderBeamSize, BrandBeam, type BrandBeamProps, BrowserLiveView, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type CitationSegment, CitationText, type CodingAgentConnection, CodingAgentsPanel, type CodingAgentsPanelProps, ComposioConnectCard, type ComposioConnectCardProps, type ErrorInfo, FetchSseEventStream, type FetchSseEventStreamOptions, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, IntegrationsBand, type IntegrationsBandProps, IntegrationsPage, type IntegrationsPageProps, MISSION_EVENT_CATEGORIES, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionEventCategory, type MissionEventsFeed, type MissionTaskBucket, type MissionTaskRailGroup, type MissionTaskRailGroupKey, MissionsPanel, type MissionsPanelProps, ORB_STATE_LABELS, type OrbActivity, type OrbDerivationOptions, OrbShimmerLabel, type OrbShimmerLabelProps, ResearchSourcesPanel, type RetryIndicator, SIMPLE_MODE_HIDDEN_TOOLS, SIMPLE_MODE_ORB_OPTIONS, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, defaultSelectedMissionTaskId, deriveMissionWorkerActivityLabel, deriveOrbActivity, formatMissionTimestamp, groupMissionTasksByBucket, isHiddenSimpleTool, isTerminalMissionStatus, mergeMissionEvents, messageOrbState, missionEventActorLabel, missionEventCategory, missionEventSummary, missionEventTaskId, missionTaskBlocks, missionTaskBucket, missionTaskRailGroups, missionTaskStatusDotClass, missionTaskTitle, missionWorkerTaskCounts, splitCitations, stripMissionControlMarkup, toolOrbState, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount, useMissionEvents };
+export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatBrowserProfile, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatEventsPage, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatIdeaNode, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionEvent, type AgentChatMissionEventSession, type AgentChatMissionEventsPage, type AgentChatMissionList, type AgentChatMissionResearch, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatPolledEvent, type AgentChatProps, type AgentChatResearchRun, type AgentChatResearchSource, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, AgentWhiteboard, type AgentWhiteboardProps, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type BorderBeamSize, BrandBeam, type BrandBeamProps, BrowserLiveView, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type CitationSegment, CitationText, type CodingAgentConnection, CodingAgentsPanel, type CodingAgentsPanelProps, ComposioConnectCard, type ComposioConnectCardProps, type ErrorInfo, FetchSseEventStream, type FetchSseEventStreamOptions, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, IntegrationsBand, type IntegrationsBandProps, IntegrationsPage, type IntegrationsPageProps, MISSION_EVENT_CATEGORIES, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionEventCategory, type MissionEventsFeed, type MissionTaskBucket, type MissionTaskRailGroup, type MissionTaskRailGroupKey, MissionsPanel, type MissionsPanelProps, ORB_STATE_LABELS, type OrbActivity, type OrbDerivationOptions, OrbShimmerLabel, type OrbShimmerLabelProps, ResearchSourcesPanel, type RetryIndicator, SIMPLE_MODE_HIDDEN_TOOLS, SIMPLE_MODE_ORB_OPTIONS, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WbDoc, type WbObject, type WbTool, WhiteboardSurface, type WhiteboardSurfaceProps, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, defaultSelectedMissionTaskId, deriveMissionWorkerActivityLabel, deriveOrbActivity, formatMissionTimestamp, groupMissionTasksByBucket, isHiddenSimpleTool, isTerminalMissionStatus, mergeMissionEvents, messageOrbState, missionEventActorLabel, missionEventCategory, missionEventSummary, missionEventTaskId, missionTaskBlocks, missionTaskBucket, missionTaskRailGroups, missionTaskStatusDotClass, missionTaskTitle, missionWorkerTaskCounts, persistChatViewMode, splitCitations, stripMissionControlMarkup, toolOrbState, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount, useMissionEvents };

package/dist/index.d.ts

@@ -66,6 +66,13 @@ interface AgentChatMessage {
     errorInfo?: AgentChatErrorInfo;
     images?: AgentChatImageAttachment[];
     attachments?: AgentChatDisplayAttachment[];
+    /**
+     * The per-turn metadata the user message was sent with, as stored on
+     * its event. The whiteboard resolves relational anchors ("latest",
+     * "selection") from the `whiteboard` block at fold time, so it must
+     * survive replay from the event log, not just the live send.
+     */
+    metadata?: Record<string, unknown>;
     llmResponseEventId?: number;
     userFeedback?: {
         rating: "up" | "down";
@@ -458,7 +465,15 @@ interface AgentChatState {
      *  results.  Deduped by sourceId on insertion. */
     researchSources: AgentChatResearchSource[];
 }
-type AgentChatViewMode = "simple" | "expert";
+/**
+ * How the conversation is shown.
+ *
+ * `whiteboard` is a *view* of the same session, not a different kind of
+ * session: the agent gets the draw tool on any turn sent from the
+ * canvas, so switching here never leaves you on a board the agent
+ * cannot draw on.
+ */
+type AgentChatViewMode = "simple" | "expert" | "whiteboard";
 type AgentChatArtifactKind = "markdown" | "table" | "chart" | "html" | "svg" | "image" | "video";
 interface AgentChatArtifactMeta {
     artifact_id: string;
@@ -901,7 +916,9 @@ interface AgentChatRuntimeApi {
     tokenUsage: AgentChatTokenUsage;
     retryIndicator: AgentChatRetryIndicator | null;
     workspaceRefreshKey: number;
-    send(content: string, images?: AgentChatImageAttachment[], attachments?: AgentChatPendingAttachment[]): Promise<void>;
+    send(content: string, images?: AgentChatImageAttachment[], attachments?: AgentChatPendingAttachment[], 
+    /** Free-form per-turn metadata, forwarded verbatim to the adapter. */
+    metadata?: Record<string, unknown>): Promise<void>;
     stop(): Promise<void>;
     retry(): Promise<void>;
     markSending(content: string): void;
@@ -998,6 +1015,14 @@ interface AgentChatProps {
      * Like `deepResearchEnabled`, the host owns the capability gate.
      */
     codeAgentsEnabled?: boolean;
+    /**
+     * Whether this agent may draw on a canvas.
+     *
+     * One half of the gate on the composer's Whiteboard segment; the other
+     * is the session having been created as a board. Like
+     * `deepResearchEnabled`, the host owns this half.
+     */
+    whiteboardEnabled?: boolean;
     /**
      * Slash-command capability group (per-agent). These gate the always-on
      * lightweight builtins and default to shown when omitted, so a host that
@@ -1022,7 +1047,151 @@ interface AgentChatProps {
      */
     onOpenBilling?: () => void;
 }
-declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, browserProfileId, onSelectBrowserProfile, browserProfilesEnabled, deepResearchEnabled, researchEnabled, codeAgentsEnabled, loopsEnabled, missionsEnabled, goalsEnabled, compressEnabled, onOpenIntegrations, onOpenBilling, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ adapter, agentId, sessionId, onSessionChange, onFileSelect, onMessagesChange, disabled, onComposerError, browserProfileId, onSelectBrowserProfile, browserProfilesEnabled, deepResearchEnabled, researchEnabled, codeAgentsEnabled, whiteboardEnabled, loopsEnabled, missionsEnabled, goalsEnabled, compressEnabled, onOpenIntegrations, onOpenBilling, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+
+type WbTool = "pen" | "eraser" | "text" | "slot" | "select" | "pan";
+
+interface AgentWhiteboardProps {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    sessionId: string | null;
+    onSessionChange?: (sessionId: string) => void;
+    /**
+     * Navigate to a session-less board. Without it "New board" cannot
+     * clear the session id, which only the host's router owns.
+     */
+    onNewBoard?: () => void;
+    disabled?: boolean;
+    /**
+     * View-mode switch, when the board is hosted inside `AgentChat`. The
+     * control lives in the chat composer, so without it here the board is
+     * a room with no door back.
+     */
+    viewMode?: AgentChatViewMode;
+    onViewModeChange?: (mode: AgentChatViewMode) => void;
+}
+/**
+ * The board over an existing runtime.
+ *
+ * Split from the standalone export so `AgentChat` can host it on the
+ * runtime it already has: two `useAgentChatRuntime` calls for one
+ * session would open two event streams and double every applied event.
+ */
+interface WhiteboardSurfaceProps extends Omit<AgentWhiteboardProps, "adapter" | "agentId"> {
+    adapter: AgentChatAdapter;
+    agentId?: string;
+    runtime: AgentChatRuntimeApi;
+}
+/** The board, standalone: owns its runtime. */
+declare function AgentWhiteboard(props: AgentWhiteboardProps): react_jsx_runtime.JSX.Element;
+declare function WhiteboardSurface({ adapter, agentId, sessionId, onSessionChange, onNewBoard, disabled, viewMode, onViewModeChange, runtime, }: WhiteboardSurfaceProps): react_jsx_runtime.JSX.Element;
+
+interface WbBase {
+    id: string;
+    /**
+     * Source tool-call id, or "local" for the user's own edits. Folding is
+     * keyed on this so a re-delivered event cannot duplicate objects: the
+     * SSE stream and the reconciliation poll both replay the same calls.
+     */
+    origin: string;
+    selected: boolean;
+}
+type WbObject = WbBase & ({
+    kind: "ink";
+    pts: number[];
+    width: number;
+    color: string;
+} | {
+    kind: "draw";
+    origin_: [number, number];
+    types: string[];
+    items: number[][];
+    width?: number;
+    tension?: number;
+    closed?: number[];
+    fill?: number[];
+    arrows?: number[];
+} | {
+    kind: "text";
+    x: number;
+    y: number;
+    text: string;
+    fontSize: number;
+    maxWidth: number;
+    lineHeight: number;
+} | {
+    kind: "formula";
+    x: number;
+    y: number;
+    latex: string;
+    fontSize: number;
+} | {
+    kind: "artifact";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    artifactId: string;
+    version?: number;
+} | {
+    /**
+     * Empty space the user reserved for the answer. The universal
+     * "where": maths (`∫…dx = [slot]`), text (`H [slot] USE`), a
+     * drawing ("the cat goes here"). Filling it removes it.
+     */
+    kind: "slot";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** What the user typed about what belongs here, if anything. */
+    hint?: string;
+} | {
+    kind: "erase";
+    mode: "rect" | "path";
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+    points?: number[][];
+    size?: number;
+});
+/**
+ * What a cluster of the user's ink says, read once and kept.
+ *
+ * Keyed by the exact strokes it covers (see `readingKey`), so adding a
+ * stroke to an expression changes its key and it reads as new -- which
+ * it is: the meaning changed. A reading the user corrected outranks any
+ * the agent produces later.
+ */
+interface WbReading {
+    text: string;
+    source: "agent" | "user";
+    strokeIds: string[];
+}
+interface WbDoc {
+    version: 1;
+    objects: WbObject[];
+    /**
+     * Transcriptions of the user's ink by cluster key. Optional so boards
+     * saved before readings existed still load; absent means "none".
+     */
+    readings?: Record<string, WbReading>;
+    /**
+     * Highest event id folded in. The persistence layer replays only tool
+     * calls newer than this after loading the saved document.
+     */
+    lastEventId: number;
+    /**
+     * Ids of the `whiteboard_draw` calls already applied.
+     *
+     * Kept explicitly rather than derived from the surviving objects'
+     * origins: deleting an object would otherwise erase the only record
+     * that its call had been consumed, and the next load would draw it
+     * again. A deletion has to outlive the thing deleted.
+     */
+    folded: string[];
+}
 
 interface AgentChatAdapterContextValue {
     adapter: AgentChatAdapter;
@@ -1035,6 +1204,20 @@ interface AgentChatAdapterContextValue {
 declare const AgentChatAdapterProvider: react.Provider<AgentChatAdapterContextValue | null>;
 declare function useAgentChatAdapterContext(): AgentChatAdapterContextValue;
 
+/**
+ * Record the Simple/Advanced preference the chat surface reads on mount.
+ *
+ * Exported for hosts that leave the chat surface entirely — the
+ * standalone whiteboard route has no runtime to call `setViewMode` on,
+ * so without this its Simple and Advanced buttons would both land on
+ * whichever mode the chat page happened to be in last, and read as two
+ * buttons doing the same thing.
+ *
+ * Takes only the two transcript modes on purpose: "whiteboard" is a
+ * per-surface choice, not a stored preference, which is why
+ * `readPersistedViewMode` ignores it too.
+ */
+declare function persistChatViewMode(mode: "simple" | "expert"): void;
 declare function useChatViewMode(): "simple" | "expert";
 interface UseAgentChatRuntimeInput {
     adapter: AgentChatAdapter;
@@ -1451,4 +1634,4 @@ interface SessionTreePanelProps {
 }
 declare function SessionTreePanel({ adapter, sessionId, activeSessionId, agentId, title, sessionListLimit, hideRoot, hideHeader, loadList, onSessionSelect, onSessionDelete, }: SessionTreePanelProps): react_jsx_runtime.JSX.Element | null;
 
-export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatBrowserProfile, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatEventsPage, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatIdeaNode, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionEvent, type AgentChatMissionEventSession, type AgentChatMissionEventsPage, type AgentChatMissionList, type AgentChatMissionResearch, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatPolledEvent, type AgentChatProps, type AgentChatResearchRun, type AgentChatResearchSource, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type BorderBeamSize, BrandBeam, type BrandBeamProps, BrowserLiveView, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type CitationSegment, CitationText, type CodingAgentConnection, CodingAgentsPanel, type CodingAgentsPanelProps, ComposioConnectCard, type ComposioConnectCardProps, type ErrorInfo, FetchSseEventStream, type FetchSseEventStreamOptions, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, IntegrationsBand, type IntegrationsBandProps, IntegrationsPage, type IntegrationsPageProps, MISSION_EVENT_CATEGORIES, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionEventCategory, type MissionEventsFeed, type MissionTaskBucket, type MissionTaskRailGroup, type MissionTaskRailGroupKey, MissionsPanel, type MissionsPanelProps, ORB_STATE_LABELS, type OrbActivity, type OrbDerivationOptions, OrbShimmerLabel, type OrbShimmerLabelProps, ResearchSourcesPanel, type RetryIndicator, SIMPLE_MODE_HIDDEN_TOOLS, SIMPLE_MODE_ORB_OPTIONS, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, defaultSelectedMissionTaskId, deriveMissionWorkerActivityLabel, deriveOrbActivity, formatMissionTimestamp, groupMissionTasksByBucket, isHiddenSimpleTool, isTerminalMissionStatus, mergeMissionEvents, messageOrbState, missionEventActorLabel, missionEventCategory, missionEventSummary, missionEventTaskId, missionTaskBlocks, missionTaskBucket, missionTaskRailGroups, missionTaskStatusDotClass, missionTaskTitle, missionWorkerTaskCounts, splitCitations, stripMissionControlMarkup, toolOrbState, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount, useMissionEvents };
+export { ACTIVE_MISSION_STATUSES, AgentChat, type AgentChatAdapter, type AgentChatAdapterContextValue, AgentChatAdapterProvider, type AgentChatArtifactKind, type AgentChatArtifactMeta, type AgentChatArtifactPayload, type AgentChatAskUserQuestionAnswer, type AgentChatAskUserQuestionArgs, type AgentChatAskUserQuestionChoice, type AgentChatAskUserQuestionQuestion, type AgentChatAttachment, type AgentChatBrowserProfile, type AgentChatChartArtifactSpec, type AgentChatDisplayAttachment, type AgentChatErrorCategory, type AgentChatErrorInfo, type AgentChatEventStream, type AgentChatEventType, type AgentChatEventsPage, type AgentChatExpertFeedbackRating, type AgentChatHtmlArtifactSpec, type AgentChatIdeaNode, type AgentChatImageAttachment, type AgentChatInboxEventStream, type AgentChatInboxItem, type AgentChatInboxKind, type AgentChatInboxList, type AgentChatInboxListInput, type AgentChatInboxStatus, type AgentChatInboxStreamEvent, type AgentChatMarkdownArtifactSpec, type AgentChatMessage, type AgentChatMessageStatus, type AgentChatMissionEvent, type AgentChatMissionEventSession, type AgentChatMissionEventsPage, type AgentChatMissionList, type AgentChatMissionResearch, type AgentChatMissionStatus, type AgentChatMissionSummary, type AgentChatMissionTask, type AgentChatMissionWorker, type AgentChatPendingAttachment, type AgentChatPolledEvent, type AgentChatProps, type AgentChatResearchRun, type AgentChatResearchSource, type AgentChatRole, type AgentChatRuntimeApi, type AgentChatRuntimeEvent, type AgentChatScheduledWorkItem, type AgentChatScheduledWorkKind, type AgentChatScheduledWorkList, type AgentChatSession, type AgentChatSessionList, type AgentChatSessionTree, type AgentChatSessionTreeNode, type AgentChatSlashCommand, type AgentChatSseMessageEvent, type AgentChatState, type AgentChatSvgArtifactSpec, type AgentChatSystemKind, type AgentChatTableArtifactSpec, type AgentChatTokenUsage, type AgentChatToolCallInfo, type AgentChatWorkspaceEntry, type AgentChatWorkspaceFile, type AgentChatWorkspaceTree, type AgentChatWorkspaceUpload, AgentWhiteboard, type AgentWhiteboardProps, type ArtifactKind, type ArtifactPayload, type AskUserQuestionAnswer, type AskUserQuestionArgs, type AskUserQuestionChoice, type AskUserQuestionQuestion, type BorderBeamSize, BrandBeam, type BrandBeamProps, BrowserLiveView, type ChartArtifactSpec, type ChatComposerError, type ChatMessage, type CitationSegment, CitationText, type CodingAgentConnection, CodingAgentsPanel, type CodingAgentsPanelProps, ComposioConnectCard, type ComposioConnectCardProps, type ErrorInfo, FetchSseEventStream, type FetchSseEventStreamOptions, type HtmlArtifactSpec, type InboxItem, type InboxList, InboxPanel, type InboxPanelProps, type InboxUnreadCountState, IntegrationsBand, type IntegrationsBandProps, IntegrationsPage, type IntegrationsPageProps, MISSION_EVENT_CATEGORIES, type MarkdownArtifactSpec, MessageResponse, type MessageResponseProps, MissionDashboard, type MissionDashboardProps, type MissionEventCategory, type MissionEventsFeed, type MissionTaskBucket, type MissionTaskRailGroup, type MissionTaskRailGroupKey, MissionsPanel, type MissionsPanelProps, ORB_STATE_LABELS, type OrbActivity, type OrbDerivationOptions, OrbShimmerLabel, type OrbShimmerLabelProps, ResearchSourcesPanel, type RetryIndicator, SIMPLE_MODE_HIDDEN_TOOLS, SIMPLE_MODE_ORB_OPTIONS, type ScheduledWorkItem, type ScheduledWorkList, ScheduledWorkPanel, type ScheduledWorkPanelProps, type SessionTree, type SessionTreeNode, SessionTreePanel, type SessionTreePanelProps, type SvgArtifactSpec, type TableArtifactSpec, type TokenUsage, type ToolCallInfo, type WbDoc, type WbObject, type WbTool, WhiteboardSurface, type WhiteboardSurfaceProps, type WorkspaceEntry, type WorkspaceFile, type WorkspaceTree, type WorkspaceUpload, defaultSelectedMissionTaskId, deriveMissionWorkerActivityLabel, deriveOrbActivity, formatMissionTimestamp, groupMissionTasksByBucket, isHiddenSimpleTool, isTerminalMissionStatus, mergeMissionEvents, messageOrbState, missionEventActorLabel, missionEventCategory, missionEventSummary, missionEventTaskId, missionTaskBlocks, missionTaskBucket, missionTaskRailGroups, missionTaskStatusDotClass, missionTaskTitle, missionWorkerTaskCounts, persistChatViewMode, splitCitations, stripMissionControlMarkup, toolOrbState, useAgentChatAdapterContext, useAgentChatRuntime, useChatViewMode, useInboxUnreadCount, useMissionEvents };