@athenaintel/react 0.57.2 → 0.60.0

package/dist/index.js

@@ -4,6 +4,15 @@ import { useAthenaDiagnostics } from "./diagnostics/useAthenaDiagnostics.js";
 import { ATHENA_SDK_ERROR_CODES, AthenaSdkError, isAthenaSdkError, readRejectionDetail, toAthenaSdkError } from "./diagnostics/errors.js";
 import { COLLAB_AGENT_REF_PREFIX, COLLAB_AGENT_REF_SHAPE, DEFAULT_STATEWIRE_MODEL, buildStatewireRunConfig, parseCollabAgentRef, resolveAgentProp } from "./runtime/statewire-run-config.js";
 import { ATHENA_REPO_SEARCH_PATH, fetchRepoSearch, repoSearchRequestBody, useAthenaRepoSearch } from "./search/useAthenaRepoSearch.js";
+import { ATHENA_RECENT_ASSETS_NOT_TYPES, ATHENA_SUB_ASSET_MEDIA_TYPES, AthenaAssetOrder, athenaAssetSearchInput, listAthenaFolder, listAthenaProjectAssets, searchAthenaAssets, useAthenaAssetSearch, useAthenaAssetsRefresh, useAthenaFavoriteAssets, useAthenaFolderAssets, useAthenaProjectAssets, useAthenaProjects, useAthenaRecentAssets } from "./search/useAthenaAssets.js";
+import { AthenaApiError, AthenaApiErrorKind, isAthenaApiError } from "./data/athena-api-error.js";
+import { ATHENA_REQUEST_TIMEOUT_MS, createAthenaFetch } from "./data/athena-request.js";
+import { useAthenaFetch } from "./data/use-athena-fetch.js";
+import { useAthenaGraphQL, useAthenaGraphQLMutation } from "./data/use-athena-graphql.js";
+import { useAthenaRest } from "./data/use-athena-rest.js";
+import { ATHENA_BUNDLE_KEY_MAX_LENGTH, ATHENA_BUNDLE_KEY_PATTERN, ATHENA_MEMBER_KEY_PATTERN, AthenaMemberNotFoundError, athenaMemberPath, isAthenaMemberName, parseAthenaMemberName, resolveAthenaMember, useAthenaMember } from "./data/athena-member.js";
+import { SEMANTIC_QUERY_TIMEOUT_MS, semanticQueryPath, useSemanticQuery } from "./data/use-semantic-query.js";
+import { ATHENA_DATA_STALE_MS, athenaRetryDelay, retryAthenaRead, useInvalidateAthenaQueries } from "./data/athena-data-client.js";
 import { AthenaProvider } from "./provider/AthenaProvider.js";
 import { getPostHogInstance } from "./provider/PostHogProvider.js";
 import { capturePosthogEvent, capturePosthogException, getPosthogCaptureGate, wrapPosthogClient } from "./lib/posthog/wrap-posthog-client.js";
@@ -28,6 +37,7 @@ import { agoraApiRoot, useAthenaBrowserDecisionConfirmer, useBrowserDecisionConf
 import { useAthenaRunLive } from "./chat/use-athena-run-live.js";
 import { useAthenaVoiceLive } from "./chat/use-athena-voice-live.js";
 import { AthenaTurnEndStatus, useAthenaTurnEnded } from "./chat/athena-turn-end-status.js";
+import { AthenaTurnChangesScope, AthenaTurnChangesSlot, TURN_CHANGES_FILES_SHOWN } from "./chat/turn-changes.js";
 import { StatewireHistoryEdge } from "./chat-ui/thread/statewire-history-edge.js";
 import { ThreadLoadingOverlay } from "./chat-ui/thread/thread-loading-overlay.js";
 import { useStatewireToolOutputs } from "./provider/statewire-window-context.js";
@@ -49,8 +59,24 @@ import { clearChatOutbox, clearUnopenableChatOutbox, countChatOutboxMessages, li
 import { TiptapText } from "./chat/tiptap-text.js";
 import { isAthenaCitationUrl, parseAthenaCitationLink, useAthenaCitationLinkHandler, useAthenaLinkClickHandler } from "./chat/athena-citation-links.js";
 import { TooltipIconButton } from "./chat/tooltip-icon-button.js";
-import { BrowseToolUI, CreateDocumentToolUI, CreateEmailDraftToolUI, CreateNotebookToolUI, CreatePresentationToolUI, CreateSheetToolUI, DescribeDatabaseToolUI, EmailSearchToolUI, GetDatabaseTableSchemaToolUI, ListDatabaseTablesToolUI, OpenAssetToolUI, OpenBrowserToolUI, RunPythonCodeToolUI, RunSqlToolUI, TOOL_UI_REGISTRY, UpdateSheetRangeToolUI, WebSearchToolUI, createAssetToolUI, resetAssetAutoOpen } from "./tools/tool-uis.js";
+import { BrowseToolUI, CreateDocumentToolUI, CreateEmailDraftToolUI, CreateNotebookToolUI, CreatePresentationToolUI, CreateSheetToolUI, DescribeDatabaseToolUI, EmailSearchToolUI, ExecuteSpreadsheetCodeToolUI, ExecuteWordDocumentCodeToolUI, GetDatabaseTableSchemaToolUI, ListDatabaseTablesToolUI, OpenAssetToolUI, OpenBrowserToolUI, RunPythonCodeToolUI, RunSqlToolUI, TOOL_UI_REGISTRY, UpdateSheetRangeToolUI, WebSearchToolUI, createAssetToolUI, resetAssetAutoOpen } from "./tools/tool-uis.js";
+import { QuerySheetRangeToolUI } from "./tools/sheet-query-tool-ui.js";
+import { CapturePageScreenshotToolUI, CaptureSheetScreenshotToolUI } from "./tools/studio-screenshot-tool-uis.js";
+import { DeleteToolUI, ExecuteToolUI } from "./tools/sandbox-tool-uis.js";
+import { AsyncTaskToolUI, EvalToolUI } from "./tools/orchestration-tool-uis.js";
+import { ListContentsToolUI, ProjectLinksToolUI, SearchAssetsToolUI } from "./tools/drive-tool-uis.js";
+import { GetObjectLinksToolUI, ListObjectTypesToolUI, SearchObjectsToolUI } from "./tools/ontology-tool-uis.js";
+import { GetPmRoadmapToolUI, PmDocumentsToolUI } from "./tools/project-tool-uis.js";
+import { BrowserBatchToolUI, ComputerToolUI, CreateNewBrowseSessionToolUI, GetCurrentUrlToolUI, GetPageTextToolUI, GoToUrlToolUI, StopBrowserSessionToolUI } from "./tools/browser-tool-uis.js";
+import { ComputerAssetCreateToolUI, ComputerAssetDeployToolUI, ComputerAssetEnsureSandboxToolUI, ComputerAssetGetStatusToolUI } from "./tools/computer-asset-tool-uis.js";
+import { ClearDocumentToolUI, ConvertDocumentToPdfToolUI, DeleteDocumentBlocksToolUI, InsertDocumentContentAfterToolUI, InsertDocumentContentBeforeToolUI, ReplaceDocumentContentToolUI } from "./tools/document-edit-tool-uis.js";
+import { CalendarEventsToolUI, EmailThreadToolUI, SendAthenaEmailToolUI } from "./tools/email-calendar-tool-uis.js";
+import { CaptureSlideScreenshotsToolUI, ManageSlidesToolUI, SetSlideNotesToolUI, UpdateSlideShapesToolUI } from "./tools/presentation-edit-tool-uis.js";
 import { SubagentTaskToolUI } from "./tools/subagent-task-tool-ui.js";
+import { SubagentLaneGroup } from "./subagents/subagent-lane-group.js";
+import { SubagentTranscriptDrawer } from "./subagents/subagent-transcript-drawer.js";
+import { DeepAgentLaneFollowScope, useDeepAgentLaneFollowRegistry } from "./subagents/lane-follow.js";
+import { useTaskSubagentGroup } from "./subagents/task-subagent-group.js";
 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";
@@ -67,6 +93,8 @@ import { VoiceDelegationCard, VoiceDelegationMessage } from "./chat-ui/messages/
 import { NestedPtcComponentsProvider, NestedPtcMessages, useNestedPtcComponents } from "./tools/NestedPtcMessages.js";
 import { ReadAssetToolUI } from "./tools/read-asset-tool-ui.js";
 import { DEFAULT_AUTO_OPEN_TOOLS } from "./tools/auto-open-tools.js";
+import { useAthenaAgentCreations } from "./tools/agent-creations.js";
+import { useAthenaAgentHighlights } from "./tools/agent-highlights.js";
 import { AppendDocumentToolUI } from "./tools/append-document-tool-ui.js";
 import { getAssetInfo, tryParseJson } from "./tools/asset-utils.js";
 import { AthenaAssetEmbed } from "./assets/AthenaAssetEmbed.js";
@@ -93,10 +121,12 @@ 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 { DEFAULT_HIDDEN_SESSIONS_COLUMNS, 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 { useAthenaThreadModel } from "./threads/use-athena-thread-model.js";
+import { useAthenaThreadAgent } from "./threads/use-athena-thread-agent.js";
+import { useAthenaThreadPlanMode } from "./threads/use-athena-thread-plan-mode.js";
 import { useAthenaSessionPersistence } from "./provider/session-persistence-context.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";
@@ -109,21 +139,27 @@ import { DICTATION_ENGINE_ERROR_KINDS, createWebSpeechDictationEngine } from "./
 import { createRecordedDictationEngine } from "./dictation/recorded-dictation-engine.js";
 import { useAthenaDictationEngine } from "./dictation/use-athena-dictation-engine.js";
 import { DICTATION_STATUSES, composeDictationDraft } from "./dictation/dictation-state.js";
+import { useAthenaComposerActions } from "./chat/composer-actions.js";
 import { useChatVoiceEnabled } from "./voice/use-chat-voice-enabled.js";
 import { useAppendToComposer } from "./composer/useAppendToComposer.js";
 import { useComposerReady, useFocusComposer } from "./composer/composer-handoff.js";
 import { useReadComposerDraft, useTryReadComposerDraft } from "./composer/useReadComposerDraft.js";
 import { useSendMessage } from "./composer/useSendMessage.js";
 import { useComposerAttachment } from "./composer/useComposerAttachment.js";
-import { ChatAgentPicker, ChatModePicker, ChatModelPicker } from "./catalog/chat-pickers.js";
+import { ChatAgentPicker, ChatModePicker, ChatModelPicker, ChatPlanModeToggle } from "./catalog/chat-pickers.js";
 import { useAthenaChatMode } from "./catalog/use-athena-chat-mode.js";
-import { MODEL_PROVIDER_LABELS, credentialFingerprint, groupModelsByProvider, normalizeAgentCatalog, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaAgentModelOptions, useAthenaModelCatalog } from "./catalog/runtime-catalog.js";
+import { MODEL_PROVIDER_LABELS, credentialFingerprint, groupModelsByProvider, normalizeAgentCatalog, normalizeAgentDirectory, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaAgentDirectory, useAthenaAgentModelOptions, useAthenaModelCatalog, useAthenaViewerIsAdmin } 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 { QuoteProvider, createQuoteStore, useQuote } from "./composer/QuoteContext.js";
 import { AttachmentProvider, createAttachmentStore, useAttachments } from "./composer/AttachmentContext.js";
+import { ComposerNamedAgents } from "./composer/ComposerNamedAgents.js";
+import { useAttachToChat } from "./composer/useAttachToChat.js";
+import { ComposerAttachedReferences, MessageAttachedReferences } from "./composer/ComposerAttachedReferences.js";
+import { useAttachedReferencesComposerProps } from "./composer/useAttachedReferencesComposerProps.js";
+import { ATTACHED_REFERENCES_METADATA_KEY, MAX_ATTACHED_REFERENCES, attachableReferenceLabel, normalizeAttachableReference, readAttachedReferences } from "./references/src/attachable.js";
 import { useParentAuth, useParentBridge } from "./runtime/auth.js";
 import { DEFAULT_APP_URL, DEFAULT_STATEWIRE_SYNC_URL, athenaLinkAppUrl, createAthenaSpacesUrl, deriveAthenaApiUrl, deriveAthenaAppUrl, deriveStatewireSyncUrl, resolveStatewireSyncUrl } from "./lib/athena-urls.js";
 import { Button, buttonVariants } from "./ui/button.js";
@@ -149,50 +185,82 @@ import { useToolAppearance } from "./tools/tool-appearance.js";
 import { useTurnToolCallsAwaitingApproval } from "./agent-runtime/src/subagents.js";
 import { windowInFrontSignal } from "./agent-runtime/src/chat-outbox-signals.js";
 export {
+  ATHENA_BUNDLE_KEY_MAX_LENGTH,
+  ATHENA_BUNDLE_KEY_PATTERN,
+  ATHENA_DATA_STALE_MS,
+  ATHENA_MEMBER_KEY_PATTERN,
   ATHENA_REACT_SDK_VERSION,
+  ATHENA_RECENT_ASSETS_NOT_TYPES,
   ATHENA_REPO_SEARCH_PATH,
+  ATHENA_REQUEST_TIMEOUT_MS,
   ATHENA_SDK_ERROR_CODES,
   ATHENA_SDK_MESSAGE_WINDOW,
+  ATHENA_SUB_ASSET_MEDIA_TYPES,
+  ATTACHED_REFERENCES_METADATA_KEY,
   AppendDocumentToolUI,
   AssetPanel,
+  AsyncTaskToolUI,
+  AthenaApiError,
+  AthenaApiErrorKind,
   AthenaAssetEmbed,
+  AthenaAssetOrder,
   AthenaAssistantActionBar,
   AthenaAssistantMessage,
   AthenaChat,
   AthenaChatErrorBoundary,
   AthenaLayout,
+  AthenaMemberNotFoundError,
   AthenaPlanStrip,
   AthenaProvider,
   AthenaReasoningPart,
   AthenaSdkError,
   AthenaThreadIdContext,
+  AthenaTurnChangesScope,
+  AthenaTurnChangesSlot,
   AthenaTurnEndStatus,
   AthenaUserMessage,
   AttachmentProvider,
   BrowseToolUI,
+  BrowserBatchToolUI,
   Button,
   COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,
   COLLAB_AGENT_REF_PREFIX,
   COLLAB_AGENT_REF_SHAPE,
+  CalendarEventsToolUI,
+  CapturePageScreenshotToolUI,
+  CaptureSheetScreenshotToolUI,
+  CaptureSlideScreenshotsToolUI,
   ChatAgentPicker,
   ChatModePicker,
   ChatModelPicker,
+  ChatPlanModeToggle,
+  ClearDocumentToolUI,
   Collapsible,
   CollapsibleContent,
   CollapsibleGroup,
   CollapsibleTrigger,
+  ComposerAttachedReferences,
   ComposerDropZone,
+  ComposerNamedAgents,
   ComposerQuotePreview,
+  ComputerAssetCreateToolUI,
+  ComputerAssetDeployToolUI,
+  ComputerAssetEnsureSandboxToolUI,
+  ComputerAssetGetStatusToolUI,
   ComputerLiveDesktop,
+  ComputerToolUI,
+  ConvertDocumentToPdfToolUI,
   CopyToolSpecButton,
   CreateDocumentToolUI,
   CreateEmailDraftToolUI,
+  CreateNewBrowseSessionToolUI,
   CreateNotebookToolUI,
   CreatePresentationToolUI,
   CreateSheetToolUI,
   DEFAULT_APP_URL,
   DEFAULT_AUTO_OPEN_TOOLS,
   DEFAULT_COLLAB_CHANNEL,
+  DEFAULT_HIDDEN_SESSIONS_COLUMNS,
   DEFAULT_SESSION_WORKBENCH_OPEN_PANE_IDS,
   DEFAULT_SESSION_WORKBENCH_PANES,
   DEFAULT_STATEWIRE_MODEL,
@@ -200,6 +268,9 @@ export {
   DEFAULT_TOOLKIT_THEME,
   DICTATION_ENGINE_ERROR_KINDS,
   DICTATION_STATUSES,
+  DeepAgentLaneFollowScope,
+  DeleteDocumentBlocksToolUI,
+  DeleteToolUI,
   DescribeDatabaseToolUI,
   DeviceOperationProvider,
   DictationStrip,
@@ -207,9 +278,19 @@ export {
   DrivingOnChip,
   EditFileToolUI,
   EmailSearchToolUI,
+  EmailThreadToolUI,
+  EvalToolUI,
+  ExecuteSpreadsheetCodeToolUI,
+  ExecuteToolUI,
+  ExecuteWordDocumentCodeToolUI,
   ExpandableSection,
   FileUploadButton,
+  GetCurrentUrlToolUI,
   GetDatabaseTableSchemaToolUI,
+  GetObjectLinksToolUI,
+  GetPageTextToolUI,
+  GetPmRoadmapToolUI,
+  GoToUrlToolUI,
   GroupedMessageParts,
   HITL_PENDING_RESUME_GRACE_MS,
   HiddenWriteTodosToolUI,
@@ -221,13 +302,20 @@ export {
   InboundChannelSubject,
   Inbox,
   InboxButton,
+  InsertDocumentContentAfterToolUI,
+  InsertDocumentContentBeforeToolUI,
   InstallPackageToolUI,
   LIVE_DESKTOP_READY_TIMEOUT_MS,
   LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE,
+  ListContentsToolUI,
   ListDatabaseTablesToolUI,
   ListFilesToolUI,
+  ListObjectTypesToolUI,
   LiveDesktopMode,
+  MAX_ATTACHED_REFERENCES,
   MODEL_PROVIDER_LABELS,
+  ManageSlidesToolUI,
+  MessageAttachedReferences,
   NestedPtcComponentsProvider,
   NestedPtcMessages,
   OFFLINE_SNAPSHOT_READ_WAIT_MS,
@@ -236,6 +324,9 @@ export {
   OpenBrowserToolUI,
   OwnerDocumentProvider,
   PlanStepMarker,
+  PmDocumentsToolUI,
+  ProjectLinksToolUI,
+  QuerySheetRangeToolUI,
   QuoteProvider,
   RANGE_PREVIEW_MAX_COLUMNS,
   RANGE_PREVIEW_MAX_ROWS,
@@ -243,8 +334,10 @@ export {
   RangePreviewTable,
   ReadAssetToolUI,
   ReadFileToolUI,
+  ReplaceDocumentContentToolUI,
   RunPythonCodeToolUI,
   RunSqlToolUI,
+  SEMANTIC_QUERY_TIMEOUT_MS,
   SESSIONS_COLUMNS,
   SESSION_RUN_STATUSES,
   SESSION_SANDBOX_LABEL,
@@ -259,7 +352,10 @@ export {
   SHEET_MAX_COLUMN,
   SHEET_MAX_ROW,
   SHELL_OUTPUT_PREVIEW_CHARS,
+  SearchAssetsToolUI,
   SearchFilesToolUI,
+  SearchObjectsToolUI,
+  SendAthenaEmailToolUI,
   SessionAttachmentsPane,
   SessionComputerPane,
   SessionList,
@@ -268,6 +364,7 @@ export {
   SessionTasksPane,
   SessionWorkbench,
   SessionsPage,
+  SetSlideNotesToolUI,
   StatewireApprovalCard,
   StatewireClientToolBridge,
   StatewireConnectionBanner,
@@ -275,7 +372,10 @@ export {
   StatewireHistoryEdge,
   StatewireQueuedMessages,
   StatewireRunRefusalNotice,
+  StopBrowserSessionToolUI,
+  SubagentLaneGroup,
   SubagentTaskToolUI,
+  SubagentTranscriptDrawer,
   SuperGroupingCard,
   SuperGroupingFinalText,
   SuperGroupingProvider,
@@ -289,6 +389,7 @@ export {
   TOOLKIT_THEMES,
   TOOL_ICONS,
   TOOL_UI_REGISTRY,
+  TURN_CHANGES_FILES_SHOWN,
   TestRecordingMarkToolUI,
   TestRecordingReportCard,
   TestRecordingStartToolUI,
@@ -315,6 +416,7 @@ export {
   TooltipTrigger,
   UNREADABLE_DEVICE_OPERATION,
   UpdateSheetRangeToolUI,
+  UpdateSlideShapesToolUI,
   VoiceDelegationCard,
   VoiceDelegationMessage,
   VoiceUpdateCard,
@@ -337,9 +439,13 @@ export {
   assetPanelTypeOf,
   assetTypeLabel,
   athenaAssetContentPath,
+  athenaAssetSearchInput,
   athenaDiagnostics,
   athenaLinkAppUrl,
+  athenaMemberPath,
+  athenaRetryDelay,
   athenaStatewireErrorNotice,
+  attachableReferenceLabel,
   buildActivityTimeline,
   buildCoalescedCaptureProperties,
   buildStatewireRunConfig,
@@ -367,6 +473,7 @@ export {
   countActivityTools,
   countChatOutboxMessages,
   createAssetToolUI,
+  createAthenaFetch,
   createAthenaSpacesUrl,
   createAttachmentStore,
   createComputerLiveDesktopSession,
@@ -428,7 +535,9 @@ export {
   inboundMessageBody,
   inboxStateChip,
   installAthenaDiagnosticsGlobal,
+  isAthenaApiError,
   isAthenaCitationUrl,
+  isAthenaMemberName,
   isAthenaSdkError,
   isCriticalPosthogEvent,
   isGithubWakeMessage,
@@ -439,18 +548,23 @@ export {
   isThreadFavoriteUnavailableError,
   isThreadRenameUnavailableError,
   isToolResultSuccess,
+  listAthenaFolder,
+  listAthenaProjectAssets,
   listChatOutboxMessages,
   listThreads,
   liveDesktopViewerUrl,
   matchesSessionsQuery,
   mintThreadId,
   normalizeAgentCatalog,
+  normalizeAgentDirectory,
+  normalizeAttachableReference,
   normalizeModelCatalog,
   normalizeResult,
   normalizeSessionsQuery,
   orderedPullRequests,
   parseA1Range,
   parseAthenaCitationLink,
+  parseAthenaMemberName,
   parseCollabAgentRef,
   parseTestRecordingStopResult,
   parseTodoPlan,
@@ -460,6 +574,7 @@ export {
   rangePreviewFromCellMap,
   rangePreviewFromRows,
   rangePreviewToTableData,
+  readAttachedReferences,
   readComputerRuntimeStatus,
   readComputerSshAccess,
   readGithubWakeEvent,
@@ -476,10 +591,14 @@ export {
   resetRememberedExpansionsForTests,
   resolveActivityPhase,
   resolveAgentProp,
+  resolveAthenaMember,
   resolveCatalogModelId,
   resolveStatewireSyncUrl,
   resultMessage,
+  retryAthenaRead,
   reviewDecisionLabel,
+  searchAthenaAssets,
+  semanticQueryPath,
   sessionIndicator,
   sessionListGroupOf,
   sessionOriginBadge,
@@ -517,21 +636,37 @@ export {
   useAssetEmbed,
   useAssetPanelStore,
   useAthenaAgentCatalog,
+  useAthenaAgentCreations,
+  useAthenaAgentDirectory,
+  useAthenaAgentHighlights,
   useAthenaAgentModelOptions,
   useAthenaAssetContent,
+  useAthenaAssetSearch,
+  useAthenaAssetsRefresh,
   useAthenaBrowserDecisionConfirmer,
   useAthenaChatMode,
   useAthenaCitationLinkHandler,
+  useAthenaComposerActions,
   useAthenaComputerSshAccess,
   useAthenaComputerStatus,
   useAthenaConfig,
   useAthenaDiagnostics,
   useAthenaDictationEngine,
+  useAthenaFavoriteAssets,
+  useAthenaFetch,
+  useAthenaFolderAssets,
+  useAthenaGraphQL,
+  useAthenaGraphQLMutation,
   useAthenaInboxUnreadCount,
   useAthenaLinkClickHandler,
+  useAthenaMember,
   useAthenaModelCatalog,
   useAthenaOfflineSnapshotAt,
+  useAthenaProjectAssets,
+  useAthenaProjects,
+  useAthenaRecentAssets,
   useAthenaRepoSearch,
+  useAthenaRest,
   useAthenaRunLive,
   useAthenaSessionAttention,
   useAthenaSessionPersistence,
@@ -541,20 +676,27 @@ export {
   useAthenaStatewireRuntime,
   useAthenaStatewireThreadId,
   useAthenaStatewireThreadList,
+  useAthenaThreadAgent,
   useAthenaThreadId,
   useAthenaThreadManager,
   useAthenaThreadModel,
+  useAthenaThreadPlanMode,
   useAthenaTurnEnded,
+  useAthenaViewerIsAdmin,
   useAthenaVoiceLive,
+  useAttachToChat,
+  useAttachedReferencesComposerProps,
   useAttachments,
   useBrowserDecisionConfirmer,
   useChatVoiceEnabled,
   useComposerAttachment,
   useComposerReady,
+  useDeepAgentLaneFollowRegistry,
   useDeviceOperationReader,
   useDictation,
   useFileUpload,
   useFocusComposer,
+  useInvalidateAthenaQueries,
   useIsInPopoutDocument,
   useLatestTodoPlan,
   useNestedPtcComponents,
@@ -567,6 +709,7 @@ export {
   useReadComposerDraft,
   useRefreshThreadList,
   useRestConversationHistory,
+  useSemanticQuery,
   useSendMessage,
   useSessionWorkbench,
   useSessionWorkbenchWorkspace,
@@ -575,6 +718,7 @@ export {
   useStatewireConversationHistory,
   useStatewireHistory,
   useStatewireToolOutputs,
+  useTaskSubagentGroup,
   useToolAppearance,
   useToolPartPlacement,
   useTryReadComposerDraft,

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/keryx-http/src/initial-sync.cjs

@@ -42,28 +42,74 @@ function keryxRoomReadUrl({
   read.searchParams.set("branch", branch);
   return read.toString();
 }
+const HTTP_FIRST_READ_IDLE_TIMEOUT_MS = 6e4;
+const HTTP_FIRST_READ_TIMEOUT_MS = 10 * 6e4;
+async function readBody({ response, onChunk }) {
+  const stream = response.body;
+  if (stream === null) return new Uint8Array(await response.arrayBuffer());
+  const reader = stream.getReader();
+  const chunks = [];
+  let length = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    chunks.push(value);
+    length += value.byteLength;
+    onChunk();
+  }
+  const body = new Uint8Array(length);
+  let offset = 0;
+  for (const chunk of chunks) {
+    body.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return body;
+}
 async function readRoomOverHttp({
   url,
   signal,
-  fetchImpl = fetch
+  fetchImpl = fetch,
+  idleTimeoutMs
 }) {
   var _a;
-  const response = await fetchImpl(url, { headers: { Accept: "application/octet-stream" }, signal });
-  if (!response.ok) {
-    await ((_a = response.body) == null ? void 0 : _a.cancel().catch(() => void 0));
-    throw new Error(`GET /ydoc answered ${response.status}`);
-  }
-  const body = new Uint8Array(await response.arrayBuffer());
-  const decoded = decoding__namespace.readAny(decoding__namespace.createDecoder(body));
-  if (decoded === null || typeof decoded !== "object" || !(decoded.doc instanceof Uint8Array)) {
-    throw new Error("GET /ydoc answered a body without a document");
-  }
-  return {
-    // a copy: lib0 hands out a view into the body
-    update: new Uint8Array(decoded.doc),
-    answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,
-    bytes: body.byteLength
+  const reading = new AbortController();
+  const stop = () => reading.abort(signal == null ? void 0 : signal.reason);
+  if (signal == null ? void 0 : signal.aborted) stop();
+  else signal == null ? void 0 : signal.addEventListener("abort", stop, { once: true });
+  let idle = null;
+  const stillReceiving = () => {
+    if (idle !== null) clearTimeout(idle);
+    idle = setTimeout(
+      () => reading.abort(new DOMException(`GET /ydoc received nothing for ${idleTimeoutMs} ms`, "TimeoutError")),
+      idleTimeoutMs
+    );
   };
+  stillReceiving();
+  try {
+    const response = await fetchImpl(url, { headers: { Accept: "application/octet-stream" }, signal: reading.signal });
+    if (!response.ok) {
+      await ((_a = response.body) == null ? void 0 : _a.cancel().catch(() => void 0));
+      throw new Error(`GET /ydoc answered ${response.status}`);
+    }
+    stillReceiving();
+    const body = await readBody({ response, onChunk: stillReceiving });
+    const decoded = decoding__namespace.readAny(decoding__namespace.createDecoder(body));
+    if (decoded === null || typeof decoded !== "object" || !(decoded.doc instanceof Uint8Array)) {
+      throw new Error("GET /ydoc answered a body without a document");
+    }
+    return {
+      // a copy: lib0 hands out a view into the body
+      update: new Uint8Array(decoded.doc),
+      answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,
+      bytes: body.byteLength
+    };
+  } catch (error) {
+    if (reading.signal.aborted && !(signal == null ? void 0 : signal.aborted)) throw reading.signal.reason;
+    throw error;
+  } finally {
+    if (idle !== null) clearTimeout(idle);
+    signal == null ? void 0 : signal.removeEventListener("abort", stop);
+  }
 }
 const MEMO_PREFIX = "keryx-initial-sync:";
 const INITIAL_SYNC_UNSUPPORTED_TTL_MS = 60 * 60 * 1e3;
@@ -108,6 +154,8 @@ function knownInitialSyncSupport({
     return null;
   }
 }
+exports.HTTP_FIRST_READ_IDLE_TIMEOUT_MS = HTTP_FIRST_READ_IDLE_TIMEOUT_MS;
+exports.HTTP_FIRST_READ_TIMEOUT_MS = HTTP_FIRST_READ_TIMEOUT_MS;
 exports.INITIAL_SYNC_CAPABILITY_HEADER = INITIAL_SYNC_CAPABILITY_HEADER;
 exports.INITIAL_SYNC_DIFF = INITIAL_SYNC_DIFF;
 exports.INITIAL_SYNC_PARAM = INITIAL_SYNC_PARAM;

package/dist/keryx-http/src/initial-sync.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"initial-sync.cjs","sources":["../../../../keryx-http/src/initial-sync.ts"],"sourcesContent":["/**\n * Opening a big room HTTP-first (Word at scale, 2026-11-02).\n *\n * A Keryx socket's initial sync step 2 is the whole document, sent as one frame that uWS deflates on\n * Keryx's event loop: 1.4-1.8 s for a 132 MiB Word room, during which no other room on that server\n * is served, then 17 MiB on the wire. A Keryx that carries the `@y/hub` patch's diffed initial sync\n * answers a socket that connects with `?initialSync=diff` with only what the client lacks past its\n * own sync step 1, and serves `GET /ydoc` compressed (zstd, brotli or gzip, as the browser names\n * them) from a kept copy. So a client opening a big room reads it over HTTP first - decoded by the\n * browser as it downloads - applies it as the server's state, and opens its socket asking for the\n * rest: usually just the delete set.\n *\n * A Keryx says it answers that way in its `GET /ydoc` answer to a browser\n * (`X-Keryx-Initial-Sync: diff`, exposed to cross-origin readers). A Keryx without the patch says\n * nothing: its document is then not used, the socket opens as before, and the origin is remembered\n * as one that does not answer, so the next open skips the read.\n */\n\nimport * as decoding from 'lib0/decoding';\n\n/** The socket query parameter, and its one value, that ask for a diffed initial sync. */\nexport const INITIAL_SYNC_PARAM = 'initialSync';\nexport const INITIAL_SYNC_DIFF = 'diff';\n\n/** The `GET /ydoc` response header with which a Keryx says it answers `?initialSync=diff`. */\nexport const INITIAL_SYNC_CAPABILITY_HEADER = 'x-keryx-initial-sync';\n\n/**\n * The `GET /ydoc` URL of the room a socket URL names: `wss://host/ws/<org>/<docId>` (or the\n * `/api/ws/v1/` spelling) becomes `https://host/api/ydoc/v1/<org>/<docId>?yauth=…&branch=…`. `null`\n * for a URL of any other shape.\n */\nexport function keryxRoomReadUrl({\n  wsUrl,\n  token,\n  branch,\n}: {\n  wsUrl: string;\n  token: string;\n  branch: string;\n}): string | null {\n  let parsed: URL;\n  try {\n    parsed = new URL(wsUrl);\n  } catch {\n    return null;\n  }\n  const scheme = parsed.protocol === 'wss:' ? 'https:' : parsed.protocol === 'ws:' ? 'http:' : null;\n  if (scheme === null) return null;\n  const match = /^(.*?)\\/(?:api\\/ws\\/v1|ws)\\/([^/]+)\\/([^/]+)\\/?$/.exec(parsed.pathname);\n  if (match === null) return null;\n  const [, prefix = '', org = '', docId = ''] = match;\n  const read = new URL(`${scheme}//${parsed.host}${prefix}/api/ydoc/v1/${org}/${docId}`);\n  read.searchParams.set('yauth', token);\n  read.searchParams.set('branch', branch);\n  return read.toString();\n}\n\n/** A room read over HTTP. */\nexport interface RoomReadOverHttp {\n  /** The room's state as one update (empty for a room never written). */\n  update: Uint8Array;\n  /** Keryx said it answers a socket's sync step 1 (`INITIAL_SYNC_CAPABILITY_HEADER`). */\n  answersSyncStep1: boolean;\n  /** The decoded body's size. */\n  bytes: number;\n}\n\n/**\n * Read a room over `GET /ydoc` (`url` from {@link keryxRoomReadUrl}). The runtime's `fetch` names\n * and decodes the content codings. Throws on a non-2xx answer or a body that is not a lib0 `{ doc }`.\n */\nexport async function readRoomOverHttp({\n  url,\n  signal,\n  fetchImpl = fetch,\n}: {\n  url: string;\n  signal?: AbortSignal;\n  fetchImpl?: typeof fetch;\n}): Promise<RoomReadOverHttp> {\n  const response = await fetchImpl(url, { headers: { Accept: 'application/octet-stream' }, signal });\n  if (!response.ok) {\n    await response.body?.cancel().catch(() => undefined);\n    throw new Error(`GET /ydoc answered ${response.status}`);\n  }\n  const body = new Uint8Array(await response.arrayBuffer());\n  const decoded = decoding.readAny(decoding.createDecoder(body)) as { doc?: unknown } | null;\n  if (decoded === null || typeof decoded !== 'object' || !(decoded.doc instanceof Uint8Array)) {\n    throw new Error('GET /ydoc answered a body without a document');\n  }\n  return {\n    // a copy: lib0 hands out a view into the body\n    update: new Uint8Array(decoded.doc),\n    answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,\n    bytes: body.byteLength,\n  };\n}\n\n/** Where {@link rememberInitialSyncSupport} keeps what it learned: `localStorage`'s surface. */\nexport interface InitialSyncSupportStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nconst MEMO_PREFIX = 'keryx-initial-sync:';\n/** A Keryx that answered without the header is asked again an hour later: it may have been upgraded. */\nexport const INITIAL_SYNC_UNSUPPORTED_TTL_MS = 60 * 60 * 1000;\n/** A Keryx that answers is believed for a week; one rolled back meanwhile just sends whole documents. */\nexport const INITIAL_SYNC_SUPPORTED_TTL_MS = 7 * 24 * 60 * 60 * 1000;\n\n/** The origin a socket URL connects to, as the memo keys it (`wss://host`). */\nexport function keryxOriginOf(wsUrl: string): string | null {\n  try {\n    const parsed = new URL(wsUrl);\n    return `${parsed.protocol}//${parsed.host}`;\n  } catch {\n    return null;\n  }\n}\n\n/** Remember whether the Keryx at `origin` answered with the capability header. */\nexport function rememberInitialSyncSupport({\n  storage,\n  origin,\n  supported,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  supported: boolean;\n  now?: number;\n}): void {\n  try {\n    storage?.setItem(`${MEMO_PREFIX}${origin}`, JSON.stringify({ supported, at: now }));\n  } catch {\n    // a full or refused storage only costs the next open a read\n  }\n}\n\n/**\n * What is known of the Keryx at `origin`: `true` (it answers a socket's sync step 1), `false` (it\n * did not, within the last hour) or `null` (not known: read it and see).\n */\nexport function knownInitialSyncSupport({\n  storage,\n  origin,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  now?: number;\n}): boolean | null {\n  let raw: string | null = null;\n  try {\n    raw = storage?.getItem(`${MEMO_PREFIX}${origin}`) ?? null;\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n  try {\n    const memo = JSON.parse(raw) as { supported?: unknown; at?: unknown };\n    if (typeof memo.supported !== 'boolean' || typeof memo.at !== 'number') return null;\n    const ttl = memo.supported ? INITIAL_SYNC_SUPPORTED_TTL_MS : INITIAL_SYNC_UNSUPPORTED_TTL_MS;\n    return now - memo.at <= ttl ? memo.supported : null;\n  } catch {\n    return null;\n  }\n}\n"],"names":["decoding"],"mappings":"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"}
+{"version":3,"file":"initial-sync.cjs","sources":["../../../../keryx-http/src/initial-sync.ts"],"sourcesContent":["/**\n * Opening a big room HTTP-first (Word at scale, 2026-11-02).\n *\n * A Keryx socket's initial sync step 2 is the whole document, sent as one frame that uWS deflates on\n * Keryx's event loop: 1.4-1.8 s for a 132 MiB Word room, during which no other room on that server\n * is served, then 17 MiB on the wire. A Keryx that carries the `@y/hub` patch's diffed initial sync\n * answers a socket that connects with `?initialSync=diff` with only what the client lacks past its\n * own sync step 1, and serves `GET /ydoc` compressed (zstd, brotli or gzip, as the browser names\n * them) from a kept copy. So a client opening a big room reads it over HTTP first - decoded by the\n * browser as it downloads - applies it as the server's state, and opens its socket asking for the\n * rest: usually just the delete set.\n *\n * A Keryx says it answers that way in its `GET /ydoc` answer to a browser\n * (`X-Keryx-Initial-Sync: diff`, exposed to cross-origin readers). A Keryx without the patch says\n * nothing: its document is then not used, the socket opens as before, and the origin is remembered\n * as one that does not answer, so the next open skips the read.\n */\n\nimport * as decoding from 'lib0/decoding';\n\n/** The socket query parameter, and its one value, that ask for a diffed initial sync. */\nexport const INITIAL_SYNC_PARAM = 'initialSync';\nexport const INITIAL_SYNC_DIFF = 'diff';\n\n/** The `GET /ydoc` response header with which a Keryx says it answers `?initialSync=diff`. */\nexport const INITIAL_SYNC_CAPABILITY_HEADER = 'x-keryx-initial-sync';\n\n/**\n * Which sockets of a room that opens HTTP-first ask for a diffed initial sync, while Keryx is known\n * to answer it and the room holds no write Keryx has not echoed.\n *\n * - `every-socket` (Word documents): the socket after the room's read, every reconnect, and the\n *   first socket of a room opened from its local copy.\n * - `after-read` (decks): only the socket that follows the room's own read. A room opened from its\n *   local copy, and every reconnect, get Keryx's whole document, as a room that does not open\n *   HTTP-first does. Keryx diffs a room that is not one compacted row against its whole merged\n *   document on every socket that asks (the `@y/hub` patch's `diffForClient`). On a fast link that\n *   costs a deck reopened from its copy more than the whole document does (the Midas smoke's\n *   160-slide deck synced in 3.3 s, where the whole document took about 0.6 s).\n */\nexport type DiffedInitialSync = 'every-socket' | 'after-read';\n\n/**\n * The `GET /ydoc` URL of the room a socket URL names: `wss://host/ws/<org>/<docId>` (or the\n * `/api/ws/v1/` spelling) becomes `https://host/api/ydoc/v1/<org>/<docId>?yauth=…&branch=…`. `null`\n * for a URL of any other shape.\n */\nexport function keryxRoomReadUrl({\n  wsUrl,\n  token,\n  branch,\n}: {\n  wsUrl: string;\n  token: string;\n  branch: string;\n}): string | null {\n  let parsed: URL;\n  try {\n    parsed = new URL(wsUrl);\n  } catch {\n    return null;\n  }\n  const scheme = parsed.protocol === 'wss:' ? 'https:' : parsed.protocol === 'ws:' ? 'http:' : null;\n  if (scheme === null) return null;\n  const match = /^(.*?)\\/(?:api\\/ws\\/v1|ws)\\/([^/]+)\\/([^/]+)\\/?$/.exec(parsed.pathname);\n  if (match === null) return null;\n  const [, prefix = '', org = '', docId = ''] = match;\n  const read = new URL(`${scheme}//${parsed.host}${prefix}/api/ydoc/v1/${org}/${docId}`);\n  read.searchParams.set('yauth', token);\n  read.searchParams.set('branch', branch);\n  return read.toString();\n}\n\n/** A room read over HTTP. */\nexport interface RoomReadOverHttp {\n  /** The room's state as one update (empty for a room never written). */\n  update: Uint8Array;\n  /** Keryx said it answers a socket's sync step 1 (`INITIAL_SYNC_CAPABILITY_HEADER`). */\n  answersSyncStep1: boolean;\n  /** The decoded body's size. */\n  bytes: number;\n}\n\n/**\n * How long a room's HTTP-first read may receive nothing (no answer yet, or no byte of its body)\n * before the room gives it up and syncs over its socket instead: the minute every read was allowed\n * in all before, so no read is given up sooner than it was.\n */\nexport const HTTP_FIRST_READ_IDLE_TIMEOUT_MS = 60_000;\n\n/**\n * How long a room's HTTP-first read may take in all, however steadily its bytes come. A read still\n * downloading is otherwise never thrown away: the socket's whole-document sync it would fall back to\n * carries the same bytes, restarted from the first one on every reconnect (a large deck on a slow\n * link took 39 s to 550 s that way, `@athenaintel/decks`' `deck-open-watchdog`).\n */\nexport const HTTP_FIRST_READ_TIMEOUT_MS = 10 * 60_000;\n\n/** The body, read as it arrives: `onChunk` hears each piece. */\nasync function readBody({ response, onChunk }: { response: Response; onChunk: () => void }): Promise<Uint8Array> {\n  const stream = response.body;\n  if (stream === null) return new Uint8Array(await response.arrayBuffer());\n  const reader = stream.getReader();\n  const chunks: Uint8Array[] = [];\n  let length = 0;\n  for (;;) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n    length += value.byteLength;\n    onChunk();\n  }\n  const body = new Uint8Array(length);\n  let offset = 0;\n  for (const chunk of chunks) {\n    body.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return body;\n}\n\n/**\n * Read a room over `GET /ydoc` (`url` from {@link keryxRoomReadUrl}). The runtime's `fetch` names\n * and decodes the content codings. Throws on a non-2xx answer or a body that is not a lib0 `{ doc }`.\n * With `idleTimeoutMs`, a read that receives nothing for that long (no answer, or no byte of its\n * body) is given up with a `TimeoutError`; one whose bytes keep coming runs as long as they do.\n */\nexport async function readRoomOverHttp({\n  url,\n  signal,\n  fetchImpl = fetch,\n  idleTimeoutMs,\n}: {\n  url: string;\n  signal?: AbortSignal;\n  fetchImpl?: typeof fetch;\n  idleTimeoutMs?: number;\n}): Promise<RoomReadOverHttp> {\n  const reading = new AbortController();\n  const stop = () => reading.abort(signal?.reason);\n  if (signal?.aborted) stop();\n  else signal?.addEventListener('abort', stop, { once: true });\n  let idle: ReturnType<typeof setTimeout> | null = null;\n  const stillReceiving = () => {\n    if (idleTimeoutMs === undefined) return;\n    if (idle !== null) clearTimeout(idle);\n    idle = setTimeout(\n      () => reading.abort(new DOMException(`GET /ydoc received nothing for ${idleTimeoutMs} ms`, 'TimeoutError')),\n      idleTimeoutMs\n    );\n  };\n  stillReceiving();\n  try {\n    const response = await fetchImpl(url, { headers: { Accept: 'application/octet-stream' }, signal: reading.signal });\n    if (!response.ok) {\n      await response.body?.cancel().catch(() => undefined);\n      throw new Error(`GET /ydoc answered ${response.status}`);\n    }\n    stillReceiving();\n    const body = await readBody({ response, onChunk: stillReceiving });\n    const decoded = decoding.readAny(decoding.createDecoder(body)) as { doc?: unknown } | null;\n    if (decoded === null || typeof decoded !== 'object' || !(decoded.doc instanceof Uint8Array)) {\n      throw new Error('GET /ydoc answered a body without a document');\n    }\n    return {\n      // a copy: lib0 hands out a view into the body\n      update: new Uint8Array(decoded.doc),\n      answersSyncStep1: response.headers.get(INITIAL_SYNC_CAPABILITY_HEADER) === INITIAL_SYNC_DIFF,\n      bytes: body.byteLength,\n    };\n  } catch (error) {\n    // The idle timeout's own reason, whatever the runtime's fetch rejected the stopped read with\n    if (reading.signal.aborted && !signal?.aborted) throw reading.signal.reason;\n    throw error;\n  } finally {\n    if (idle !== null) clearTimeout(idle);\n    signal?.removeEventListener('abort', stop);\n  }\n}\n\n/** Where {@link rememberInitialSyncSupport} keeps what it learned: `localStorage`'s surface. */\nexport interface InitialSyncSupportStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nconst MEMO_PREFIX = 'keryx-initial-sync:';\n/** A Keryx that answered without the header is asked again an hour later: it may have been upgraded. */\nexport const INITIAL_SYNC_UNSUPPORTED_TTL_MS = 60 * 60 * 1000;\n/** A Keryx that answers is believed for a week; one rolled back meanwhile just sends whole documents. */\nexport const INITIAL_SYNC_SUPPORTED_TTL_MS = 7 * 24 * 60 * 60 * 1000;\n\n/** The origin a socket URL connects to, as the memo keys it (`wss://host`). */\nexport function keryxOriginOf(wsUrl: string): string | null {\n  try {\n    const parsed = new URL(wsUrl);\n    return `${parsed.protocol}//${parsed.host}`;\n  } catch {\n    return null;\n  }\n}\n\n/** Remember whether the Keryx at `origin` answered with the capability header. */\nexport function rememberInitialSyncSupport({\n  storage,\n  origin,\n  supported,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  supported: boolean;\n  now?: number;\n}): void {\n  try {\n    storage?.setItem(`${MEMO_PREFIX}${origin}`, JSON.stringify({ supported, at: now }));\n  } catch {\n    // a full or refused storage only costs the next open a read\n  }\n}\n\n/**\n * What is known of the Keryx at `origin`: `true` (it answers a socket's sync step 1), `false` (it\n * did not, within the last hour) or `null` (not known: read it and see).\n */\nexport function knownInitialSyncSupport({\n  storage,\n  origin,\n  now = Date.now(),\n}: {\n  storage: InitialSyncSupportStorage | null;\n  origin: string;\n  now?: number;\n}): boolean | null {\n  let raw: string | null = null;\n  try {\n    raw = storage?.getItem(`${MEMO_PREFIX}${origin}`) ?? null;\n  } catch {\n    return null;\n  }\n  if (raw === null) return null;\n  try {\n    const memo = JSON.parse(raw) as { supported?: unknown; at?: unknown };\n    if (typeof memo.supported !== 'boolean' || typeof memo.at !== 'number') return null;\n    const ttl = memo.supported ? INITIAL_SYNC_SUPPORTED_TTL_MS : INITIAL_SYNC_UNSUPPORTED_TTL_MS;\n    return now - memo.at <= ttl ? memo.supported : null;\n  } catch {\n    return null;\n  }\n}\n"],"names":["decoding"],"mappings":"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"}