@arbidocs/react 0.5.111 → 0.5.113

package/dist/index.d-oR5FKZpJ.d.cts

@@ -1,579 +0,0 @@
-import * as zustand from 'zustand';
-import * as React$1 from 'react';
-import { ReactNode, ComponentType, ReactElement } from 'react';
-import { StoreApi } from 'zustand/vanilla';
-import { ArtifactEvent, SearchChunk } from '@arbidocs/sdk/browser';
-import { ToasterProps } from 'sonner';
-
-/**
- * `<ArbiHost config>`: the one place a host app hands its configuration to every hook and kit.
- *
- *   <ArbiHost config={{ arbi, session, documents, calendar, mail, account, … }}>
- *     <App />
- *   </ArbiHost>
- *
- * Every field is optional and has a default (see `ArbiHostConfig`); a kit reads its domain from
- * the config (`useArbiHost().documents`, `useHost().billing` in blocks). A nested `<ArbiHost>`
- * overrides only the fields it gives and inherits the rest (`environment` field by field), for a
- * subtree that opens projects in its own tabs, say. There is no other host provider: a new domain
- * is a new optional field, never a new provider.
- *
- * SDK-free (this module, ./context, ./merge and the entity vocabulary are all it reaches), so a
- * marketing site that only sets the blocks environment does not bundle the SDK.
- */
-
-/** A sign-in layer mounted inside the host (`defaultHost` in `@arbidocs/blocks/connect`). */
-interface ArbiHostConnection {
-    Provider: ComponentType<{
-        children: ReactNode;
-    }>;
-}
-interface ArbiHostProps<Config extends object> {
-    config: Config;
-    children?: ReactNode;
-}
-/**
- * Provide the host configuration. Typed by the package it is imported from: `@arbidocs/react`'s
- * takes the react domains, `@arbidocs/blocks`' the blocks domains as well.
- */
-declare function ArbiHost<Config extends object>({ config, children, }: ArbiHostProps<Config>): React.ReactElement;
-
-/**
- * The host configuration's React context: one value for the whole tree, set by `<ArbiHost>`
- * (./ArbiHost.tsx). It is untyped here so the SDK-free slices (`/ui`, `/shell`, the blocks root)
- * can read their part (`dictate`, `environment`) without reaching the SDK's types; the typed read
- * is `useArbiHost()` (react) and `useHost()` (blocks).
- */
-/** The host configuration as stored: see `ArbiHostConfig`. */
-type HostConfigRecord = Readonly<Record<string, unknown>>;
-/** The host configuration in scope, untyped (`{}` outside an `<ArbiHost>`). */
-declare function useHostConfigRecord(): HostConfigRecord;
-
-/** The assistant's name when the host names it nothing else. */
-declare const DEFAULT_ASSISTANT_NAME = "ARBI";
-/** Every kit phrase that names the assistant. */
-interface AssistantCopy {
-    /** The name itself. */
-    name: string;
-    /** "Ask ARBI": a button or tab that starts a question. */
-    ask: string;
-    /** "Ask ARBI anything": an empty list's call to ask. */
-    askAnything: string;
-    /** "Ask ARBI anything…": the chat composer's placeholder. */
-    askAnythingPlaceholder: string;
-    /** "Ask ARBI...": a compact composer's placeholder. */
-    askPlaceholder: string;
-    /** "Ask ARBI about your documents": the empty chat's heading. */
-    askAboutDocuments: string;
-    /** The files bulk bar's chat tooltip. */
-    askAboutSelection: string;
-    /** "ARBI is asking": the heading over a question the assistant asks. */
-    isAsking: string;
-    /** The composer's placeholder while the assistant waits for an answer. */
-    answerPlaceholder: string;
-    /** The empty threads list, with the composer below it. */
-    emptyThreadsComposer: string;
-    /** The empty threads list, with a New Task button. */
-    emptyThreadsNewTask: string;
-    /** The drafting chip's hint while the thread drafts in a document. */
-    draftingHint: string;
-    /** The drafting chip's hint before the document is attached. */
-    draftingAttachHint: string;
-    /** The chat's facts tab note. */
-    factsInContext: (facts: string) => string;
-    /** "Ask one question — ARBI answers it for each of …": the AI review's ask step. */
-    reviewEach: (count: number, scope: string) => string;
-    /** The facts bar's note on the chat's facts budget. */
-    factsBudgetHint: string;
-    /** An AI review cell left without an answer. */
-    noAnswerHint: string;
-    /** The new-thread dialog's button that hands the thread to the assistant. */
-    startWith: string;
-    /** The mail action bar's "Reply with ARBI". */
-    replyWith: string;
-    /** The Word editor's comment button that @mentions the assistant. */
-    include: string;
-    /** A reply to an email asked for outside a workspace. */
-    replyNeedsWorkspace: string;
-    /** After an upload. */
-    uploadedIndexing: string;
-    /** Before an upload completes. */
-    afterUpload: string;
-    /** The built-in Deep research workflow's description and details. */
-    deepResearch: {
-        description: string;
-        details: string;
-    };
-    /** The built-in AI annotation operation's details. */
-    annotate: {
-        details: string;
-        placeholder: string;
-    };
-}
-/** The phrases for one name. `assistantCopy()` is ARBI's own text. */
-declare function assistantCopy(name?: string): AssistantCopy;
-/** The host's name for its assistant (`ArbiHostConfig.assistantName`), else "ARBI". */
-declare function useAssistantName(): string;
-/** The kit phrases for the host's assistant name. */
-declare function useAssistantCopy(): AssistantCopy;
-
-/**
- * @mentions in chat text: pure helpers shared by the composer (autocomplete, extraction) and
- * the message renderer (chips). No React, no SDK.
- *
- * A mention lives in two places: the readable `@Label` text in the message content, and a
- * structured entry on the message (`{ type, user_ext_id, label }`) that the server reads to share
- * the conversation and notify. The composer only ever inserts `@<label>` for a known candidate,
- * so the structured list can be recovered from the text at send time ({@link extractMentions});
- * the renderer turns each stored mention back into a chip ({@link linkMentions}).
- */
-/** Who can be mentioned: a workspace member, or the assistant. */
-type MentionKind = 'user' | 'assistant';
-/** One entry of the mention autocomplete. */
-interface MentionCandidate {
-    /** User external id (`usr-…`) for a person; any stable key (e.g. `assistant`) for the assistant. */
-    id: string;
-    kind: MentionKind;
-    /** Inserted as `@<label>`. For people this must be the server's display name (given + family). */
-    label: string;
-    /** Secondary line in the menu (email, role, …). */
-    description?: string;
-}
-/** The structured mention a message carries (the API's `MessageMention`). */
-interface MessageMentionRef {
-    type: MentionKind;
-    user_ext_id?: string | null;
-    label?: string | null;
-}
-/**
- * The `@query` the caret is in, if any: the `@` must start the text or follow whitespace, and the
- * query may contain spaces (names do) but no newline. Returns the index of the `@` and the query.
- */
-declare function findMentionQuery(text: string, caret: number): {
-    start: number;
-    query: string;
-} | null;
-/** Candidates matching a query: label prefix (or word-prefix) matches, prefix matches first. */
-declare function filterMentionCandidates(candidates: ReadonlyArray<MentionCandidate>, query: string): MentionCandidate[];
-/** Replace the `@query` at `start…caret` with `@<label> `; returns the new text and caret. */
-declare function insertMention(text: string, start: number, caret: number, label: string): {
-    text: string;
-    caret: number;
-};
-/**
- * The candidates mentioned in `text`, in order of first appearance. Longer labels win overlaps,
- * so `@Bob Smith` is Bob Smith, not a separate `@Bob`.
- */
-declare function extractMentions(text: string, candidates: ReadonlyArray<MentionCandidate>): MentionCandidate[];
-/** The API payload for mentioned candidates. */
-declare function toMessageMentions(mentioned: ReadonlyArray<MentionCandidate>): MessageMentionRef[];
-/** Fragment prefix of the links {@link linkMentions} writes. */
-declare const MENTION_HREF_PREFIX = "#mention-";
-/**
- * Turn each stored mention's `@<label>` in `content` into a markdown link
- * `[@<label>](#mention-<id>)`, so a markdown renderer can draw it as a chip (see
- * {@link mentionFromHref}). Text that no longer matches (a renamed user) stays plain text.
- * `assistantLabels` lists other names the assistant may have been mentioned by.
- */
-declare function linkMentions(content: string, mentions: ReadonlyArray<MessageMentionRef> | null | undefined, assistantLabels?: ReadonlyArray<string>): string;
-/** The mention a `#mention-…` href points at, or null for any other href. */
-declare function mentionFromHref(href: string | null | undefined): {
-    kind: MentionKind;
-    id: string;
-} | null;
-/** A recipient alone (by any of its labels) is not a message. */
-declare function hasMessageBody(value: string, recipientLabel?: string | ReadonlyArray<string>): boolean;
-
-/**
- * Drafting mode: the documents open beside the chat, and which one a chat turn drafts in.
- *
- * A viewer registers the document it shows (`useRegisterOpenDocument`). Being open binds nothing:
- * a turn names a document (`active_artifact_ext_id`, read with `takeDocumentForTurn` as the
- * question is sent) only when its thread is bound to it (`./thread-document`: started from the
- * document, or attached in that thread), when the document was made in that thread, or when the
- * open document is ambient (an email draft open in the composer). The server then binds the live
- * document to the turn: a Word document is read on demand and edited as tracked changes in the
- * open editor, and what the assistant saves becomes a child version of it. The request carries a
- * reference, never the content.
- *
- * The named document is always the subject, also while one of its earlier versions is on screen
- * read-only: a version still names its document. Sending a turn then returns the viewer to the live
- * document (`showLive`), where the assistant's edits appear as they are made. (Pinning a specific
- * version as a source is a separate feature: it does not go through here.)
- *
- * A module-level registry (not React context), like `useChatSurface`, so a viewer and a chat agree
- * wherever they sit in the tree; the most recently opened document is on top and closing it hands
- * back to the one before. It is not the session state's viewing document (`useArbiSessionState`):
- * it holds what mounted viewers can draft in (saved documents only, with the callback that shows
- * the live one again), and a turn reads it outside React. A viewer on the session's viewing
- * document passes that as `shownId` (it may be a version reference, resolved here the same way as
- * `selectViewingDocumentId` does).
- */
-/** What a viewer knows about the document it shows. */
-interface SavedDocumentInput {
-    /** The document (`doc-…`), never a version reference. */
-    documentId: string | null | undefined;
-    /** An unsaved draft (client-minted id, no backend record). */
-    isDraft: boolean;
-    /** Still streaming: nothing is persisted yet. */
-    isStreaming: boolean;
-    /** An image, audio or video artifact: there is no text to draft in. */
-    isBlobArtifact: boolean;
-    /** The loaded document record. */
-    documentData: {
-        external_id?: string | null;
-        wp_type?: string | null;
-        file_name?: string | null;
-    } | null | undefined;
-}
-/** The fields that decide where a document opens. */
-interface WordDocumentKind {
-    file_name?: string | null;
-    wp_type?: string | null;
-}
-/**
- * A document edited in the Word editor: a `.docx`, or a document the assistant wrote (an
- * artifact). The one rule for where a document opens (`openWordEditor` or `openDocument`) and
- * which documents a chat drafts in.
- */
-declare function opensInWord(doc: WordDocumentKind | null | undefined): boolean;
-/**
- * The saved, content-backed document a chat can draft in, or null. Only a saved artifact or Word
- * document counts: drafts, an artifact still streaming and blob artifacts do not.
- */
-declare function savedDocumentIdFor(input: SavedDocumentInput): string | null;
-interface OpenDocumentRegistration {
-    /** The saved document the viewer shows (`doc-…`); null or empty registers nothing. */
-    documentId: string | null | undefined;
-    /** What is on screen: the document itself, or one of its earlier versions (`doc-…@v2`). */
-    shownId?: string | null;
-    /** Show the live document again. Called when a turn starts while an earlier version is shown. */
-    showLive?: () => void;
-    /** The workspace the document belongs to; a chat in another workspace does not draft in it. */
-    workspaceId?: string | null;
-    /** The thread the document was made in: that thread drafts in it without being bound to it. */
-    conversationId?: string | null;
-    /**
-     * Drafted in by whichever chat is beside it, bound or not (an email draft open in the composer:
-     * the composer is a drafting surface of its own).
-     */
-    ambient?: boolean;
-}
-/**
- * Registers the document a viewer shows as the open document while the caller is mounted and
- * `documentId` is set. Pass `savedDocumentIdFor(...)`, or the id of a document known to be saved.
- */
-declare function useRegisterOpenDocument(registration: OpenDocumentRegistration): void;
-/** The open document's id (the most recently opened), or null. Re-renders when it changes. */
-declare function useOpenDocumentId(options?: {
-    workspaceId?: string | null;
-}): string | null;
-/** The open document's id (the most recently opened); with `workspaceId`, only one of it. */
-declare function openDocumentId(options?: {
-    workspaceId?: string | null;
-}): string | null;
-/** What a turn is about to be sent in: its conversation and the document its thread is bound to. */
-interface TurnDocumentInput {
-    /** The thread's bound document (`threadDocumentId` / the session's `newChatDocumentId`). */
-    boundDocumentId: string | null | undefined;
-    /** The conversation (null: a new chat). */
-    conversationId: string | null | undefined;
-    /** The chat's workspace: an open document of another workspace is never picked up. */
-    workspaceId?: string | null;
-}
-/** The document a turn sent now would draft in, or null. Re-renders as documents open and close. */
-declare function useTurnDocumentId(input: TurnDocumentInput): string | null;
-/**
- * The document an assistant turn about to be sent drafts in, or null. Call it once per turn as the
- * question is sent: when an earlier version of the document is on screen, the viewer returns to the
- * live document, where the assistant's edits appear.
- */
-declare function takeDocumentForTurn(input: TurnDocumentInput): string | null;
-
-/**
- * The documents the assistant is writing (or wrote) in this tab's chats, as their artifact events
- * stream in: the chat engine records every one (`recordChatArtifact`), before the host's
- * `chat.onArtifact` shows it. One store for every surface that shows a draft as it is written: the
- * answer's artifact card, the document viewer, and a drafting chat's document pane.
- *
- * A module-level store, like the open-document registry: a chat and a viewer agree wherever they
- * sit in the tree. It holds what streamed in this tab only; a saved draft is read from the
- * documents list. Cleared on sign-out (`clearChatArtifacts`).
- */
-/** An artifact as it streams: what the events said so far. */
-interface ChatArtifact {
-    /** The document it is written into (`doc-…`). */
-    docExtId: string;
-    title: string;
-    /** The content so far (Markdown, or the html/react source of a live artifact). */
-    content: string;
-    /**
-     * `markdown` / `text` are document drafts (stored by the server as Word documents); `html` /
-     * `react` are live artifacts; `image` is a generated image.
-     */
-    mode: 'markdown' | 'html' | 'text' | 'react' | 'image';
-    isComplete: boolean;
-    version?: number | null;
-    /** The answer that writes it. */
-    messageExtId?: string;
-    /** The conversation it is written in (`new` until the server named it). */
-    conversationId: string;
-    createdAt: string;
-}
-/** Record an artifact event of a chat turn in `conversationId`. */
-declare function recordChatArtifact(event: ArtifactEvent, conversationId: string): void;
-/** Forget every streamed artifact (sign-out). */
-declare function clearChatArtifacts(): void;
-/** Every artifact streamed in this tab, by document id. */
-declare function getChatArtifacts(): Readonly<Record<string, ChatArtifact>>;
-/** The artifact streaming (or streamed) into this document, if one did in this tab. */
-declare function getChatArtifact(documentId: string | null | undefined): ChatArtifact | undefined;
-/** The artifact streaming into this document, if one is. Re-renders as it streams. */
-declare function useChatArtifact(documentId: string | null | undefined): ChatArtifact | undefined;
-/** The artifact this answer writes (or wrote), if it did in this tab. */
-declare function useMessageChatArtifact(messageId: string | null | undefined): ChatArtifact | undefined;
-
-/**
- * A thread's document: the one document a conversation drafts in, part of the conversation.
- *
- * A thread is bound to a document only when it was started from it ("Chat about this document" in
- * the viewer) or the person attached it in that thread. Only that thread names it on its turns
- * (`active_artifact_ext_id`), on every turn and after a reload. A document merely open or docked
- * beside the chat binds nothing: a new chat (the ask bar, the new-chat button, the thread
- * launcher, home) starts unbound, so a question there never becomes an edit of whatever is open.
- *
- * The binding is the server's: the conversation's `bound_document_ext_id`, set by the first turn
- * (`bound_document_ext_id` on the turn that starts it) or by a PATCH, and read under each reader's
- * access (`bound_document_unavailable`: bound to a document this reader cannot open). It follows
- * the person to every device, and a shared thread's members all see it. The query cache holds it
- * (`./thread-binding`); a new chat's binding is the session's `newChatDocumentId` until its first
- * turn creates the conversation.
- *
- * This module is the light half (no query client, no SDK), so the shell entry can carry it.
- */
-/** What a conversation row says about its binding. */
-interface ThreadBindingRow {
-    external_id: string;
-    bound_document_ext_id?: string | null;
-    bound_document_unavailable?: boolean | null;
-    updated_at?: string | null;
-}
-/** A conversation's binding as this reader sees it. */
-interface ThreadBinding {
-    /** The bound document, or null (unbound, or bound to one this reader cannot open). */
-    documentId: string | null;
-    /** Bound to a document this reader cannot open (another member's private document, or deleted). */
-    unavailable: boolean;
-}
-declare const UNBOUND: ThreadBinding;
-/** A row's binding. */
-declare function bindingOfRow(row: ThreadBindingRow | null | undefined): ThreadBinding;
-/** The most recently active conversation bound to a document, among `conversations`, or null. */
-declare function latestThreadOfDocument(conversations: readonly ThreadBindingRow[] | null | undefined, documentId: string): string | null;
-declare const LEGACY_THREAD_DOCUMENTS_KEY = "arbi-thread-documents";
-/** The bindings this browser kept locally (conversation id → document id); empty when none. */
-declare function readLegacyThreadDocuments(): Record<string, string>;
-/** Forget locally kept bindings (moved to the server); the key goes with the last of them. */
-declare function forgetLegacyThreadDocuments(conversationIds: readonly string[]): void;
-
-/**
- * A search's state outside any component: the query last searched, its passages, and whether it
- * is running. A page that shows the shared session (`sharedSearchSession`) keeps its results when
- * it is left and opened again, another surface can hand it a query to run on arrival
- * ({@link requestSearch}), and {@link persistSearchSession} keeps the last query across reloads.
- */
-
-type SearchStatus = 'idle' | 'running' | 'done' | 'error';
-interface SearchSessionState {
-    /** The workspace the query and results belong to. */
-    workspaceId: string | null;
-    /** The query last searched, or handed over to run. */
-    query: string;
-    /** The last search's passages, best first. */
-    results: SearchChunk[];
-    /** A search has finished with results to show (cleared by {@link clearSearchSession}). */
-    searched: boolean;
-    status: SearchStatus;
-    error: string | null;
-    /** A query handed over by {@link requestSearch}, run once by the page that shows the session. */
-    pending: string | null;
-    /** Counts searches, so the reply to an older one never overwrites a newer one. */
-    run: number;
-}
-type SearchSession = StoreApi<SearchSessionState>;
-declare function createSearchSession(): SearchSession;
-/** The session a host's search page shows. */
-declare const sharedSearchSession: SearchSession;
-/** Back to nothing searched (in `workspaceId` when given); a running search's reply is dropped. */
-declare function clearSearchSession(workspaceId?: string | null, session?: SearchSession): void;
-/**
- * Hand a query to the search page, which runs it when it shows the session (the user already
- * asked once; the page must not wait for a second Enter).
- */
-declare function requestSearch(query: string, workspaceId: string | null, session?: SearchSession): void;
-/** The handed-over query, once: the next call returns null. */
-declare function takePendingSearch(session?: SearchSession): string | null;
-/**
- * Keep the last query (and its workspace) in `storage` under `key`, so the search box shows it
- * after a reload. Results are not kept. Returns the unsubscribe.
- */
-declare function persistSearchSession(key: string, storage?: Pick<Storage, 'getItem' | 'setItem'> | undefined, session?: SearchSession): () => void;
-
-type NotifyVariant = 'success' | 'error' | 'info' | 'warning';
-interface AppNotification {
-    id: string;
-    title: string;
-    description?: string;
-    variant: NotifyVariant;
-    /** Epoch ms the entry was recorded. */
-    ts: number;
-    read: boolean;
-    /** Optional in-app link the entry deep-links to (passed to the bell's onNavigate). */
-    href?: string;
-    /** Optional click action — wins over `href` when both are present. Session
-     *  history only: never persisted, so a closure is safe here. */
-    onSelect?: () => void;
-    /** The label of the action `onSelect` runs ("Reply", "View"). */
-    actionLabel?: string;
-    /** Workspace the entry belongs to. */
-    workspaceId?: string;
-    /** Markup of a rich (non-string) toast message, for a log that shows it as it was toasted. */
-    html?: string;
-    /** Routine session activity ("Opening workspace…", "Saved") — kept for the
-     *  log but not something that demands attention: excluded from the unread
-     *  badge and from the bell's list. */
-    ambient?: boolean;
-    /** Where the entry comes from. Session entries (`notify.*`) have none; a
-     *  backend bridge stamps its own (e.g. 'server') so {@link syncSource} can
-     *  replace exactly its slice on every refetch without touching the rest. */
-    source?: string;
-}
-interface NotifyOptions {
-    /** Shown under the title in the toast; a string description is also recorded. */
-    description?: ReactNode;
-    /** Record an entry in the history (default true). False pops the toast only — for an event
-     *  whose entry arrives another way (a server-persisted notification synced by a bridge). */
-    record?: boolean;
-    /** Pop the transient toast (default true unless muted). False records the entry only. */
-    toast?: boolean;
-    /** Recorded title for a rich (non-string) toast title. Default: the string title, else the
-     *  rich title's text. */
-    recordTitle?: string;
-    /** Recorded markup for a rich toast title (default: the title rendered to static markup). */
-    html?: string;
-    href?: string;
-    /** Workspace the notification belongs to: its glyph shows in the toast and its link is the
-     *  entry's default `href` (both as configured with {@link configureNotify}). */
-    workspaceId?: string;
-    duration?: number;
-    /** A toast action button (sonner). Clicking the entry runs it too. */
-    action?: {
-        label: ReactNode;
-        onClick: () => void;
-    };
-    /** Override the toast glyph (sonner). */
-    icon?: ReactNode;
-    /** Extra class on the toast (sonner). */
-    className?: string;
-    /** Record as routine session activity (see {@link AppNotification.ambient}): born read. */
-    ambient?: boolean;
-}
-/** Session entries kept (oldest dropped first) — a safety net against pathological growth; a
- *  large upload can log many entries, so it is generous. Source slices are bounded by their source. */
-declare const MAX_SESSION_NOTIFICATIONS = 5000;
-interface NotifyState {
-    notifications: AppNotification[];
-    /** Toasts are muted: entries are still recorded — the history is what the user comes back to. */
-    muted: boolean;
-    setMuted: (muted: boolean) => void;
-    markRead: (id: string) => void;
-    markAllRead: () => void;
-    removeNotification: (id: string) => void;
-    removeNotifications: (ids: readonly string[]) => void;
-    clearNotifications: () => void;
-    /** Replace the history (e.g. seed a demo/initial set). */
-    seed: (items: AppNotification[]) => void;
-    /** Record an entry (used by `notify.*`; sonner renders the toast). */
-    record: (note: AppNotification) => void;
-    /** Reconcile one source's slice with fresh truth (e.g. a backend list on
-     *  every refetch): entries stamped with `source` are replaced wholesale —
-     *  including their read state, which the source owns — while entries from
-     *  other sources (session activity) stay untouched. Newest first. */
-    syncSource: (source: string, items: AppNotification[]) => void;
-}
-declare const useNotify: zustand.UseBoundStore<zustand.StoreApi<NotifyState>>;
-/** What a host configures once for every `notify.*` call. */
-interface NotifyConfig {
-    /** The toast glyph of a notification that names a workspace. */
-    workspaceIcon?: (workspaceId: string) => ReactNode;
-    /** The default link of an entry that names a workspace. */
-    workspaceHref?: (workspaceId: string) => string | undefined;
-    /** The default of {@link NotifyOptions.ambient} for calls that do not say: a host whose own
-     *  toasts are mostly confirmations ("Saved") records them as log lines, and passes
-     *  `ambient: false` for what should claim attention. Default false. */
-    ambient?: boolean;
-}
-/** Set the host's workspace glyph and link (merged into what is configured). */
-declare function configureNotify(next: NotifyConfig): void;
-declare const notify: {
-    success: (title: ReactNode, opts?: NotifyOptions) => string;
-    error: (title: ReactNode, opts?: NotifyOptions) => string;
-    info: (title: ReactNode, opts?: NotifyOptions) => string;
-    warning: (title: ReactNode, opts?: NotifyOptions) => string;
-};
-/** Replace the history — inject a seed/initial set. */
-declare function seedNotifications(items: AppNotification[]): void;
-/**
- * Keep the session history and the mute switch across reloads in `storage` under `key`: restores
- * them now and saves every change. Source slices are not saved (their source re-syncs them), and
- * neither are actions — a closure does not survive a reload. Returns the unsubscribe.
- */
-declare function persistNotifyHistory(key: string, storage?: Pick<Storage, 'getItem' | 'setItem'> | undefined): () => void;
-/** Unread count selector for the topbar bell — ambient session activity never
- *  demands attention, so it never counts. */
-declare const selectUnread: (s: NotifyState) => number;
-/** Default glyph colour per variant (raw palette, override via `toneClassNames`). */
-declare const DEFAULT_NOTIFY_TONE: Record<NotifyVariant, string>;
-
-/** What a custom bell trigger needs to render itself. */
-interface NotificationBellTriggerState {
-    /** Unread count (0 when none). */
-    unread: number;
-    /** Accessible name, including the count: "Notifications, 2 unread". */
-    ariaLabel: string;
-    testId: string;
-}
-interface NotificationBellProps {
-    /**
-     * Replaces the default icon button with the host's own trigger (for example a labelled sidebar
-     * row). It must forward its ref and rest props: it is mounted as the dropdown trigger.
-     */
-    renderTrigger?: (state: NotificationBellTriggerState) => ReactElement;
-    /** Called with an entry's `href` when it's clicked (e.g. router navigate). */
-    onNavigate?: (href: string) => void;
-    /** Open this entry in the host notification centre instead of following its link. */
-    onSelectNotification?: (notification: AppNotification) => void;
-    /** Called after an entry is locally marked read — the hook for a backend
-     *  bridge to propagate read state upstream (filter by the ids it owns). */
-    onMarkRead?: (id: string) => void;
-    /** Called after "Mark all read" — same upstream-propagation hook. */
-    onMarkAllRead?: () => void;
-    /** Show the store's toast mute switch in the header — the bell is where notification
-     *  behaviour is controlled. */
-    showMuteToggle?: boolean;
-    /** Override per-variant glyph colours (e.g. brand emerald for success). */
-    toneClassNames?: Partial<Record<NotifyVariant, string>>;
-    emptyText?: string;
-    /** Footer link to the app's full notification surface. Omit to hide. */
-    onViewAll?: () => void;
-    viewAllLabel?: string;
-    testId?: string;
-    /** Where the panel opens relative to the bell (a sidebar-footer bell opens upward). */
-    side?: 'top' | 'right' | 'bottom' | 'left';
-    align?: 'start' | 'center' | 'end';
-}
-declare function NotificationBell({ renderTrigger, onNavigate, onSelectNotification, onMarkRead, onMarkAllRead, showMuteToggle, toneClassNames, emptyText, onViewAll, viewAllLabel, testId, side, align, }: NotificationBellProps): React$1.JSX.Element;
-
-declare function Toaster({ toastOptions, ...props }: ToasterProps): React$1.JSX.Element;
-
-export { persistSearchSession as $, type AppNotification as A, extractMentions as B, type ChatArtifact as C, DEFAULT_ASSISTANT_NAME as D, filterMentionCandidates as E, findMentionQuery as F, forgetLegacyThreadDocuments as G, type HostConfigRecord as H, getChatArtifact as I, getChatArtifacts as J, hasMessageBody as K, LEGACY_THREAD_DOCUMENTS_KEY as L, MAX_SESSION_NOTIFICATIONS as M, NotificationBell as N, type OpenDocumentRegistration as O, insertMention as P, latestThreadOfDocument as Q, linkMentions as R, type SavedDocumentInput as S, type ThreadBinding as T, UNBOUND as U, mentionFromHref as V, type WordDocumentKind as W, notify as X, openDocumentId as Y, opensInWord as Z, persistNotifyHistory as _, ArbiHost as a, readLegacyThreadDocuments as a0, recordChatArtifact as a1, requestSearch as a2, savedDocumentIdFor as a3, seedNotifications as a4, selectUnread as a5, sharedSearchSession as a6, takeDocumentForTurn as a7, takePendingSearch as a8, toMessageMentions as a9, useAssistantCopy as aa, useAssistantName as ab, useChatArtifact as ac, useHostConfigRecord as ad, useMessageChatArtifact as ae, useNotify as af, useOpenDocumentId as ag, useRegisterOpenDocument as ah, useTurnDocumentId as ai, type ArbiHostConnection as b, type ArbiHostProps as c, type AssistantCopy as d, DEFAULT_NOTIFY_TONE as e, MENTION_HREF_PREFIX as f, type MentionCandidate as g, type MentionKind as h, type MessageMentionRef as i, type NotificationBellProps as j, type NotificationBellTriggerState as k, type NotifyConfig as l, type NotifyOptions as m, type NotifyVariant as n, type SearchSession as o, type SearchSessionState as p, type SearchStatus as q, type ThreadBindingRow as r, Toaster as s, type TurnDocumentInput as t, assistantCopy as u, bindingOfRow as v, clearChatArtifacts as w, clearSearchSession as x, configureNotify as y, createSearchSession as z };