@athenaintel/react 0.28.1 → 0.32.0

package/dist/index.js

@@ -10,10 +10,13 @@ import { capturePosthogEvent, capturePosthogException, getPosthogCaptureGate, wr
 import { buildCoalescedCaptureProperties, isCriticalPosthogEvent, withCaptureGateBypass } from "./lib/posthog/capture-gate.js";
 import { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaReasoningPart, AthenaUserMessage } from "./chat/AthenaChat.js";
 import { AthenaChatErrorBoundary } from "./chat/AthenaChatErrorBoundary.js";
-import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
+import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
 import { CollapsibleGroup, DEFAULT_TOOLKIT_THEME, SuperGroupingProvider, TOOLKIT_THEMES } from "./chat/super-grouping/CollapsibleGroup.js";
 import { createToolBasedGroupingFunction } from "./chat/super-grouping/grouping-function.js";
 import { SuperGroupingCard, SuperGroupingFinalText, resetRememberedExpansionsForTests, useActivityExpansion } from "./chat/super-grouping/SuperGroupingCard.js";
+import { SuperGroupingTranscript } from "./chat/super-grouping/SuperGroupingTranscript.js";
+import { splitTurnSegments } from "./chat/super-grouping/turn-segments.js";
+import { formatWorkDuration, readTurnTiming, workedDurationMs } from "./chat/super-grouping/turn-timing.js";
 import { defaultGetToolGroupKey } from "./chat/super-grouping/toolkit-map.js";
 import { StatewireApprovalCard } from "./chat/StatewireApprovalCard.js";
 import { useStatewireApprovalRequest } from "./chat/use-statewire-approval-request.js";
@@ -24,6 +27,7 @@ import { useStatewireToolOutputs } from "./provider/statewire-window-context.js"
 import { ATHENA_SDK_MESSAGE_WINDOW, useAthenaStatewireRuntime } from "./runtime/useAthenaStatewireRuntime.js";
 import { StatewireQueuedMessages } from "./chat/StatewireQueuedMessages.js";
 import { StatewireConnectionBanner, StatewireErrorBanner } from "./chat/statewire-banners.js";
+import { RUN_START_REFUSAL_FALLBACK_MESSAGE, StatewireRunRefusalNotice } from "./chat/StatewireRunRefusalNotice.js";
 import { StatewireClientToolBridge } from "./chat/StatewireClientToolBridge.js";
 import { collectStatewireClientTools, statewireClientToolWireEntries } from "./chat/statewire-client-tools.js";
 import { useAthenaStatewireLifecycle } from "./provider/statewire-lifecycle-context.js";
@@ -38,9 +42,10 @@ import { BrowseToolUI, CreateDocumentToolUI, CreateEmailDraftToolUI, CreateNoteb
 import { CopyToolSpecButton, ExpandableSection, ToolCard, normalizeResult, truncate } from "./tools/primitives.js";
 import { InstallPackageToolUI } from "./tools/misc-tool-uis.js";
 import { TOOL_ICONS, toolIcon } from "./tools/tool-icons.js";
-import { HiddenWriteTodosToolUI, WriteTodosToolUI, parseTodoPlan } from "./tools/write-todos-tool-ui.js";
+import { HiddenWriteTodosToolUI, PlanStepMarker, WriteTodosToolUI, parseTodoPlan } from "./tools/write-todos-tool-ui.js";
 import { useLatestTodoPlan } from "./tools/todo-plan-store.js";
-import { EditFileToolUI, ListFilesToolUI, ReadFileToolUI, SearchFilesToolUI, WriteFileToolUI, friendlyWorkspacePath } from "./tools/file-tool-uis.js";
+import { EditFileToolUI, ListFilesToolUI, ReadFileToolUI, SearchFilesToolUI, WriteFileToolUI } from "./tools/file-tool-uis.js";
+import { collectAssetTitles, friendlyWorkspacePath, humanizeToolName, summarizeToolCall } from "./tools/tool-summary.js";
 import { ToolFallback, ToolFallbackAppearanceProvider, ToolFallbackArgs, ToolFallbackContent, ToolFallbackError, ToolFallbackNotice, ToolFallbackResult, ToolFallbackRoot, ToolFallbackTrigger, clearAutoOpenedAssets } from "./tools/tool-fallback.js";
 import { VoiceUpdateCard, VoiceUpdateToolUI } from "./tools/voice-update-tool-ui.js";
 import { VoiceDelegationCard, VoiceDelegationMessage } from "./chat-ui/messages/voice-delegation-card.js";
@@ -53,14 +58,27 @@ import { AthenaAssetEmbed } from "./assets/AthenaAssetEmbed.js";
 import { AssetPanel } from "./assets/AssetPanel.js";
 import { AthenaLayout } from "./assets/AthenaLayout.js";
 import { useAssetPanelStore } from "./assets/asset-panel-store.js";
-import { useAssetEmbed } from "./assets/use-asset-embed.js";
+import { SESSION_WORKBENCH_ASSETS_PANE_ID, SessionWorkbench } from "./workbench/SessionWorkbench.js";
+import { SESSION_WORKSPACE_LIVE_REFETCH_MS, useSessionWorkbench, useSessionWorkbenchWorkspace } from "./workbench/session-workbench-context.js";
+import { DEFAULT_SESSION_WORKBENCH_OPEN_PANE_IDS, DEFAULT_SESSION_WORKBENCH_PANES, SESSION_WORKBENCH_ATTACHMENTS_PANE, SESSION_WORKBENCH_COMPUTER_PANE, SESSION_WORKBENCH_PULL_REQUESTS_PANE, SESSION_WORKBENCH_SHELL_PANE, SESSION_WORKBENCH_TASKS_PANE, SessionAttachmentsPane, SessionComputerPane, SessionPullRequestsPane, SessionShellPane, SessionTasksPane } from "./workbench/session-workbench-panes.js";
+import { SESSION_SANDBOX_LABEL, SHELL_OUTPUT_PREVIEW_CHARS, assetPanelTypeOf, assetTypeLabel, athenaLinkAppUrl, computerStateBadge, deriveShellRows, deriveTaskSteps, filterShellRows, filterWorkbenchPanes, reviewDecisionLabel, shellMachine, taskProgress, toolResultText, workspaceComputers } from "./workbench/session-workbench-model.js";
+import { computerSshAccessPath, computerStatusPath, fetchComputerRuntimeStatus, fetchComputerSshAccess, fetchSessionWorkspace, readComputerRuntimeStatus, readComputerSshAccess, readSessionWorkspace, sessionWorkspacePath } from "./workbench/session-workspace-api.js";
+import { useAthenaComputerSshAccess, useAthenaComputerStatus, useAthenaSessionWorkspace } from "./workbench/use-session-workspace.js";
+import { appendCitationReferenceParams, useAssetEmbed } from "./assets/use-asset-embed.js";
 import { useAthenaConfig } from "./provider/AthenaContext.js";
 import { ThreadList } from "./threads/ThreadList.js";
 import { SessionList } from "./threads/SessionList.js";
+import { mintThreadId } from "./threads/mint-thread-id.js";
 import { useAthenaSessionAttention } from "./threads/use-athena-session-attention.js";
-import { groupSessions, orderedPullRequests, pullRequestChip, pullRequestChipState, sessionIndicator, sessionListGroupOf, sessionOriginLabel, sessionSecondaryLine } from "./threads/session-list-model.js";
+import { SessionsPage } from "./threads/SessionsPage.js";
+import { INBOX_PAGE_SIZE, INBOX_QUERY, INBOX_UNREAD_QUERY, Inbox, InboxButton, useAthenaInboxUnreadCount } from "./threads/Inbox.js";
+import { useAthenaSessions } from "./threads/use-athena-sessions.js";
+import { DEFAULT_COLLAB_CHANNEL, SESSION_RUN_STATUSES, SESSION_SESSION_STATUSES, matchesSessionsQuery, normalizeSessionsQuery, planSessionsQuery, sessionsQueryKey, sortSessions, unavailableSessionsQueryFields } from "./threads/sessions-query.js";
+import { SESSIONS_COLUMNS, agentLabel, channelLabel, creatorLabel, groupSessionsBy, inboxStateChip, sessionStatusChip, sessionsCsv, sessionsFilterChips } from "./threads/sessions-page-model.js";
+import { WEB_APP_ORIGIN_LABEL, groupSessions, orderedPullRequests, pullRequestChip, pullRequestChipState, sessionIndicator, sessionListGroupOf, sessionOriginBadge, sessionOriginLabel, sessionSecondaryLine } from "./threads/session-list-model.js";
 import { AthenaThreadIdContext, useAthenaStatewireThreadId, useAthenaThreadId } from "./threads/thread-id-context.js";
-import { THREAD_TITLE_MAX_LENGTH, archiveThread, createThread, getThreadState, isThreadArchiveUnavailableError, isThreadFavoriteUnavailableError, isThreadRenameUnavailableError, listThreads, renameThread, setThreadFavorite, setThreadReadState } from "./threads/api.js";
+import { useAthenaThreadModel } from "./threads/use-athena-thread-model.js";
+import { THREAD_TITLE_MAX_LENGTH, archiveThread, createThread, dismissThreadFromInbox, getThreadState, isThreadArchiveUnavailableError, isThreadFavoriteUnavailableError, isThreadRenameUnavailableError, listThreads, renameThread, setThreadFavorite, setThreadReadState } from "./threads/api.js";
 import { THREAD_PREFETCH_HOVER_DELAY_MS, THREAD_PREFETCH_MAX_CONCURRENT } from "./threads/thread-prefetcher.js";
 import { conversationDisplayTitle, useRestConversationHistory } from "./threads/use-rest-conversation-history.js";
 import { conversationSummaryFromIndexEntry, useStatewireConversationHistory } from "./threads/use-statewire-conversation-history.js";
@@ -72,28 +90,37 @@ import { createRecordedDictationEngine } from "./dictation/recorded-dictation-en
 import { useAthenaDictationEngine } from "./dictation/use-athena-dictation-engine.js";
 import { DICTATION_STATUSES, composeDictationDraft } from "./dictation/dictation-state.js";
 import { useAppendToComposer } from "./composer/useAppendToComposer.js";
-import { useComposerReady } from "./composer/composer-handoff.js";
+import { useComposerReady, useFocusComposer } from "./composer/composer-handoff.js";
+import { useReadComposerDraft } from "./composer/useReadComposerDraft.js";
 import { useSendMessage } from "./composer/useSendMessage.js";
 import { useComposerAttachment } from "./composer/useComposerAttachment.js";
+import { ChatAgentPicker, ChatModelPicker } from "./catalog/chat-pickers.js";
+import { MODEL_PROVIDER_LABELS, credentialFingerprint, groupModelsByProvider, normalizeAgentCatalog, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaModelCatalog } from "./catalog/runtime-catalog.js";
 import { useFileUpload } from "./composer/useFileUpload.js";
 import { FileUploadButton } from "./composer/FileUploadButton.js";
 import { ComposerDropZone } from "./composer/ComposerDropZone.js";
 import { ComposerQuotePreview } from "./composer/ComposerQuotePreview.js";
-import { useQuote } from "./composer/QuoteContext.js";
+import { QuoteProvider, createQuoteStore, useQuote } from "./composer/QuoteContext.js";
+import { AttachmentProvider, createAttachmentStore, useAttachments } from "./composer/AttachmentContext.js";
 import { useParentAuth, useParentBridge } from "./runtime/auth.js";
 import { DEFAULT_APP_URL, DEFAULT_STATEWIRE_SYNC_URL, createAthenaSpacesUrl, deriveAthenaApiUrl, deriveAthenaAppUrl, deriveStatewireSyncUrl, resolveStatewireSyncUrl } from "./lib/athena-urls.js";
 import { Button, buttonVariants } from "./ui/button.js";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./ui/tooltip.js";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "./ui/collapsible.js";
+import { OwnerDocumentProvider, useIsInPopoutDocument, useOwnerDocument, usePortalContainer } from "./lib/owner-document.js";
+import { SHEET_MAX_COLUMN, SHEET_MAX_ROW, a1AnchorCell, a1RangeBounds, columnLettersToNumber, columnNumberToLetters, formatA1Cell, formatA1Range, parseA1Range, splitSheetPrefix } from "./sheet-range/a1.js";
+import { RANGE_PREVIEW_MAX_COLUMNS, RANGE_PREVIEW_MAX_ROWS, rangePreviewFromCellMap, rangePreviewFromRows, rangePreviewToTableData } from "./sheet-range/range-preview.js";
+import { RangePreviewTable } from "./sheet-range/range-preview-table.js";
 import { Toolkits } from "./toolkits/index.js";
 import { themeToStyleVars, themes } from "./theme/index.js";
-import { HITL_PENDING_RESUME_GRACE_MS, asHitlApproval, isPendingInterrupt, readInterruptMessage } from "./packages/agent-runtime/src/interrupts.js";
-import { classifyToolResult, isToolResultSuccess, resultMessage } from "./packages/agent-runtime/src/tool-result.js";
+import { COLLAB_AGENT_CHANNEL_SESSION_MISMATCH, readRunStartRefusal } from "./agent-runtime/src/errors.js";
+import { HITL_PENDING_RESUME_GRACE_MS, asHitlApproval, isPendingInterrupt, readInterruptMessage } from "./agent-runtime/src/interrupts.js";
+import { classifyToolResult, isToolResultSuccess, resultMessage } from "./agent-runtime/src/tool-result.js";
 import { cn } from "cnfast";
-import { deriveConversationAttention } from "./packages/agent-runtime/src/conversation-list.js";
-import { describeToolArgs, formatToolName, getToolDisplayMeta, toolActiveLabel, toolCompletedLabel } from "./packages/agent-runtime/src/tool-metadata.js";
-import { githubWakeEventLabel, githubWakeMarkerText, isGithubWakeMessage, readGithubWakeEvent } from "./packages/agent-runtime/src/github-wake-event.js";
-import { hasStatewireThreadExtras } from "./packages/agent-runtime/src/thread-extras.js";
+import { deriveConversationAttention } from "./agent-runtime/src/conversation-list.js";
+import { describeToolArgs, formatToolName, getToolDisplayMeta, toolActiveLabel, toolCompletedLabel } from "./agent-runtime/src/tool-metadata.js";
+import { githubWakeEventLabel, githubWakeMarkerText, isGithubWakeMessage, readGithubWakeEvent } from "./agent-runtime/src/github-wake-event.js";
+import { hasStatewireThreadExtras } from "./agent-runtime/src/thread-extras.js";
 import { useToolAppearance } from "./tools/tool-appearance.js";
 export {
   ATHENA_REACT_SDK_VERSION,
@@ -113,10 +140,14 @@ export {
   AthenaSdkError,
   AthenaThreadIdContext,
   AthenaUserMessage,
+  AttachmentProvider,
   BrowseToolUI,
   Button,
+  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,
   COLLAB_AGENT_REF_PREFIX,
   COLLAB_AGENT_REF_SHAPE,
+  ChatAgentPicker,
+  ChatModelPicker,
   Collapsible,
   CollapsibleContent,
   CollapsibleGroup,
@@ -131,6 +162,9 @@ export {
   CreateSheetToolUI,
   DEFAULT_APP_URL,
   DEFAULT_AUTO_OPEN_TOOLS,
+  DEFAULT_COLLAB_CHANNEL,
+  DEFAULT_SESSION_WORKBENCH_OPEN_PANE_IDS,
+  DEFAULT_SESSION_WORKBENCH_PANES,
   DEFAULT_STATEWIRE_MODEL,
   DEFAULT_STATEWIRE_SYNC_URL,
   DEFAULT_TOOLKIT_THEME,
@@ -146,28 +180,64 @@ export {
   GetDatabaseTableSchemaToolUI,
   HITL_PENDING_RESUME_GRACE_MS,
   HiddenWriteTodosToolUI,
+  INBOX_PAGE_SIZE,
+  INBOX_QUERY,
+  INBOX_UNREAD_QUERY,
+  Inbox,
+  InboxButton,
   InstallPackageToolUI,
   ListDatabaseTablesToolUI,
   ListFilesToolUI,
+  MODEL_PROVIDER_LABELS,
   NestedPtcComponentsProvider,
   NestedPtcMessages,
   OpenAssetToolUI,
   OpenBrowserToolUI,
+  OwnerDocumentProvider,
+  PlanStepMarker,
+  QuoteProvider,
+  RANGE_PREVIEW_MAX_COLUMNS,
+  RANGE_PREVIEW_MAX_ROWS,
+  RUN_START_REFUSAL_FALLBACK_MESSAGE,
+  RangePreviewTable,
   ReadAssetToolUI,
   ReadFileToolUI,
   RunPythonCodeToolUI,
   RunSqlToolUI,
+  SESSIONS_COLUMNS,
+  SESSION_RUN_STATUSES,
+  SESSION_SANDBOX_LABEL,
+  SESSION_SESSION_STATUSES,
+  SESSION_WORKBENCH_ASSETS_PANE_ID,
+  SESSION_WORKBENCH_ATTACHMENTS_PANE,
+  SESSION_WORKBENCH_COMPUTER_PANE,
+  SESSION_WORKBENCH_PULL_REQUESTS_PANE,
+  SESSION_WORKBENCH_SHELL_PANE,
+  SESSION_WORKBENCH_TASKS_PANE,
+  SESSION_WORKSPACE_LIVE_REFETCH_MS,
+  SHEET_MAX_COLUMN,
+  SHEET_MAX_ROW,
+  SHELL_OUTPUT_PREVIEW_CHARS,
   SearchFilesToolUI,
+  SessionAttachmentsPane,
+  SessionComputerPane,
   SessionList,
+  SessionPullRequestsPane,
+  SessionShellPane,
+  SessionTasksPane,
+  SessionWorkbench,
+  SessionsPage,
   StatewireApprovalCard,
   StatewireClientToolBridge,
   StatewireConnectionBanner,
   StatewireErrorBanner,
   StatewireHistoryEdge,
   StatewireQueuedMessages,
+  StatewireRunRefusalNotice,
   SuperGroupingCard,
   SuperGroupingFinalText,
   SuperGroupingProvider,
+  SuperGroupingTranscript,
   THREAD_PREFETCH_HOVER_DELAY_MS,
   THREAD_PREFETCH_MAX_CONCURRENT,
   THREAD_TITLE_MAX_LENGTH,
@@ -198,6 +268,7 @@ export {
   VoiceDelegationMessage,
   VoiceUpdateCard,
   VoiceUpdateToolUI,
+  WEB_APP_ORIGIN_LABEL,
   WaitingOnYouBanner,
   WaitingOnYouBannerView,
   WakeMarkerCard,
@@ -205,9 +276,16 @@ export {
   WebSearchToolUI,
   WriteFileToolUI,
   WriteTodosToolUI,
+  a1AnchorCell,
+  a1RangeBounds,
+  agentLabel,
+  appendCitationReferenceParams,
   archiveThread,
   asHitlApproval,
+  assetPanelTypeOf,
+  assetTypeLabel,
   athenaDiagnostics,
+  athenaLinkAppUrl,
   athenaStatewireErrorNotice,
   buildActivityTimeline,
   buildCoalescedCaptureProperties,
@@ -215,43 +293,72 @@ export {
   buttonVariants,
   capturePosthogEvent,
   capturePosthogException,
+  channelLabel,
   classifyToolResult,
   clearAutoOpenedAssets,
   cn,
+  collectAssetTitles,
   collectStatewireClientTools,
+  columnLettersToNumber,
+  columnNumberToLetters,
   composeDictationDraft,
+  computerSshAccessPath,
+  computerStateBadge,
+  computerStatusPath,
   conversationDisplayTitle,
   conversationSummaryFromIndexEntry,
   countActivityTools,
   createAssetToolUI,
   createAthenaSpacesUrl,
+  createAttachmentStore,
+  createQuoteStore,
   createRecordedDictationEngine,
   createThread,
   createToolBasedGroupingFunction,
   createWebSpeechDictationEngine,
+  creatorLabel,
+  credentialFingerprint,
   defaultGetToolGroupKey,
   deriveAthenaApiUrl,
   deriveAthenaAppUrl,
   deriveConversationAttention,
+  deriveShellRows,
   deriveStatewireSyncUrl,
+  deriveTaskSteps,
   describeToolArgs,
+  dismissThreadFromInbox,
   excludeFinalTextFromGroups,
+  excludePartsFromGroups,
+  fetchComputerRuntimeStatus,
+  fetchComputerSshAccess,
   fetchRepoSearch,
+  fetchSessionWorkspace,
+  filterShellRows,
+  filterWorkbenchPanes,
+  formatA1Cell,
+  formatA1Range,
   formatToolName,
+  formatWorkDuration,
   friendlyWorkspacePath,
   getActivityItemLabel,
   getActivitySummary,
   getActivityToolState,
   getAssetInfo,
   getFinalText,
+  getFinalTextParts,
   getPostHogInstance,
   getPosthogCaptureGate,
+  getReasoningLabel,
   getThreadState,
   getToolDisplayMeta,
   githubWakeEventLabel,
   githubWakeMarkerText,
+  groupModelsByProvider,
   groupSessions,
+  groupSessionsBy,
   hasStatewireThreadExtras,
+  humanizeToolName,
+  inboxStateChip,
   installAthenaDiagnosticsGlobal,
   isAthenaCitationUrl,
   isAthenaSdkError,
@@ -263,31 +370,60 @@ export {
   isThreadRenameUnavailableError,
   isToolResultSuccess,
   listThreads,
+  matchesSessionsQuery,
+  mintThreadId,
+  normalizeAgentCatalog,
+  normalizeModelCatalog,
   normalizeResult,
+  normalizeSessionsQuery,
   orderedPullRequests,
+  parseA1Range,
   parseAthenaCitationLink,
   parseCollabAgentRef,
   parseTodoPlan,
+  planSessionsQuery,
   pullRequestChip,
   pullRequestChipState,
+  rangePreviewFromCellMap,
+  rangePreviewFromRows,
+  rangePreviewToTableData,
+  readComputerRuntimeStatus,
+  readComputerSshAccess,
   readGithubWakeEvent,
   readInterruptMessage,
   readRejectionDetail,
+  readRunStartRefusal,
+  readSessionWorkspace,
+  readTurnTiming,
   renameThread,
   repoSearchRequestBody,
   resetAssetAutoOpen,
   resetRememberedExpansionsForTests,
   resolveActivityPhase,
   resolveAgentProp,
+  resolveCatalogModelId,
   resolveStatewireSyncUrl,
   resultMessage,
+  reviewDecisionLabel,
   sessionIndicator,
   sessionListGroupOf,
+  sessionOriginBadge,
   sessionOriginLabel,
   sessionSecondaryLine,
+  sessionStatusChip,
+  sessionWorkspacePath,
+  sessionsCsv,
+  sessionsFilterChips,
+  sessionsQueryKey,
   setThreadFavorite,
   setThreadReadState,
+  shellMachine,
+  sortSessions,
+  splitSheetPrefix,
+  splitTurnSegments,
   statewireClientToolWireEntries,
+  summarizeToolCall,
+  taskProgress,
   themeToStyleVars,
   themes,
   threadSummaryFromConversation,
@@ -295,43 +431,63 @@ export {
   toolActiveLabel,
   toolCompletedLabel,
   toolIcon,
+  toolResultText,
   truncate,
   tryParseJson,
+  unavailableSessionsQueryFields,
   useActivityExpansion,
   useAppendToComposer,
   useAssetEmbed,
   useAssetPanelStore,
+  useAthenaAgentCatalog,
   useAthenaCitationLinkHandler,
+  useAthenaComputerSshAccess,
+  useAthenaComputerStatus,
   useAthenaConfig,
   useAthenaDiagnostics,
   useAthenaDictationEngine,
+  useAthenaInboxUnreadCount,
   useAthenaLinkClickHandler,
+  useAthenaModelCatalog,
   useAthenaRepoSearch,
   useAthenaRunLive,
   useAthenaSessionAttention,
+  useAthenaSessionWorkspace,
+  useAthenaSessions,
   useAthenaStatewireLifecycle,
   useAthenaStatewireRuntime,
   useAthenaStatewireThreadId,
   useAthenaStatewireThreadList,
   useAthenaThreadId,
   useAthenaThreadManager,
+  useAthenaThreadModel,
+  useAttachments,
   useComposerAttachment,
   useComposerReady,
   useDictation,
   useFileUpload,
+  useFocusComposer,
+  useIsInPopoutDocument,
   useLatestTodoPlan,
   useNestedPtcComponents,
+  useOwnerDocument,
   useParentAuth,
   useParentBridge,
+  usePortalContainer,
   useQuote,
+  useReadComposerDraft,
   useRefreshThreadList,
   useRestConversationHistory,
   useSendMessage,
+  useSessionWorkbench,
+  useSessionWorkbenchWorkspace,
   useStatewireApprovalRequest,
   useStatewireConversationHistory,
   useStatewireToolOutputs,
   useToolAppearance,
   withCaptureGateBypass,
+  workedDurationMs,
+  workspaceComputers,
   wrapPosthogClient
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/lib/owner-document.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const OwnerDocumentContext = react.createContext(null);
+function OwnerDocumentProvider({ document: doc, children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(OwnerDocumentContext.Provider, { value: doc, children });
+}
+function useOwnerDocument() {
+  const provided = react.useContext(OwnerDocumentContext);
+  if (provided) return provided;
+  return typeof document !== "undefined" ? document : null;
+}
+function useIsInPopoutDocument() {
+  const provided = react.useContext(OwnerDocumentContext);
+  return provided !== null && typeof document !== "undefined" && provided !== document;
+}
+function usePortalContainer() {
+  const provided = react.useContext(OwnerDocumentContext);
+  return react.useMemo(() => {
+    var _a;
+    if (!provided) return void 0;
+    if (typeof document !== "undefined" && provided === document) return void 0;
+    if ((_a = provided.defaultView) == null ? void 0 : _a.closed) return void 0;
+    return provided.body;
+  }, [provided]);
+}
+exports.OwnerDocumentProvider = OwnerDocumentProvider;
+exports.useIsInPopoutDocument = useIsInPopoutDocument;
+exports.useOwnerDocument = useOwnerDocument;
+exports.usePortalContainer = usePortalContainer;
+//# sourceMappingURL=owner-document.cjs.map

package/dist/lib/owner-document.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-document.cjs","sources":["../../src/lib/owner-document.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, type ReactNode, useContext, useMemo } from 'react';\n\n/**\n * Which browser document a component is rendered into.\n *\n * A host pops a pane out by portaling it into a second browser window (Olympus's\n * Spaces popouts, a desktop shell's pop-out windows): the React tree keeps\n * running in the main window while its DOM lives in the popout's document.\n * Anything that reaches for the global `document` then talks to the wrong\n * window — most visibly Radix/shadcn portals, which mount menus, dialogs and\n * tooltips into the MAIN window's body while their trigger sits in the popout.\n *\n * `OwnerDocumentProvider` is mounted by the host around every popped-out\n * subtree (Olympus's Spaces popout frame wraps every tab and the popout\n * window's own layout chrome). The SDK's own portaled UI (popover, tooltip,\n * the composer's mention menu) and the host's portals read the same context.\n * In the main window nothing is provided and the hooks fall back to the\n * globals, with `usePortalContainer()` returning `undefined` so every library\n * keeps its default container.\n */\nconst OwnerDocumentContext = createContext<Document | null>(null);\n\nexport interface OwnerDocumentProviderProps {\n  /** The document hosting this subtree; `null` for the main window. */\n  document: Document | null;\n  children: ReactNode;\n}\n\nexport function OwnerDocumentProvider({ document: doc, children }: OwnerDocumentProviderProps) {\n  return <OwnerDocumentContext.Provider value={doc}>{children}</OwnerDocumentContext.Provider>;\n}\n\n/** The document this subtree renders into, or the global document when not in a popout. */\nexport function useOwnerDocument(): Document | null {\n  const provided = useContext(OwnerDocumentContext);\n  if (provided) return provided;\n  return typeof document !== 'undefined' ? document : null;\n}\n\n/** `true` when the subtree is hosted by a popout window rather than the main document. */\nexport function useIsInPopoutDocument(): boolean {\n  const provided = useContext(OwnerDocumentContext);\n  return provided !== null && typeof document !== 'undefined' && provided !== document;\n}\n\n/**\n * The `container` to hand a portal so it opens in the window its trigger is\n * in: the popout's `body`, or `undefined` in the main window so the library\n * default applies. Guards against a since-closed popout window.\n */\nexport function usePortalContainer(): HTMLElement | undefined {\n  const provided = useContext(OwnerDocumentContext);\n  return useMemo(() => {\n    if (!provided) return undefined;\n    if (typeof document !== 'undefined' && provided === document) return undefined;\n    if (provided.defaultView?.closed) return undefined;\n    return provided.body;\n  }, [provided]);\n}\n"],"names":["createContext","useContext","useMemo"],"mappings":";;;;AAsBA,MAAM,uBAAuBA,MAAAA,cAA+B,IAAI;AAQzD,SAAS,sBAAsB,EAAE,UAAU,KAAK,YAAwC;AAC7F,wCAAQ,qBAAqB,UAArB,EAA8B,OAAO,KAAM,UAAS;AAC9D;AAGO,SAAS,mBAAoC;AAClD,QAAM,WAAWC,MAAAA,WAAW,oBAAoB;AAChD,MAAI,SAAU,QAAO;AACrB,SAAO,OAAO,aAAa,cAAc,WAAW;AACtD;AAGO,SAAS,wBAAiC;AAC/C,QAAM,WAAWA,MAAAA,WAAW,oBAAoB;AAChD,SAAO,aAAa,QAAQ,OAAO,aAAa,eAAe,aAAa;AAC9E;AAOO,SAAS,qBAA8C;AAC5D,QAAM,WAAWA,MAAAA,WAAW,oBAAoB;AAChD,SAAOC,MAAAA,QAAQ,MAAM;;AACnB,QAAI,CAAC,SAAU,QAAO;AACtB,QAAI,OAAO,aAAa,eAAe,aAAa,SAAU,QAAO;AACrE,SAAI,cAAS,gBAAT,mBAAsB,OAAQ,QAAO;AACzC,WAAO,SAAS;AAAA,EAClB,GAAG,CAAC,QAAQ,CAAC;AACf;;;;;"}

package/dist/lib/owner-document.d.ts

@@ -0,0 +1,17 @@
+import { type ReactNode } from 'react';
+export interface OwnerDocumentProviderProps {
+    /** The document hosting this subtree; `null` for the main window. */
+    document: Document | null;
+    children: ReactNode;
+}
+export declare function OwnerDocumentProvider({ document: doc, children }: OwnerDocumentProviderProps): import("react").JSX.Element;
+/** The document this subtree renders into, or the global document when not in a popout. */
+export declare function useOwnerDocument(): Document | null;
+/** `true` when the subtree is hosted by a popout window rather than the main document. */
+export declare function useIsInPopoutDocument(): boolean;
+/**
+ * The `container` to hand a portal so it opens in the window its trigger is
+ * in: the popout's `body`, or `undefined` in the main window so the library
+ * default applies. Guards against a since-closed popout window.
+ */
+export declare function usePortalContainer(): HTMLElement | undefined;

package/dist/lib/owner-document.js

@@ -0,0 +1,32 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+const OwnerDocumentContext = createContext(null);
+function OwnerDocumentProvider({ document: doc, children }) {
+  return /* @__PURE__ */ jsx(OwnerDocumentContext.Provider, { value: doc, children });
+}
+function useOwnerDocument() {
+  const provided = useContext(OwnerDocumentContext);
+  if (provided) return provided;
+  return typeof document !== "undefined" ? document : null;
+}
+function useIsInPopoutDocument() {
+  const provided = useContext(OwnerDocumentContext);
+  return provided !== null && typeof document !== "undefined" && provided !== document;
+}
+function usePortalContainer() {
+  const provided = useContext(OwnerDocumentContext);
+  return useMemo(() => {
+    var _a;
+    if (!provided) return void 0;
+    if (typeof document !== "undefined" && provided === document) return void 0;
+    if ((_a = provided.defaultView) == null ? void 0 : _a.closed) return void 0;
+    return provided.body;
+  }, [provided]);
+}
+export {
+  OwnerDocumentProvider,
+  useIsInPopoutDocument,
+  useOwnerDocument,
+  usePortalContainer
+};
+//# sourceMappingURL=owner-document.js.map

package/dist/lib/owner-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-document.js","sources":["../../src/lib/owner-document.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, type ReactNode, useContext, useMemo } from 'react';\n\n/**\n * Which browser document a component is rendered into.\n *\n * A host pops a pane out by portaling it into a second browser window (Olympus's\n * Spaces popouts, a desktop shell's pop-out windows): the React tree keeps\n * running in the main window while its DOM lives in the popout's document.\n * Anything that reaches for the global `document` then talks to the wrong\n * window — most visibly Radix/shadcn portals, which mount menus, dialogs and\n * tooltips into the MAIN window's body while their trigger sits in the popout.\n *\n * `OwnerDocumentProvider` is mounted by the host around every popped-out\n * subtree (Olympus's Spaces popout frame wraps every tab and the popout\n * window's own layout chrome). The SDK's own portaled UI (popover, tooltip,\n * the composer's mention menu) and the host's portals read the same context.\n * In the main window nothing is provided and the hooks fall back to the\n * globals, with `usePortalContainer()` returning `undefined` so every library\n * keeps its default container.\n */\nconst OwnerDocumentContext = createContext<Document | null>(null);\n\nexport interface OwnerDocumentProviderProps {\n  /** The document hosting this subtree; `null` for the main window. */\n  document: Document | null;\n  children: ReactNode;\n}\n\nexport function OwnerDocumentProvider({ document: doc, children }: OwnerDocumentProviderProps) {\n  return <OwnerDocumentContext.Provider value={doc}>{children}</OwnerDocumentContext.Provider>;\n}\n\n/** The document this subtree renders into, or the global document when not in a popout. */\nexport function useOwnerDocument(): Document | null {\n  const provided = useContext(OwnerDocumentContext);\n  if (provided) return provided;\n  return typeof document !== 'undefined' ? document : null;\n}\n\n/** `true` when the subtree is hosted by a popout window rather than the main document. */\nexport function useIsInPopoutDocument(): boolean {\n  const provided = useContext(OwnerDocumentContext);\n  return provided !== null && typeof document !== 'undefined' && provided !== document;\n}\n\n/**\n * The `container` to hand a portal so it opens in the window its trigger is\n * in: the popout's `body`, or `undefined` in the main window so the library\n * default applies. Guards against a since-closed popout window.\n */\nexport function usePortalContainer(): HTMLElement | undefined {\n  const provided = useContext(OwnerDocumentContext);\n  return useMemo(() => {\n    if (!provided) return undefined;\n    if (typeof document !== 'undefined' && provided === document) return undefined;\n    if (provided.defaultView?.closed) return undefined;\n    return provided.body;\n  }, [provided]);\n}\n"],"names":[],"mappings":";;AAsBA,MAAM,uBAAuB,cAA+B,IAAI;AAQzD,SAAS,sBAAsB,EAAE,UAAU,KAAK,YAAwC;AAC7F,6BAAQ,qBAAqB,UAArB,EAA8B,OAAO,KAAM,UAAS;AAC9D;AAGO,SAAS,mBAAoC;AAClD,QAAM,WAAW,WAAW,oBAAoB;AAChD,MAAI,SAAU,QAAO;AACrB,SAAO,OAAO,aAAa,cAAc,WAAW;AACtD;AAGO,SAAS,wBAAiC;AAC/C,QAAM,WAAW,WAAW,oBAAoB;AAChD,SAAO,aAAa,QAAQ,OAAO,aAAa,eAAe,aAAa;AAC9E;AAOO,SAAS,qBAA8C;AAC5D,QAAM,WAAW,WAAW,oBAAoB;AAChD,SAAO,QAAQ,MAAM;;AACnB,QAAI,CAAC,SAAU,QAAO;AACtB,QAAI,OAAO,aAAa,eAAe,aAAa,SAAU,QAAO;AACrE,SAAI,cAAS,gBAAT,mBAAsB,OAAQ,QAAO;AACzC,WAAO,SAAS;AAAA,EAClB,GAAG,CAAC,QAAQ,CAAC;AACf;"}

package/dist/lib/portal-surface.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const cnfast = require("cnfast");
+const SURFACES = {
+  popover: [
+    { property: "display", value: "block", utility: "block" },
+    { property: "backgroundColor", value: "var(--popover)", utility: "bg-popover" },
+    { property: "color", value: "var(--popover-foreground)", utility: "text-popover-foreground" },
+    { property: "borderColor", value: "var(--border)", utility: "border-border" }
+  ],
+  tooltip: [
+    { property: "display", value: "block", utility: "block" },
+    { property: "backgroundColor", value: "var(--foreground)", utility: "bg-foreground" },
+    { property: "color", value: "var(--background)", utility: "text-background" }
+  ]
+};
+function utilityOf(token) {
+  let depth = 0;
+  let start = 0;
+  for (let index = 0; index < token.length; index += 1) {
+    const char = token[index];
+    if (char === "[" || char === "(") depth += 1;
+    else if (char === "]" || char === ")") depth -= 1;
+    else if (char === ":" && depth === 0) start = index + 1;
+  }
+  return token.slice(start).replace(/^!|!$/g, "");
+}
+function callerSets(className, utility) {
+  if (!className) return false;
+  return className.split(/\s+/).some((token) => {
+    const base = utilityOf(token);
+    if (!base || base === utility) return false;
+    return !cnfast.cn(utility, base).split(" ").includes(utility) || !cnfast.cn(base, utility).split(" ").includes(base);
+  });
+}
+function portalSurfaceStyle({
+  surface,
+  className,
+  themeStyle,
+  style
+}) {
+  const defaults = {};
+  for (const { property, value, utility } of SURFACES[surface]) {
+    if (!callerSets(className, utility)) defaults[property] = value;
+  }
+  return {
+    ...defaults,
+    // The wrapper's `.athena-themed` sets the theme's face; a portal root sets it here.
+    ...themeStyle ? { fontFamily: "var(--font-family, inherit)" } : {},
+    ...themeStyle,
+    ...style
+  };
+}
+exports.portalSurfaceStyle = portalSurfaceStyle;
+//# sourceMappingURL=portal-surface.cjs.map

package/dist/lib/portal-surface.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-surface.cjs","sources":["../../src/lib/portal-surface.ts"],"sourcesContent":["import type { CSSProperties } from 'react';\nimport { cn } from './utils';\n\n/** The look of a portaled root: a popover-like panel, or a tooltip. */\nexport type PortalSurface = 'popover' | 'tooltip';\n\n/** An inline default, with the utility class of the root's own class list it stands in for. */\ninterface SurfaceDefault {\n  property: 'display' | 'backgroundColor' | 'color' | 'borderColor';\n  value: string;\n  utility: string;\n}\n\nconst SURFACES: Record<PortalSurface, readonly SurfaceDefault[]> = {\n  popover: [\n    { property: 'display', value: 'block', utility: 'block' },\n    { property: 'backgroundColor', value: 'var(--popover)', utility: 'bg-popover' },\n    { property: 'color', value: 'var(--popover-foreground)', utility: 'text-popover-foreground' },\n    { property: 'borderColor', value: 'var(--border)', utility: 'border-border' },\n  ],\n  tooltip: [\n    { property: 'display', value: 'block', utility: 'block' },\n    { property: 'backgroundColor', value: 'var(--foreground)', utility: 'bg-foreground' },\n    { property: 'color', value: 'var(--background)', utility: 'text-background' },\n  ],\n};\n\n/** A class without its variants (`hover:`, `dark:`, `data-[state=open]:`) and `!` marks. */\nfunction utilityOf(token: string): string {\n  let depth = 0;\n  let start = 0;\n  for (let index = 0; index < token.length; index += 1) {\n    const char = token[index];\n    if (char === '[' || char === '(') depth += 1;\n    else if (char === ']' || char === ')') depth -= 1;\n    else if (char === ':' && depth === 0) start = index + 1;\n  }\n  return token.slice(start).replace(/^!|!$/g, '');\n}\n\n/**\n * Whether the caller's classes set what `utility` sets, at any variant: a class\n * `cn` would let replace it, or that it would replace (`border-x-red-500`\n * against `border-border`). `cn` already resolves the class list this way.\n */\nfunction callerSets(className: string | undefined, utility: string): boolean {\n  if (!className) return false;\n  return className.split(/\\s+/).some((token) => {\n    const base = utilityOf(token);\n    if (!base || base === utility) return false;\n    return !cn(utility, base).split(' ').includes(utility) || !cn(base, utility).split(' ').includes(base);\n  });\n}\n\n/**\n * The inline style of SDK content portaled outside the provider wrapper —\n * tooltips, popovers, the composer's pickers — so it draws its own box and\n * colours in any host.\n *\n * Portaled content renders under the host's `document.body`, inside the host's\n * stylesheet, carrying the SDK's scope classes for its tokens. Stylesheet rules\n * alone cannot be trusted there:\n *\n * - `.athena-sdk` (the tokens) is `display: contents`, its role on the\n *   provider wrapper, and `.athena-themed` is too, unlayered — content without\n *   a box draws no background, padding or radius.\n * - A host whose Tailwind theme writes the same utilities against tokens of\n *   another format (`bg-popover` as `hsl(var(--popover))`, shadcn's HSL\n *   channels; Athena's own desktop app) emits them unlayered, beating the\n *   SDK's layered utilities, and `hsl()` of the SDK's full colours is invalid:\n *   a transparent menu over the page.\n *\n * An inline style beats every stylesheet rule, and its `var(--…)` references\n * resolve against the root's own tokens: the scope class's defaults, a host's\n * overrides of them, and the theme's variables in `themeStyle`. Because it\n * beats the caller's classes too, a property the caller's `className` sets\n * (`bg-red-600`, `hover:text-white`, `flex`) is left to the classes, as\n * before; `style` overrides any of them.\n */\nexport function portalSurfaceStyle({\n  surface,\n  className,\n  themeStyle,\n  style,\n}: {\n  surface: PortalSurface;\n  /** The caller's classes on the root. */\n  className?: string;\n  /** The provider theme's CSS variables (`useAthenaThemeStyle`), when a theme is set. */\n  themeStyle?: CSSProperties | Record<string, string> | null;\n  /** The caller's own style, applied last. */\n  style?: CSSProperties;\n}): CSSProperties {\n  const defaults: CSSProperties = {};\n  for (const { property, value, utility } of SURFACES[surface]) {\n    if (!callerSets(className, utility)) defaults[property] = value;\n  }\n  return {\n    ...defaults,\n    // The wrapper's `.athena-themed` sets the theme's face; a portal root sets it here.\n    ...(themeStyle ? { fontFamily: 'var(--font-family, inherit)' } : {}),\n    ...(themeStyle as CSSProperties | undefined),\n    ...style,\n  };\n}\n"],"names":["cn"],"mappings":";;;AAaA,MAAM,WAA6D;AAAA,EACjE,SAAS;AAAA,IACP,EAAE,UAAU,WAAW,OAAO,SAAS,SAAS,QAAA;AAAA,IAChD,EAAE,UAAU,mBAAmB,OAAO,kBAAkB,SAAS,aAAA;AAAA,IACjE,EAAE,UAAU,SAAS,OAAO,6BAA6B,SAAS,0BAAA;AAAA,IAClE,EAAE,UAAU,eAAe,OAAO,iBAAiB,SAAS,gBAAA;AAAA,EAAgB;AAAA,EAE9E,SAAS;AAAA,IACP,EAAE,UAAU,WAAW,OAAO,SAAS,SAAS,QAAA;AAAA,IAChD,EAAE,UAAU,mBAAmB,OAAO,qBAAqB,SAAS,gBAAA;AAAA,IACpE,EAAE,UAAU,SAAS,OAAO,qBAAqB,SAAS,kBAAA;AAAA,EAAkB;AAEhF;AAGA,SAAS,UAAU,OAAuB;AACxC,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,UAAM,OAAO,MAAM,KAAK;AACxB,QAAI,SAAS,OAAO,SAAS,IAAK,UAAS;AAAA,aAClC,SAAS,OAAO,SAAS,IAAK,UAAS;AAAA,aACvC,SAAS,OAAO,UAAU,WAAW,QAAQ;AAAA,EACxD;AACA,SAAO,MAAM,MAAM,KAAK,EAAE,QAAQ,UAAU,EAAE;AAChD;AAOA,SAAS,WAAW,WAA+B,SAA0B;AAC3E,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO,UAAU,MAAM,KAAK,EAAE,KAAK,CAAC,UAAU;AAC5C,UAAM,OAAO,UAAU,KAAK;AAC5B,QAAI,CAAC,QAAQ,SAAS,QAAS,QAAO;AACtC,WAAO,CAACA,OAAAA,GAAG,SAAS,IAAI,EAAE,MAAM,GAAG,EAAE,SAAS,OAAO,KAAK,CAACA,OAAAA,GAAG,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE,SAAS,IAAI;AAAA,EACvG,CAAC;AACH;AA2BO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQkB;AAChB,QAAM,WAA0B,CAAA;AAChC,aAAW,EAAE,UAAU,OAAO,aAAa,SAAS,OAAO,GAAG;AAC5D,QAAI,CAAC,WAAW,WAAW,OAAO,EAAG,UAAS,QAAQ,IAAI;AAAA,EAC5D;AACA,SAAO;AAAA,IACL,GAAG;AAAA;AAAA,IAEH,GAAI,aAAa,EAAE,YAAY,8BAAA,IAAkC,CAAA;AAAA,IACjE,GAAI;AAAA,IACJ,GAAG;AAAA,EAAA;AAEP;;"}

package/dist/lib/portal-surface.d.ts

@@ -0,0 +1,37 @@
+import type { CSSProperties } from 'react';
+/** The look of a portaled root: a popover-like panel, or a tooltip. */
+export type PortalSurface = 'popover' | 'tooltip';
+/**
+ * The inline style of SDK content portaled outside the provider wrapper —
+ * tooltips, popovers, the composer's pickers — so it draws its own box and
+ * colours in any host.
+ *
+ * Portaled content renders under the host's `document.body`, inside the host's
+ * stylesheet, carrying the SDK's scope classes for its tokens. Stylesheet rules
+ * alone cannot be trusted there:
+ *
+ * - `.athena-sdk` (the tokens) is `display: contents`, its role on the
+ *   provider wrapper, and `.athena-themed` is too, unlayered — content without
+ *   a box draws no background, padding or radius.
+ * - A host whose Tailwind theme writes the same utilities against tokens of
+ *   another format (`bg-popover` as `hsl(var(--popover))`, shadcn's HSL
+ *   channels; Athena's own desktop app) emits them unlayered, beating the
+ *   SDK's layered utilities, and `hsl()` of the SDK's full colours is invalid:
+ *   a transparent menu over the page.
+ *
+ * An inline style beats every stylesheet rule, and its `var(--…)` references
+ * resolve against the root's own tokens: the scope class's defaults, a host's
+ * overrides of them, and the theme's variables in `themeStyle`. Because it
+ * beats the caller's classes too, a property the caller's `className` sets
+ * (`bg-red-600`, `hover:text-white`, `flex`) is left to the classes, as
+ * before; `style` overrides any of them.
+ */
+export declare function portalSurfaceStyle({ surface, className, themeStyle, style, }: {
+    surface: PortalSurface;
+    /** The caller's classes on the root. */
+    className?: string;
+    /** The provider theme's CSS variables (`useAthenaThemeStyle`), when a theme is set. */
+    themeStyle?: CSSProperties | Record<string, string> | null;
+    /** The caller's own style, applied last. */
+    style?: CSSProperties;
+}): CSSProperties;