@arbidocs/react 0.5.111 → 0.5.112

package/dist/query-keys.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/query-keys.ts"],
+  "sourcesContent": ["/**\n * The one query-key factory of the ARBI front end: every React Query key and mutation key the\n * packages and the app use is built here, under `['arbi', \u2026]`. Literal key arrays anywhere else\n * fail the `arbi/query-keys-from-factory` lint rule and `query-keys.guard.test.ts`, so a key can't\n * drift from the queries it names (a stale literal reads or invalidates nothing, silently).\n *\n * Dependency-free on purpose (types only): e2e helpers import it and pass keys into the page.\n */\n\nimport type {\n  CalendarWindow,\n  ListEventsParams,\n  OverlayLayerName,\n  RoomQuery,\n} from '@arbidocs/sdk/browser'\n\nexport const arbiQueryKeys = {\n  fileShares: () => ['arbi', 'fileShares'] as const,\n  fileShare: (id: string) => ['arbi', 'fileShare', id] as const,\n  fileSharePdf: (id: string, status?: string) => ['arbi', 'fileSharePdf', id, status] as const,\n  workspaces: () => ['arbi', 'workspaces'] as const,\n  /** Every workspace's member list: what a workspace switch drops. */\n  allWorkspaceUsers: () => ['arbi', 'workspaceUsers'] as const,\n  workspaceUsers: (workspaceId: string) => ['arbi', 'workspaceUsers', workspaceId] as const,\n  /** Every workspace's documents list: the prefix a write patches when it does not know the workspace. */\n  allDocuments: () => ['arbi', 'documents'] as const,\n  documents: (workspaceId: string) => ['arbi', 'documents', workspaceId] as const,\n  /** One document (a viewer's); writes keep it current next to the list. */\n  document: (docId: string) => ['arbi', 'document', docId] as const,\n  documentsById: (docIds: string[]) =>\n    ['arbi', 'documentsById', [...docIds].sort().join(',')] as const,\n  /** Every workspace's near-duplicate pairs. */\n  allSimilarDocuments: () => ['arbi', 'similarDocuments'] as const,\n  similarDocuments: (workspaceId: string, threshold: number) =>\n    ['arbi', 'similarDocuments', workspaceId, threshold] as const,\n  /** Every version list: the prefix a new version invalidates. */\n  allDocumentVersions: () => ['arbi', 'documentVersions'] as const,\n  documentVersions: (docId: string) => ['arbi', 'documentVersions', docId] as const,\n  conversations: (workspaceId: string) => ['arbi', 'conversations', workspaceId] as const,\n  /** Every workspace's conversation list (and threads): the prefix a conversation write invalidates. */\n  allConversations: () => ['arbi', 'conversations'] as const,\n  /** A conversation's threads, under the conversations prefix (ids are unique across workspaces). */\n  conversationThreads: (conversationId: string) =>\n    ['arbi', 'conversations', conversationId, 'threads'] as const,\n  /** One stored message with everything the server keeps on it (its trace and metadata). */\n  messageDetails: (messageId: string) => ['arbi', 'messageDetails', messageId] as const,\n  /** The backend's built-in slash commands. */\n  assistantCommands: () => ['arbi', 'assistantCommands'] as const,\n  /** Every workspace's tags (lists, tables and kinds): what a cross-workspace change refreshes. */\n  allTags: () => ['arbi', 'tags'] as const,\n  tags: (workspaceId: string) => ['arbi', 'tags', workspaceId] as const,\n  /** Under the workspace's tags: the kinds' fields (refreshed with the tags). */\n  tagKinds: (workspaceId: string) => ['arbi', 'tags', workspaceId, 'kinds'] as const,\n  /** Every filtered list (a table of tags): what a tag write refreshes, the whole list aside. */\n  tagLists: (workspaceId: string) => ['arbi', 'tags', workspaceId, 'list'] as const,\n  /** Under the workspace's tags: a tag, doctag or fact write that invalidates `tags` refreshes it. */\n  tagList: (workspaceId: string, query: string) =>\n    ['arbi', 'tags', workspaceId, 'list', query] as const,\n  /** A kind's fields, under the workspace's tags. */\n  tagKind: (workspaceId: string, kind: string) =>\n    ['arbi', 'tags', workspaceId, 'kind', kind] as const,\n  /** A task's history, under the conversations prefix: every conversation write refreshes it. */\n  conversationActivity: (conversationId: string) =>\n    ['arbi', 'conversations', conversationId, 'activity'] as const,\n  thumbnails: (docIds: string[]) => ['arbi', 'thumbnails', [...docIds].sort().join(',')] as const,\n  /** Every stage of a document's parsed content. */\n  parsedDocument: (docId: string) => ['arbi', 'parsedDoc', docId] as const,\n  parsedDoc: (docId: string, stage: string) => ['arbi', 'parsedDoc', docId, stage] as const,\n  agents: () => ['arbi', 'agents'] as const,\n  sessions: () => ['arbi', 'sessions'] as const,\n  health: () => ['arbi', 'health'] as const,\n  workflows: () => ['arbi', 'workflows'] as const,\n  /** Under `workflows()`: a workflow write or run refreshes its runs too. */\n  workflowRuns: (workflowId: string) => ['arbi', 'workflows', workflowId, 'runs'] as const,\n  /** Every workspace's facts: the prefix a fact write invalidates. */\n  allFacts: () => ['arbi', 'facts'] as const,\n  facts: (workspaceId: string) => ['arbi', 'facts', workspaceId] as const,\n  configs: () => ['arbi', 'configs'] as const,\n  activity: () => ['arbi', 'activity'] as const,\n  /** Every transfer query (jobs, lists, plans): what a finished job refreshes. */\n  allWorkspaceTransfers: () => ['arbi', 'workspaceTransfers'] as const,\n  /** The caller's recent transfer jobs out of a workspace. */\n  workspaceTransfers: (workspaceId: string) =>\n    ['arbi', 'workspaceTransfers', 'list', workspaceId] as const,\n  /** One transfer job's progress. */\n  workspaceTransfer: (transferId: string) =>\n    ['arbi', 'workspaceTransfers', 'job', transferId] as const,\n  /** What a scope (serialised) would take in a workspace, for a mode. */\n  workspaceTransferPlan: (workspaceId: string, scope: string, mode: string) =>\n    ['arbi', 'workspaceTransfers', 'plan', workspaceId, scope, mode] as const,\n  /**\n   * A workspace's activity feed (all its pages), read `limit` entries a page (absent: the server's\n   * default): each page size is its own entry, under the workspace's key.\n   */\n  workspaceActivity: (workspaceId: string, limit?: number) =>\n    limit === undefined\n      ? (['arbi', 'workspaceActivity', workspaceId] as const)\n      : (['arbi', 'workspaceActivity', workspaceId, limit] as const),\n  projects: () => ['arbi', 'projects'] as const,\n  projectUsage: (projectExtId: string, monthsBack: number) =>\n    ['arbi', 'projectUsage', projectExtId, monthsBack] as const,\n  projectConversationUsage: (projectExtId: string, monthsBack: number) =>\n    ['arbi', 'projectUsage', projectExtId, 'byConversation', monthsBack] as const,\n  projectInvoices: (projectExtId: string) => ['arbi', 'projectInvoices', projectExtId] as const,\n  /** The plans and add-ons on sale. */\n  products: () => ['arbi', 'products'] as const,\n  /** Prices of a purchase or a change (quotes, previews); nothing is bought. */\n  billingQuotes: () => ['arbi', 'billingQuote'] as const,\n  userUsageToday: () => ['arbi', 'userUsageToday'] as const,\n  currentUser: () => ['arbi', 'currentUser'] as const,\n  firmPool: () => ['arbi', 'firmPool'] as const,\n  contacts: () => ['arbi', 'contacts'] as const,\n  /** Every chat query (the list and each open thread). */\n  chats: () => ['arbi', 'chats'] as const,\n  /** My chats, raw (titles and last messages are ciphertext), most recently active first. */\n  chatList: () => ['arbi', 'chats', 'list'] as const,\n  /** One thread's loaded messages, decrypted, oldest first (`ChatThreadData`). */\n  chatThread: (chatExtId: string) => ['arbi', 'chats', 'thread', chatExtId] as const,\n  /** My own agent's progress on my last message to it (`agent_dm_status`), per agent. */\n  agentDmStatus: (agentExtId: string) => ['arbi', 'chats', 'agentStatus', agentExtId] as const,\n  /** The paid features this person may use (`/v1/user/entitlements`). */\n  entitlements: () => ['arbi', 'entitlements'] as const,\n  skills: () => ['arbi', 'skills'] as const,\n  /** A skill's main file (SKILL.md), as text. */\n  skillSource: (docExtId: string) => ['arbi', 'skills', 'source', docExtId] as const,\n  /** An agent's pinned config; `undefined` = the library default config. */\n  agentConfig: (agentExtId?: string) => ['arbi', 'agentConfig', agentExtId ?? 'default'] as const,\n  agentWorkspaces: (agentExtId: string) => ['arbi', 'agentWorkspaces', agentExtId] as const,\n  /** An agent's own login, polled while its controls are open. */\n  agentSession: (agentExtId: string) => ['arbi', 'agentSession', agentExtId] as const,\n  agentChats: (agentExtId: string) => ['arbi', 'agentChats', agentExtId] as const,\n  authorizeLimits: () => ['arbi', 'authorizeLimits'] as const,\n  mcpTools: () => ['arbi', 'mcpTools'] as const,\n  models: () => ['arbi', 'models'] as const,\n  availableModels: () => ['arbi', 'availableModels'] as const,\n  modelConnections: (userId?: string) => ['arbi', 'modelConnections', userId] as const,\n  directModelUsage: (userId?: string) => ['arbi', 'directModelUsage', userId] as const,\n  /** The signed-in user's own profile (name, picture, email). */\n  profile: () => ['arbi', 'profile'] as const,\n  identity: () => ['arbi', 'identity'] as const,\n  /** The signed-in user's settings record (notification preferences, flags). */\n  userSettings: () => ['arbi', 'userSettings'] as const,\n  /** Every notification list: the prefix a delete, a read receipt or an arrival invalidates. */\n  allSupportTickets: () => ['arbi', 'support'] as const,\n  supportTickets: () => ['arbi', 'support', 'tickets'] as const,\n  supportTicket: (id: number) => ['arbi', 'support', 'tickets', id] as const,\n  allNotifications: () => ['arbi', 'notifications'] as const,\n  /** The newest `limit` notifications, received and sent. */\n  notifications: (limit: number) => ['arbi', 'notifications', limit] as const,\n  /** The documents a workspace may use as its Word house template. */\n  houseTemplateCandidates: (workspaceId: string) =>\n    ['arbi', 'houseTemplateCandidates', workspaceId] as const,\n  // \u2500\u2500 Storage, archive \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  /** Every storage view (projects, items, names, Recently deleted): what a restore or delete refreshes. */\n  storage: () => ['arbi', 'storage'] as const,\n  /** What each project stores; no params: every such list. */\n  storageProjects: (params?: object) =>\n    params === undefined\n      ? (['arbi', 'storage', 'projects'] as const)\n      : (['arbi', 'storage', 'projects', params] as const),\n  /** The largest items stored; no params: every such list. */\n  storageItems: (params?: object) =>\n    params === undefined\n      ? (['arbi', 'storage', 'items'] as const)\n      : (['arbi', 'storage', 'items', params] as const),\n  /** Decrypted document names of storage items. */\n  storageItemNames: (params?: object) =>\n    params === undefined\n      ? (['arbi', 'storage', 'names'] as const)\n      : (['arbi', 'storage', 'names', params] as const),\n  /** The deployment's storage day by day. */\n  storageSnapshots: (params?: object) =>\n    params === undefined\n      ? (['arbi', 'storage', 'snapshots'] as const)\n      : (['arbi', 'storage', 'snapshots', params] as const),\n  /** A workspace's Recently deleted documents; no id: every workspace's. */\n  workspaceTrash: (workspaceId?: string) =>\n    workspaceId === undefined\n      ? (['arbi', 'storage', 'workspaceTrash'] as const)\n      : (['arbi', 'storage', 'workspaceTrash', workspaceId] as const),\n  /** A workspace's archive state; no id: every workspace's. */\n  workspaceArchive: (workspaceId?: string) =>\n    workspaceId === undefined\n      ? (['arbi', 'workspaceArchive'] as const)\n      : (['arbi', 'workspaceArchive', workspaceId] as const),\n  // \u2500\u2500 Databases \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Every key below names its workspace right after its kind: a list read in one workspace is never\n  // served, or overwritten, in another (the list is the session's open workspace on the server).\n  /** Every database query of every workspace (what a write or a switch refreshes). */\n  databases: () => ['arbi', 'databases'] as const,\n  /** A workspace's databases; no id: every workspace's. */\n  databaseList: (workspaceId?: string) =>\n    workspaceId === undefined\n      ? (['arbi', 'databases', 'list'] as const)\n      : (['arbi', 'databases', 'list', workspaceId] as const),\n  /** One database of a workspace; no workspace: every one read. */\n  database: (workspaceId?: string, databaseId?: string) =>\n    workspaceId === undefined\n      ? (['arbi', 'databases', 'one'] as const)\n      : (['arbi', 'databases', 'one', workspaceId, databaseId ?? ''] as const),\n  /**\n   * A database's rows (a search); no workspace: every database's, no params: every search of one.\n   * `['arbi', 'databases', 'rows', workspaceId, databaseId, params]`.\n   */\n  databaseRows: (workspaceId?: string, databaseId?: string, params?: object) =>\n    workspaceId === undefined\n      ? (['arbi', 'databases', 'rows'] as const)\n      : params === undefined\n        ? (['arbi', 'databases', 'rows', workspaceId, databaseId ?? ''] as const)\n        : (['arbi', 'databases', 'rows', workspaceId, databaseId ?? '', params] as const),\n  /** The saved dashboards of a store's scope (the user's own, or a workspace's database). */\n  dashboards: (scope: string) => ['arbi', 'dashboards', scope] as const,\n  /** A database's rows grouped and measured (a chart); no workspace: every database's. */\n  databaseAggregate: (workspaceId?: string, databaseId?: string, request?: object) =>\n    workspaceId === undefined\n      ? (['arbi', 'databases', 'aggregate'] as const)\n      : (['arbi', 'databases', 'aggregate', workspaceId, databaseId ?? '', request ?? {}] as const),\n  // \u2500\u2500 Configs, health \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  /** Under `configs()`: the saved configuration versions. */\n  configVersions: () => ['arbi', 'configs', 'versions'] as const,\n  /** Under `configs()`: the JSON schema of every config model. */\n  configSchema: () => ['arbi', 'configs', 'schema'] as const,\n  /** Under `configs()`: one configuration. */\n  config: (configId: string) => ['arbi', 'configs', 'one', configId] as const,\n  /** The remote model providers' health. */\n  remoteModels: () => ['arbi', 'remoteModels'] as const,\n  // \u2500\u2500 Conversations \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  /** Under the conversations prefix: what a parked run waits for the owner to allow. */\n  conversationPendingAuth: (conversationId: string) =>\n    ['arbi', 'conversations', conversationId, 'pending-auth'] as const,\n  // \u2500\u2500 Document tools \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  /** Signatures on a document (a version); no id: every document's. */\n  documentSignatures: (docId?: string, version?: number | null) =>\n    docId === undefined\n      ? (['arbi', 'documentSignatures'] as const)\n      : (['arbi', 'documentSignatures', docId, version ?? null] as const),\n  /** The certificate of a signature reference. */\n  signatureVerification: (reference: string) =>\n    ['arbi', 'signatureVerification', reference] as const,\n  /** Every signature request list: what a request write refreshes. */\n  signatureRequests: () => ['arbi', 'signatureRequests'] as const,\n  signatureRequestsForDocument: (docId: string) =>\n    ['arbi', 'signatureRequests', 'document', docId] as const,\n  /** Who may sign in a workspace; no id: every workspace's. */\n  signatureCandidates: (workspaceId?: string) =>\n    workspaceId === undefined\n      ? (['arbi', 'signatureRequests', 'candidates'] as const)\n      : (['arbi', 'signatureRequests', 'candidates', workspaceId] as const),\n  /** The user's saved (informal) signature. */\n  savedSignature: () => ['arbi', 'savedSignature'] as const,\n  /** An html/react artifact's source. */\n  artifactSource: (docId: string) => ['arbi', 'artifactSource', docId] as const,\n  /** An artifact's text, under its parsed content (refreshed with it). */\n  artifactText: (docId: string) => ['arbi', 'parsedDoc', docId, 'marker', 'artifact-text'] as const,\n  /** An image document's bytes as an object URL. */\n  assetImage: (docId: string) => ['arbi', 'assetImage', docId] as const,\n  // \u2500\u2500 Misc \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  /** An agent config's model tier (the builder's badge). */\n  agentConfigModel: (configId: string) => ['arbi', 'agentConfigModel', configId] as const,\n  /** Under `billingQuotes()`: the price of a plan change. */\n  billingPreview: (projectExtId: string, change: unknown) =>\n    ['arbi', 'billingQuote', 'preview', projectExtId, change] as const,\n  billingPlanQuote: (projectExtId: string | null, body: unknown) =>\n    ['arbi', 'billingQuote', 'plan', projectExtId, body] as const,\n  billingAddonQuote: (projectExtId: string, kind: string) =>\n    ['arbi', 'billingQuote', 'addon', projectExtId, kind] as const,\n  /** Under `contacts()`: a search of the people one can reach. */\n  contactSearch: (term: string) => ['arbi', 'contacts', 'search', term] as const,\n  /** Under the workspace's facts: a filtered list. */\n  factList: (workspaceId: string, filter: unknown) =>\n    ['arbi', 'facts', workspaceId, filter] as const,\n  /**\n   * Under `skills()`: a workspace's list, hidden ones included or not. Without a marketplace the\n   * server lists the open workspace's skills, so the list is kept per workspace.\n   */\n  skillList: (workspaceId: string, includeHidden: boolean) =>\n    ['arbi', 'skills', 'list', workspaceId, includeHidden] as const,\n  /** Under the project's events: one kind, one page size. */\n  projectEventList: (projectExtId: string, kind: string, limit: number | 'default') =>\n    ['arbi', 'projects', projectExtId, 'events', kind, limit] as const,\n  /** The documents pinned for offline reading on this device. */\n  offlineDocuments: () => ['arbi', 'offlineDocuments'] as const,\n  /** Notifications of one kind for a deployment's user (polled). */\n  typedNotifications: (kind: string, apiUrl: string, userId: string | undefined) =>\n    ['arbi', 'typedNotifications', kind, apiUrl, userId ?? ''] as const,\n}\n\n/**\n * Keys of the mutations a host may need to follow (its own caches outside these hooks), e.g. with\n * a `MutationCache` subscription: a workflow run creates a task in the host's own task list.\n */\nexport const arbiMutationKeys = {\n  /** A member's role changed. */\n  setWorkspaceMemberRoles: () => ['arbi', 'workspaces', 'roles'] as const,\n  runWorkflow: () => ['arbi', 'workflows', 'run'] as const,\n  updateTagKindSchema: () => ['arbi', 'tags', 'kinds', 'update'] as const,\n  createTag: () => ['arbi', 'tags', 'create'] as const,\n  updateTag: () => ['arbi', 'tags', 'update'] as const,\n  deleteTag: () => ['arbi', 'tags', 'delete'] as const,\n  extractEntities: () => ['arbi', 'tags', 'entities', 'extract'] as const,\n  updateDocuments: () => ['arbi', 'documents', 'update'] as const,\n  deleteDocuments: () => ['arbi', 'documents', 'delete'] as const,\n  uploadDocuments: () => ['arbi', 'documents', 'upload'] as const,\n  uploadUrls: () => ['arbi', 'documents', 'uploadUrls'] as const,\n  assignDocTags: () => ['arbi', 'doctags', 'assign'] as const,\n  removeDocTags: () => ['arbi', 'doctags', 'remove'] as const,\n  updateDocTag: () => ['arbi', 'doctags', 'update'] as const,\n  generateDocTags: () => ['arbi', 'doctags', 'generate'] as const,\n  /** Members added to or removed from a workspace (leaving included). */\n  workspaceMembership: () => ['arbi', 'workspaces', 'members'] as const,\n  /** A chat turn being sent (the app's send pipeline). */\n  sendMessage: () => ['arbi', 'conversations', 'send'] as const,\n}\n\n/**\n * Query keys of the calendar hooks, all under `['arbi', 'calendar']`. The calendar is the user's,\n * not a workspace's; only the overlays carry the open workspace.\n */\nexport const calendarQueryKeys = {\n  all: () => ['arbi', 'calendar'] as const,\n  settings: () => ['arbi', 'calendar', 'settings'] as const,\n  calendars: () => ['arbi', 'calendar', 'calendars'] as const,\n  /** Every event list: the prefix an event write invalidates. */\n  events: () => ['arbi', 'calendar', 'events'] as const,\n  eventList: (p: ListEventsParams) =>\n    [\n      'arbi',\n      'calendar',\n      'events',\n      { start: p.start, end: p.end, calendars: p.calendars?.join(',') ?? null },\n    ] as const,\n  /** Every single event read. */\n  eventDetails: () => ['arbi', 'calendar', 'event'] as const,\n  event: (id: string, recurrenceId?: string | null) =>\n    ['arbi', 'calendar', 'event', id, recurrenceId ?? null] as const,\n  shares: (calId: string) => ['arbi', 'calendar', 'shares', calId] as const,\n  invitations: () => ['arbi', 'calendar', 'invitations'] as const,\n  holidayCountries: () => ['arbi', 'calendar', 'holiday-countries'] as const,\n  allRooms: () => ['arbi', 'calendar', 'rooms'] as const,\n  rooms: (q: RoomQuery) => ['arbi', 'calendar', 'rooms', q] as const,\n  freebusy: (attendees: string[], start: string, end: string) =>\n    ['arbi', 'calendar', 'freebusy', attendees.join(','), start, end] as const,\n  allLookups: () => ['arbi', 'calendar', 'lookup'] as const,\n  lookup: (uid: string) => ['arbi', 'calendar', 'lookup', uid] as const,\n  overlays: (workspaceId: string | null, w?: CalendarWindow, layers?: OverlayLayerName[]) =>\n    [\n      'arbi',\n      'calendar',\n      'overlays',\n      workspaceId,\n      w ? { start: w.start, end: w.end, layers: layers?.join(',') } : null,\n    ] as const,\n  accounts: () => ['arbi', 'calendar', 'accounts'] as const,\n  caldavProfiles: () => ['arbi', 'calendar', 'caldav-profiles'] as const,\n  bookingPages: () => ['arbi', 'calendar', 'booking-pages'] as const,\n  /** The offline outbox (writes made offline, not yet sent). */\n  outbox: () => ['arbi', 'calendar', 'outbox'] as const,\n}\n\n/** Query keys of the call hooks, all under `['arbi', 'calls']`. Calls are the user's, not a workspace's. */\nexport const callQueryKeys = {\n  all: () => ['arbi', 'calls'] as const,\n  config: () => ['arbi', 'calls', 'config'] as const,\n  call: (callExtId: string) => ['arbi', 'calls', 'call', callExtId] as const,\n  /** Everything about a call's recordings: the prefix a recording event invalidates. */\n  recordingsOf: (callExtId: string) => ['arbi', 'calls', 'recordings', callExtId] as const,\n  recordings: (callExtId: string) => ['arbi', 'calls', 'recordings', callExtId, 'list'] as const,\n  recording: (callExtId: string, recordingExtId: string) =>\n    ['arbi', 'calls', 'recordings', callExtId, 'one', recordingExtId] as const,\n  inviteLinks: (callExtId: string) => ['arbi', 'calls', 'invite-links', callExtId] as const,\n}\n\nexport const connectorQueryKeys = {\n  all: () => ['arbi', 'connectors'] as const,\n  catalog: () => ['arbi', 'connectors', 'catalog'] as const,\n  mine: () => ['arbi', 'connectors', 'mine'] as const,\n  mailboxFolders: (vendor: string) => ['arbi', 'connectors', 'folders', vendor] as const,\n  mailboxSyncProgress: (vendor: string, workspaceExtId: string) =>\n    ['arbi', 'connectors', 'sync-progress', vendor, workspaceExtId] as const,\n  allMailboxSyncProgress: () => ['arbi', 'connectors', 'sync-progress'] as const,\n  driveFolders: (vendor: string) => ['arbi', 'connectors', 'drive-folders', vendor] as const,\n  driveFolderChildren: (vendor: string, itemId: string) =>\n    ['arbi', 'connectors', 'drive-folder-children', vendor, itemId] as const,\n  driveFolderDocCount: (vendor: string, itemId: string) =>\n    ['arbi', 'connectors', 'drive-folder-doc-count', vendor, itemId] as const,\n  driveSyncEstimate: (vendor: string) =>\n    ['arbi', 'connectors', 'drive-sync-estimate', vendor] as const,\n  driveSyncProgress: (vendor: string) =>\n    ['arbi', 'connectors', 'drive-sync-progress', vendor] as const,\n  allDriveSyncProgress: () => ['arbi', 'connectors', 'drive-sync-progress'] as const,\n  slack: () => ['arbi', 'connectors', 'slack'] as const,\n}\n\nexport const mailQueryKeys = {\n  all: () => ['arbi', 'mail'] as const,\n  policy: () => ['arbi', 'mail', 'policy'] as const,\n  accounts: () => ['arbi', 'mail', 'accounts'] as const,\n  unlock: (accountId: string | undefined, sessionKey: string | null) =>\n    ['arbi', 'mail', 'unlock', accountId, sessionKey ?? ''] as const,\n  allFolders: () => ['arbi', 'mail', 'folders'] as const,\n  folders: (accountId: string | undefined) => ['arbi', 'mail', 'folders', accountId] as const,\n  allMessages: () => ['arbi', 'mail', 'messages'] as const,\n  messages: (\n    accountId: string | undefined,\n    folderId: string | undefined,\n    query: string,\n    cursor: string | null\n  ) => ['arbi', 'mail', 'messages', accountId, folderId, query, cursor] as const,\n  message: (accountId: string | undefined, messageId: string | null | undefined) =>\n    ['arbi', 'mail', 'message', accountId, messageId] as const,\n  /** Every conversation list: the prefix a flag or move patches or refreshes. */\n  allConversations: () => ['arbi', 'mail', 'conversations'] as const,\n  conversations: (\n    accountId: string | undefined,\n    folderId: string | undefined,\n    query: string,\n    cursor: string | null\n  ) => ['arbi', 'mail', 'conversations', accountId, folderId, query, cursor] as const,\n  /** Every thread read of an account. */\n  accountThreads: (accountId: string) => ['arbi', 'mail', 'thread', accountId] as const,\n  thread: (\n    accountId: string | undefined,\n    threadId: string | null | undefined,\n    folderId: string | undefined\n  ) => ['arbi', 'mail', 'thread', accountId, threadId, folderId] as const,\n  /** Where the ARBI mailbox files mail (folders and conversations, per workspace). */\n  nativeFiling: () => ['arbi', 'mail', 'filing', 'native'] as const,\n  /** Every filing lookup: refreshed after mail is added to a workspace or a rule is stopped. */\n  allFiling: () => ['arbi', 'mail', 'filing'] as const,\n  filing: (accountId: string | undefined, messageIds: string[], threadIds: string[]) =>\n    ['arbi', 'mail', 'filing', accountId, messageIds.join(' '), threadIds.join(' ')] as const,\n  /** The key the user's client keys older native mail with: outside the `['arbi', 'mail']` prefix, so\n   * refreshing mail never fetches it again. */\n  threadSecret: () => ['arbi', 'mail-thread-secret'] as const,\n  /** The projects an email's AI work can be billed to. */\n  projects: () => ['arbi', 'mail', 'projects'] as const,\n  /** A saved draft prepared for editing. */\n  draftCompose: (accountId: string | undefined, draftId: string | undefined) =>\n    ['arbi', 'mail', 'draft-compose', accountId, draftId] as const,\n  attachmentText: (accountId: string, messageId: string, attachmentId: string) =>\n    ['arbi', 'mail', 'attachment-text', accountId, messageId, attachmentId] as const,\n}\n\n/** `pdf`: the document as a PDF; `original`: the stored file (an image, a recording, a sheet). */\nexport type DocumentBytesKind = 'pdf' | 'original'\n\n/** Every version and kind of a document's bytes: the prefix a new version invalidates. */\nexport const documentBytesKey = (\n  documentRef: string,\n  version?: number | null,\n  kind?: DocumentBytesKind\n) =>\n  version === undefined\n    ? (['arbi', 'documentBytes', documentRef] as const)\n    : (['arbi', 'documentBytes', documentRef, version, kind ?? 'pdf'] as const)\n\n/** Whether `queryKey` lies under `prefix` (a factory key): React Query's own prefix match. */\nexport function isUnderQueryKey(queryKey: readonly unknown[], prefix: readonly unknown[]): boolean {\n  return prefix.every((part, i) => queryKey[i] === part)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/query-persist.js

@@ -0,0 +1,66 @@
+import { get, set, del } from "idb-keyval";
+import {
+  isOfflineReadableArbiQuery,
+  isReplayableArbiMutation,
+  isRestorableArbiQueryOnline
+} from "./offline.js";
+const IDB_KEY = "arbi-react-query-cache";
+const OWNER_KEY = "arbi-react-query-cache-owner";
+const CACHE_BUSTER = "arbi-rq-v2";
+const MAX_AGE = 1e3 * 60 * 60 * 24 * 7;
+function createIDBPersister() {
+  return {
+    persistClient: (client) => set(IDB_KEY, client),
+    // The offline persister must be INERT when online. Because the documents
+    // list never auto-refetches, a rehydrated copy would be trusted
+    // indefinitely and surface stale statuses across a reload — e.g. a document
+    // that finished processing while the tab was closed (its one-shot
+    // completion WS event is long gone) still renders as "queued". So when
+    // online we strip that query from the restored cache; it then loads
+    // fresh from the server exactly as it did before offline support existed.
+    // A document caught mid-processing is stripped for the same reason, and the
+    // entitlements are read fresh (isRestorableArbiQueryOnline).
+    // Queued offline mutations and all other queries restore normally. When
+    // offline we keep everything so the pages still have something to show.
+    restoreClient: async () => {
+      const persisted = await get(IDB_KEY);
+      if (!persisted) return persisted;
+      const isOffline = typeof navigator !== "undefined" && navigator.onLine === false;
+      if (isOffline) return persisted;
+      persisted.clientState.queries = persisted.clientState.queries.filter(
+        (q) => isRestorableArbiQueryOnline(q.queryKey, q.state.data)
+      );
+      return persisted;
+    },
+    removeClient: () => del(IDB_KEY)
+  };
+}
+async function claimOfflineQueue(userExtId) {
+  const owner = await get(OWNER_KEY);
+  if (owner !== userExtId) await del(IDB_KEY);
+  await set(OWNER_KEY, userExtId);
+}
+function createArbiQueryPersistOptions() {
+  return {
+    persister: createIDBPersister(),
+    maxAge: MAX_AGE,
+    buster: CACHE_BUSTER,
+    dehydrateOptions: {
+      // Persist mutations that were paused offline so a queued write (apply tag,
+      // edit field) survives a reload and replays on reconnect. Resuming them
+      // after a reload requires the registered mutation defaults
+      // (registerArbiMutationDefaults). Scope to real offline EDITS: an incidental
+      // paused mutation (e.g. workspace-open) isn't a user change to queue/replay.
+      shouldDehydrateMutation: (mutation) => mutation.state.isPaused && isReplayableArbiMutation(mutation.options.mutationKey),
+      shouldDehydrateQuery: (query) => {
+        if (query.state.status !== "success") return false;
+        return isOfflineReadableArbiQuery(query.queryKey);
+      }
+    }
+  };
+}
+export {
+  claimOfflineQueue,
+  createArbiQueryPersistOptions
+};
+//# sourceMappingURL=query-persist.js.map

package/dist/query-persist.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/query-persist.ts"],
+  "sourcesContent": ["/**\n * The query cache kept for an offline start (`createArbiQueryClient({ persist: true })`).\n *\n * Persists a *metadata-only* slice of the query cache to IndexedDB so an already signed-in user\n * can cold-start offline and still see their workspaces and documents list (and open a pinned\n * document). Deliberately conservative about what is written to disk: only the families\n * {@link isOfflineReadableArbiQuery} names; NEVER conversations, messages or document bytes (the\n * pinned bytes live separately, encrypted: `offline-documents.ts`).\n *\n * An async IndexedDB persister (idb-keyval, structured clone) rather than the JSON sync persister:\n * the robust choice for binary-capable storage.\n */\n\nimport { get, set, del } from 'idb-keyval'\nimport type {\n  PersistedClient,\n  Persister,\n  PersistQueryClientOptions,\n} from '@tanstack/react-query-persist-client'\nimport {\n  isOfflineReadableArbiQuery,\n  isReplayableArbiMutation,\n  isRestorableArbiQueryOnline,\n} from './offline'\n\nconst IDB_KEY = 'arbi-react-query-cache'\n\n// Which account the persisted offline queue belongs to. The queue is one record\n// per browser, so it is only valid for the account that wrote it.\nconst OWNER_KEY = 'arbi-react-query-cache-owner'\n\n// Bump to invalidate everyone's persisted cache after an incompatible change.\n// v2: documents and their writes moved to the `@arbidocs/react` keys.\nconst CACHE_BUSTER = 'arbi-rq-v2'\n\nconst MAX_AGE = 1000 * 60 * 60 * 24 * 7 // 7 days\n\n/** What `<PersistQueryClientProvider persistOptions>` takes for the package's offline cache. */\nexport type ArbiQueryPersistOptions = Omit<PersistQueryClientOptions, 'queryClient'>\n\nfunction createIDBPersister(): Persister {\n  return {\n    persistClient: (client: PersistedClient) => set(IDB_KEY, client),\n    // The offline persister must be INERT when online. Because the documents\n    // list never auto-refetches, a rehydrated copy would be trusted\n    // indefinitely and surface stale statuses across a reload \u2014 e.g. a document\n    // that finished processing while the tab was closed (its one-shot\n    // completion WS event is long gone) still renders as \"queued\". So when\n    // online we strip that query from the restored cache; it then loads\n    // fresh from the server exactly as it did before offline support existed.\n    // A document caught mid-processing is stripped for the same reason, and the\n    // entitlements are read fresh (isRestorableArbiQueryOnline).\n    // Queued offline mutations and all other queries restore normally. When\n    // offline we keep everything so the pages still have something to show.\n    restoreClient: async () => {\n      const persisted = await get<PersistedClient>(IDB_KEY)\n      if (!persisted) return persisted\n      const isOffline = typeof navigator !== 'undefined' && navigator.onLine === false\n      if (isOffline) return persisted\n      persisted.clientState.queries = persisted.clientState.queries.filter((q) =>\n        isRestorableArbiQueryOnline(q.queryKey, q.state.data)\n      )\n      return persisted\n    },\n    removeClient: () => del(IDB_KEY),\n  }\n}\n\n/**\n * Hand the offline write queue to the account that is signing in. Queued edits\n * are replayed under whoever is logged in on reload, so a queue left by a\n * different account (or one whose owner was never recorded) must be discarded\n * here \u2014 otherwise another person's edit syncs, and fails, as this user.\n * The same account keeps its queue across logins.\n */\nexport async function claimOfflineQueue(userExtId: string): Promise<void> {\n  const owner = await get<string>(OWNER_KEY)\n  if (owner !== userExtId) await del(IDB_KEY)\n  await set(OWNER_KEY, userExtId)\n}\n\n/** The persistence of the offline cache (see the module comment). */\nexport function createArbiQueryPersistOptions(): ArbiQueryPersistOptions {\n  return {\n    persister: createIDBPersister(),\n    maxAge: MAX_AGE,\n    buster: CACHE_BUSTER,\n    dehydrateOptions: {\n      // Persist mutations that were paused offline so a queued write (apply tag,\n      // edit field) survives a reload and replays on reconnect. Resuming them\n      // after a reload requires the registered mutation defaults\n      // (registerArbiMutationDefaults). Scope to real offline EDITS: an incidental\n      // paused mutation (e.g. workspace-open) isn't a user change to queue/replay.\n      shouldDehydrateMutation: (mutation) =>\n        mutation.state.isPaused && isReplayableArbiMutation(mutation.options.mutationKey),\n      shouldDehydrateQuery: (query) => {\n        if (query.state.status !== 'success') return false\n        // Every query key comes from the package factory: its offline families are the whole\n        // list (document metadata, the workspace list, the settings, the projects, the\n        // entitlements; never a document's content or bytes).\n        return isOfflineReadableArbiQuery(query.queryKey)\n      },\n    },\n  }\n}\n"],
+  "mappings": "AAaA,SAAS,KAAK,KAAK,WAAW;AAM9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,UAAU;AAIhB,MAAM,YAAY;AAIlB,MAAM,eAAe;AAErB,MAAM,UAAU,MAAO,KAAK,KAAK,KAAK;AAKtC,SAAS,qBAAgC;AACvC,SAAO;AAAA,IACL,eAAe,CAAC,WAA4B,IAAI,SAAS,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAY/D,eAAe,YAAY;AACzB,YAAM,YAAY,MAAM,IAAqB,OAAO;AACpD,UAAI,CAAC,UAAW,QAAO;AACvB,YAAM,YAAY,OAAO,cAAc,eAAe,UAAU,WAAW;AAC3E,UAAI,UAAW,QAAO;AACtB,gBAAU,YAAY,UAAU,UAAU,YAAY,QAAQ;AAAA,QAAO,CAAC,MACpE,4BAA4B,EAAE,UAAU,EAAE,MAAM,IAAI;AAAA,MACtD;AACA,aAAO;AAAA,IACT;AAAA,IACA,cAAc,MAAM,IAAI,OAAO;AAAA,EACjC;AACF;AASA,eAAsB,kBAAkB,WAAkC;AACxE,QAAM,QAAQ,MAAM,IAAY,SAAS;AACzC,MAAI,UAAU,UAAW,OAAM,IAAI,OAAO;AAC1C,QAAM,IAAI,WAAW,SAAS;AAChC;AAGO,SAAS,gCAAyD;AACvE,SAAO;AAAA,IACL,WAAW,mBAAmB;AAAA,IAC9B,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMhB,yBAAyB,CAAC,aACxB,SAAS,MAAM,YAAY,yBAAyB,SAAS,QAAQ,WAAW;AAAA,MAClF,sBAAsB,CAAC,UAAU;AAC/B,YAAI,MAAM,MAAM,WAAW,UAAW,QAAO;AAI7C,eAAO,2BAA2B,MAAM,QAAQ;AAAA,MAClD;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/queued-writes.js

@@ -0,0 +1,59 @@
+import { useCallback, useRef } from "react";
+import { isAbortError } from "@arbidocs/client";
+import { ArbiWorkspaceUnavailableError } from "@arbidocs/sdk/browser";
+const QUEUED_WRITE_BLOCKED_MESSAGE = "This change belongs to a workspace that can't be opened right now, so it was not sent. It is kept here until it can be.";
+function primeOnClient(client) {
+  return (workspaceId) => workspaceId === client.session.getState().selectedWorkspaceId ? void 0 : client.workspaceKeys.prime(workspaceId);
+}
+function primeOnArbi(arbi) {
+  return (workspaceId) => arbi.hasWorkspace && workspaceId === arbi.getWorkspaceId() ? void 0 : arbi.workspaces.open(workspaceId);
+}
+async function inWorkspace(prime, workspaceId, write) {
+  if (workspaceId) {
+    try {
+      await prime(workspaceId);
+    } catch (error) {
+      if (isAbortError(error)) throw error;
+      throw new ArbiWorkspaceUnavailableError(workspaceId, error, QUEUED_WRITE_BLOCKED_MESSAGE);
+    }
+  }
+  return write();
+}
+function isWorkspaceUnavailable(error) {
+  return error instanceof ArbiWorkspaceUnavailableError;
+}
+const QUEUED_WRITE_RETRY = {
+  retry: (failureCount, error) => isWorkspaceUnavailable(error) && failureCount < 8,
+  retryDelay: (attempt) => Math.min(1e3 * 2 ** attempt, 3e4)
+};
+function isBlockedOnWorkspace(mutation) {
+  return isWorkspaceUnavailable(mutation.state.error ?? mutation.state.failureReason);
+}
+function useCapturingWorkspace(mutation, capture) {
+  const captureRef = useRef(capture);
+  captureRef.current = capture;
+  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;
+  const mutate = useCallback(
+    (variables, ...rest) => rawMutate(captureRef.current(variables), ...rest),
+    [rawMutate]
+  );
+  const mutateAsync = useCallback(
+    (variables, ...rest) => rawMutateAsync(
+      captureRef.current(variables),
+      ...rest
+    ),
+    [rawMutateAsync]
+  );
+  return { ...mutation, mutate, mutateAsync };
+}
+export {
+  QUEUED_WRITE_BLOCKED_MESSAGE,
+  QUEUED_WRITE_RETRY,
+  inWorkspace,
+  isBlockedOnWorkspace,
+  isWorkspaceUnavailable,
+  primeOnArbi,
+  primeOnClient,
+  useCapturingWorkspace
+};
+//# sourceMappingURL=queued-writes.js.map

package/dist/queued-writes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/queued-writes.ts"],
+  "sourcesContent": ["/**\n * The workspace of a write that may be queued (offline, then replayed on reconnect or after a\n * reload). The workspace is captured when the write is made and kept with it, and the write is\n * sent in that workspace: it is opened for this session first (its key deposited, without\n * switching to it), and the request names it or acts on resources the server keys by their own\n * workspace. So a replay never lands in whatever workspace happens to be open by then.\n *\n * When the workspace cannot be opened (signed out, access removed), nothing is sent: the write\n * fails with `ArbiWorkspaceUnavailableError`, is retried a few times (a reload replays before the\n * sign-in has finished), and then stays in the pending changes as not sent, with its local edit\n * kept, rather than going anywhere else.\n */\n\nimport { useCallback, useRef } from 'react'\nimport { isAbortError, type ArbiClient } from '@arbidocs/client'\nimport { ArbiWorkspaceUnavailableError } from '@arbidocs/sdk/browser'\n\n/** A queued write's own workspace (`wrk-\u2026`), captured when it was made. */\nexport interface QueuedWriteWorkspace {\n  /** The workspace the write belongs to. Filled in when it is made; absent on older queued writes. */\n  workspaceId?: string\n}\n\n/** What a write that could not be sent in its workspace says. */\nexport const QUEUED_WRITE_BLOCKED_MESSAGE =\n  \"This change belongs to a workspace that can't be opened right now, so it was not sent. It is kept here until it can be.\"\n\n/** Opens a workspace for this server session without switching to it (nothing for the current one). */\nexport type WorkspacePrimer = (workspaceId: string) => Promise<void> | void\n\n/** {@link WorkspacePrimer} on a bare client (a replay after a reload): its key, via `/prime-key`. */\nexport function primeOnClient(client: ArbiClient): WorkspacePrimer {\n  return (workspaceId) =>\n    workspaceId === client.session.getState().selectedWorkspaceId\n      ? undefined\n      : client.workspaceKeys.prime(workspaceId)\n}\n\n/** {@link WorkspacePrimer} on an `Arbi` (`workspaces.open`, which never switches). */\nexport function primeOnArbi(arbi: {\n  hasWorkspace: boolean\n  getWorkspaceId(): string\n  workspaces: { open(workspaceId: string): Promise<void> }\n}): WorkspacePrimer {\n  return (workspaceId) =>\n    arbi.hasWorkspace && workspaceId === arbi.getWorkspaceId()\n      ? undefined\n      : arbi.workspaces.open(workspaceId)\n}\n\n/**\n * Run `write` in `workspaceId`: that workspace is opened for this server session first (`prime`).\n * When it can't be, nothing is sent. No workspace (a write queued before workspaces were\n * recorded): as before.\n */\nexport async function inWorkspace<T>(\n  prime: WorkspacePrimer,\n  workspaceId: string | null | undefined,\n  write: () => Promise<T>\n): Promise<T> {\n  if (workspaceId) {\n    try {\n      await prime(workspaceId)\n    } catch (error) {\n      if (isAbortError(error)) throw error\n      throw new ArbiWorkspaceUnavailableError(workspaceId, error, QUEUED_WRITE_BLOCKED_MESSAGE)\n    }\n  }\n  return write()\n}\n\n/** Whether a write failed only because its workspace could not be opened (nothing was sent). */\nexport function isWorkspaceUnavailable(error: unknown): boolean {\n  return error instanceof ArbiWorkspaceUnavailableError\n}\n\n/** How many times a write whose workspace cannot be opened is tried again, and how long apart. */\nexport const QUEUED_WRITE_RETRY = {\n  retry: (failureCount: number, error: unknown) =>\n    isWorkspaceUnavailable(error) && failureCount < 8,\n  retryDelay: (attempt: number) => Math.min(1000 * 2 ** attempt, 30_000),\n} as const\n\n/** Whether a queued write is held back because its workspace cannot be opened. */\nexport function isBlockedOnWorkspace(mutation: {\n  state: { error?: unknown; failureReason?: unknown }\n}): boolean {\n  return isWorkspaceUnavailable(mutation.state.error ?? mutation.state.failureReason)\n}\n\n/**\n * Fill in the workspace of each write a mutation makes, when its caller gave none: `mutate` and\n * `mutateAsync` pass `capture(variables)` on. Read when the write is made, so a write queued\n * offline keeps the workspace it was made in. The wrapped functions are as stable as the mutation's.\n */\nexport function useCapturingWorkspace<\n  V,\n  T extends { mutate: (variables: V, ...rest: never[]) => unknown; mutateAsync: unknown },\n>(mutation: T, capture: (variables: V) => V): T {\n  const captureRef = useRef(capture)\n  captureRef.current = capture\n  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation\n  const mutate = useCallback(\n    (variables: V, ...rest: never[]) =>\n      (rawMutate as (v: V, ...r: never[]) => unknown)(captureRef.current(variables), ...rest),\n    [rawMutate]\n  ) as T['mutate']\n  const mutateAsync = useCallback(\n    (variables: V, ...rest: never[]) =>\n      (rawMutateAsync as (v: V, ...r: never[]) => Promise<unknown>)(\n        captureRef.current(variables),\n        ...rest\n      ),\n    [rawMutateAsync]\n  ) as T['mutateAsync']\n  return { ...mutation, mutate, mutateAsync }\n}\n"],
+  "mappings": "AAaA,SAAS,aAAa,cAAc;AACpC,SAAS,oBAAqC;AAC9C,SAAS,qCAAqC;AASvC,MAAM,+BACX;AAMK,SAAS,cAAc,QAAqC;AACjE,SAAO,CAAC,gBACN,gBAAgB,OAAO,QAAQ,SAAS,EAAE,sBACtC,SACA,OAAO,cAAc,MAAM,WAAW;AAC9C;AAGO,SAAS,YAAY,MAIR;AAClB,SAAO,CAAC,gBACN,KAAK,gBAAgB,gBAAgB,KAAK,eAAe,IACrD,SACA,KAAK,WAAW,KAAK,WAAW;AACxC;AAOA,eAAsB,YACpB,OACA,aACA,OACY;AACZ,MAAI,aAAa;AACf,QAAI;AACF,YAAM,MAAM,WAAW;AAAA,IACzB,SAAS,OAAO;AACd,UAAI,aAAa,KAAK,EAAG,OAAM;AAC/B,YAAM,IAAI,8BAA8B,aAAa,OAAO,4BAA4B;AAAA,IAC1F;AAAA,EACF;AACA,SAAO,MAAM;AACf;AAGO,SAAS,uBAAuB,OAAyB;AAC9D,SAAO,iBAAiB;AAC1B;AAGO,MAAM,qBAAqB;AAAA,EAChC,OAAO,CAAC,cAAsB,UAC5B,uBAAuB,KAAK,KAAK,eAAe;AAAA,EAClD,YAAY,CAAC,YAAoB,KAAK,IAAI,MAAO,KAAK,SAAS,GAAM;AACvE;AAGO,SAAS,qBAAqB,UAEzB;AACV,SAAO,uBAAuB,SAAS,MAAM,SAAS,SAAS,MAAM,aAAa;AACpF;AAOO,SAAS,sBAGd,UAAa,SAAiC;AAC9C,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AACrB,QAAM,EAAE,QAAQ,WAAW,aAAa,eAAe,IAAI;AAC3D,QAAM,SAAS;AAAA,IACb,CAAC,cAAiB,SACf,UAA+C,WAAW,QAAQ,SAAS,GAAG,GAAG,IAAI;AAAA,IACxF,CAAC,SAAS;AAAA,EACZ;AACA,QAAM,cAAc;AAAA,IAClB,CAAC,cAAiB,SACf;AAAA,MACC,WAAW,QAAQ,SAAS;AAAA,MAC5B,GAAG;AAAA,IACL;AAAA,IACF,CAAC,cAAc;AAAA,EACjB;AACA,SAAO,EAAE,GAAG,UAAU,QAAQ,YAAY;AAC5C;",
+  "names": []
+}

package/dist/remote-control.js

@@ -0,0 +1,67 @@
+import { logger } from "@arbidocs/client";
+import { useArbiSessionState } from "./session/index.js";
+const REMOTE_CONTROL_VIEW = "actions.remoteControl";
+const OFF = { enabled: false, pending: null, controllingAgent: null };
+const remoteControlStateOf = (state) => state.views.transient[REMOTE_CONTROL_VIEW] ?? OFF;
+function useRemoteControl(selector) {
+  return useArbiSessionState((state) => selector(remoteControlStateOf(state)));
+}
+function remoteControlActions(session) {
+  const update = (change) => {
+    const state = remoteControlStateOf(session.getState());
+    session.setTransientView(REMOTE_CONTROL_VIEW, { ...state, ...change(state) });
+  };
+  return {
+    /** Stash a requested run and open the consent prompt (`pending` set). */
+    request: (req) => update(() => ({ pending: req })),
+    /** Resolve the pending request: `forSession` enables it for the whole session; either way
+     *  the pending request is cleared. Running it is the caller's job. */
+    grant: ({ forSession }) => update((state) => ({ enabled: forSession || state.enabled, pending: null })),
+    /** Reject the pending request — clears it, changes nothing else. */
+    deny: () => update(() => ({ pending: null })),
+    /** Directly set the session enabled flag. Turning it OFF revokes immediately: clears any
+     *  pending prompt and the controlling banner (GUARANTEE #5). */
+    setEnabled: (enabled) => update(() => enabled ? { enabled } : { enabled, pending: null, controllingAgent: null }),
+    /** Set (or clear) the agent whose run is currently executing. */
+    setControllingAgent: (agent) => update(() => ({ controllingAgent: agent })),
+    /** Back to the session start: off, nothing pending, nobody driving (a sign-in or sign-out). */
+    reset: () => session.setTransientView(REMOTE_CONTROL_VIEW, void 0)
+  };
+}
+function hasRunnableSteps(steps) {
+  return Array.isArray(steps) && steps.length > 0 && steps.every((s) => typeof s?.target === "string" && s.target.length > 0);
+}
+function toGuidedSteps(steps) {
+  return steps.map((s) => ({
+    target: s.target,
+    do: s.do ?? void 0,
+    value: s.value ?? void 0,
+    note: s.note ?? void 0,
+    pauseMs: s.pauseMs ?? void 0,
+    waitMs: s.waitMs ?? void 0
+  }));
+}
+function toRemoteControlRequest(msg, isSequenceId) {
+  const steps = hasRunnableSteps(msg.steps) ? toGuidedSteps(msg.steps) : void 0;
+  const sequenceId = typeof msg.sequence_id === "string" && isSequenceId(msg.sequence_id) ? msg.sequence_id : void 0;
+  if (!steps && !sequenceId) {
+    logger.warn("[RemoteControl] Ignoring message with no runnable action", msg.sequence_id);
+    return null;
+  }
+  return {
+    // The agent is always named in the prompt; fall back to a neutral label rather than leaving
+    // the consent dialog anonymous.
+    agentName: msg.agent_name.trim() || "An assistant",
+    agentExtId: msg.agent_ext_id ?? void 0,
+    sequenceId,
+    steps
+  };
+}
+export {
+  REMOTE_CONTROL_VIEW,
+  remoteControlActions,
+  remoteControlStateOf,
+  toRemoteControlRequest,
+  useRemoteControl
+};
+//# sourceMappingURL=remote-control.js.map

package/dist/remote-control.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/remote-control.ts"],
+  "sourcesContent": ["/**\n * Remote control's session state and its websocket message: an `agt-\u2026` assistant asks to drive\n * the UI over the live connection (`remote_control`), and the user's consent decides whether it\n * may. The guided run itself (the cursor, the clicks) is `@arbidocs/blocks`' (`createRemoteControl`).\n *\n * GUARANTEE #1: `enabled` is `false` at the start of EVERY session and is NEVER saved. The state is\n * a transient view of the session's layout (`views.transient`), which the layout never saves. Every\n * sign-in and sign-out drops it: `@arbidocs/blocks`' remote control resets it (`reset`) on the\n * host's sign-in, sign-out, expiry and change of user, on every host, and a host's own\n * `resetLayout` drops it too.\n *\n * The actions here are pure state. Running the requested run (and labelling the driver for its\n * duration) is the orchestration layer's.\n *\n * \u2500\u2500 BACKEND WS CONTRACT \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n * Message `type`: `'remote_control'`. Payload (snake_case, matching the other WS messages):\n *   {\n *     type: 'remote_control',\n *     agent_name: string,          // display name of the requesting agent\n *     agent_ext_id?: string,       // the agent's `agt-\u2026` external id\n *     sequence_id?: string,        // a REGISTERED guided-run id\n *     steps?: GuidedStep[],        // OR an inline guided run (target-based)\n *   }\n * Exactly one of `sequence_id` / `steps` is expected. An unknown `sequence_id`, a `steps` list with\n * no valid target, and an empty/absent run are all ignored.\n */\nimport type { components } from '@arbidocs/client'\nimport { logger } from '@arbidocs/client'\nimport type { ArbiSessionState, ArbiSessionStore } from './session'\nimport { useArbiSessionState } from './session'\n\n/** The websocket message: an `agt-\u2026` agent asks to drive the UI (exactly one of `sequence_id` /\n *  `steps`). The generated schema type is the single source of truth. */\nexport type RemoteControlMessage = components['schemas']['RemoteControlMessage']\n/** One guided-cursor step, as on the wire (nullable JSON fields). */\ntype RemoteControlStep = components['schemas']['RemoteControlStep']\n\n/** One UI operation: glide the cursor to `target`, then perform `do` on it. */\nexport interface GuidedStep {\n  /** `[data-testid=...]` (or any CSS selector) the cursor glides to and acts on. */\n  target: string\n  /** Interaction once the cursor arrives. Defaults to 'click'. */\n  do?: 'click' | 'type'\n  /** Text to type for `do: 'type'`. */\n  value?: string\n  /** Narration toast shown when the step runs. */\n  note?: string\n  /** Pause (ms) AFTER this step, before the next. */\n  pauseMs?: number\n  /** Max ms to wait for the target to appear (it may follow a prior step). */\n  waitMs?: number\n}\n\n/** A remote-control run requested by a backend agent (name always present so the consent prompt\n *  can name who is asking \u2014 GUARANTEE #3). Carries either a registered `sequenceId` or an inline\n *  `steps` list to execute. */\nexport interface RemoteControlRequest {\n  /** Display name of the requesting assistant, e.g. \"Research Assistant\". */\n  agentName: string\n  /** The assistant's `agt-\u2026` external id, shown so the user knows which agent. */\n  agentExtId?: string\n  /** A registered guided-run id to execute. */\n  sequenceId?: string\n  /** An ad-hoc guided run to execute (used when no registered sequence fits). */\n  steps?: GuidedStep[]\n}\n\n/** The agent whose run is actively executing \u2014 drives the \"controlling\" banner. */\nexport interface ControllingAgent {\n  name: string\n  extId?: string\n}\n\n/** Session-only remote-control state (never saved \u2014 see the file header). */\nexport interface RemoteControlState {\n  /** Whether WS-driven runs may execute without re-prompting this session. */\n  enabled: boolean\n  /** The in-flight consent request awaiting the user's decision, or null. */\n  pending: RemoteControlRequest | null\n  /** Set while a WS-driven run is actively executing (labels the banner). */\n  controllingAgent: ControllingAgent | null\n}\n\n/** The session the state lives in. */\nexport type RemoteControlSession = Pick<ArbiSessionStore, 'getState' | 'setTransientView'>\n\n/** The transient view that holds the state. */\nexport const REMOTE_CONTROL_VIEW = 'actions.remoteControl'\nconst OFF: RemoteControlState = { enabled: false, pending: null, controllingAgent: null }\n\n/** The remote-control state of a session state. */\nexport const remoteControlStateOf = (state: Pick<ArbiSessionState, 'views'>): RemoteControlState =>\n  (state.views.transient[REMOTE_CONTROL_VIEW] as RemoteControlState | undefined) ?? OFF\n\n/** A slice of the remote-control state of the host's session; re-renders when it changes. */\nexport function useRemoteControl<T>(selector: (state: RemoteControlState) => T): T {\n  return useArbiSessionState((state) => selector(remoteControlStateOf(state)))\n}\n\n/** The state's actions on a session. */\nexport function remoteControlActions(session: RemoteControlSession) {\n  const update = (change: (state: RemoteControlState) => Partial<RemoteControlState>): void => {\n    const state = remoteControlStateOf(session.getState())\n    session.setTransientView(REMOTE_CONTROL_VIEW, { ...state, ...change(state) })\n  }\n  return {\n    /** Stash a requested run and open the consent prompt (`pending` set). */\n    request: (req: RemoteControlRequest): void => update(() => ({ pending: req })),\n    /** Resolve the pending request: `forSession` enables it for the whole session; either way\n     *  the pending request is cleared. Running it is the caller's job. */\n    grant: ({ forSession }: { forSession: boolean }): void =>\n      update((state) => ({ enabled: forSession || state.enabled, pending: null })),\n    /** Reject the pending request \u2014 clears it, changes nothing else. */\n    deny: (): void => update(() => ({ pending: null })),\n    /** Directly set the session enabled flag. Turning it OFF revokes immediately: clears any\n     *  pending prompt and the controlling banner (GUARANTEE #5). */\n    setEnabled: (enabled: boolean): void =>\n      update(() => (enabled ? { enabled } : { enabled, pending: null, controllingAgent: null })),\n    /** Set (or clear) the agent whose run is currently executing. */\n    setControllingAgent: (agent: ControllingAgent | null): void =>\n      update(() => ({ controllingAgent: agent })),\n    /** Back to the session start: off, nothing pending, nobody driving (a sign-in or sign-out). */\n    reset: (): void => session.setTransientView(REMOTE_CONTROL_VIEW, undefined),\n  }\n}\n\n/** A runnable steps list: a non-empty array whose every step has a real target selector \u2014 the\n *  one field the runner cannot act without. Operates on the wire step (nullable JSON fields). */\nfunction hasRunnableSteps(\n  steps: RemoteControlStep[] | null | undefined\n): steps is RemoteControlStep[] {\n  return (\n    Array.isArray(steps) &&\n    steps.length > 0 &&\n    steps.every((s) => typeof s?.target === 'string' && s.target.length > 0)\n  )\n}\n\n/** Normalise wire steps (nullable JSON fields) into plain optionals \u2014 a `null` off the socket\n *  becomes an absent field. */\nfunction toGuidedSteps(steps: RemoteControlStep[]): GuidedStep[] {\n  return steps.map((s) => ({\n    target: s.target,\n    do: s.do ?? undefined,\n    value: s.value ?? undefined,\n    note: s.note ?? undefined,\n    pauseMs: s.pauseMs ?? undefined,\n    waitMs: s.waitMs ?? undefined,\n  }))\n}\n\n/**\n * Narrow an incoming message into a request, or null if nothing is runnable: inline steps that\n * all have a target, or a `sequence_id` the site registered (`isSequenceId`).\n */\nexport function toRemoteControlRequest(\n  msg: RemoteControlMessage,\n  isSequenceId: (id: string) => boolean\n): RemoteControlRequest | null {\n  const steps = hasRunnableSteps(msg.steps) ? toGuidedSteps(msg.steps) : undefined\n  const sequenceId =\n    typeof msg.sequence_id === 'string' && isSequenceId(msg.sequence_id)\n      ? msg.sequence_id\n      : undefined\n  if (!steps && !sequenceId) {\n    logger.warn('[RemoteControl] Ignoring message with no runnable action', msg.sequence_id)\n    return null\n  }\n  return {\n    // The agent is always named in the prompt; fall back to a neutral label rather than leaving\n    // the consent dialog anonymous.\n    agentName: msg.agent_name.trim() || 'An assistant',\n    agentExtId: msg.agent_ext_id ?? undefined,\n    sequenceId,\n    steps,\n  }\n}\n"],
+  "mappings": "AA2BA,SAAS,cAAc;AAEvB,SAAS,2BAA2B;AA0D7B,MAAM,sBAAsB;AACnC,MAAM,MAA0B,EAAE,SAAS,OAAO,SAAS,MAAM,kBAAkB,KAAK;AAGjF,MAAM,uBAAuB,CAAC,UAClC,MAAM,MAAM,UAAU,mBAAmB,KAAwC;AAG7E,SAAS,iBAAoB,UAA+C;AACjF,SAAO,oBAAoB,CAAC,UAAU,SAAS,qBAAqB,KAAK,CAAC,CAAC;AAC7E;AAGO,SAAS,qBAAqB,SAA+B;AAClE,QAAM,SAAS,CAAC,WAA6E;AAC3F,UAAM,QAAQ,qBAAqB,QAAQ,SAAS,CAAC;AACrD,YAAQ,iBAAiB,qBAAqB,EAAE,GAAG,OAAO,GAAG,OAAO,KAAK,EAAE,CAAC;AAAA,EAC9E;AACA,SAAO;AAAA;AAAA,IAEL,SAAS,CAAC,QAAoC,OAAO,OAAO,EAAE,SAAS,IAAI,EAAE;AAAA;AAAA;AAAA,IAG7E,OAAO,CAAC,EAAE,WAAW,MACnB,OAAO,CAAC,WAAW,EAAE,SAAS,cAAc,MAAM,SAAS,SAAS,KAAK,EAAE;AAAA;AAAA,IAE7E,MAAM,MAAY,OAAO,OAAO,EAAE,SAAS,KAAK,EAAE;AAAA;AAAA;AAAA,IAGlD,YAAY,CAAC,YACX,OAAO,MAAO,UAAU,EAAE,QAAQ,IAAI,EAAE,SAAS,SAAS,MAAM,kBAAkB,KAAK,CAAE;AAAA;AAAA,IAE3F,qBAAqB,CAAC,UACpB,OAAO,OAAO,EAAE,kBAAkB,MAAM,EAAE;AAAA;AAAA,IAE5C,OAAO,MAAY,QAAQ,iBAAiB,qBAAqB,MAAS;AAAA,EAC5E;AACF;AAIA,SAAS,iBACP,OAC8B;AAC9B,SACE,MAAM,QAAQ,KAAK,KACnB,MAAM,SAAS,KACf,MAAM,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,YAAY,EAAE,OAAO,SAAS,CAAC;AAE3E;AAIA,SAAS,cAAc,OAA0C;AAC/D,SAAO,MAAM,IAAI,CAAC,OAAO;AAAA,IACvB,QAAQ,EAAE;AAAA,IACV,IAAI,EAAE,MAAM;AAAA,IACZ,OAAO,EAAE,SAAS;AAAA,IAClB,MAAM,EAAE,QAAQ;AAAA,IAChB,SAAS,EAAE,WAAW;AAAA,IACtB,QAAQ,EAAE,UAAU;AAAA,EACtB,EAAE;AACJ;AAMO,SAAS,uBACd,KACA,cAC6B;AAC7B,QAAM,QAAQ,iBAAiB,IAAI,KAAK,IAAI,cAAc,IAAI,KAAK,IAAI;AACvE,QAAM,aACJ,OAAO,IAAI,gBAAgB,YAAY,aAAa,IAAI,WAAW,IAC/D,IAAI,cACJ;AACN,MAAI,CAAC,SAAS,CAAC,YAAY;AACzB,WAAO,KAAK,4DAA4D,IAAI,WAAW;AACvF,WAAO;AAAA,EACT;AACA,SAAO;AAAA;AAAA;AAAA,IAGL,WAAW,IAAI,WAAW,KAAK,KAAK;AAAA,IACpC,YAAY,IAAI,gBAAgB;AAAA,IAChC;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/search/index.js

@@ -0,0 +1,23 @@
+import {
+  useSemanticSearch
+} from "./useSemanticSearch.js";
+import {
+  sharedSearchSession,
+  createSearchSession,
+  clearSearchSession,
+  requestSearch,
+  takePendingSearch,
+  persistSearchSession
+} from "./session.js";
+import { MAX_RETRIEVE_DOC_IDS } from "@arbidocs/sdk/browser";
+export {
+  MAX_RETRIEVE_DOC_IDS,
+  clearSearchSession,
+  createSearchSession,
+  persistSearchSession,
+  requestSearch,
+  sharedSearchSession,
+  takePendingSearch,
+  useSemanticSearch
+};
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/search/index.ts"],
+  "sourcesContent": ["export {\n  useSemanticSearch,\n  type SemanticSearch,\n  type SemanticSearchOptions,\n  type SearchMode,\n} from './useSemanticSearch'\n// Also in `@arbidocs/react/shell` (one module): a host's store reaches it without the root entry.\nexport {\n  sharedSearchSession,\n  createSearchSession,\n  clearSearchSession,\n  requestSearch,\n  takePendingSearch,\n  persistSearchSession,\n  type SearchSession,\n  type SearchSessionState,\n  type SearchStatus,\n} from './session'\nexport { MAX_RETRIEVE_DOC_IDS, type SearchChunk } from '@arbidocs/sdk/browser'\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,4BAA8C;",
+  "names": []
+}

package/dist/search/session.js

@@ -0,0 +1,58 @@
+import { createStore } from "zustand/vanilla";
+const EMPTY = {
+  query: "",
+  results: [],
+  searched: false,
+  status: "idle",
+  error: null,
+  pending: null
+};
+function createSearchSession() {
+  return createStore(() => ({ ...EMPTY, workspaceId: null, run: 0 }));
+}
+const sharedSearchSession = createSearchSession();
+function clearSearchSession(workspaceId, session = sharedSearchSession) {
+  session.setState((s) => ({
+    ...EMPTY,
+    workspaceId: workspaceId === void 0 ? s.workspaceId : workspaceId,
+    run: s.run + 1
+  }));
+}
+function requestSearch(query, workspaceId, session = sharedSearchSession) {
+  clearSearchSession(workspaceId, session);
+  session.setState({ query, pending: query });
+}
+function takePendingSearch(session = sharedSearchSession) {
+  const { pending } = session.getState();
+  if (pending !== null) session.setState({ pending: null });
+  return pending;
+}
+function persistSearchSession(key, storage = globalThis.localStorage, session = sharedSearchSession) {
+  if (!storage) return () => {
+  };
+  try {
+    const saved = JSON.parse(storage.getItem(key) ?? "null");
+    if (saved && typeof saved.query === "string" && !session.getState().query)
+      session.setState({ query: saved.query, workspaceId: saved.workspaceId ?? null });
+  } catch {
+  }
+  let last = "";
+  return session.subscribe(({ query, workspaceId }) => {
+    const next = JSON.stringify({ query, workspaceId });
+    if (next === last) return;
+    last = next;
+    try {
+      storage.setItem(key, next);
+    } catch {
+    }
+  });
+}
+export {
+  clearSearchSession,
+  createSearchSession,
+  persistSearchSession,
+  requestSearch,
+  sharedSearchSession,
+  takePendingSearch
+};
+//# sourceMappingURL=session.js.map

package/dist/search/session.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/search/session.ts"],
+  "sourcesContent": ["/**\n * A search's state outside any component: the query last searched, its passages, and whether it\n * is running. A page that shows the shared session (`sharedSearchSession`) keeps its results when\n * it is left and opened again, another surface can hand it a query to run on arrival\n * ({@link requestSearch}), and {@link persistSearchSession} keeps the last query across reloads.\n */\nimport { createStore, type StoreApi } from 'zustand/vanilla'\nimport type { SearchChunk } from '@arbidocs/sdk/browser'\n\nexport type SearchStatus = 'idle' | 'running' | 'done' | 'error'\n\nexport interface SearchSessionState {\n  /** The workspace the query and results belong to. */\n  workspaceId: string | null\n  /** The query last searched, or handed over to run. */\n  query: string\n  /** The last search's passages, best first. */\n  results: SearchChunk[]\n  /** A search has finished with results to show (cleared by {@link clearSearchSession}). */\n  searched: boolean\n  status: SearchStatus\n  error: string | null\n  /** A query handed over by {@link requestSearch}, run once by the page that shows the session. */\n  pending: string | null\n  /** Counts searches, so the reply to an older one never overwrites a newer one. */\n  run: number\n}\n\nexport type SearchSession = StoreApi<SearchSessionState>\n\nconst EMPTY: Omit<SearchSessionState, 'workspaceId' | 'run'> = {\n  query: '',\n  results: [],\n  searched: false,\n  status: 'idle',\n  error: null,\n  pending: null,\n}\n\nexport function createSearchSession(): SearchSession {\n  return createStore<SearchSessionState>(() => ({ ...EMPTY, workspaceId: null, run: 0 }))\n}\n\n/** The session a host's search page shows. */\nexport const sharedSearchSession: SearchSession = createSearchSession()\n\n/** Back to nothing searched (in `workspaceId` when given); a running search's reply is dropped. */\nexport function clearSearchSession(\n  workspaceId?: string | null,\n  session: SearchSession = sharedSearchSession\n): void {\n  session.setState((s) => ({\n    ...EMPTY,\n    workspaceId: workspaceId === undefined ? s.workspaceId : workspaceId,\n    run: s.run + 1,\n  }))\n}\n\n/**\n * Hand a query to the search page, which runs it when it shows the session (the user already\n * asked once; the page must not wait for a second Enter).\n */\nexport function requestSearch(\n  query: string,\n  workspaceId: string | null,\n  session: SearchSession = sharedSearchSession\n): void {\n  clearSearchSession(workspaceId, session)\n  session.setState({ query, pending: query })\n}\n\n/** The handed-over query, once: the next call returns null. */\nexport function takePendingSearch(session: SearchSession = sharedSearchSession): string | null {\n  const { pending } = session.getState()\n  if (pending !== null) session.setState({ pending: null })\n  return pending\n}\n\ninterface SavedSearch {\n  query?: string\n  workspaceId?: string | null\n}\n\n/**\n * Keep the last query (and its workspace) in `storage` under `key`, so the search box shows it\n * after a reload. Results are not kept. Returns the unsubscribe.\n */\nexport function persistSearchSession(\n  key: string,\n  storage: Pick<Storage, 'getItem' | 'setItem'> | undefined = globalThis.localStorage,\n  session: SearchSession = sharedSearchSession\n): () => void {\n  if (!storage) return () => {}\n  try {\n    const saved = JSON.parse(storage.getItem(key) ?? 'null') as SavedSearch | null\n    if (saved && typeof saved.query === 'string' && !session.getState().query)\n      session.setState({ query: saved.query, workspaceId: saved.workspaceId ?? null })\n  } catch {\n    // Unreadable: start empty.\n  }\n  let last = ''\n  return session.subscribe(({ query, workspaceId }) => {\n    const next = JSON.stringify({ query, workspaceId })\n    if (next === last) return\n    last = next\n    try {\n      storage.setItem(key, next)\n    } catch {\n      // Storage full or blocked: the query is simply not kept.\n    }\n  })\n}\n"],
+  "mappings": "AAMA,SAAS,mBAAkC;AAwB3C,MAAM,QAAyD;AAAA,EAC7D,OAAO;AAAA,EACP,SAAS,CAAC;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AACX;AAEO,SAAS,sBAAqC;AACnD,SAAO,YAAgC,OAAO,EAAE,GAAG,OAAO,aAAa,MAAM,KAAK,EAAE,EAAE;AACxF;AAGO,MAAM,sBAAqC,oBAAoB;AAG/D,SAAS,mBACd,aACA,UAAyB,qBACnB;AACN,UAAQ,SAAS,CAAC,OAAO;AAAA,IACvB,GAAG;AAAA,IACH,aAAa,gBAAgB,SAAY,EAAE,cAAc;AAAA,IACzD,KAAK,EAAE,MAAM;AAAA,EACf,EAAE;AACJ;AAMO,SAAS,cACd,OACA,aACA,UAAyB,qBACnB;AACN,qBAAmB,aAAa,OAAO;AACvC,UAAQ,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;AAC5C;AAGO,SAAS,kBAAkB,UAAyB,qBAAoC;AAC7F,QAAM,EAAE,QAAQ,IAAI,QAAQ,SAAS;AACrC,MAAI,YAAY,KAAM,SAAQ,SAAS,EAAE,SAAS,KAAK,CAAC;AACxD,SAAO;AACT;AAWO,SAAS,qBACd,KACA,UAA4D,WAAW,cACvE,UAAyB,qBACb;AACZ,MAAI,CAAC,QAAS,QAAO,MAAM;AAAA,EAAC;AAC5B,MAAI;AACF,UAAM,QAAQ,KAAK,MAAM,QAAQ,QAAQ,GAAG,KAAK,MAAM;AACvD,QAAI,SAAS,OAAO,MAAM,UAAU,YAAY,CAAC,QAAQ,SAAS,EAAE;AAClE,cAAQ,SAAS,EAAE,OAAO,MAAM,OAAO,aAAa,MAAM,eAAe,KAAK,CAAC;AAAA,EACnF,QAAQ;AAAA,EAER;AACA,MAAI,OAAO;AACX,SAAO,QAAQ,UAAU,CAAC,EAAE,OAAO,YAAY,MAAM;AACnD,UAAM,OAAO,KAAK,UAAU,EAAE,OAAO,YAAY,CAAC;AAClD,QAAI,SAAS,KAAM;AACnB,WAAO;AACP,QAAI;AACF,cAAQ,QAAQ,KAAK,IAAI;AAAA,IAC3B,QAAQ;AAAA,IAER;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/search/useSemanticSearch.js

@@ -0,0 +1,82 @@
+import { useCallback, useEffect, useState, useSyncExternalStore } from "react";
+import { searchChunks } from "@arbidocs/sdk/browser";
+import { useArbi } from "../useArbi.js";
+import {
+  clearSearchSession,
+  createSearchSession
+} from "./session.js";
+const IDLE = {
+  query: "",
+  results: [],
+  searched: false,
+  status: "idle",
+  error: null
+};
+function useSemanticSearch(docIds = [], options = {}) {
+  const arbi = useArbi();
+  const [ownSession] = useState(createSearchSession);
+  const session = options.session ?? ownSession;
+  const { model, workspaceId } = options;
+  const state = useSyncExternalStore(session.subscribe, session.getState, session.getState);
+  const foreign = !!workspaceId && !!state.workspaceId && state.workspaceId !== workspaceId;
+  useEffect(() => {
+    if (!workspaceId) return;
+    const current = session.getState().workspaceId;
+    if (current !== workspaceId) {
+      if (current) clearSearchSession(workspaceId, session);
+      else session.setState({ workspaceId });
+    }
+  }, [session, workspaceId]);
+  const search = useCallback(
+    async (query, mode = "hybrid") => {
+      const trimmed = query.trim();
+      if (!trimmed) {
+        clearSearchSession(void 0, session);
+        return;
+      }
+      const run = session.getState().run + 1;
+      const searched = workspaceId ?? session.getState().workspaceId ?? void 0;
+      session.setState((s) => ({
+        query: trimmed,
+        status: "running",
+        error: null,
+        run,
+        workspaceId: workspaceId ?? s.workspaceId
+      }));
+      try {
+        const result = await arbi.assistant.retrieve(trimmed, docIds, {
+          searchMode: mode,
+          store: false,
+          ...model ? { model } : {},
+          ...searched ? { workspaceId: searched } : {}
+        });
+        if (session.getState().run !== run) return;
+        session.setState({ results: searchChunks(result), searched: true, status: "done" });
+      } catch (error) {
+        if (session.getState().run !== run) return;
+        session.setState({
+          status: "error",
+          error: error instanceof Error ? error.message : "Search failed"
+        });
+      }
+    },
+    [arbi, docIds, model, session, workspaceId]
+  );
+  const clear = useCallback(() => clearSearchSession(void 0, session), [session]);
+  const shown = foreign ? IDLE : state;
+  return {
+    query: shown.query,
+    results: shown.results,
+    searched: shown.searched,
+    status: shown.status,
+    error: shown.error,
+    isRunning: shown.status === "running",
+    search,
+    clear,
+    session
+  };
+}
+export {
+  useSemanticSearch
+};
+//# sourceMappingURL=useSemanticSearch.js.map

package/dist/search/useSemanticSearch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/search/useSemanticSearch.ts"],
+  "sourcesContent": ["/**\n * Search documents for passages: retrieval only, no LLM answer. One implementation for every\n * search surface (the search page, the \u2318K palette, a compact doc search).\n */\nimport { useCallback, useEffect, useState, useSyncExternalStore } from 'react'\nimport { searchChunks, type SearchChunk } from '@arbidocs/sdk/browser'\nimport { useArbi } from '../useArbi'\nimport {\n  clearSearchSession,\n  createSearchSession,\n  type SearchSession,\n  type SearchSessionState,\n  type SearchStatus,\n} from './session'\n\nexport type SearchMode = 'semantic' | 'keyword' | 'hybrid'\n\nexport interface SemanticSearchOptions {\n  /** The assistant configuration the search runs with; default the server's. */\n  model?: string\n  /**\n   * Where the search lives. Default: this component's own (gone when it unmounts). Pass\n   * `sharedSearchSession` for a page whose results outlive it.\n   */\n  session?: SearchSession\n  /**\n   * The workspace searched (default: the current one). The request names it; a session holding\n   * another workspace's search starts over.\n   */\n  workspaceId?: string | null\n}\n\nexport interface SemanticSearch {\n  /** The query last searched. */\n  query: string\n  /** Its passages, best first. */\n  results: SearchChunk[]\n  /** A search has finished with results to show (they stay while the next one runs). */\n  searched: boolean\n  status: SearchStatus\n  error: string | null\n  isRunning: boolean\n  /** Search; an empty query clears. */\n  search: (query: string, mode?: SearchMode) => Promise<void>\n  /** Back to nothing searched. */\n  clear: () => void\n  session: SearchSession\n}\n\nconst IDLE: Pick<SearchSessionState, 'query' | 'results' | 'searched' | 'status' | 'error'> = {\n  query: '',\n  results: [],\n  searched: false,\n  status: 'idle',\n  error: null,\n}\n\n/**\n * Search `docIds` (none: the whole workspace) and return the matching passages. The reply is\n * ranked by the SDK's `searchChunks`; nothing is kept server-side.\n */\nexport function useSemanticSearch(\n  docIds: string[] = [],\n  options: SemanticSearchOptions = {}\n): SemanticSearch {\n  const arbi = useArbi()\n  const [ownSession] = useState(createSearchSession)\n  const session = options.session ?? ownSession\n  const { model, workspaceId } = options\n  const state = useSyncExternalStore(session.subscribe, session.getState, session.getState)\n\n  // Another workspace's search is not this one's: start over.\n  const foreign = !!workspaceId && !!state.workspaceId && state.workspaceId !== workspaceId\n  useEffect(() => {\n    if (!workspaceId) return\n    const current = session.getState().workspaceId\n    if (current !== workspaceId) {\n      if (current) clearSearchSession(workspaceId, session)\n      else session.setState({ workspaceId })\n    }\n  }, [session, workspaceId])\n\n  const search = useCallback(\n    async (query: string, mode: SearchMode = 'hybrid') => {\n      const trimmed = query.trim()\n      if (!trimmed) {\n        clearSearchSession(undefined, session)\n        return\n      }\n      const run = session.getState().run + 1\n      // The workspace searched, captured now: the request names it (opened for this session if it\n      // is not the current one), so a switch while it runs cannot answer it from another workspace.\n      const searched = workspaceId ?? session.getState().workspaceId ?? undefined\n      session.setState((s) => ({\n        query: trimmed,\n        status: 'running',\n        error: null,\n        run,\n        workspaceId: workspaceId ?? s.workspaceId,\n      }))\n      try {\n        const result = await arbi.assistant.retrieve(trimmed, docIds, {\n          searchMode: mode,\n          store: false,\n          ...(model ? { model } : {}),\n          ...(searched ? { workspaceId: searched } : {}),\n        })\n        if (session.getState().run !== run) return\n        session.setState({ results: searchChunks(result), searched: true, status: 'done' })\n      } catch (error) {\n        if (session.getState().run !== run) return\n        session.setState({\n          status: 'error',\n          error: error instanceof Error ? error.message : 'Search failed',\n        })\n      }\n    },\n    [arbi, docIds, model, session, workspaceId]\n  )\n\n  const clear = useCallback(() => clearSearchSession(undefined, session), [session])\n\n  const shown = foreign ? IDLE : state\n  return {\n    query: shown.query,\n    results: shown.results,\n    searched: shown.searched,\n    status: shown.status,\n    error: shown.error,\n    isRunning: shown.status === 'running',\n    search,\n    clear,\n    session,\n  }\n}\n"],
+  "mappings": "AAIA,SAAS,aAAa,WAAW,UAAU,4BAA4B;AACvE,SAAS,oBAAsC;AAC/C,SAAS,eAAe;AACxB;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AAoCP,MAAM,OAAwF;AAAA,EAC5F,OAAO;AAAA,EACP,SAAS,CAAC;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AACT;AAMO,SAAS,kBACd,SAAmB,CAAC,GACpB,UAAiC,CAAC,GAClB;AAChB,QAAM,OAAO,QAAQ;AACrB,QAAM,CAAC,UAAU,IAAI,SAAS,mBAAmB;AACjD,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,EAAE,OAAO,YAAY,IAAI;AAC/B,QAAM,QAAQ,qBAAqB,QAAQ,WAAW,QAAQ,UAAU,QAAQ,QAAQ;AAGxF,QAAM,UAAU,CAAC,CAAC,eAAe,CAAC,CAAC,MAAM,eAAe,MAAM,gBAAgB;AAC9E,YAAU,MAAM;AACd,QAAI,CAAC,YAAa;AAClB,UAAM,UAAU,QAAQ,SAAS,EAAE;AACnC,QAAI,YAAY,aAAa;AAC3B,UAAI,QAAS,oBAAmB,aAAa,OAAO;AAAA,UAC/C,SAAQ,SAAS,EAAE,YAAY,CAAC;AAAA,IACvC;AAAA,EACF,GAAG,CAAC,SAAS,WAAW,CAAC;AAEzB,QAAM,SAAS;AAAA,IACb,OAAO,OAAe,OAAmB,aAAa;AACpD,YAAM,UAAU,MAAM,KAAK;AAC3B,UAAI,CAAC,SAAS;AACZ,2BAAmB,QAAW,OAAO;AACrC;AAAA,MACF;AACA,YAAM,MAAM,QAAQ,SAAS,EAAE,MAAM;AAGrC,YAAM,WAAW,eAAe,QAAQ,SAAS,EAAE,eAAe;AAClE,cAAQ,SAAS,CAAC,OAAO;AAAA,QACvB,OAAO;AAAA,QACP,QAAQ;AAAA,QACR,OAAO;AAAA,QACP;AAAA,QACA,aAAa,eAAe,EAAE;AAAA,MAChC,EAAE;AACF,UAAI;AACF,cAAM,SAAS,MAAM,KAAK,UAAU,SAAS,SAAS,QAAQ;AAAA,UAC5D,YAAY;AAAA,UACZ,OAAO;AAAA,UACP,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,UACzB,GAAI,WAAW,EAAE,aAAa,SAAS,IAAI,CAAC;AAAA,QAC9C,CAAC;AACD,YAAI,QAAQ,SAAS,EAAE,QAAQ,IAAK;AACpC,gBAAQ,SAAS,EAAE,SAAS,aAAa,MAAM,GAAG,UAAU,MAAM,QAAQ,OAAO,CAAC;AAAA,MACpF,SAAS,OAAO;AACd,YAAI,QAAQ,SAAS,EAAE,QAAQ,IAAK;AACpC,gBAAQ,SAAS;AAAA,UACf,QAAQ;AAAA,UACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU;AAAA,QAClD,CAAC;AAAA,MACH;AAAA,IACF;AAAA,IACA,CAAC,MAAM,QAAQ,OAAO,SAAS,WAAW;AAAA,EAC5C;AAEA,QAAM,QAAQ,YAAY,MAAM,mBAAmB,QAAW,OAAO,GAAG,CAAC,OAAO,CAAC;AAEjF,QAAM,QAAQ,UAAU,OAAO;AAC/B,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,SAAS,MAAM;AAAA,IACf,UAAU,MAAM;AAAA,IAChB,QAAQ,MAAM;AAAA,IACd,OAAO,MAAM;AAAA,IACb,WAAW,MAAM,WAAW;AAAA,IAC5B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}