@semiont/react-ui 0.5.26 → 0.5.28

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import * as _semiont_react_ui from '@semiont/react-ui';
 import { BrowseMediaRenderers as BrowseMediaRenderers$1, AnnotateMediaRenderers as AnnotateMediaRenderers$1 } from '@semiont/react-ui';
-import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, StateUnit, GatheredContext, EventMap, DiscoveredKB, AnnotationId, AnchorStrategy, AnchorConfidence, StoredEventLike, ConnectionState, BackendDownload, ProgressEvent, AccessToken } from '@semiont/core';
+import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, StateUnit, CollaboratorEntry, EventMap, DiscoveredKB, AnnotationId, AnchorStrategy, AnchorConfidence, StoredEventLike, ConnectionState, GatheredContext, BackendDownload, ProgressEvent, AccessToken } from '@semiont/core';
 export { Annotation } from '@semiont/core';
 import * as React$1 from 'react';
 import React__default, { ComponentType, ReactNode, KeyboardEvent as KeyboardEvent$1, Component, ErrorInfo, MouseEvent, Ref } from 'react';
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import { SemiontClient, SemiontSession, DiscoveryTransport, DiscoveryState, SemiontBrowser, SessionStorage, SessionFactory, OpenResource, TagSchema, UploadProgress, BeckonStateUnit, MarkStateUnit, GatherStateUnit, YieldStateUnit, ReferencedByEntry } from '@semiont/sdk';
+import { SemiontClient, SemiontSession, DiscoveryTransport, DiscoveryState, SemiontBrowser, SessionStorage, SessionFactory, YieldOutcome, OpenResource, ResourceGatherOptions, TagSchema, UploadProgress, BeckonStateUnit, MarkStateUnit, GatherStateUnit, YieldStateUnit, ReferencedByEntry } from '@semiont/sdk';
 export { BeckonStateUnit, GatherStateUnit, GenerateDocumentOptions, HOVER_DELAY_MS, HoverHandlers, MarkStateUnit, MatchStateUnit, PendingAnnotation, SearchPipeline, SearchPipelineOptions, SearchState, TagSchema, YieldStateUnit, createBeckonStateUnit, createGatherStateUnit, createHoverHandlers, createMarkStateUnit, createMatchStateUnit, createSearchPipeline, createYieldStateUnit } from '@semiont/sdk';
 import { Observable } from 'rxjs';
 
@@ -921,7 +921,7 @@ interface Router {
  * router.push('/know/discover', { reason: 'resource-closed' });
  *
  * // React Router
- * import { useNavigate } from 'react-router-dom';
+ * import { useNavigate } from 'react-router';
  * const navigate = useNavigate();
  * const router = useObservableRouter({ push: navigate });
  * router.push('/know/discover', { reason: 'resource-closed' });
@@ -1072,28 +1072,6 @@ interface UseResourceContentResult {
  */
 declare function useResourceContent(client: SemiontClient | null, rUri: ResourceId, resource: ResourceDescriptor, enabled?: boolean): UseResourceContentResult;
 
-interface ResourceGatherOptions {
-    depth?: number;
-    maxResources?: number;
-    includeContent?: boolean;
-    includeSummary?: boolean;
-    /** Entity types to exclude from the gather's semantic recall (e.g. ['Question']). */
-    excludeEntityTypes?: string[];
-}
-interface UseResourceGatherResult {
-    context: GatheredContext | null;
-    loading: boolean;
-    error: Error | null;
-    /** Run a resource gather (`gather.resource`) and store the result. */
-    gather: (resourceId: string, options?: ResourceGatherOptions) => Promise<void>;
-    reset: () => void;
-}
-/**
- * Drives a whole-resource gather (`client.gather.resource`, a Promise — no progress
- * stream) into React state. The home for the GENERATE-FROM-BUTTON resource-gather flow.
- */
-declare function useResourceGather(): UseResourceGatherResult;
-
 interface UseResourceLoaderResult {
     resource: ResourceDescriptor | undefined;
     annotations: AnnotationsCollection;
@@ -1123,6 +1101,32 @@ interface UseMediaTokenResult {
  */
 declare function useMediaToken(client: SemiontClient | null, id: ResourceId): UseMediaTokenResult;
 
+interface UseCollaboratorsResult {
+    collaborators: CollaboratorEntry[];
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * The KB's collaborator roster — its declared software agents, each with the
+ * job types it serves and, when discovery could answer, its model's context and
+ * output ceilings (INFERENCE-LIMITS-EXPOSURE).
+ *
+ * Takes the client explicitly rather than reaching for `useSemiont()`, matching
+ * `useMediaToken(client)`: a bring-your-own-session host can use it with a bare
+ * session, and the batteries-included page passes `session.client`.
+ *
+ * SUBSCRIBES rather than fetching once. `browse.agents()` is a `CacheObservable`
+ * whose only refresh triggers are `bus:resume-gap` and an explicit `fresh()` —
+ * a backend restart with a changed roster necessarily presents as an SSE gap, so
+ * a one-shot read would pin the UI to a roster that no longer exists. Awaiting
+ * it instead would also force a network round trip on every mount, which is
+ * exactly what the cache exists to avoid.
+ *
+ * `error` is surfaced but empty-on-failure is the display contract: a roster
+ * that cannot be read shows as no roster, never as a broken panel.
+ */
+declare function useCollaborators(client: SemiontClient | null): UseCollaboratorsResult;
+
 /**
  * Subscribe to session-scoped bus events on an explicit `SemiontSession` — the
  * provider-free counterpart to `useEventSubscriptions`. The embeddable viewer
@@ -1328,9 +1332,9 @@ declare function useEventSubscriptions(subscriptions: {
 }): void;
 
 interface ResourceAnnotationsContextType {
-    newAnnotationIds: Set<string>;
+    sparkleAnnotationIds: Set<string>;
     markAnnotation: (rUri: ResourceId, motivation: 'highlighting' | 'linking' | 'assessing' | 'commenting' | 'tagging', selector: Selector | Selector[], body?: any[]) => Promise<string | undefined>;
-    clearNewAnnotationId: (id: AnnotationId) => void;
+    clearSparkle: (id: AnnotationId) => void;
     triggerSparkleAnimation: (annotationId: string) => void;
 }
 declare function ResourceAnnotationsProvider({ children }: {
@@ -1475,7 +1479,7 @@ interface Props$c {
     }) => void;
     onChange?: (content: string) => void;
     editable?: boolean;
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     hoveredAnnotationId?: string | null;
     scrollToAnnotationId?: string | null;
     sourceView?: boolean;
@@ -1486,73 +1490,121 @@ interface Props$c {
     generatingReferenceId?: string | null;
     hoverDelayMs: number;
 }
-declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$c): React$1.JSX.Element;
+declare function CodeMirrorRenderer({ content, segments, onChange, editable, sparkleAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$c): React$1.JSX.Element;
 
-type JobProgress$8 = components['schemas']['JobProgress'];
+type JobProgress$9 = components['schemas']['JobProgress'];
+type JobProgressMessage = components['schemas']['JobProgressMessage'];
 /**
- * Every string this component renders. Required by default and with NO
- * English fallbacks (ASSIST-SURFACE-WARTS Lane A): a `tr.x || 'X'` default
- * turns a forgotten key into English text in a Japanese UI, silently and
- * only at runtime. Required keys make the same mistake a type error at the
- * call site. Only genuinely conditional copy is optional.
+ * Every string this component renders. Required by default and with NO English
+ * fallbacks (ASSIST-SURFACE-WARTS Lane A): a `tr.x || 'X'` default turns a
+ * forgotten key into English text in a Japanese UI, silently and only at
+ * runtime. Required keys make the same mistake a type error at the call site.
+ *
+ * The nine wire codes collapse to ONE required function rather than nine keys:
+ * the code→copy switch belongs in one place, and threading nine strings through
+ * five call sites would put five copies of it in the tree. Build it with
+ * `assistProgressCopy(t)`.
  */
 interface AssistProgressTranslations {
-    /** Header title (e.g. "Annotating Entity References" / "Generating Resource"). Omit for the headerless inline style. */
-    title?: string;
-    /** Cancel-button title attribute. */
+    /** Control label while the run is in flight. */
     cancel: string;
-    /** Default in-progress status message (used when the job sends no `message`). */
+    /** Control label once the run has ended. */
+    close: string;
+    /** Localized copy for a progress code. */
+    message: (m: JobProgressMessage) => string;
+    /**
+     * Shown when no code has arrived yet — a pure liveness heartbeat, or an event
+     * predating the coded wire. `JobProgress.message` is optional for exactly
+     * these cases.
+     */
     inProgress: string;
-    /** Status copy for the terminal 'complete' stage. */
-    complete: string;
-    /** Fallback status copy for the terminal 'error' stage. */
-    failed: string;
-    /** Request-parameters block heading. */
-    paramsTitle: string;
-    /** Current-work detail line — the generic form, used by every flow. */
-    processing: (label: string) => string;
+    /**
+     * The subject line: what is being worked on, with its position when known.
+     * Takes the wire's `{ kind, value }` — the localized name for `kind` is the
+     * translation layer's business, not this component's.
+     */
+    subject: (current: NonNullable<JobProgress$9['current']>, done?: number, total?: number) => string;
+    /**
+     * Localized NAME for an echoed request parameter. The wire sends a code
+     * (`instructions`, `tone`, …); the VALUE beside it is the user's own words
+     * and is never translated.
+     */
+    paramLabel: (code: string) => string;
     /** Completed entity-type log line (reference flow only). */
     found?: (count: number) => string;
-    /** Current-work detail line, reference-flow wording; falls back to `processing`. */
-    current?: (label: string) => string;
-    /** Dismiss-button label. */
-    close: string;
 }
+/**
+ * The CSS `data-type` hook: five motivations plus generation. A closed set, so
+ * it is typed as one — a typo used to produce unstyled chrome, silently
+ * (CLEAN-PROGRESS A9).
+ */
+type AssistDataType = 'highlight' | 'comment' | 'assessment' | 'reference' | 'tag' | 'generation';
 interface AssistProgressProps {
-    progress: JobProgress$8;
-    /** CSS `data-type` hook ('highlight' | 'comment' | … | 'reference' | 'tag' | 'generation'). */
-    dataType: string;
-    /** Cancel the underlying job — rendered while running when provided. Caller wires `client.job.cancelRequest(...)`. */
-    onCancel?: () => void;
+    progress: JobProgress$9;
+    dataType: AssistDataType;
+    /**
+     * What the finished run produced, offered as a link in the ended frame
+     * (GENERATE-FROM-RESOURCE D8). The label is the artifact's own name — user
+     * content, never translated. Rendered only once `ended`: mid-run there is no
+     * outcome to offer, whatever the caller has wired.
+     */
+    outcome?: {
+        label: string;
+        onOpen: () => void;
+    } | undefined;
     /**
-     * Dismiss the display — rendered whenever provided. WHEN dismissal is
-     * offered is the caller's policy (AssistShell withholds the callback while
-     * the assist is still running). Caller wires `client.mark.dismissProgress()`.
+     * The owner's terminal sentence, rendered in place of the payload message
+     * once `ended` (GENERATION-ARRIVAL P1). The producer's final frame is a
+     * fire-and-forget emit that can lose the race with `job:complete`, so an
+     * ended frame must not trust the last payload to describe the ending —
+     * the owner, which signalled `ended`, supplies the words too. Inert while
+     * the run is live.
      */
+    endedMessage?: string;
+    /**
+     * The run has ENDED. The owner's fact, not the payload's
+     * (ASSIST-PROGRESS-CONSOLIDATION D7): terminality is signalled on
+     * `job:complete` / `job:fail`, which `AssistShell` already observes via
+     * `isAssisting`. This component deliberately does not read `progress.stage` —
+     * no producer in the repo emits a terminal stage, and the two branches that
+     * believed the schema's description were unreachable for exactly that reason.
+     *
+     * REQUIRED (CLEAN-PROGRESS A1). It was optional, and the one call site that
+     * forgot it shipped a flow that could never reach the ended state at all.
+     * Nothing about a progress payload can tell this component the run is over,
+     * so the owner must say — and a default of `false` is a wrong answer, not a
+     * safe one.
+     */
+    ended: boolean;
+    /** Cancel the underlying job. Caller wires `client.job.cancelRequest(...)`. */
+    onCancel?: () => void;
+    /** Dismiss the display. Caller wires `client.mark.dismissProgress()`. */
     onDismiss?: () => void;
-    /** Render the percentage bar (tag flow's visual; percentage itself comes from `progress`). */
-    showPercentBar?: boolean;
     translations: AssistProgressTranslations;
 }
 /**
- * The one job-progress renderer (#7) — unifies the three previous shapes
- * (AssistSection's inline block, the reference/generation widget, TaggingPanel's
- * inline block). Presentational and provider-free: no session, no context —
- * cancel/dismiss arrive as callbacks, so it renders identically on the page and
- * in embeddable (bring-your-own-session) hosts. Feature blocks are
- * data-presence-driven: each call site keeps its established visuals by passing
- * the data and translations it always had.
+ * The one job-progress renderer, for all five motivations.
+ *
+ * Presentational and provider-free: no session, no context — cancel/dismiss
+ * arrive as callbacks, so it renders identically on the page and in embeddable
+ * (bring-your-own-session) hosts.
+ *
+ * One shape for every flow. What varies is DATA, not flags: a bar appears
+ * because there is a fraction to fill it, a subject line appears because there
+ * is a subject. The previous `title` / `showPercentBar` / `found` / `current`
+ * opt-ins produced four unrelated layouts from one component, which is what
+ * generated the duplicate renders and doubled chrome this replaces.
  */
-declare function AssistProgress({ progress, dataType, onCancel, onDismiss, showPercentBar, translations: tr, }: AssistProgressProps): React$1.JSX.Element;
+declare function AssistProgress({ progress, dataType, ended, outcome, endedMessage, onCancel, onDismiss, translations: tr, }: AssistProgressProps): React$1.JSX.Element;
 
-type JobProgress$7 = components['schemas']['JobProgress'];
+type JobProgress$8 = components['schemas']['JobProgress'];
 interface AssistShellProps {
-    /** localStorage persist-key suffix and CSS `data-type` ('highlight' | 'comment' | 'assessment' | 'reference' | 'tag'). */
-    assistType: string;
+    /** localStorage persist-key suffix and CSS `data-type`. */
+    assistType: AssistDataType;
     /** Collapsible section title (already translated). */
     title: string;
     isAssisting: boolean;
-    progress: JobProgress$7 | null | undefined;
+    progress: JobProgress$8 | null | undefined;
     /** The per-motivation form (fields + submit) — shown when no progress is displayed. */
     form: ReactNode;
     /**
@@ -1564,7 +1616,7 @@ interface AssistShellProps {
      * itself, so a caller that omitted this would render untranslated chrome —
      * the failure Lane A exists to make impossible.
      */
-    progressProps: Omit<AssistProgressProps, 'progress' | 'dataType'>;
+    progressProps: Omit<AssistProgressProps, 'progress' | 'dataType' | 'ended'>;
 }
 /**
  * The one assist-section chrome (#7): collapsible header with persisted expand
@@ -1901,7 +1953,7 @@ interface AnnotateMediaRendererProps {
     selectedMotivation: SelectionMotivation | null;
     hoveredAnnotationId?: string | null;
     hoverDelayMs?: number;
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     scrollToAnnotationId?: string | null;
     showLineNumbers?: boolean;
     enableWidgets?: boolean;
@@ -1910,7 +1962,7 @@ interface AnnotateMediaRendererProps {
 }
 /** Annotating media dispatch, keyed by the registry render mode. */
 type AnnotateMediaRenderers = Partial<Record<string, ComponentType<AnnotateMediaRendererProps>>>;
-declare function TextAnnotateRenderer({ content, annotations, session, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, showLineNumbers, hoverDelayMs, enableWidgets, getTargetResourceName, generatingReferenceId, }: AnnotateMediaRendererProps): React$1.JSX.Element;
+declare function TextAnnotateRenderer({ content, annotations, session, sparkleAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, showLineNumbers, hoverDelayMs, enableWidgets, getTargetResourceName, generatingReferenceId, }: AnnotateMediaRendererProps): React$1.JSX.Element;
 declare function ImageAnnotateRenderer({ content, resourceUri, annotations, session, drawingMode, selectedMotivation, hoveredAnnotationId, hoverDelayMs, }: AnnotateMediaRendererProps): React$1.JSX.Element | null;
 declare function PdfAnnotateRenderer({ content, resourceUri, annotations, session, drawingMode, selectedMotivation, hoveredAnnotationId, hoverDelayMs, }: AnnotateMediaRendererProps): React$1.JSX.Element | null;
 /**
@@ -1939,7 +1991,7 @@ interface Props$9 {
     /** Session for the shown resource — its client emits mark:* / mark.request; its bus feeds toolbar + beckon events. */
     session: SemiontSession | null;
     /** Recently-created annotation ids to sparkle (host-provided; was ResourceAnnotationsContext). */
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     /** The bar's Mode control reports the chosen mode here (the owner applies it). */
     onModeChange?: (mode: boolean) => void;
     /** Render the built-in bar (default). false → no bar; selection capture and drawing stay live. */
@@ -1952,9 +2004,9 @@ interface Props$9 {
  *
  * @emits mark:requested - User requested to create annotation. Payload: { selector: Selector | Selector[], motivation: SelectionMotivation }
  * @subscribes beckon:hover - Annotation hovered. Payload: { annotationId: string | null }
- * @subscribes beckon:focus - Scroll to and highlight annotation. Payload: { annotationId: string }
+ * @subscribes beckon:focus - Scroll to and highlight annotation, unless `resourceId` names a different resource (D7). Payload: { annotationId: string, resourceId?: string }
  */
-declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode, session, newAnnotationIds, onModeChange, showToolbar, renderers, }: Props$9): React$1.JSX.Element;
+declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode, session, sparkleAnnotationIds, onModeChange, showToolbar, renderers, }: Props$9): React$1.JSX.Element;
 
 interface Props$8 {
     /**
@@ -2021,7 +2073,7 @@ interface Props$7 {
     /** Session for the shown resource — emits browse:click / beckon:hover; its bus feeds beckon events. */
     session: SemiontSession | null;
     /** Recently-created annotation ids to sparkle (host-provided; was ResourceAnnotationsContext). */
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     /** Override the read-only media renderers (render mode → renderer); merged over the defaults. */
     renderers?: BrowseMediaRenderers;
     /** A content link (`<a href>` in the rendered content) was clicked. The viewer preventDefaults and
@@ -2062,7 +2114,7 @@ interface ReferenceHover {
  * @subscribes beckon:hover - Highlight annotation on hover. Payload: { annotationId: string | null }
  * @subscribes beckon:focus - Scroll to and highlight annotation. Payload: { annotationId: string }
  */
-declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, resourceUri, annotations, selectedClick, onModeChange, onClickActionChange, showToolbar, annotateMode, hoverDelayMs, session, newAnnotationIds, renderers, onLinkClick, onReferenceHover, inline, }: Props$7) => React$1.JSX.Element>;
+declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, resourceUri, annotations, selectedClick, onModeChange, onClickActionChange, showToolbar, annotateMode, hoverDelayMs, session, sparkleAnnotationIds, renderers, onLinkClick, onReferenceHover, inline, }: Props$7) => React$1.JSX.Element>;
 
 interface Props$6 {
     /** The '@id' of the resource whose bytes to offer. */
@@ -2143,7 +2195,7 @@ interface Props$4 {
     /** Inline display variant: auto-height, no inner scroll, no pane chrome (browse path). Default: fill-the-pane. */
     inline?: boolean;
     /** Recently-created annotation ids to sparkle (threaded to the browse/annotate subtree). */
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     generatingReferenceId?: string | null;
     showLineNumbers?: boolean;
     hoverDelayMs?: number;
@@ -2194,9 +2246,12 @@ interface Props$4 {
  * panel opening invokes the host's `onOpenPanel` callback — the host owns
  * the panel and any `panel:open` emission.
  *
- * @subscribes browse:click - User clicked on annotation. Payload: { annotationId: string, motivation, anchorRect? }
+ * @subscribes browse:click - An annotation was clicked — locally, or driven over
+ *   the wire by another participant. Payload: { annotationId: string, anchorRect? };
+ *   the motivation is derived from the annotation the id names, and an id this
+ *   viewer has not loaded is a no-op.
  */
-declare function ResourceViewer({ resource, annotations, session, onOpenResource, onOpenPanel, onLinkClick, onReferenceHover, inline, newAnnotationIds, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp, annotateMode: annotateModeProp, onAnnotateModeChange, clickAction: clickActionProp, onClickActionChange, selectionMotivation: selectionMotivationProp, onSelectionMotivationChange, shape: shapeProp, onShapeChange, showToolbar, browseRenderers, annotateRenderers, }: Props$4): React__default.JSX.Element;
+declare function ResourceViewer({ resource, annotations, session, onOpenResource, onOpenPanel, onLinkClick, onReferenceHover, inline, sparkleAnnotationIds, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp, annotateMode: annotateModeProp, onAnnotateModeChange, clickAction: clickActionProp, onClickActionChange, selectionMotivation: selectionMotivationProp, onSelectionMotivationChange, shape: shapeProp, onShapeChange, showToolbar, browseRenderers, annotateRenderers, }: Props$4): React__default.JSX.Element;
 
 interface AssessmentEntryProps {
     /** Session for interaction routing (browse.click etc.); the panel threads it. */
@@ -2209,7 +2264,7 @@ interface AssessmentEntryProps {
 declare function AssessmentEntry({ session, assessment, isFocused, isHovered, ref, }: AssessmentEntryProps): React$1.JSX.Element;
 
 type Motivation$5 = components['schemas']['Motivation'];
-type JobProgress$6 = components['schemas']['JobProgress'];
+type JobProgress$7 = components['schemas']['JobProgress'];
 interface PendingAnnotation$5 {
     selector: Selector | Selector[];
     motivation: Motivation$5;
@@ -2222,7 +2277,7 @@ interface AssessmentPanelProps {
     annotations: Annotation[];
     pendingAnnotation: PendingAnnotation$5 | null;
     isAssisting?: boolean;
-    progress?: JobProgress$6 | null;
+    progress?: JobProgress$7 | null;
     locale?: string;
     /** BCP-47 tag of the resource being analyzed — forwarded to the assist call. */
     sourceLanguage?: string;
@@ -2262,8 +2317,18 @@ interface Props$3 {
     eventCount: number;
     lastEventTimestamp?: string;
     knowledgeBaseName?: string;
+    /**
+     * The KB's collaborator roster (`client.browse.agents()`, typically via
+     * `useCollaborators`). Optional so hosts that never wire it — including
+     * external consumers of this package — render exactly as before.
+     *
+     * Each entry's `limits` is absent whenever discovery could not answer *right
+     * now* (INFERENCE-LIMITS-EXPOSURE D3), so a missing ceiling is normal and
+     * shows as no ceiling rather than as an error.
+     */
+    collaborators?: CollaboratorEntry[];
 }
-declare function CollaborationPanel({ state, eventCount, lastEventTimestamp, knowledgeBaseName }: Props$3): React$1.JSX.Element;
+declare function CollaborationPanel({ state, eventCount, lastEventTimestamp, knowledgeBaseName, collaborators }: Props$3): React$1.JSX.Element;
 
 interface CommentEntryProps {
     /** Session for interaction routing (browse.click etc.); the panel threads it. */
@@ -2277,7 +2342,7 @@ interface CommentEntryProps {
 declare function CommentEntry({ session, comment, isFocused, isHovered, annotateMode, ref, }: CommentEntryProps): React$1.JSX.Element;
 
 type Motivation$4 = components['schemas']['Motivation'];
-type JobProgress$5 = components['schemas']['JobProgress'];
+type JobProgress$6 = components['schemas']['JobProgress'];
 interface PendingAnnotation$4 {
     selector: Selector | Selector[];
     motivation: Motivation$4;
@@ -2291,7 +2356,7 @@ interface CommentsPanelProps {
     pendingAnnotation: PendingAnnotation$4 | null;
     annotateMode?: boolean;
     isAssisting?: boolean;
-    progress?: JobProgress$5 | null;
+    progress?: JobProgress$6 | null;
     locale?: string;
     /** BCP-47 tag of the resource being analyzed — forwarded to the assist call. */
     sourceLanguage?: string;
@@ -2308,7 +2373,7 @@ interface CommentsPanelProps {
  */
 declare function CommentsPanel({ session, resourceId, annotations, pendingAnnotation, annotateMode, isAssisting, progress, locale, sourceLanguage, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): React$1.JSX.Element;
 
-type JobProgress$4 = components['schemas']['JobProgress'];
+type JobProgress$5 = components['schemas']['JobProgress'];
 interface AssistSectionProps {
     /** Session carrying the client and event bus; null renders inert. */
     session: SemiontSession | null;
@@ -2318,7 +2383,7 @@ interface AssistSectionProps {
     locale?: string;
     /** BCP-47 tag of the resource being analyzed. Forwarded to the prompt so the LLM analyzes non-English source correctly. */
     sourceLanguage?: string;
-    progress?: JobProgress$4 | null | undefined;
+    progress?: JobProgress$5 | null | undefined;
 }
 /**
  * Assist fields for the text motivations (highlight, assessment, comment):
@@ -2342,7 +2407,7 @@ interface HighlightEntryProps {
 declare function HighlightEntry({ session, highlight, isFocused, isHovered, ref, }: HighlightEntryProps): React$1.JSX.Element;
 
 type Motivation$3 = components['schemas']['Motivation'];
-type JobProgress$3 = components['schemas']['JobProgress'];
+type JobProgress$4 = components['schemas']['JobProgress'];
 interface PendingAnnotation$3 {
     selector: Selector | Selector[];
     motivation: Motivation$3;
@@ -2355,7 +2420,7 @@ interface HighlightPanelProps {
     annotations: Annotation[];
     pendingAnnotation: PendingAnnotation$3 | null;
     isAssisting?: boolean;
-    progress?: JobProgress$3 | null;
+    progress?: JobProgress$4 | null;
     annotateMode?: boolean;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
@@ -2406,11 +2471,13 @@ interface ReferenceEntryProps {
     onOpenResource?: (resourceId: string) => void;
     annotateMode?: boolean;
     isGenerating?: boolean;
+    /** The reference just got attention-worthy (created or resolved) — glow the icon (RESOLUTION-SPARKLE D6). */
+    sparkle?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function ReferenceEntry({ session, reference, isFocused, isHovered, onOpenResource, annotateMode, isGenerating, ref, }: ReferenceEntryProps): React$1.JSX.Element;
+declare function ReferenceEntry({ session, reference, isFocused, isHovered, onOpenResource, annotateMode, isGenerating, sparkle, ref, }: ReferenceEntryProps): React$1.JSX.Element;
 
-type JobProgress$2 = components['schemas']['JobProgress'];
+type JobProgress$3 = components['schemas']['JobProgress'];
 
 type Motivation$2 = components['schemas']['Motivation'];
 type ReferencedBy = components['schemas']['GetReferencedByResponse']['referencedBy'][number];
@@ -2427,7 +2494,7 @@ interface Props$1 {
     resourceId: string;
     annotations?: Annotation[];
     isAssisting: boolean;
-    progress: JobProgress$2 | null;
+    progress: JobProgress$3 | null;
     annotateMode?: boolean;
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
@@ -2455,6 +2522,8 @@ interface Props$1 {
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
+    /** Annotations currently sparkling (recently created or resolved) — entries in the set glow their icon (RESOLUTION-SPARKLE D6). */
+    sparkleAnnotationIds?: Set<string>;
     /** User UI locale — stamped on the unresolved-reference body's `language` field. */
     locale?: string;
     /** BCP-47 tag of the resource being analyzed — fed into the prompt for source-aware analysis. */
@@ -2468,9 +2537,10 @@ interface Props$1 {
  * @emits mark:cancel-pending - Cancel pending reference annotation. Payload: undefined
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function ReferencesPanel({ session, onOpenResource, resourceId, annotations, isAssisting, progress, annotateMode, Link, routes, allEntityTypes, entityTypesError, generatingReferenceId, referencedBy, referencedByLoading, referencedByError, onRetryReferencedBy, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: Props$1): React__default.JSX.Element;
+declare function ReferencesPanel({ session, onOpenResource, resourceId, annotations, isAssisting, progress, annotateMode, Link, routes, allEntityTypes, entityTypesError, generatingReferenceId, referencedBy, referencedByLoading, referencedByError, onRetryReferencedBy, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, sparkleAnnotationIds, locale, sourceLanguage, }: Props$1): React__default.JSX.Element;
 
 type Agent = components['schemas']['Agent'];
+type JobProgress$2 = components['schemas']['JobProgress'];
 interface Props {
     /** Session carrying the client and event bus; null renders inert. */
     session: SemiontSession | null;
@@ -2492,6 +2562,17 @@ interface Props {
      * to a verb). Omit to hide the Generate action.
      */
     onGenerate?: () => void;
+    /**
+     * Generation lifecycle, page-held (`yield.isGenerating$` / `yield.progress$`
+     * / `yield.outcome$`): this panel is generation's progress surface
+     * (GENERATE-FROM-RESOURCE D7) — the run reports where it was started.
+     */
+    isGenerating?: boolean;
+    generationProgress?: JobProgress$2 | null;
+    /** The finished run's result; the ended frame links it by name (D8). */
+    generationOutcome?: YieldOutcome | null;
+    /** Clear the finished display — wires `yield.dismissProgress()`. */
+    onDismissProgress?: () => void;
 }
 /**
  * Panel for displaying resource metadata and management actions
@@ -2500,7 +2581,7 @@ interface Props {
  * @emits mark:unarchive - Unarchive this resource
  * @emits mark:archive - Archive this resource
  */
-declare function ResourceInfoPanel({ session, resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, wasAttributedTo, wasDerivedFrom, generator, onGenerate, }: Props): React$1.JSX.Element;
+declare function ResourceInfoPanel({ session, resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, wasAttributedTo, wasDerivedFrom, generator, onGenerate, isGenerating, generationProgress, generationOutcome, onDismissProgress, }: Props): React$1.JSX.Element;
 
 interface StatisticsPanelProps {
     highlights: Annotation[];
@@ -2558,7 +2639,7 @@ declare function TaggingPanel({ session, resourceId, annotations, annotateMode,
 type JobProgress = components['schemas']['JobProgress'];
 
 type Motivation = components['schemas']['Motivation'];
-type TabKey = 'statistics' | 'reference' | 'highlight' | 'assessment' | 'comment' | 'tag';
+type TabKey = 'statistics' | AnnotatorKey;
 interface PendingAnnotation {
     selector: Selector | Selector[];
     motivation: Motivation;
@@ -2598,6 +2679,8 @@ interface UnifiedAnnotationsPanelProps {
     entityTypesError?: Error | null;
     referencedByError?: Error | null;
     onRetryReferencedBy?: () => void;
+    /** Annotations currently sparkling (recently created or resolved) — RESOLUTION-SPARKLE D6. */
+    sparkleAnnotationIds?: Set<string>;
     resourceId: string;
     initialTab?: TabKey;
     initialTabGeneration?: number;
@@ -2836,7 +2919,22 @@ interface GenerationConfig {
     context: GatheredContext;
 }
 
+interface ComposeParams$1 {
+    name: string;
+    /** Full file:// URI. */
+    storagePath: string;
+    content: string;
+    entityTypes: string[];
+    language: string;
+}
+
 interface ReferenceWizardModalProps {
+    /**
+     * Roster entry serving `generation`, forwarded to ConfigureGenerationStep so
+     * the max-length control is bounded by the model's real output ceiling.
+     * Optional: absent means today's default bounds (INFERENCE-LIMITS-EXPOSURE D3).
+     */
+    generationAgent?: CollaboratorEntry;
     isOpen: boolean;
     onClose: () => void;
     /** The annotation being resolved */
@@ -2847,6 +2945,12 @@ interface ReferenceWizardModalProps {
     defaultTitle: string;
     /** Entity types from the annotation */
     entityTypes: string[];
+    /**
+     * The source resource's display name — a page fact (the wizard opens FROM
+     * that resource), shown in the gather skeleton's source line before the
+     * gathered context can say it itself.
+     */
+    resourceName?: string;
     /** Current locale for generation defaults */
     locale: string;
     /** Gathered context state */
@@ -2856,21 +2960,36 @@ interface ReferenceWizardModalProps {
     /** Callbacks */
     onGenerateSubmit: (referenceId: string, config: GenerationConfig) => void;
     onLinkResource: (referenceId: string, targetResourceId: string) => void;
-    onComposeNavigate: (context: GatheredContext, annotationId: string, resourceId: string, title: string, entityTypes: string[]) => void;
+    /**
+     * Create-and-link (COMPOSE-IN-MODAL): the host runs `yield.resource` then
+     * `bind.body` and settles the promise; rejection keeps the modal open with
+     * the compose footer re-enabled. Replaces the old navigate-to-page flow.
+     */
+    onComposeSubmit: (referenceId: string, params: ComposeParams$1) => Promise<void>;
+    /** Picker vocabulary for compose when the reference fixed no entity types. */
+    entityTypeOptions?: string[];
+    /** Editor hover delay for the compose step's CodeMirror. */
+    hoverDelayMs?: number;
     /** Translation strings */
     translations: {
-        gatherTitle: string;
-        configureGenerationTitle: string;
-        configureSearchTitle: string;
-        searchResultsTitle: string;
+        /** The ONE title, all steps — the flow is resolving a reference; the
+            strategy band below says where in it you are. */
+        resolveTitle: string;
         sourceContextLabel: string;
         connectionsLabel: string;
         citedByLabel: string;
+        graphPaneTitle: string;
+        graphEmpty: string;
+        resourceLinkLabel: string;
+        corpusPaneTitle: string;
+        corpusEmpty: string;
+        excludedReceipt: string;
+        machineRead: string;
         userHintLabel: string;
+        userHintEffect: string;
         userHintPlaceholder: string;
         loadingContext: string;
         failedContext: string;
-        cancel: string;
         search: string;
         searching: string;
         generate: string;
@@ -2882,6 +3001,7 @@ interface ReferenceWizardModalProps {
         noResults: string;
         resourceTitle: string;
         resourceTitlePlaceholder: string;
+        saveLocation: string;
         additionalInstructions: string;
         additionalInstructionsPlaceholder: string;
         language: string;
@@ -2891,41 +3011,51 @@ interface ReferenceWizardModalProps {
         creativityCreative: string;
         maxLength: string;
         maxLengthHelp: string;
+        maxLengthCeiling: string;
         maxResults: string;
         semanticScoring: string;
         semanticScoringHelp: string;
+        searchFailed: string;
+        entityTypes: string;
+        contentLabel: string;
+        createAndLink: string;
+        creatingAndLinking: string;
+        discardDraftPrompt: string;
+        discardDraft: string;
+        keepEditing: string;
     };
 }
-declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeNavigate, translations: t, }: ReferenceWizardModalProps): React$1.JSX.Element;
-
-interface ResourceGatherConfig {
-    depth: number;
-    maxResources: number;
-    includeContent: boolean;
-    includeSummary: boolean;
-}
+declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, resourceName, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeSubmit, entityTypeOptions, hoverDelayMs, translations: t, generationAgent, }: ReferenceWizardModalProps): React$1.JSX.Element;
 
 interface ResourceGenerateModalTranslations {
-    gatherTitle: string;
-    reviewTitle: string;
-    configureTitle: string;
-    next: string;
-    back: string;
-    cancel: string;
+    /** The ONE modal title — names the flow, not a step. */
+    title: string;
     gatherIntro: string;
     includeContent: string;
     includeSummary: string;
     gatherDepth: string;
     gatherMaxResources: string;
     gatherButton: string;
-    excludeLabel: string;
+    /** Labels the recall chips: every type included until deselected. */
+    recallLabel: string;
+    /** Affordance on the post-gather receipt row (title/tooltip). */
+    editGather: string;
     loadingContext: string;
     failedContext: string;
     sourceContextLabel: string;
     connectionsLabel: string;
     citedByLabel: string;
+    graphPaneTitle: string;
+    graphEmpty: string;
+    resourceLinkLabel: string;
+    corpusPaneTitle: string;
+    corpusEmpty: string;
+    excludedReceipt: string;
+    machineRead: string;
+    score: string;
     resourceTitle: string;
     resourceTitlePlaceholder: string;
+    saveLocation: string;
     additionalInstructions: string;
     additionalInstructionsPlaceholder: string;
     language: string;
@@ -2935,15 +3065,24 @@ interface ResourceGenerateModalTranslations {
     creativityCreative: string;
     maxLength: string;
     maxLengthHelp: string;
+    maxLengthCeiling: string;
     generate: string;
+    discardDraftPrompt: string;
+    discardDraft: string;
+    keepEditing: string;
 }
 interface ResourceGenerateModalProps {
+    /**
+     * Roster entry serving `generation`, forwarded to ConfigureGenerationStep so
+     * the max-length control is bounded by the model's real output ceiling.
+     * Optional: absent means today's default bounds (INFERENCE-LIMITS-EXPOSURE D3).
+     */
+    generationAgent?: CollaboratorEntry;
     isOpen: boolean;
     onClose: () => void;
     resourceId: string;
     defaultTitle: string;
     locale: string;
-    gatherDefaults?: Partial<ResourceGatherConfig>;
     /**
      * Entity types offered in the exclusion picker. Owner-supplied so the
      * modal cannot present a failed load as an empty vocabulary.
@@ -2951,18 +3090,39 @@ interface ResourceGenerateModalProps {
     entityTypeOptions?: string[];
     /**
      * Emit the chosen generation config. The parent runs the job
-     * (`client.yield.fromResource(resourceId, …).run(…)`) — mirrors how the
-     * annotation wizard delegates `yield.fromAnnotation` to its parent.
+     * (`client.yield.fromContext(config.context, …)`) — mirrors how the
+     * annotation wizard delegates generation to its parent.
      */
     onGenerateSubmit: (resourceId: string, config: GenerationConfig) => void;
+    /**
+     * Resource-gather state, verbatim from the SDK's gather unit slots
+     * (`gather.resourceContext$` / `resourceLoading$` / `resourceError$`) — the
+     * page reads the observables and threads them here, the same shape the
+     * reference wizard has always had (FLOW-LIFECYCLE-CONVERGENCE D3/A6). The
+     * modal renders this state; it never owns it.
+     */
+    gatherContext: GatheredContext | null;
+    gatherLoading: boolean;
+    gatherError: Error | null;
+    /**
+     * Run the gather — the page wires `gather.gatherResource(resourceId, …)`.
+     * No resourceId in the payload: the owner already holds it. `gatherResource`
+     * clears its slots at start, so no reset threading is needed.
+     */
+    onGather: (options: ResourceGatherOptions) => void;
     translations: ResourceGenerateModalTranslations;
 }
 /**
- * Resource-generate flow (GENERATE-FROM-BUTTON): configure gather options →
- * `gather.resource` → review the gathered `GatheredContext` → configure
- * generation → emit. Reuses the kind-aware `GatherContextStep` for the review.
+ * Resource-generate flow (GENERATE-FROM-BUTTON, folded by GATHER-AT-THE-TOP):
+ * one composite stack in a single scroll pane — the gather controls at the
+ * top, the gathered `GatheredContext` below them once gather fires, and the
+ * generation params beneath the evidence once context arrives. Re-gathering
+ * is scroll-up → tweak → Gather; `gatherResource` clears its slots at start,
+ * so the evidence refreshes in place. [gather zone] → [evidence] → [act
+ * zone]: the same grammar the resolve wizard expresses, whose gather zone
+ * happens to be automatic and whose act zone has a strategy choice.
  */
-declare function ResourceGenerateModal({ isOpen, onClose, resourceId, defaultTitle, locale, gatherDefaults, entityTypeOptions, onGenerateSubmit, translations: t, }: ResourceGenerateModalProps): React$1.JSX.Element;
+declare function ResourceGenerateModal({ isOpen, onClose, resourceId, defaultTitle, locale, entityTypeOptions, onGenerateSubmit, gatherContext, gatherLoading, gatherError, onGather, translations: t, generationAgent, }: ResourceGenerateModalProps): React$1.JSX.Element;
 
 interface SearchModalProps$1 {
     isOpen: boolean;
@@ -2982,21 +3142,6 @@ interface SearchModalProps$1 {
 }
 declare function SearchModal({ isOpen, onClose, onNavigate, translations }: SearchModalProps$1): React__default.JSX.Element;
 
-interface ResourceSearchModalProps$1 {
-    isOpen: boolean;
-    onClose: () => void;
-    onSelect: (resourceId: string) => void;
-    searchTerm?: string;
-    translations?: {
-        title?: string;
-        placeholder?: string;
-        searching?: string;
-        noResults?: string;
-        close?: string;
-    };
-}
-declare function ResourceSearchModal({ isOpen, onClose, onSelect, searchTerm, translations }: ResourceSearchModalProps$1): React$1.JSX.Element;
-
 /**
  * Base modal props that all modals share
  */
@@ -3030,22 +3175,6 @@ interface SearchModalProps extends BaseModalProps, NavigableModalProps {
         close?: string;
     };
 }
-/**
- * Resource search modal props
- */
-interface ResourceSearchModalProps extends BaseModalProps {
-    /** Callback when a resource is selected */
-    onSelect: (resourceId: string) => void;
-    /** Initial search term */
-    searchTerm?: string;
-    /** Optional translation support */
-    translations?: {
-        title?: string;
-        placeholder?: string;
-        searching?: string;
-        noResults?: string;
-    };
-}
 
 /**
  * Skip links for keyboard navigation accessibility
@@ -3496,7 +3625,7 @@ interface ShellStateUnit extends StateUnit {
     activePanel$: Observable<ToolbarPanelType | null>;
     scrollToAnnotationId$: Observable<string | null>;
     panelInitialTab$: Observable<{
-        tab: string;
+        tab: AnnotatorKey;
         generation: number;
     } | null>;
     openPanel(panel: string): void;
@@ -4116,26 +4245,15 @@ interface ListState<T> {
     retry(): void;
 }
 
-type ComposeMode = 'new' | 'clone' | 'reference';
+type ComposeMode = 'new' | 'clone';
 interface ComposeParams {
     mode?: string | undefined;
     token?: string | undefined;
-    annotationUri?: string | undefined;
-    sourceDocumentId?: string | undefined;
-    name?: string | undefined;
-    entityTypes?: string | undefined;
-    storedContext?: string | undefined;
 }
 interface CloneData {
     sourceResource: ResourceDescriptor;
     sourceContent: string;
 }
-interface ReferenceData {
-    annotationUri: string;
-    sourceDocumentId: string;
-    name: string;
-    entityTypes: string[];
-}
 interface SaveResourceParams$1 {
     mode: ComposeMode;
     name: string;
@@ -4147,16 +4265,12 @@ interface SaveResourceParams$1 {
     entityTypes?: string[];
     language: string;
     archiveOriginal?: boolean;
-    annotationUri?: string;
-    sourceDocumentId?: string;
 }
 interface ComposePageStateUnit extends StateUnit {
     browse: ShellStateUnit;
     mode$: Observable<ComposeMode>;
     loading$: Observable<boolean>;
     cloneData$: Observable<CloneData | null>;
-    referenceData$: Observable<ReferenceData | null>;
-    gatheredContext$: Observable<GatheredContext | null>;
     entityTypes: ListState<string[]>;
     /**
      * Live upload-progress for the in-flight `save(...)` call. Emits the
@@ -4173,15 +4287,14 @@ declare function createComposePageStateUnit(session: SemiontSession, browse: She
  * ResourceComposePage Component
  *
  * Pure React component for creating and editing resources.
- * Supports three modes: new resource, clone, and reference completion.
+ * Supports two modes: new resource and clone. (Reference completion moved
+ * into the resolve wizard — COMPOSE-IN-MODAL.)
  * All dependencies passed as props - no Next.js hooks!
  */
 
 interface ResourceComposePageProps {
-    mode: 'new' | 'clone' | 'reference';
+    mode: 'new' | 'clone';
     cloneData?: CloneData | null;
-    referenceData?: ReferenceData | null;
-    gatheredContext?: GatheredContext | null;
     availableEntityTypes: string[];
     initialLocale: string;
     theme: 'light' | 'dark';
@@ -4199,10 +4312,7 @@ interface ResourceComposePageProps {
     translations: {
         title: string;
         titleEditClone: string;
-        titleCompleteReference: string;
         subtitleClone: string;
-        subtitleReference: string;
-        linkedNoticePrefix: string;
         resourceName: string;
         resourceNamePlaceholder: string;
         entityTypes: string;
@@ -4224,16 +4334,14 @@ interface ResourceComposePageProps {
         cancel: string;
         saving: string;
         creating: string;
-        creatingAndLinking: string;
         saveClonedResource: string;
-        createAndLinkResource: string;
         createResource: string;
     };
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
 interface SaveResourceParams {
-    mode: 'new' | 'clone' | 'reference';
+    mode: 'new' | 'clone';
     name: string;
     storageUri: string;
     content?: string;
@@ -4243,10 +4351,8 @@ interface SaveResourceParams {
     entityTypes?: string[];
     language: string;
     archiveOriginal?: boolean;
-    annotationUri?: string;
-    sourceDocumentId?: string;
 }
-declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, hoverDelayMs, activePanel, onSaveResource, onCancel, uploadProgress, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): React__default.JSX.Element;
+declare function ResourceComposePage({ mode, cloneData, availableEntityTypes, initialLocale, theme, hoverDelayMs, activePanel, onSaveResource, onCancel, uploadProgress, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): React__default.JSX.Element;
 
 /**
  * Inline upload-progress affordance for the compose page.
@@ -4290,6 +4396,16 @@ interface ResourceDiscoveryPageProps {
     recentError?: Error | null;
     onRetryRecent?: () => void;
     isSearching: boolean;
+    /**
+     * How the current search answer was produced — `'lexical'` (title/metadata
+     * matching) or `'semantic'` (the vector fallback that runs only when lexical
+     * matching returned nothing). Undefined before the first answer, and on the
+     * no-query view where `recent` renders and no label describes it.
+     *
+     * Optional so hosts that never wire it — including external consumers —
+     * render exactly as before (SEMANTIC-FALLBACK P3b).
+     */
+    searchMatchKind?: 'lexical' | 'semantic';
     searchQuery: string;
     onSearchQueryChange: (query: string) => void;
     selectedEntityType: string;
@@ -4304,6 +4420,7 @@ interface ResourceDiscoveryPageProps {
         searchPlaceholder: string;
         searchButton: string;
         searching: string;
+        semanticFallbackNotice: string;
         filterByEntityType: string;
         all: string;
         recentResources: string;
@@ -4320,7 +4437,7 @@ interface ResourceDiscoveryPageProps {
     };
     ToolbarPanels: React__default.ComponentType<any>;
 }
-declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, recentError, onRetryRecent, isSearching, searchQuery, onSearchQueryChange, selectedEntityType, onSelectedEntityTypeChange, theme, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): React__default.JSX.Element;
+declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, recentError, onRetryRecent, isSearching, searchMatchKind, searchQuery, onSearchQueryChange, selectedEntityType, onSelectedEntityTypeChange, theme, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): React__default.JSX.Element;
 
 /**
  * ResourceCard Component
@@ -4406,7 +4523,8 @@ interface ResourceViewerPageProps {
  * @subscribes yield:clone - Clone the current resource
  * @subscribes beckon:sparkle - Trigger sparkle animation
  * @subscribes mark:added - Annotation was created (sparkle)
- * @subscribes browse:reference-navigate - Navigate to a referenced document
+ * @subscribes mark:body-updated - Reference resolved via a linking-add operation (sparkle, both loci)
+ * @subscribes browse:resource-open - Open a resource in the viewer (local links + the launcher's tour verbs)
  * @subscribes browse:entity-type-clicked - Navigate filtered by entity type
  *
  * Outcome-notification channels (mark:create-error, mark:delete-error,
@@ -4517,9 +4635,17 @@ declare function createWelcomeStateUnit(session: SemiontSession): WelcomeStateUn
 
 interface DiscoverSearchPipeline {
     query$: Observable<string>;
+    /**
+     * The page AND the label that describes it, as one value. `matchKind` is
+     * carried here rather than beside it because SEMANTIC-FALLBACK S10 is
+     * tier-agnostic: two separately-observable pieces of state let a render pair
+     * this query's label with the previous query's list. Undefined only before
+     * the first answer (and while a query is empty), never as a third kind.
+     */
     state$: Observable<{
         results: ResourceDescriptor[];
         isSearching: boolean;
+        matchKind?: 'lexical' | 'semantic';
     }>;
     setQuery(value: string): void;
 }
@@ -4583,5 +4709,5 @@ declare function useShellStateUnit(): ShellStateUnit;
  */
 declare function useObservable<T>(obs$: Observable<T> | null | undefined): T | undefined;
 
-export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, AdminExchangePage, AdminSecurityPage, AdminUsersPage, AnnotateToolbar, AnnotateView, AnnotationHistory, AnnotationOverlay, AnnotationProvider, AssessmentEntry, AssessmentPanel, AssistProgress, AssistSection, AssistShell, AsyncErrorBoundary, AuthErrorDisplay, BrowseView, Button, ButtonGroup, COMMON_PANELS, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, CommentEntry, CommentsPanel, ComposeLoadingState, DownloadFileLink, EntityTagsPage, EntityTypeBadges, ErrorBoundary, ExportCard, Footer, HighlightEntry, HighlightPanel, HistoryEvent, ImageAnnotateRenderer, ImageBrowseRenderer, ImageURLSchema, ImageViewer, ImportCard, ImportProgress, JsonLdPanel, JsonLdView, KeyboardShortcutsHelpModal, LeftSidebar, LineNumbersProvider, LinkedDataPage, LiveRegionProvider, NavigationMenu, OAuthUserSchema, ObservableLink, PageLayout, PanelHeader, PdfAnnotateRenderer, PdfBrowseRenderer, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RESOURCE_PANELS, RecentDocumentsPage, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, ReferencesPanel, ResizeHandle, ResourceAnnotationsProvider, ResourceCard, ResourceComposePage, ResourceDiscoveryPage, ResourceErrorState, ResourceGenerateModal, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, ResourceTagsInline, ResourceViewer, ResourceViewerPage, SearchModal, SelectedTextDisplay, SemiontBranding, SemiontFavicon, SemiontProvider, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, SignInForm, SignUpForm, SimpleNavigation, SkipLinks, SortableResourceTab, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, TaggingPanel, TextAnnotateRenderer, TextBrowseRenderer, ThemeProvider, ToastContainer, ToastProvider, Toolbar, TranslationProvider, UnifiedAnnotationsPanel, UnifiedHeader, UploadProgressBar, UserMenuSkeleton, WebBrowserStorage, WelcomePage, annotatorKeyForMotivation, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createAdminSecurityStateUnit, createAdminUsersStateUnit, createComposePageStateUnit, createDiscoverStateUnit, createEntityTagsStateUnit, createExchangeStateUnit, createResourceLoaderStateUnit, createResourceViewerPageStateUnit, createSessionStateUnit, createShellStateUnit, createWelcomeStateUnit, cssVariables, defaultAnnotateRenderers, defaultBrowseRenderers, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, mediaUrl, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, setPdfWorkerSrc, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKBDiscovery, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMediaToken, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePendingCreation, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceGather, useResourceLoader, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionEventSubscriptions, useSessionExpiry, useSessionStateUnit, useShellStateUnit, useStateUnit, useTheme, useToast, useToolbarPrefs, useTranslations };
-export type { AdminDevOpsPageProps, AdminExchangePageProps, AdminExchangePageTranslations, AdminSecurityPageProps, AdminSecurityStateUnit, AdminUser, AdminUserStats, AdminUsersPageProps, AdminUsersStateUnit, AnnotateMediaRendererProps, AnnotateMediaRenderers, AnnotationConfig, AnnotationCreationHandler, AnnotationGroups, AnnotationHandlers, AnnotationManager, AnnotationProviderProps, AnnotationUIState, AnnotationsCollection, Annotator, AnnotatorKey, AssistProgressProps, AssistProgressTranslations, AssistShellProps, AuthErrorDisplayProps, AvailableLocale, BorderRadiusToken, BrowseMediaRenderers, ButtonGroupProps, ButtonProps, ClickAction, CloneData, CollapsibleResourceNavigationProps, ColorToken, ComposeLoadingStateProps, ComposeMode, ComposePageStateUnit, ComposeParams, CreateAnnotationParams, CreateConfig, DeleteAnnotationParams, DetectionConfig, DevOpsFeature, DiscoverStateUnit, DrawingMode, EntityTagsPageProps, EntityTagsStateUnit, ExchangeStateUnit, ExportCardProps, ExportCardTranslations, HoverEmitterProps, ImportCardProps, ImportCardTranslations, ImportPreview, ImportProgressProps, ImportProgressTranslations, KBDiscoveryOptions, KBDiscoveryResult, KeyboardShortcut, LinkComponentProps, LinkedDataPageProps, LinkedDataPageTranslations, MediaRendererProps, Motivation$7 as Motivation, NavigationItem, NavigationMenuHelper, NavigationProps, OAuthProvider, OAuthUser, ObservableLinkProps, OverlayAnnotation, PendingCreation, RecentDocumentsPageProps, ReferenceData, ReferenceHover, ReferenceWizardModalProps, ResolvedTheme, ResourceCardProps, ResourceComposePageProps, ResourceDiscoveryPageProps, ResourceErrorStateProps, ResourceGatherOptions, ResourceGenerateModalProps, ResourceGenerateModalTranslations, ResourceLoaderStateUnit, ResourceSearchModalProps, ResourceViewerPageProps, ResourceViewerPageStateUnit, RouteBuilder, SaveResourceParams$1 as SaveResourceParams, SearchModalProps, SelectionMotivation, SelectorType, SemiontProviderProps, SemiontResource$1 as SemiontResource, SessionStateUnit, ShadowToken, ShapeType, ShellStateUnit, ShellStateUnitOptions, SignInFormProps, SignUpFormProps, SimpleNavigationItem, SimpleNavigationProps, SortableResourceTabProps, SpacingToken, TagSchemasPageProps, TextSegment, TextSelection, Theme, ToastMessage, ToastType, ToolbarPanelType, ToolbarPart, ToolbarPrefs, TransitionToken, TranslationManager, TranslationProviderProps, TypographyToken, UICreateAnnotationParams, UploadProgressBarProps, UseMediaTokenResult, UseResourceContentResult, UseResourceGatherResult, UseResourceLoaderResult, WelcomePageProps, WelcomeStateUnit, WizardState };
+export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, AdminExchangePage, AdminSecurityPage, AdminUsersPage, AnnotateToolbar, AnnotateView, AnnotationHistory, AnnotationOverlay, AnnotationProvider, AssessmentEntry, AssessmentPanel, AssistProgress, AssistSection, AssistShell, AsyncErrorBoundary, AuthErrorDisplay, BrowseView, Button, ButtonGroup, COMMON_PANELS, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, CommentEntry, CommentsPanel, ComposeLoadingState, DownloadFileLink, EntityTagsPage, EntityTypeBadges, ErrorBoundary, ExportCard, Footer, HighlightEntry, HighlightPanel, HistoryEvent, ImageAnnotateRenderer, ImageBrowseRenderer, ImageURLSchema, ImageViewer, ImportCard, ImportProgress, JsonLdPanel, JsonLdView, KeyboardShortcutsHelpModal, LeftSidebar, LineNumbersProvider, LinkedDataPage, LiveRegionProvider, NavigationMenu, OAuthUserSchema, ObservableLink, PageLayout, PanelHeader, PdfAnnotateRenderer, PdfBrowseRenderer, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RESOURCE_PANELS, RecentDocumentsPage, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, ReferencesPanel, ResizeHandle, ResourceAnnotationsProvider, ResourceCard, ResourceComposePage, ResourceDiscoveryPage, ResourceErrorState, ResourceGenerateModal, ResourceInfoPanel, ResourceLoadingState, ResourceTagsInline, ResourceViewer, ResourceViewerPage, SearchModal, SelectedTextDisplay, SemiontBranding, SemiontFavicon, SemiontProvider, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, SignInForm, SignUpForm, SimpleNavigation, SkipLinks, SortableResourceTab, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, TaggingPanel, TextAnnotateRenderer, TextBrowseRenderer, ThemeProvider, ToastContainer, ToastProvider, Toolbar, TranslationProvider, UnifiedAnnotationsPanel, UnifiedHeader, UploadProgressBar, UserMenuSkeleton, WebBrowserStorage, WelcomePage, annotatorKeyForMotivation, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createAdminSecurityStateUnit, createAdminUsersStateUnit, createComposePageStateUnit, createDiscoverStateUnit, createEntityTagsStateUnit, createExchangeStateUnit, createResourceLoaderStateUnit, createResourceViewerPageStateUnit, createSessionStateUnit, createShellStateUnit, createWelcomeStateUnit, cssVariables, defaultAnnotateRenderers, defaultBrowseRenderers, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, mediaUrl, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, setPdfWorkerSrc, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useCollaborators, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKBDiscovery, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMediaToken, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePendingCreation, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceLoader, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionEventSubscriptions, useSessionExpiry, useSessionStateUnit, useShellStateUnit, useStateUnit, useTheme, useToast, useToolbarPrefs, useTranslations };
+export type { AdminDevOpsPageProps, AdminExchangePageProps, AdminExchangePageTranslations, AdminSecurityPageProps, AdminSecurityStateUnit, AdminUser, AdminUserStats, AdminUsersPageProps, AdminUsersStateUnit, AnnotateMediaRendererProps, AnnotateMediaRenderers, AnnotationConfig, AnnotationCreationHandler, AnnotationGroups, AnnotationHandlers, AnnotationManager, AnnotationProviderProps, AnnotationUIState, AnnotationsCollection, Annotator, AnnotatorKey, AssistDataType, AssistProgressProps, AssistProgressTranslations, AssistShellProps, AuthErrorDisplayProps, AvailableLocale, BorderRadiusToken, BrowseMediaRenderers, ButtonGroupProps, ButtonProps, ClickAction, CloneData, CollapsibleResourceNavigationProps, ColorToken, ComposeLoadingStateProps, ComposeMode, ComposePageStateUnit, ComposeParams, CreateAnnotationParams, CreateConfig, DeleteAnnotationParams, DetectionConfig, DevOpsFeature, DiscoverStateUnit, DrawingMode, EntityTagsPageProps, EntityTagsStateUnit, ExchangeStateUnit, ExportCardProps, ExportCardTranslations, HoverEmitterProps, ImportCardProps, ImportCardTranslations, ImportPreview, ImportProgressProps, ImportProgressTranslations, KBDiscoveryOptions, KBDiscoveryResult, KeyboardShortcut, LinkComponentProps, LinkedDataPageProps, LinkedDataPageTranslations, MediaRendererProps, Motivation$7 as Motivation, NavigationItem, NavigationMenuHelper, NavigationProps, OAuthProvider, OAuthUser, ObservableLinkProps, OverlayAnnotation, PendingCreation, RecentDocumentsPageProps, ReferenceHover, ReferenceWizardModalProps, ResolvedTheme, ResourceCardProps, ResourceComposePageProps, ResourceDiscoveryPageProps, ResourceErrorStateProps, ResourceGenerateModalProps, ResourceGenerateModalTranslations, ResourceLoaderStateUnit, ResourceViewerPageProps, ResourceViewerPageStateUnit, RouteBuilder, SaveResourceParams$1 as SaveResourceParams, SearchModalProps, SelectionMotivation, SelectorType, SemiontProviderProps, SemiontResource$1 as SemiontResource, SessionStateUnit, ShadowToken, ShapeType, ShellStateUnit, ShellStateUnitOptions, SignInFormProps, SignUpFormProps, SimpleNavigationItem, SimpleNavigationProps, SortableResourceTabProps, SpacingToken, TagSchemasPageProps, TextSegment, TextSelection, Theme, ToastMessage, ToastType, ToolbarPanelType, ToolbarPart, ToolbarPrefs, TransitionToken, TranslationManager, TranslationProviderProps, TypographyToken, UICreateAnnotationParams, UploadProgressBarProps, UseCollaboratorsResult, UseMediaTokenResult, UseResourceContentResult, UseResourceLoaderResult, WelcomePageProps, WelcomeStateUnit, WizardState };