@semiont/react-ui 0.4.20 → 0.4.22

package/dist/index.d.mts

@@ -1,31 +1,28 @@
-import * as _semiont_core from '@semiont/core';
-import { components, ResourceId, Selector, AnnotationId, PersistedEvent, EventBus, EventMap, MarkProgress, StoredEventLike, paths, GatheredContext, Motivation as Motivation$9, YieldProgress } from '@semiont/core';
+import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, EventMap, AnnotationId, StoredEventLike, ConnectionState, GatheredContext } from '@semiont/core';
+export { Annotation } from '@semiont/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { ComponentType, ReactNode, KeyboardEvent as KeyboardEvent$1, Component, ErrorInfo, Ref } from 'react';
-import { O as OpenResourcesManager, K as KbSessionStatus, a as KnowledgeBase, T as TranslationManager, b as OpenResource } from './KnowledgeBaseSessionContext-BNNunwzO.mjs';
-export { A as AuthSession, c as KnowledgeBaseSessionContext, d as KnowledgeBaseSessionProvider, e as KnowledgeBaseSessionValue, N as NewKnowledgeBase, u as useKnowledgeBaseSession } from './KnowledgeBaseSessionContext-BNNunwzO.mjs';
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryOptions } from '@tanstack/react-query';
-import { SemiontApiClient, ValidationResult, TokenRefresher } from '@semiont/api-client';
+import { T as TranslationManager } from './TranslationManager-9Xj3MIWQ.mjs';
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import { Observable } from 'rxjs';
+import { ViewModel, SemiontBrowser, SessionStorage, SemiontSession, OpenResource, ImportPreview, CloneData, ReferenceData, ShellVM } from '@semiont/sdk';
+export { ActiveJob, AdminSecurityVM, AdminUsersVM, AnnotationGroups, BeckonVM, COMMON_PANELS, CloneData, ComposeMode, ComposePageVM, ComposeParams, DiscoverVM, EntityTagsVM, ExchangeVM, GatherVM, GenerateDocumentOptions, HOVER_DELAY_MS, HoverHandlers, ImportPreview, Job, JobAssignment, JobClaimAdapter, JobClaimAdapterOptions, JobQueueVM, MarkVM, MatchVM, PendingAnnotation, RESOURCE_PANELS, ReferenceData, ResourceLoaderVM, ResourceViewerPageVM, SaveResourceParams, SearchPipeline, SearchPipelineOptions, SearchState, SessionVM, ShellVM, ShellVMOptions, ToolbarPanelType, WelcomeVM, WizardState, YieldVM, createAdminSecurityVM, createAdminUsersVM, createBeckonVM, createComposePageVM, createDiscoverVM, createEntityTagsVM, createExchangeVM, createGatherVM, createHoverHandlers, createJobClaimAdapter, createJobQueueVM, createMarkVM, createMatchVM, createResourceLoaderVM, createResourceViewerPageVM, createSearchPipeline, createSessionVM, createShellVM, createWelcomeVM, createYieldVM } from '@semiont/sdk';
 import { TagSchema } from '@semiont/ontology';
 export { TAG_SCHEMAS, TagCategory, TagSchema, getAllTagSchemas, getSchemaCategory as getTagCategory, getTagSchema, getTagSchemasByDomain, isValidCategory } from '@semiont/ontology';
+import { Observable } from 'rxjs';
 
-type Annotation$m = components['schemas']['Annotation'];
 /**
  * Collection of all annotation types for a resource.
  * Replaces separate highlights, references, assessments, comments, tags props.
  */
 interface AnnotationsCollection {
-    highlights: Annotation$m[];
-    references: Annotation$m[];
-    assessments: Annotation$m[];
-    comments: Annotation$m[];
-    tags: Annotation$m[];
+    highlights: Annotation[];
+    references: Annotation[];
+    assessments: Annotation[];
+    comments: Annotation[];
+    tags: Annotation[];
 }
 /**
  * Event handlers for annotation interactions.
@@ -33,7 +30,7 @@ interface AnnotationsCollection {
  */
 interface AnnotationHandlers {
     /** Unified click handler - routes based on annotation type and current mode */
-    onClick?: (annotation: Annotation$m, event?: React.MouseEvent) => void;
+    onClick?: (annotation: Annotation, event?: React.MouseEvent) => void;
     /** Unified hover handler for all annotation types */
     onHover?: (annotationId: string | null) => void;
     /** Hover handler specifically for comment panel highlighting */
@@ -82,7 +79,7 @@ interface UICreateAnnotationParams {
  * - linking: Shows Quick Reference popup FIRST, creates when user confirms
  */
 interface AnnotationCreationHandler {
-    onCreate?: (params: UICreateAnnotationParams) => void | Promise<void> | Promise<Annotation$m | undefined>;
+    onCreate?: (params: UICreateAnnotationParams) => void | Promise<void> | Promise<Annotation | undefined>;
 }
 /**
  * UI state for annotation toolbar and interactions.
@@ -115,7 +112,6 @@ interface AnnotationConfig {
     annotateMode?: boolean;
 }
 
-type Annotation$l = components['schemas']['Annotation'];
 /**
  * Parameters for creating an annotation
  */
@@ -138,19 +134,16 @@ interface DeleteAnnotationParams {
  * Framework-agnostic interface for annotation mutations.
  * Apps provide implementations via AnnotationProvider.
  *
- * Example implementation (React Query):
+ * Example implementation:
  * ```typescript
- * function useAnnotationManager(): AnnotationManager {
- *   const createMutation = useAnnotations().create.useMutation();
- *   const deleteMutation = useAnnotations().delete.useMutation();
- *
+ * function useAnnotationManager(client: SemiontClient): AnnotationManager {
  *   return {
  *     markAnnotation: async (params) => {
- *       const result = await createMutation.mutateAsync({...});
+ *       const result = await client.mark.annotation(params.rUri, {...});
  *       return result.annotation;
  *     },
  *     deleteAnnotation: async (params) => {
- *       await deleteMutation.mutateAsync({...});
+ *       await client.mark.delete(params.rUri, params.annotationId);
  *     }
  *   };
  * }
@@ -162,7 +155,7 @@ interface AnnotationManager {
      * @param params - Creation parameters (rUri, motivation, selector, body)
      * @returns Promise resolving to the created annotation, or undefined if creation fails
      */
-    markAnnotation: (params: CreateAnnotationParams) => Promise<Annotation$l | undefined>;
+    markAnnotation: (params: CreateAnnotationParams) => Promise<Annotation | undefined>;
     /**
      * Delete an annotation
      * @param params - Deletion parameters (annotationId, rUri)
@@ -171,62 +164,6 @@ interface AnnotationManager {
     deleteAnnotation: (params: DeleteAnnotationParams) => Promise<void>;
 }
 
-/**
- * Cache Manager Interface
- *
- * Framework-agnostic interface for cache invalidation.
- * Apps provide implementations via CacheProvider.
- *
- * This abstraction allows react-ui to trigger cache invalidation
- * without depending on a specific data fetching library (React Query, SWR, Apollo, etc.)
- *
- * Example implementation (React Query):
- * ```typescript
- * function useCacheManager(): CacheManager {
- *   const queryClient = useQueryClient();
- *
- *   return {
- *     invalidateAnnotations: (rUri) => {
- *       queryClient.invalidateQueries({ queryKey: ['annotations', rUri] });
- *     },
- *     invalidateEvents: (rUri) => {
- *       queryClient.invalidateQueries({ queryKey: ['documents', 'events', rUri] });
- *     }
- *   };
- * }
- * ```
- *
- * Example implementation (SWR):
- * ```typescript
- * function useCacheManager(): CacheManager {
- *   const { mutate } = useSWRConfig();
- *
- *   return {
- *     invalidateAnnotations: (rUri) => {
- *       mutate((key) => Array.isArray(key) && key[0] === 'annotations' && key[1] === rUri);
- *     },
- *     invalidateEvents: (rUri) => {
- *       mutate((key) => Array.isArray(key) && key[0] === 'events' && key[1] === rUri);
- *     }
- *   };
- * }
- * ```
- */
-interface CacheManager {
-    /**
-     * Invalidate annotation cache for a resource
-     * @param rUri - Resource URI
-     * @returns Promise or void (synchronous invalidation is acceptable)
-     */
-    invalidateAnnotations: (rUri: ResourceId) => void | Promise<void>;
-    /**
-     * Invalidate events cache for a resource
-     * @param rUri - Resource URI
-     * @returns Promise or void (synchronous invalidation is acceptable)
-     */
-    invalidateEvents: (rUri: ResourceId) => void | Promise<void>;
-}
-
 /**
  * Represents a single navigation item
  */
@@ -265,8 +202,7 @@ interface NavigationProps {
  * Type definitions for resource viewer feature
  */
 
-type SemiontResource$4 = components['schemas']['ResourceDescriptor'];
-type Annotation$k = components['schemas']['Annotation'];
+type SemiontResource$2 = ResourceDescriptor;
 type Motivation$8 = components['schemas']['Motivation'];
 /**
  * Selection for creating annotations
@@ -294,7 +230,6 @@ interface TextSelection {
  * No aliasing, wrappers, or compatibility layers elsewhere.
  */
 
-type Annotation$j = components['schemas']['Annotation'];
 type Motivation$7 = components['schemas']['Motivation'];
 /**
  * Detection configuration for SSE-based annotation detection
@@ -331,7 +266,7 @@ interface Annotator {
     isClickable: boolean;
     hasHoverInteraction: boolean;
     hasSidePanel: boolean;
-    matchesAnnotation: (annotation: Annotation$j) => boolean;
+    matchesAnnotation: (annotation: Annotation) => boolean;
     announceOnCreate: string;
     detection?: DetectionConfig;
     create: CreateConfig;
@@ -341,369 +276,6 @@ interface Annotator {
  */
 declare const ANNOTATORS: Record<string, Annotator>;
 
-/**
- * Resource operations
- */
-declare function useResources(): {
-    list: {
-        useQuery: (options?: {
-            limit?: number;
-            archived?: boolean;
-            query?: string;
-        }) => _tanstack_react_query.UseQueryResult<{
-            resources: _semiont_core.components["schemas"]["ResourceDescriptor"][];
-            total: number;
-            offset: number;
-            limit: number;
-        }, Error>;
-    };
-    get: {
-        useQuery: (id: ResourceId, options?: Omit<UseQueryOptions, "queryKey" | "queryFn">) => _tanstack_react_query.UseQueryResult<unknown, Error>;
-    };
-    events: {
-        useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
-            events: _semiont_core.components["schemas"]["StoredEventResponse"][];
-            total: number;
-            resourceId: string;
-        }, Error>;
-    };
-    annotations: {
-        useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
-            resource: _semiont_core.components["schemas"]["ResourceDescriptor"];
-            annotations: _semiont_core.components["schemas"]["Annotation"][];
-        }, Error>;
-    };
-    referencedBy: {
-        useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
-            referencedBy: {
-                id: string;
-                resourceName: string;
-                target: {
-                    source: string;
-                    selector: {
-                        exact: string;
-                    };
-                };
-            }[];
-        }, Error>;
-    };
-    representation: {
-        useQuery: (id: ResourceId, mediaType: string) => _tanstack_react_query.UseQueryResult<string, Error>;
-    };
-    mediaToken: {
-        useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
-            token: string;
-        }, Error>;
-    };
-    create: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            resourceId: string;
-        }, Error, {
-            name: string;
-            file: File | Buffer;
-            format: string;
-            entityTypes?: string[];
-            language?: string;
-            creationMethod?: string;
-            sourceAnnotationId?: string;
-            sourceResourceId?: string;
-            storageUri: string;
-        }, unknown>;
-    };
-    update: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<void, Error, {
-            id: ResourceId;
-            data: Parameters<SemiontApiClient["updateResource"]>[1];
-        }, unknown>;
-    };
-    generateCloneToken: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            token: string;
-            expiresAt: string;
-            resource: _semiont_core.components["schemas"]["ResourceDescriptor"];
-        }, Error, ResourceId, unknown>;
-    };
-    getByToken: {
-        useQuery: (cloneTokenStr: string) => _tanstack_react_query.UseQueryResult<{
-            sourceResource: _semiont_core.components["schemas"]["ResourceDescriptor"];
-            expiresAt: string;
-        }, Error>;
-    };
-    createFromToken: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            resourceId: string;
-        }, Error, {
-            token: string;
-            name: string;
-            content: string;
-            archiveOriginal?: boolean;
-        }, unknown>;
-    };
-};
-/**
- * Annotation operations
- */
-declare function useAnnotations(): {
-    get: {
-        useQuery: (id: AnnotationId) => _tanstack_react_query.UseQueryResult<never, Error>;
-    };
-    browseAnnotation: {
-        useQuery: (resourceId: ResourceId, annotationId: AnnotationId) => _tanstack_react_query.UseQueryResult<{
-            annotation: _semiont_core.components["schemas"]["Annotation"];
-            resource: _semiont_core.components["schemas"]["ResourceDescriptor"] | null;
-            resolvedResource: _semiont_core.components["schemas"]["ResourceDescriptor"] | null;
-        }, Error>;
-    };
-    history: {
-        useQuery: (resourceId: ResourceId, annotationId: AnnotationId) => _tanstack_react_query.UseQueryResult<{
-            events: _semiont_core.components["schemas"]["StoredEventResponse"][];
-            total: number;
-            annotationId: string;
-            resourceId: string;
-        }, Error>;
-    };
-    create: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            annotationId: string;
-        }, Error, {
-            resourceId: ResourceId;
-            data: Parameters<SemiontApiClient["markAnnotation"]>[1];
-        }, unknown>;
-    };
-    delete: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<void, Error, {
-            resourceId: ResourceId;
-            annotationId: AnnotationId;
-        }, unknown>;
-    };
-    updateBody: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            correlationId: string;
-        }, Error, {
-            resourceId: ResourceId;
-            annotationId: AnnotationId;
-            data: Parameters<SemiontApiClient["bindAnnotation"]>[2];
-        }, unknown>;
-    };
-};
-/**
- * Entity type operations
- */
-declare function useEntityTypes(): {
-    list: {
-        useQuery: (options?: Omit<UseQueryOptions<{
-            entityTypes: string[];
-        }>, "queryKey" | "queryFn">) => _tanstack_react_query.UseQueryResult<{
-            entityTypes: string[];
-        }, Error>;
-    };
-    add: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
-    };
-    addBulk: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<void, Error, string[], unknown>;
-    };
-};
-/**
- * Admin operations
- */
-declare function useAdmin(): {
-    users: {
-        list: {
-            useQuery: () => _tanstack_react_query.UseQueryResult<{
-                success: boolean;
-                users: {
-                    id: string;
-                    email: string;
-                    name: string | null;
-                    image: string | null;
-                    domain: string;
-                    provider: string;
-                    isAdmin: boolean;
-                    isActive: boolean;
-                    lastLogin: string | null;
-                    created: string;
-                    updatedAt: string;
-                }[];
-            }, Error>;
-        };
-        stats: {
-            useQuery: () => _tanstack_react_query.UseQueryResult<{
-                success: boolean;
-                stats: {
-                    totalUsers: number;
-                    activeUsers: number;
-                    adminUsers: number;
-                    regularUsers: number;
-                    domainBreakdown: {
-                        domain: string;
-                        count: number;
-                    }[];
-                    recentSignups: {
-                        id: string;
-                        email: string;
-                        name: string | null;
-                        created: string;
-                    }[];
-                };
-            }, Error>;
-        };
-        update: {
-            useMutation: () => _tanstack_react_query.UseMutationResult<{
-                success: boolean;
-                user: {
-                    id: string;
-                    email: string;
-                    name: string | null;
-                    image: string | null;
-                    domain: string;
-                    provider: string;
-                    isAdmin: boolean;
-                    isActive: boolean;
-                    lastLogin: string | null;
-                    created: string;
-                    updatedAt: string;
-                };
-            }, Error, {
-                id: string;
-                data: Parameters<SemiontApiClient["updateUser"]>[1];
-            }, unknown>;
-        };
-    };
-    oauth: {
-        config: {
-            useQuery: () => _tanstack_react_query.UseQueryResult<{
-                providers: {
-                    name: string;
-                    isConfigured: boolean;
-                    clientId: string;
-                }[];
-                allowedDomains: string[];
-            }, Error>;
-        };
-    };
-    exchange: {
-        backup: {
-            useMutation: () => _tanstack_react_query.UseMutationResult<{
-                filename: string;
-                size: number;
-            }, Error, void, unknown>;
-        };
-        restore: {
-            useMutation: () => _tanstack_react_query.UseMutationResult<{
-                phase: string;
-                message?: string;
-                result?: Record<string, unknown>;
-            }, Error, {
-                file: File;
-                onProgress?: (event: {
-                    phase: string;
-                    message?: string;
-                    result?: Record<string, unknown>;
-                }) => void;
-            }, unknown>;
-        };
-    };
-};
-/**
- * Moderation operations (moderator or admin role required)
- */
-declare function useModeration(): {
-    exchange: {
-        export: {
-            useMutation: () => _tanstack_react_query.UseMutationResult<{
-                filename: string;
-                size: number;
-            }, Error, {
-                includeArchived?: boolean;
-            } | undefined, unknown>;
-        };
-        import: {
-            useMutation: () => _tanstack_react_query.UseMutationResult<{
-                phase: string;
-                message?: string;
-                result?: Record<string, unknown>;
-            }, Error, {
-                file: File;
-                onProgress?: (event: {
-                    phase: string;
-                    message?: string;
-                    result?: Record<string, unknown>;
-                }) => void;
-            }, unknown>;
-        };
-    };
-};
-/**
- * Authentication and user operations via API
- */
-declare function useAuthApi(): {
-    me: {
-        useQuery: () => _tanstack_react_query.UseQueryResult<{
-            id: string;
-            email: string;
-            name: string | null;
-            image: string | null;
-            domain: string;
-            provider: string;
-            isAdmin: boolean;
-            isModerator: boolean;
-            isActive: boolean;
-            termsAcceptedAt: string | null;
-            lastLogin: string | null;
-            created: string;
-            token: string;
-        }, Error>;
-    };
-    acceptTerms: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            success: boolean;
-            message: string;
-        }, Error, void, unknown>;
-    };
-    generateMCPToken: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            refresh_token: string;
-        }, Error, void, unknown>;
-    };
-    logout: {
-        useMutation: () => _tanstack_react_query.UseMutationResult<{
-            success: boolean;
-            message: string;
-        }, Error, void, unknown>;
-    };
-};
-/**
- * Health check and system status
- */
-declare function useHealth(): {
-    check: {
-        useQuery: () => _tanstack_react_query.UseQueryResult<{
-            status: string;
-            message: string;
-            version: string;
-            timestamp: string;
-            database: "connected" | "disconnected" | "unknown";
-            environment: string;
-        }, Error>;
-    };
-    status: {
-        useQuery: (refetchInterval?: number) => _tanstack_react_query.UseQueryResult<{
-            status: string;
-            version: string;
-            features: {
-                semanticContent: string;
-                collaboration: string;
-                rbac: string;
-            };
-            message: string;
-            authenticatedAs?: string;
-            projectName?: string;
-            gitBranch?: string;
-        }, Error>;
-    };
-};
-
 /**
  * Centralized button styles matching Figma design
  * Two primary styles from authenticated home page:
@@ -745,7 +317,6 @@ declare const jsonLightHighlightStyle: HighlightStyle;
  * clicks and hovers via a single set of delegated handlers.
  */
 
-type Annotation$i = components['schemas']['Annotation'];
 /**
  * Reference Resolution Widget
  * Shows a small indicator next to references with hover preview.
@@ -754,10 +325,10 @@ type Annotation$i = components['schemas']['Annotation'];
  * and CodeMirrorRenderer handles events via container-level listeners.
  */
 declare class ReferenceResolutionWidget extends WidgetType {
-    readonly annotation: Annotation$i;
+    readonly annotation: Annotation;
     readonly targetDocumentName?: string | undefined;
     readonly isGenerating?: boolean | undefined;
-    constructor(annotation: Annotation$i, targetDocumentName?: string | undefined, isGenerating?: boolean | undefined);
+    constructor(annotation: Annotation, targetDocumentName?: string | undefined, isGenerating?: boolean | undefined);
     eq(other: ReferenceResolutionWidget): boolean;
     toDOM(): HTMLSpanElement;
     ignoreEvent(event: Event): boolean;
@@ -848,90 +419,6 @@ declare function getSelectedShapeForSelectorType(selectorType: SelectorType): Sh
  */
 declare function saveSelectedShapeForSelectorType(selectorType: SelectorType, shape: ShapeType): void;
 
-/**
- * Centralized query keys for React Query
- * Following TanStack Query best practices for type-safe cache invalidation
- * @see https://tanstack.com/query/latest/docs/framework/react/guides/query-keys
- *
- * Keys use semantic names (not URL paths) and are properly typed with 'as const'
- */
-
-declare const QUERY_KEYS: {
-    users: {
-        me: () => readonly ["users", "me"];
-    };
-    health: () => readonly ["health"];
-    status: () => readonly ["status"];
-    resources: {
-        all: (limit?: number, archived?: boolean) => readonly ["resources", {
-            readonly limit: number | undefined;
-            readonly archived: boolean | undefined;
-        }];
-        detail: (id: ResourceId) => readonly ["resources", ResourceId];
-        byToken: (token: string) => readonly ["resources", "by-token", string];
-        events: (id: ResourceId) => readonly ["resources", ResourceId, "events"];
-        annotations: (id: ResourceId) => readonly ["resources", ResourceId, "annotations"];
-        referencedBy: (id: ResourceId) => readonly ["resources", ResourceId, "referenced-by"];
-        representation: (id: ResourceId) => readonly ["resources", ResourceId, "representation"];
-        mediaToken: (id: ResourceId) => readonly ["resources", ResourceId, "media-token"];
-    };
-    annotations: {
-        detail: (id: AnnotationId) => readonly ["annotations", AnnotationId];
-        history: (resourceId: ResourceId, annotationId: AnnotationId) => readonly ["annotations", ResourceId, AnnotationId, "history"];
-    };
-    entityTypes: {
-        all: () => readonly ["entity-types"];
-    };
-    admin: {
-        users: {
-            all: () => readonly ["admin", "users"];
-            stats: () => readonly ["admin", "users", "stats"];
-        };
-        oauth: {
-            config: () => readonly ["admin", "oauth", "config"];
-        };
-    };
-};
-
-/**
- * createSearchPipeline
- *
- * A debounced-search RxJS pipeline factory. Combines an input Subject with a
- * downstream fetch function and emits typed `{ results, isSearching }` state.
- *
- * Designed to be created once per component instance via React's
- * `useState(() => createSearchPipeline(...))` lazy initializer, then consumed
- * via `useObservable(pipeline.state$)`. The pipeline holds no React state and
- * has no React imports — it's pure RxJS, unit-testable without a renderer.
- *
- * The fetch function is expected to return `Observable<T[] | undefined>`,
- * matching the cache-miss-then-data shape of `BrowseNamespace` Observables:
- * `undefined` means "fetch in flight, no value yet"; an array means "data
- * available (possibly empty)".
- */
-
-interface SearchState<T> {
-    results: T[];
-    isSearching: boolean;
-}
-interface SearchPipeline<T> {
-    /** Latest query string. Bind to a controlled input via `useObservable`. */
-    query$: Observable<string>;
-    /** Latest search state — results plus a loading flag. */
-    state$: Observable<SearchState<T>>;
-    /** Push a new query value. Triggers the debounced fetch. */
-    setQuery(value: string): void;
-    /** Tear down the input Subject. Call from `useEffect` cleanup. */
-    dispose(): void;
-}
-interface SearchPipelineOptions {
-    /** Milliseconds to wait after the last keystroke before fetching. Default 250. */
-    debounceMs?: number;
-    /** Initial query value. Useful for modals that open with a pre-filled term. */
-    initialQuery?: string;
-}
-declare function createSearchPipeline<T>(fetch: (query: string) => Observable<T[] | undefined>, options?: SearchPipelineOptions): SearchPipeline<T>;
-
 /**
  * Annotation overlay: decouples annotation highlighting from markdown rendering.
  *
@@ -946,7 +433,6 @@ declare function createSearchPipeline<T>(fetch: (query: string) => Observable<T[
  * the overlay spans — no markdown re-parse, no AST walk.
  */
 
-type Annotation$h = components['schemas']['Annotation'];
 interface OverlayAnnotation {
     id: string;
     exact: string;
@@ -1001,7 +487,7 @@ declare function clearHighlights(container: HTMLElement): void;
  * Convert W3C Annotations to the simplified overlay format.
  * Extracts TextPositionSelector offsets and annotation type.
  */
-declare function toOverlayAnnotations(annotations: Annotation$h[]): OverlayAnnotation[];
+declare function toOverlayAnnotations(annotations: Annotation[]): OverlayAnnotation[];
 
 /**
  * Resource utilities
@@ -1072,6 +558,8 @@ declare const OAuthUserSchema: {
  */
 declare function sanitizeImageURL(url: string): string | null;
 
+declare function useViewModel<VM extends ViewModel>(factory: () => VM): VM;
+
 /**
  * Creates a debounced version of a callback function
  *
@@ -1163,7 +651,7 @@ interface Router {
  * Use this to wrap your router (Next.js, React Router, etc.) when you want
  * navigation actions to be observable through the NavigationEventBus.
  *
- * @emits browse:router-push - Router navigation requested. Payload: { path: string, reason?: string }
+ * @emits nav:push - Router navigation requested. Payload: { path: string, reason?: string }
  *
  * @example
  * ```typescript
@@ -1185,13 +673,13 @@ declare function useObservableRouter<T extends Router>(baseRouter: T): T;
  * Request navigation with event emission
  *
  * This hook emits a navigation request event. The app must subscribe to
- * 'browse:external-navigate' and perform the actual navigation using
+ * 'nav:external' and perform the actual navigation using
  * its router (Next.js, React Router, etc.) to enable client-side routing.
  *
  * If no subscriber handles the event, falls back to window.location.href
  * after a brief delay to allow for event handling.
  *
- * @emits browse:external-navigate - External navigation requested. Payload: { url: string, resourceId?: string, cancelFallback: () => void }
+ * @emits nav:external - External navigation requested. Payload: { url: string, resourceId?: string, cancelFallback: () => void }
  *
  * The payload includes a `cancelFallback` function that subscribers must call to
  * prevent the window.location fallback from firing. Subscribers that handle the
@@ -1206,7 +694,7 @@ declare function useObservableRouter<T extends Router>(baseRouter: T): T;
  * // In app (frontend package) - subscribe, cancel fallback, and handle with Next.js router
  * const router = useRouter();
  * useEventSubscriptions({
- *   'browse:external-navigate': ({ url, cancelFallback }) => {
+ *   'nav:external': ({ url, cancelFallback }) => {
  *     cancelFallback(); // Prevent window.location fallback
  *     router.push(url); // Client-side navigation
  *   },
@@ -1253,84 +741,6 @@ storageKey }?: UsePanelWidthOptions): {
     maxWidth: number;
 };
 
-/**
- * Stream connection status
- */
-type StreamStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
-interface UseResourceEventsOptions {
-    rUri: ResourceId;
-    onEvent?: (event: PersistedEvent) => void;
-    onAnnotationAdded?: (event: Extract<PersistedEvent, {
-        type: 'mark:added';
-    }>) => void;
-    onAnnotationRemoved?: (event: Extract<PersistedEvent, {
-        type: 'mark:removed';
-    }>) => void;
-    onAnnotationBodyUpdated?: (event: Extract<PersistedEvent, {
-        type: 'mark:body-updated';
-    }>) => void;
-    onEntityTagAdded?: (event: Extract<PersistedEvent, {
-        type: 'mark:entity-tag-added';
-    }>) => void;
-    onEntityTagRemoved?: (event: Extract<PersistedEvent, {
-        type: 'mark:entity-tag-removed';
-    }>) => void;
-    onDocumentArchived?: (event: Extract<PersistedEvent, {
-        type: 'mark:archived';
-    }>) => void;
-    onDocumentUnarchived?: (event: Extract<PersistedEvent, {
-        type: 'mark:unarchived';
-    }>) => void;
-    onError?: (error: string) => void;
-    autoConnect?: boolean;
-}
-/**
- * React hook for subscribing to real-time document events via SSE
- *
- * Opens a long-lived SSE connection to receive events as they happen.
- *
- * @example
- * ```tsx
- * const { status, connect, disconnect } = useResourceEvents({
- *   rUri: resourceUri('http://localhost:4000/resources/doc-123'),
- *   onAnnotationAdded: (event) => {
- *     console.log('New annotation:', event.payload);
- *   },
- * });
- * ```
- */
-declare function useResourceEvents({ rUri, onEvent, onAnnotationAdded, onAnnotationRemoved, onAnnotationBodyUpdated, onEntityTagAdded, onEntityTagRemoved, onDocumentArchived, onDocumentUnarchived, onError, autoConnect, }: UseResourceEventsOptions): {
-    status: StreamStatus;
-    lastEvent: PersistedEvent | null;
-    eventCount: number;
-    connect: () => void;
-    disconnect: () => void;
-    isConnected: boolean;
-};
-
-/**
- * React hook for subscribing to global system-level events via SSE
- *
- * Opens a long-lived SSE connection to GET /api/events/stream to receive
- * domain events that are not scoped to a specific resource (e.g., entity type changes).
- *
- * Automatically invalidates relevant React Query caches when system events arrive.
- *
- * @example
- * ```tsx
- * // In your app layout:
- * useGlobalEvents(); // That's it — auto-connects and invalidates queries
- * ```
- */
-declare function useGlobalEvents({ autoConnect }?: {
-    autoConnect?: boolean;
-}): {
-    status: StreamStatus;
-    connect: () => Promise<void>;
-    disconnect: () => void;
-    isConnected: boolean;
-};
-
 interface UseRovingTabIndexOptions {
     orientation?: 'horizontal' | 'vertical' | 'grid';
     loop?: boolean;
@@ -1344,8 +754,8 @@ declare function useRovingTabIndex<T extends HTMLElement>(itemCount: number, opt
 
 /**
  * Tracks the time remaining on the active KB session's JWT and whether it's
- * expiring soon (< 5 minutes). Re-derives once per second from the
- * KnowledgeBaseSession context.
+ * expiring soon (< 5 minutes). Reads the session's `expiresAt` getter (which
+ * derives from the current `token$` value) and re-derives once per second.
  */
 declare function useSessionExpiry(): {
     timeRemaining: number | null;
@@ -1389,19 +799,38 @@ declare function useLoadingState(minLoadingTime?: number): {
  */
 declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((val: T) => T)) => void];
 
-type SemiontResource$3 = components['schemas']['ResourceDescriptor'];
 interface UseResourceContentResult {
     content: string;
     loading: boolean;
 }
+declare function useResourceContent(rUri: ResourceId, resource: ResourceDescriptor, enabled?: boolean): UseResourceContentResult;
+
+interface SemiontProviderProps {
+    /** Inject a specific browser (tests). Omit in production. */
+    browser?: SemiontBrowser;
+    children: ReactNode;
+}
+declare function SemiontProvider({ browser, children }: SemiontProviderProps): react_jsx_runtime.JSX.Element;
+declare function useSemiont(): SemiontBrowser;
+
 /**
- * Hook to load text resource content (representation)
+ * WebBrowserStorage — browser-backed `SessionStorage` implementation.
+ * Wraps `localStorage` for reads/writes and `window`'s `storage` event
+ * for cross-tab change notifications.
  *
- * Fetches and decodes the primary text representation of a resource.
- * Only for text types (text/plain, text/markdown).
- * Binary types (image/*, application/pdf) use useMediaToken instead.
+ * Construction requires a browser context. The guard matches the
+ * existing registry behavior: server rendering that accidentally
+ * instantiates this gets a loud error rather than a silent no-op
+ * that would mask token leaks.
  */
-declare function useResourceContent(rUri: ResourceId, resource: SemiontResource$3, enabled?: boolean): UseResourceContentResult;
+
+declare class WebBrowserStorage implements SessionStorage {
+    constructor();
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+    subscribe(handler: (key: string, newValue: string | null) => void): () => void;
+}
 
 interface AnnotationProviderProps {
     annotationManager: AnnotationManager;
@@ -1415,23 +844,18 @@ interface AnnotationProviderProps {
  *
  * Example usage:
  * ```typescript
- * // In app (apps/frontend/src/hooks/useAnnotationManager.ts)
- *
- * function useAnnotationManager(): AnnotationManager {
- *   const annotations = useAnnotations();
- *   const createMutation = annotations.create.useMutation();
- *   const deleteMutation = annotations.delete.useMutation();
- *
+ * function useAnnotationManager(client: SemiontClient): AnnotationManager {
  *   return {
  *     markAnnotation: async (params) => {
- *       const result = await createMutation.mutateAsync({
- *         rUri: params.rUri,
- *         data: { motivation: params.motivation, target: { source: params.rUri, selector: params.selector }, body: params.body }
+ *       const result = await client.mark.annotation(params.rUri, {
+ *         motivation: params.motivation,
+ *         target: { source: params.rUri, selector: params.selector },
+ *         body: params.body,
  *       });
  *       return result.annotation;
  *     },
  *     deleteAnnotation: async (params) => {
- *       await deleteMutation.mutateAsync({ resourceId: params.rUri, annotationId: params.annotationId });
+ *       await client.mark.delete(params.rUri, params.annotationId);
  *     }
  *   };
  * }
@@ -1452,158 +876,39 @@ declare function AnnotationProvider({ annotationManager, children }: AnnotationP
  */
 declare function useAnnotationManager(): AnnotationManager;
 
-interface ApiClientProviderProps {
-    baseUrl: string;
-    /**
-     * Optional 401-recovery hook. If provided, the api-client will retry
-     * requests once with a fresh token when a 401 is encountered. The
-     * frontend's protected layouts pass `useKnowledgeBaseSession().refreshActive`
-     * here so the api-client can transparently recover from expired access tokens.
-     */
-    tokenRefresher?: TokenRefresher;
-    children: ReactNode;
-}
-/**
- * Provider for API client — must be nested inside EventBusProvider.
- * The client is re-created when the baseUrl changes (workspace switch).
- * The EventBus is taken from EventBusContext so client and UI components
- * share the same workspace-scoped bus.
- */
-declare function ApiClientProvider({ baseUrl: url, tokenRefresher, children, }: ApiClientProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access the stateless API client singleton
- * Must be used within an ApiClientProvider
- * @returns Stateless SemiontApiClient instance
- */
-declare function useApiClient(): SemiontApiClient;
-
-interface AuthTokenProviderProps {
-    token: string | null;
-    children: ReactNode;
-}
-/**
- * Provider for auth token
- * Pass the current token value - React handles the rest
- */
-declare function AuthTokenProvider({ token, children, }: AuthTokenProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to get current auth token
- *
- * Returns the current token value from context.
- * Re-renders automatically when token changes (normal React behavior).
- *
- * @returns Current access token (null if not authenticated)
- * @throws Error if used outside AuthTokenProvider
- */
-declare function useAuthToken(): string | null;
-
-interface CacheProviderProps {
-    cacheManager: CacheManager;
-    children: React__default.ReactNode;
-}
 /**
- * Cache Provider
+ * Subscribe to a bus event with automatic cleanup.
  *
- * Provides cache invalidation capabilities via the Provider Pattern.
- * Apps inject their own CacheManager implementation.
+ * Two buses exist: the app-scoped bus on `SemiontBrowser` (panel, shell,
+ * tabs, nav, settings — events that must work without a KB session) and
+ * the per-session bus on `SemiontClient` (mark, beckon, gather,
+ * match, bind, yield, browse — events tied to a live KB). This hook
+ * subscribes to BOTH so components don't need to know which scope a
+ * channel is on. Each channel only fires on one bus, so there's no
+ * double-delivery.
  *
- * Example usage:
- * ```typescript
- * // In app (apps/frontend/src/hooks/useCacheManager.ts)
- * function useCacheManager(): CacheManager {
- *   const queryClient = useQueryClient();
- *
- *   return {
- *     invalidateAnnotations: (rUri) => {
- *       queryClient.invalidateQueries({ queryKey: ['annotations', rUri] });
- *     },
- *     invalidateEvents: (rUri) => {
- *       queryClient.invalidateQueries({ queryKey: ['documents', 'events', rUri] });
- *     }
- *   };
- * }
- *
- * // In app layout
- * const cacheManager = useCacheManager();
- * <CacheProvider cacheManager={cacheManager}>
- *   <YourComponents />
- * </CacheProvider>
- * ```
- */
-declare function CacheProvider({ cacheManager, children }: CacheProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access the CacheManager
- *
- * @throws Error if used outside CacheProvider
- * @returns CacheManager instance
- */
-declare function useCacheManager(): CacheManager;
-
-interface EventBusProviderProps {
-    children: ReactNode;
-}
-/**
- * Unified event bus provider for all application events.
- *
- * Each provider mount creates a fresh EventBus instance. This means:
- * - Workspace switches (which remount via key prop) get isolated buses
- * - Tests get isolation naturally — no resetEventBusForTesting needed
- *
- * Operation handlers (API calls triggered by events) are set up separately via
- * the useBindFlow hook, which should be called at the resource page level.
- */
-declare function EventBusProvider({ children }: EventBusProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access the unified event bus
- *
- * Use this everywhere instead of:
- * - useMakeMeaningEvents()
- * - useNavigationEvents()
- * - useGlobalSettingsEvents()
- *
- * @example
- * ```typescript
- * const eventBus = useEventBus();
- *
- * // Emit any event
- * eventBus.get('beckon:hover').next({ annotationId: '123' });
- * eventBus.get('browse:sidebar-toggle').next(undefined);
- * eventBus.get('settings:theme-changed').next({ theme: 'dark' });
- *
- * // Subscribe to any event
- * useEffect(() => {
- *   const unsubscribe = eventBus.on('beckon:hover', ({ annotationId }) => {
- *     console.log(annotationId);
- *   });
- *   return () => unsubscribe();
- * }, []);
- * ```
- */
-declare function useEventBus(): EventBus;
-
-/**
- * Subscribe to an event bus event with automatic cleanup.
- *
- * This hook solves the "stale closure" problem by always using the latest
- * version of the handler without re-subscribing.
+ * Stable-handler pattern: the ref-wrapped handler means `handler` itself
+ * can change on every render without causing a re-subscription.
  *
  * @example
  * ```tsx
  * useEventSubscription('mark:create-ok', ({ annotationId }) => {
- *   // This always uses the latest props/state
- *   triggerSparkleAnimation(annotation.id);
+ *   triggerSparkleAnimation(annotationId);
  * });
  * ```
  */
 declare function useEventSubscription<K extends keyof EventMap>(eventName: K, handler: (payload: EventMap[K]) => void): void;
 /**
- * Subscribe to multiple events at once.
+ * Subscribe to multiple bus events at once. Same semantics as
+ * `useEventSubscription`, batched — each channel is subscribed on both
+ * the app bus (`SemiontBrowser`) and the session bus
+ * (`SemiontClient`, when a session is active).
  *
  * @example
  * ```tsx
  * useEventSubscriptions({
  *   'mark:create-ok': ({ annotationId }) => handleCreated(annotationId),
- *   'mark:delete-ok': ({ annotationId }) => removeAnnotation(annotationId),
+ *   'panel:toggle': ({ panel }) => console.log('toggled', panel),
  * });
  * ```
  */
@@ -1611,33 +916,6 @@ declare function useEventSubscriptions(subscriptions: {
     [K in keyof EventMap]?: (payload: EventMap[K]) => void;
 }): void;
 
-/**
- * Provider Pattern: Accepts OpenResourcesManager implementation as prop
- * and makes it available to child components via Context.
- *
- * Apps provide their own implementation (localStorage, sessionStorage, database, etc.)
- * and pass it to this provider at the root level.
- *
- * @example
- * ```tsx
- * // In app root
- * const openResourcesManager = useOpenResourcesManager(); // App's implementation
- *
- * <OpenResourcesProvider openResourcesManager={openResourcesManager}>
- *   <App />
- * </OpenResourcesProvider>
- * ```
- */
-declare function OpenResourcesProvider({ openResourcesManager, children }: {
-    openResourcesManager: OpenResourcesManager;
-    children: React__default.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access OpenResourcesManager from Context
- * Components use this hook to access open resources functionality
- */
-declare function useOpenResources(): OpenResourcesManager;
-
 interface ResourceAnnotationsContextType {
     newAnnotationIds: Set<string>;
     markAnnotation: (rUri: ResourceId, motivation: 'highlighting' | 'linking' | 'assessing' | 'commenting' | 'tagging', selector: Selector | Selector[], body?: any[]) => Promise<string | undefined>;
@@ -1707,41 +985,6 @@ interface RouteBuilder {
     admin?: () => string;
 }
 
-/**
- * Pure helpers for the KnowledgeBaseSession provider.
- *
- * Contains:
- *  - localStorage shape and read/write helpers for KB list, active KB id,
- *    and per-KB sessions
- *  - JWT expiry parsing and "is expired" check
- *  - URL/protocol helpers for KB instances
- *  - The public `getKbSessionStatus(kbId)` helper that the KB-list UI uses
- *    to color status dots without subscribing to context changes
- *
- * No React imports, no module-scoped state, no side effects beyond
- * localStorage. Splitting these out of the provider file makes them
- * unit-testable in isolation and keeps the React provider focused on
- * lifecycle and state.
- */
-
-/** The shape persisted to localStorage per KB. */
-interface StoredSession {
-    access: string;
-    refresh: string;
-}
-declare function defaultProtocol(host: string): 'http' | 'https';
-declare function isValidHostname(host: string): boolean;
-declare function kbBackendUrl(kb: KnowledgeBase): string;
-/**
- * Read the locally-stored credential status for a KB. Pure / synchronous —
- * does not subscribe to context changes. Used by KB-list UI to color status
- * dots without requiring re-renders on every tick.
- */
-declare function getKbSessionStatus(kbId: string): KbSessionStatus;
-
-declare function notifySessionExpired(message?: string): void;
-declare function notifyPermissionDenied(message?: string): void;
-
 declare const AVAILABLE_LOCALES: readonly ["ar", "bn", "cs", "da", "de", "el", "en", "es", "fa", "fi", "fr", "he", "hi", "id", "it", "ja", "ko", "ms", "nl", "no", "pl", "pt", "ro", "sv", "th", "tr", "uk", "vi", "zh"];
 type AvailableLocale = typeof AVAILABLE_LOCALES[number];
 interface TranslationProviderProps {
@@ -1798,10 +1041,9 @@ declare function usePreloadTranslations(): {
  * They handle position conversion, tooltip generation, and decoration metadata.
  */
 
-type Annotation$g = components['schemas']['Annotation'];
 interface TextSegment {
     exact: string;
-    annotation?: Annotation$g;
+    annotation?: Annotation;
     start: number;
     end: number;
 }
@@ -1821,16 +1063,17 @@ interface Props$b {
     sourceView?: boolean;
     showLineNumbers?: boolean;
     enableWidgets?: boolean;
-    eventBus?: EventBus;
+    session?: SemiontSession | null | undefined;
     getTargetResourceName?: (resourceId: string) => string | undefined;
     generatingReferenceId?: string | null;
     hoverDelayMs: number;
 }
-declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, eventBus, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$b): react_jsx_runtime.JSX.Element;
+declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$b): react_jsx_runtime.JSX.Element;
 
 type Motivation$6 = components['schemas']['Motivation'];
+type JobProgress$7 = components['schemas']['JobProgress'];
 interface AnnotateReferencesProgressWidgetProps {
-    progress: MarkProgress | null;
+    progress: JobProgress$7 | null;
     annotationType?: Motivation$6 | 'reference';
 }
 /**
@@ -1893,7 +1136,6 @@ interface ProtectedErrorBoundaryProps {
  */
 declare function ProtectedErrorBoundary({ children, resetKeys, }: ProtectedErrorBoundaryProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$f = components['schemas']['Annotation'];
 interface LiveRegionContextType {
     announce: (message: string, priority?: 'polite' | 'assertive') => void;
 }
@@ -1909,9 +1151,9 @@ declare function useSearchAnnouncements(): {
 declare function useDocumentAnnouncements(annotators?: Record<string, Annotator>): {
     announceDocumentSaved: () => void;
     announceDocumentDeleted: () => void;
-    announceAnnotationCreated: (annotation: Annotation$f) => void;
+    announceAnnotationCreated: (annotation: Annotation) => void;
     announceAnnotationDeleted: () => void;
-    announceAnnotationUpdated: (annotation: Annotation$f) => void;
+    announceAnnotationUpdated: (annotation: Annotation) => void;
     announceError: (message: string) => void;
 };
 declare function useResourceLoadingAnnouncements(): {
@@ -2010,7 +1252,7 @@ interface Props$9<T extends string = string> {
 /**
  * Toolbar component for panel navigation
  *
- * @emits browse:panel-toggle - Toggle panel visibility. Payload: { panel: string }
+ * @emits panel:toggle - Toggle panel visibility. Payload: { panel: string }
  */
 declare function Toolbar<T extends string = string>({ context, activePanel, isArchived }: Props$9<T>): react_jsx_runtime.JSX.Element;
 
@@ -2031,9 +1273,8 @@ interface SettingsPanelProps {
  */
 declare function SettingsPanel({ showLineNumbers, theme, locale, isPendingLocaleChange, hoverDelayMs }: SettingsPanelProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$e = components['schemas']['Annotation'];
 interface JsonLdViewProps {
-    annotation: Annotation$e;
+    annotation: Annotation;
     onBack: () => void;
 }
 declare function JsonLdView({ annotation, onBack }: JsonLdViewProps): react_jsx_runtime.JSX.Element;
@@ -2064,14 +1305,13 @@ interface PopupContainerProps {
 }
 declare function PopupContainer({ children, position, onClose, isOpen, wide }: PopupContainerProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$d = components['schemas']['Annotation'];
 interface AnnotationOverlayProps {
-    annotations: Annotation$d[];
+    annotations: Annotation[];
     imageWidth: number;
     imageHeight: number;
     displayWidth: number;
     displayHeight: number;
-    eventBus?: EventBus;
+    session?: SemiontSession | null | undefined;
     hoveredAnnotationId?: string | null;
     selectedAnnotationId?: string | null;
     hoverDelayMs: number;
@@ -2082,16 +1322,15 @@ interface AnnotationOverlayProps {
  * @emits beckon:hover - Annotation hovered or unhovered. Payload: { annotationId: string | null }
  * @emits browse:click - Annotation clicked. Payload: { annotationId: string, motivation: Motivation }
  */
-declare function AnnotationOverlay({ annotations, imageWidth, imageHeight, displayWidth, displayHeight, eventBus, hoveredAnnotationId, selectedAnnotationId, hoverDelayMs }: AnnotationOverlayProps): react_jsx_runtime.JSX.Element;
+declare function AnnotationOverlay({ annotations, imageWidth, imageHeight, displayWidth, displayHeight, session, hoveredAnnotationId, selectedAnnotationId, hoverDelayMs }: AnnotationOverlayProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$c = components['schemas']['Annotation'];
 type DrawingMode = 'rectangle' | 'polygon' | 'circle' | 'freeform' | null;
 interface SvgDrawingCanvasProps {
     imageUrl: string;
-    existingAnnotations?: Annotation$c[];
+    existingAnnotations?: Annotation[];
     drawingMode: DrawingMode;
     selectedMotivation?: SelectionMotivation | null;
-    eventBus?: EventBus;
+    session?: SemiontSession | null | undefined;
     hoveredAnnotationId?: string | null;
     selectedAnnotationId?: string | null;
     hoverDelayMs?: number;
@@ -2102,7 +1341,7 @@ interface SvgDrawingCanvasProps {
  * @emits browse:click - Annotation clicked on canvas. Payload: { annotationId: string, motivation: Motivation }
  * @emits mark:requested - New annotation drawn on canvas. Payload: { selector: SvgSelector, motivation: SelectionMotivation }
  */
-declare function SvgDrawingCanvas({ imageUrl, existingAnnotations, drawingMode, selectedMotivation, eventBus, hoveredAnnotationId, selectedAnnotationId }: SvgDrawingCanvasProps): react_jsx_runtime.JSX.Element;
+declare function SvgDrawingCanvas({ imageUrl, existingAnnotations, drawingMode, selectedMotivation, session, hoveredAnnotationId, selectedAnnotationId }: SvgDrawingCanvasProps): react_jsx_runtime.JSX.Element;
 
 interface KeyboardShortcutsHelpModalProps {
     isOpen: boolean;
@@ -2114,30 +1353,23 @@ declare function KeyboardShortcutsHelpModal({ isOpen, onClose }: KeyboardShortcu
  * Modal that surfaces when a 403 forbidden error is reported via
  * `notifyPermissionDenied` (called from QueryCache.onError).
  *
- * Reads `permissionDeniedAt` and `permissionDeniedMessage` from
- * KnowledgeBaseSessionContext. The provider clears the flag when the user
- * dismisses the modal.
- *
- * Must be mounted inside KnowledgeBaseSessionProvider.
+ * Reads `permissionDeniedAt$` and `permissionDeniedMessage$` from the
+ * active `FrontendSessionSignals`. The signals instance clears the
+ * flag when the user dismisses the modal. Modal state lives on
+ * signals (not the session itself) so headless sessions
+ * (workers/CLIs) don't carry dead observables.
  */
 declare function PermissionDeniedModal(): react_jsx_runtime.JSX.Element;
 
-interface ProposeEntitiesModalProps {
-    isOpen: boolean;
-    onConfirm: (selectedTypes: string[]) => void;
-    onCancel: () => void;
-}
-declare function ProposeEntitiesModal({ isOpen, onConfirm, onCancel }: ProposeEntitiesModalProps): react_jsx_runtime.JSX.Element;
-
 /**
  * Modal that surfaces when the active KB's session expires (a 401 from
- * either the provider's own JWT validation or from any React Query call
+ * either the session's own JWT validation or from any React Query call
  * via the QueryCache.onError handler).
  *
- * Reads `sessionExpiredAt` from KnowledgeBaseSessionContext. When the user
- * dismisses the modal, the provider clears the flag.
- *
- * Must be mounted inside KnowledgeBaseSessionProvider.
+ * Reads `sessionExpiredAt$` from the active `FrontendSessionSignals`.
+ * When the user dismisses the modal, the signals instance clears the
+ * flag. Modal state lives on signals (not the session itself) so
+ * headless sessions (workers/CLIs) don't carry dead observables.
  */
 declare function SessionExpiredModal(): react_jsx_runtime.JSX.Element;
 
@@ -2217,7 +1449,6 @@ interface Props$5 {
 }
 declare function HistoryEvent({ event, annotations, allEvents, isRelated, t, Link, routes, onEventRef, onEventClick, onEventHover }: Props$5): react_jsx_runtime.JSX.Element;
 
-type SemiontResource$2 = components['schemas']['ResourceDescriptor'];
 /**
  * ResourceViewer - Display and interact with resource content and annotations
  *
@@ -2227,7 +1458,7 @@ type SemiontResource$2 = components['schemas']['ResourceDescriptor'];
  * - No manual refetch needed - events handle cache invalidation
  *
  * Requirements:
- * - Must be wrapped in MakeMeaningEventBusProvider (provides event bus)
+ * - Must be wrapped in SemiontProvider (which owns the session's event bus)
  * - Must be wrapped in CacheContext (provides cache manager)
  *
  * Event flow:
@@ -2237,7 +1468,7 @@ type SemiontResource$2 = components['schemas']['ResourceDescriptor'];
  * Phase 3 complete: Fully event-driven - all user interactions use unified event bus
  */
 interface Props$4 {
-    resource: SemiontResource$2 & {
+    resource: ResourceDescriptor & {
         content: string;
     };
     annotations: AnnotationsCollection;
@@ -2248,7 +1479,7 @@ interface Props$4 {
 }
 /**
  * @emits mark:delete - User requested to delete annotation. Payload: { annotationId: string }
- * @emits browse:panel-open - Request to open panel with annotation. Payload: { panel: string, scrollToAnnotationId?: string, motivation?: Motivation }
+ * @emits panel:open - Request to open panel with annotation. Payload: { panel: string, scrollToAnnotationId?: string, motivation?: Motivation }
  *
  * @subscribes mark:mode-toggled - Toggles between browse and annotate mode. Payload: { mode: 'browse' | 'annotate' }
  * @subscribes mark:added - New annotation was added. Payload: { annotation: Annotation }
@@ -2261,30 +1492,25 @@ interface Props$4 {
  */
 declare function ResourceViewer({ resource, annotations, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp }: Props$4): react_jsx_runtime.JSX.Element;
 
-type Annotation$b = components['schemas']['Annotation'];
 interface AssessmentEntryProps {
-    assessment: Annotation$b;
+    assessment: Annotation;
     isFocused: boolean;
     isHovered?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
 declare function AssessmentEntry({ assessment, isFocused, isHovered, ref, }: AssessmentEntryProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$a = components['schemas']['Annotation'];
 type Motivation$5 = components['schemas']['Motivation'];
-interface PendingAnnotation$6 {
+type JobProgress$6 = components['schemas']['JobProgress'];
+interface PendingAnnotation$5 {
     selector: Selector | Selector[];
     motivation: Motivation$5;
 }
 interface AssessmentPanelProps {
-    annotations: Annotation$a[];
-    pendingAnnotation: PendingAnnotation$6 | null;
+    annotations: Annotation[];
+    pendingAnnotation: PendingAnnotation$5 | null;
     isAssisting?: boolean;
-    progress?: {
-        status: string;
-        percentage?: number;
-        message?: string;
-    } | null;
+    progress?: JobProgress$6 | null;
     locale?: string;
     annotateMode?: boolean;
     scrollToAnnotationId?: string | null;
@@ -2301,16 +1527,32 @@ interface AssessmentPanelProps {
 declare function AssessmentPanel({ annotations, pendingAnnotation, isAssisting, progress, locale, annotateMode, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: AssessmentPanelProps): react_jsx_runtime.JSX.Element;
 
 interface Props$3 {
-    isConnected: boolean;
+    /**
+     * Connection state from `client.actor.state$`. See
+     * `packages/api-client/src/view-models/domain/actor-vm.ts`.
+     *
+     * UI mapping:
+     *   `open` | `reconnecting` | `initial` | `connecting`
+     *     → treated as "healthy" (green dot, "Live" label, event count visible).
+     *     `reconnecting` is specifically INCLUDED in healthy because a
+     *     brief reconnect (mount churn, channel-set change, quick blip)
+     *     shouldn't alarm the user. The 100 ms reconnect debounce and
+     *     sub-second fetch retry make `reconnecting` a transient state.
+     *   `degraded` | `closed`
+     *     → treated as "disconnected" (red dot, "Disconnected" label).
+     *     `degraded` is the 3 s threshold at which the state machine
+     *     decides the disconnect is sustained; this is the UI-banner
+     *     trigger the plan was designed around.
+     */
+    state: ConnectionState;
     eventCount: number;
     lastEventTimestamp?: string;
     knowledgeBaseName?: string;
 }
-declare function CollaborationPanel({ isConnected, eventCount, lastEventTimestamp, knowledgeBaseName }: Props$3): react_jsx_runtime.JSX.Element;
+declare function CollaborationPanel({ state, eventCount, lastEventTimestamp, knowledgeBaseName }: Props$3): react_jsx_runtime.JSX.Element;
 
-type Annotation$9 = components['schemas']['Annotation'];
 interface CommentEntryProps {
-    comment: Annotation$9;
+    comment: Annotation;
     isFocused: boolean;
     isHovered?: boolean;
     annotateMode?: boolean;
@@ -2318,22 +1560,18 @@ interface CommentEntryProps {
 }
 declare function CommentEntry({ comment, isFocused, isHovered, annotateMode, ref, }: CommentEntryProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$8 = components['schemas']['Annotation'];
 type Motivation$4 = components['schemas']['Motivation'];
-interface PendingAnnotation$5 {
+type JobProgress$5 = components['schemas']['JobProgress'];
+interface PendingAnnotation$4 {
     selector: Selector | Selector[];
     motivation: Motivation$4;
 }
 interface CommentsPanelProps {
-    annotations: Annotation$8[];
-    pendingAnnotation: PendingAnnotation$5 | null;
+    annotations: Annotation[];
+    pendingAnnotation: PendingAnnotation$4 | null;
     annotateMode?: boolean;
     isAssisting?: boolean;
-    progress?: {
-        status: string;
-        percentage?: number;
-        message?: string;
-    } | null;
+    progress?: JobProgress$5 | null;
     locale?: string;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
@@ -2348,19 +1586,12 @@ interface CommentsPanelProps {
  */
 declare function CommentsPanel({ annotations, pendingAnnotation, annotateMode, isAssisting, progress, locale, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): react_jsx_runtime.JSX.Element;
 
+type JobProgress$4 = components['schemas']['JobProgress'];
 interface AssistSectionProps {
     annotationType: 'highlight' | 'assessment' | 'comment';
     isAssisting: boolean;
     locale?: string;
-    progress?: {
-        status: string;
-        percentage?: number;
-        message?: string;
-        requestParams?: Array<{
-            label: string;
-            value: string;
-        }>;
-    } | null | undefined;
+    progress?: JobProgress$4 | null | undefined;
 }
 /**
  * Shared assist section for Highlight, Assessment, and Comment panels
@@ -2376,30 +1607,25 @@ interface AssistSectionProps {
  */
 declare function AssistSection({ annotationType, isAssisting, locale, progress, }: AssistSectionProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$7 = components['schemas']['Annotation'];
 interface HighlightEntryProps {
-    highlight: Annotation$7;
+    highlight: Annotation;
     isFocused: boolean;
     isHovered?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
 declare function HighlightEntry({ highlight, isFocused, isHovered, ref, }: HighlightEntryProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$6 = components['schemas']['Annotation'];
 type Motivation$3 = components['schemas']['Motivation'];
-interface PendingAnnotation$4 {
+type JobProgress$3 = components['schemas']['JobProgress'];
+interface PendingAnnotation$3 {
     selector: Selector | Selector[];
     motivation: Motivation$3;
 }
 interface HighlightPanelProps {
-    annotations: Annotation$6[];
-    pendingAnnotation: PendingAnnotation$4 | null;
+    annotations: Annotation[];
+    pendingAnnotation: PendingAnnotation$3 | null;
     isAssisting?: boolean;
-    progress?: {
-        status: string;
-        percentage?: number;
-        message?: string;
-    } | null;
+    progress?: JobProgress$3 | null;
     annotateMode?: boolean;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
@@ -2431,9 +1657,8 @@ interface PanelHeaderProps {
  */
 declare function PanelHeader({ count, title }: PanelHeaderProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$5 = components['schemas']['Annotation'];
 interface ReferenceEntryProps {
-    reference: Annotation$5;
+    reference: Annotation;
     isFocused: boolean;
     isHovered?: boolean;
     routes: RouteBuilder;
@@ -2443,26 +1668,18 @@ interface ReferenceEntryProps {
 }
 declare function ReferenceEntry({ reference, isFocused, isHovered, routes, annotateMode, isGenerating, ref, }: ReferenceEntryProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$4 = components['schemas']['Annotation'];
+type JobProgress$2 = components['schemas']['JobProgress'];
+
 type Motivation$2 = components['schemas']['Motivation'];
-type ResponseContent<T> = T extends {
-    responses: {
-        200: {
-            content: {
-                'application/json': infer R;
-            };
-        };
-    };
-} ? R : never;
-type ReferencedBy = ResponseContent<paths['/resources/{id}/referenced-by']['get']>['referencedBy'][number];
-interface PendingAnnotation$3 {
+type ReferencedBy = components['schemas']['GetReferencedByResponse']['referencedBy'][number];
+interface PendingAnnotation$2 {
     selector: Selector | Selector[];
     motivation: Motivation$2;
 }
 interface Props$1 {
-    annotations?: Annotation$4[];
+    annotations?: Annotation[];
     isAssisting: boolean;
-    progress: MarkProgress | null;
+    progress: JobProgress$2 | null;
     annotateMode?: boolean;
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
@@ -2470,7 +1687,7 @@ interface Props$1 {
     generatingReferenceId?: string | null;
     referencedBy?: ReferencedBy[];
     referencedByLoading?: boolean;
-    pendingAnnotation: PendingAnnotation$3 | null;
+    pendingAnnotation: PendingAnnotation$2 | null;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
@@ -2510,48 +1727,35 @@ interface Props {
  */
 declare function ResourceInfoPanel({ resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, creationMethod, wasAttributedTo, wasDerivedFrom, generator, }: Props): react_jsx_runtime.JSX.Element;
 
-type Annotation$3 = components['schemas']['Annotation'];
 interface StatisticsPanelProps {
-    highlights: Annotation$3[];
-    comments: Annotation$3[];
-    assessments: Annotation$3[];
-    references: Annotation$3[];
-    tags: Annotation$3[];
+    highlights: Annotation[];
+    comments: Annotation[];
+    assessments: Annotation[];
+    references: Annotation[];
+    tags: Annotation[];
 }
 declare function StatisticsPanel({ highlights, comments, assessments, references, tags }: StatisticsPanelProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$2 = components['schemas']['Annotation'];
 interface TagEntryProps {
-    tag: Annotation$2;
+    tag: Annotation;
     isFocused: boolean;
     isHovered?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
 declare function TagEntry({ tag, isFocused, isHovered, ref, }: TagEntryProps): react_jsx_runtime.JSX.Element;
 
-type Annotation$1 = components['schemas']['Annotation'];
 type Motivation$1 = components['schemas']['Motivation'];
-interface PendingAnnotation$2 {
+type JobProgress$1 = components['schemas']['JobProgress'];
+interface PendingAnnotation$1 {
     selector: Selector | Selector[];
     motivation: Motivation$1;
 }
 interface TaggingPanelProps {
-    annotations: Annotation$1[];
+    annotations: Annotation[];
     annotateMode?: boolean;
     isAssisting?: boolean;
-    progress?: {
-        status: string;
-        percentage?: number;
-        currentCategory?: string;
-        processedCategories?: number;
-        totalCategories?: number;
-        message?: string;
-        requestParams?: Array<{
-            label: string;
-            value: string;
-        }>;
-    } | null;
-    pendingAnnotation: PendingAnnotation$2 | null;
+    progress?: JobProgress$1 | null;
+    pendingAnnotation: PendingAnnotation$1 | null;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
@@ -2566,10 +1770,11 @@ interface TaggingPanelProps {
  */
 declare function TaggingPanel({ annotations, annotateMode, isAssisting, progress, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: TaggingPanelProps): react_jsx_runtime.JSX.Element;
 
-type Annotation = components['schemas']['Annotation'];
+type JobProgress = components['schemas']['JobProgress'];
+
 type Motivation = components['schemas']['Motivation'];
 type TabKey = 'statistics' | 'reference' | 'highlight' | 'assessment' | 'comment' | 'tag';
-interface PendingAnnotation$1 {
+interface PendingAnnotation {
     selector: Selector | Selector[];
     motivation: Motivation;
 }
@@ -2587,8 +1792,8 @@ interface UnifiedAnnotationsPanelProps {
     annotators: Record<string, Annotator>;
     annotateMode?: boolean;
     assistingMotivation?: Motivation | null;
-    progress?: MarkProgress | null;
-    pendingAnnotation: PendingAnnotation$1 | null;
+    progress?: JobProgress | null;
+    pendingAnnotation: PendingAnnotation | null;
     allEntityTypes?: string[];
     generatingReferenceId?: string | null;
     referencedBy?: any[];
@@ -2665,7 +1870,7 @@ interface ObservableLinkProps extends React__default.AnchorHTMLAttributes<HTMLAn
  * - State coordination before navigation
  * - Logging navigation flows
  *
- * The component emits 'browse:link-clicked' event before allowing
+ * The component emits 'nav:link-clicked' event before allowing
  * the browser to follow the link.
  *
  * @example
@@ -2689,7 +1894,7 @@ interface ObservableLinkProps extends React__default.AnchorHTMLAttributes<HTMLAn
  * </Link>
  * ```
  *
- * @emits browse:link-clicked - Link clicked by user. Payload: { href: string, label?: string }
+ * @emits nav:link-clicked - Link clicked by user. Payload: { href: string, label?: string }
  */
 declare function ObservableLink({ href, label, onClick, children, ...anchorProps }: ObservableLinkProps): react_jsx_runtime.JSX.Element;
 
@@ -2723,7 +1928,7 @@ interface SimpleNavigationProps$1 {
  * Simple navigation component for Admin and Moderation modes.
  * Renders a section header with optional dropdown and static navigation tabs.
  *
- * @emits browse:sidebar-toggle - Toggle sidebar collapsed/expanded state. Payload: undefined
+ * @emits shell:sidebar-toggle - Toggle sidebar collapsed/expanded state. Payload: undefined
  */
 declare function SimpleNavigation({ title, items, currentPath, LinkComponent, dropdownContent, isCollapsed, icons, collapseSidebarLabel, expandSidebarLabel }: SimpleNavigationProps$1): react_jsx_runtime.JSX.Element;
 
@@ -2789,9 +1994,9 @@ interface CollapsibleResourceNavigationProps {
  * Supports drag and drop for resource reordering when expanded.
  * Platform-agnostic design for use across different React environments.
  *
- * @emits browse:resource-reorder - Resource tab reordered. Payload: { oldIndex: number, newIndex: number }
- * @emits browse:resource-close - Resource tab closed. Payload: { resourceId: string }
- * @emits browse:sidebar-toggle - Toggle sidebar collapsed/expanded state. Payload: undefined
+ * @emits tabs:reorder - Resource tab reordered. Payload: { oldIndex: number, newIndex: number }
+ * @emits tabs:close - Resource tab closed. Payload: { resourceId: string }
+ * @emits shell:sidebar-toggle - Toggle sidebar collapsed/expanded state. Payload: undefined
  */
 declare function CollapsibleResourceNavigation({ fixedItems, resources, isCollapsed, currentPath, LinkComponent, onNavigate, getResourceHref, className, translations, icons, navigationMenu }: CollapsibleResourceNavigationProps): react_jsx_runtime.JSX.Element;
 
@@ -2842,8 +2047,6 @@ interface ReferenceWizardModalProps {
     context: GatheredContext | null;
     contextLoading: boolean;
     contextError: Error | null;
-    /** Event bus for emitting downstream events */
-    eventBus: EventBus;
     /** Callbacks */
     onGenerateSubmit: (referenceId: string, config: GenerationConfig) => void;
     onLinkResource: (referenceId: string, targetResourceId: string) => void;
@@ -2887,7 +2090,7 @@ interface ReferenceWizardModalProps {
         semanticScoringHelp: string;
     };
 }
-declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, locale, context, contextLoading, contextError, eventBus, onGenerateSubmit, onLinkResource, onComposeNavigate, translations: t, }: ReferenceWizardModalProps): react_jsx_runtime.JSX.Element;
+declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeNavigate, translations: t, }: ReferenceWizardModalProps): react_jsx_runtime.JSX.Element;
 
 interface SearchModalProps$1 {
     isOpen: boolean;
@@ -3391,17 +2594,6 @@ interface ExportCardProps {
 }
 declare function ExportCard({ onExport, isExporting, translations: t }: ExportCardProps): react_jsx_runtime.JSX.Element;
 
-/**
- * ImportCard — File drop zone, preview, and import trigger
- *
- * Pure React component. All state and handlers passed as props.
- */
-interface ImportPreview {
-    format: string;
-    version: number;
-    sourceUrl: string;
-    stats: Record<string, number>;
-}
 interface ImportCardTranslations {
     title: string;
     description: string;
@@ -3871,19 +3063,10 @@ interface TagSchemasPageProps {
 }
 declare function TagSchemasPage({ schemas, isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: TagSchemasPageProps): react_jsx_runtime.JSX.Element;
 
-type ResourceDescriptor$2 = components['schemas']['ResourceDescriptor'];
 interface ResourceComposePageProps {
     mode: 'new' | 'clone' | 'reference';
-    cloneData?: {
-        sourceResource: ResourceDescriptor$2;
-        sourceContent: string;
-    };
-    referenceData?: {
-        annotationUri: string;
-        sourceDocumentId: string;
-        name: string;
-        entityTypes: string[];
-    };
+    cloneData?: CloneData | null;
+    referenceData?: ReferenceData | null;
     gatheredContext?: GatheredContext | null;
     availableEntityTypes: string[];
     initialLocale: string;
@@ -3945,10 +3128,9 @@ interface SaveResourceParams {
 }
 declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, showLineNumbers, hoverDelayMs, activePanel, onSaveResource, onCancel, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): react_jsx_runtime.JSX.Element;
 
-type ResourceDescriptor$1 = components['schemas']['ResourceDescriptor'];
 interface ResourceDiscoveryPageProps {
-    recentDocuments: ResourceDescriptor$1[];
-    searchDocuments: ResourceDescriptor$1[];
+    recentDocuments: ResourceDescriptor[];
+    searchDocuments: ResourceDescriptor[];
     entityTypes: string[];
     isLoadingRecent: boolean;
     isSearching: boolean;
@@ -3981,7 +3163,6 @@ interface ResourceDiscoveryPageProps {
 }
 declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, isSearching, searchQuery, onSearchQueryChange, theme, showLineNumbers, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): react_jsx_runtime.JSX.Element;
 
-type ResourceDescriptor = components['schemas']['ResourceDescriptor'];
 interface ResourceCardProps {
     resource: ResourceDescriptor;
     onOpen: (resource: ResourceDescriptor) => void;
@@ -3991,7 +3172,7 @@ interface ResourceCardProps {
 }
 declare const ResourceCard: React__default.MemoExoticComponent<({ resource, onOpen, tabIndex, archivedLabel, createdLabel }: ResourceCardProps) => react_jsx_runtime.JSX.Element>;
 
-type SemiontResource = components['schemas']['ResourceDescriptor'];
+type SemiontResource = ResourceDescriptor;
 interface ResourceViewerPageProps {
     /**
      * The resource to display
@@ -4022,9 +3203,11 @@ interface ResourceViewerPageProps {
      */
     refetchDocument: () => Promise<unknown>;
     /**
-     * SSE attention stream connection status for the active workspace
+     * Bus connection state for the active workspace. Six-valued state
+     * machine from `actor.state$`; CollaborationPanel maps it to the
+     * "Live" / "Disconnected" visual.
      */
-    streamStatus: StreamStatus;
+    streamStatus: ConnectionState;
     /**
      * Name of the active knowledge base (for display in panels)
      */
@@ -4035,7 +3218,7 @@ interface ResourceViewerPageProps {
  *
  * Uses hooks directly (NO containers, NO render props, NO ResourceViewerPageContent wrapper)
  *
- * @emits browse:router-push - Navigate to a resource or filtered view
+ * @emits nav:push - Navigate to a resource or filtered view
  * @emits beckon:sparkle - Trigger sparkle animation on an annotation
  * @emits bind:update-body - Update annotation body content
  * @subscribes mark:archive - Archive the current resource
@@ -4059,217 +3242,40 @@ interface ResourceViewerPageProps {
  */
 declare function ResourceViewerPage({ resource, rUri, locale, Link, routes, ToolbarPanels, refetchDocument, streamStatus, knowledgeBaseName, }: ResourceViewerPageProps): react_jsx_runtime.JSX.Element;
 
-/**
- * useBeckonFlow — Annotation attention / pointer coordination hook
- *
- * Manages which annotation currently has the user's attention:
- * - Hover state (hoveredAnnotationId)
- * - Hover → sparkle relay
- * - Click → focus relay
- *
- * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that
- * subscribes to events and pushes values into React state.
- *
- * Note: beckon:sparkle visual effect (triggerSparkleAnimation) is owned by
- * ResourceViewerPage, which subscribes to beckon:sparkle and delegates to
- * ResourceAnnotationsContext. This hook emits the signal; it does not render the effect.
- *
- * @subscribes beckon:hover - Sets hoveredAnnotationId; emits beckon:sparkle
- * @subscribes browse:click - Emits beckon:focus (attention relay only)
- * @emits      beckon:sparkle
- * @emits      beckon:focus
- */
-
-interface BeckonFlowState {
-    hoveredAnnotationId: string | null;
-}
-declare function useBeckonFlow(): BeckonFlowState;
-/** Default milliseconds the mouse must dwell before beckon:hover is emitted. */
-declare const HOVER_DELAY_MS = 150;
-type EmitHover = (annotationId: string | null) => void;
-interface HoverHandlers {
-    /** Call with the annotation ID when the mouse enters an annotation element. */
-    handleMouseEnter: (annotationId: string) => void;
-    /** Call when the mouse leaves the annotation element. */
-    handleMouseLeave: () => void;
-    /** Cancel any pending timer — call in the useEffect cleanup. */
-    cleanup: () => void;
-}
-/**
- * Creates hover handlers for imperative code (non-hook contexts).
- * @param emit - Callback to emit hover events
- * @param delayMs - Hover delay in milliseconds
- */
-declare function createHoverHandlers(emit: EmitHover, delayMs: number): HoverHandlers;
 interface HoverEmitterProps {
     onMouseEnter: () => void;
     onMouseLeave: () => void;
 }
-/**
- * React hook that returns onMouseEnter / onMouseLeave props for a single
- * annotation entry element.
- *
- * @param annotationId - The ID of the annotation this element represents.
- * @param hoverDelayMs - Hover delay in milliseconds (defaults to HOVER_DELAY_MS for panel entries)
- */
-declare function useHoverEmitter(annotationId: string, hoverDelayMs?: number): HoverEmitterProps;
-/**
- * Opens a participant-scoped SSE connection to receive cross-participant
- * beckon signals. Each incoming signal is emitted as beckon:focus on the
- * EventBus — the existing scroll/highlight machinery handles it automatically.
- *
- * Signals are ephemeral: delivered if connected, silently dropped if not.
- *
- * @example
- * ```tsx
- * // In your layout (render-nothing connector):
- * useAttentionStream();
- * ```
- */
-declare function useAttentionStream(): {
-    status: StreamStatus;
-};
-
-/**
- * useMarkFlow - Annotation state management hook
- *
- * Bridges EventBus commands to namespace API methods for annotation CRUD
- * and AI assist. Manages UI state (pendingAnnotation, assistingMotivation,
- * progress) via EventBus subscriptions — the React-specific portion.
- *
- * The FlowEngine's HTTP bridging role is replaced by namespace methods:
- * - mark:submit → semiont.mark.annotation()
- * - mark:delete → semiont.mark.delete()
- * - mark:assist-request → semiont.mark.assist() (Observable)
- */
-
-interface PendingAnnotation {
-    selector: Selector | Selector[];
-    motivation: Motivation$9;
-}
-interface MarkFlowState {
-    pendingAnnotation: PendingAnnotation | null;
-    assistingMotivation: Motivation$9 | null;
-    progress: MarkProgress | null;
-    assistStreamRef: React.MutableRefObject<AbortController | null>;
-}
-declare function useMarkFlow(rUri: ResourceId): MarkFlowState;
-
-/**
- * usePanelBrowse - Panel navigation and scroll coordination hook
- *
- * Manages sidebar panel state:
- * - Active panel tracking (which panel is open)
- * - Scroll coordination (scrollToAnnotationId)
- * - Panel routing with initial tab
- * - LocalStorage persistence
- *
- * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that
- * subscribes to events and pushes values into React state.
- */
-type ToolbarPanelType = 'history' | 'info' | 'annotations' | 'settings' | 'collaboration' | 'user' | 'jsonld' | 'knowledge-base';
-/** Panels available on all pages */
-declare const COMMON_PANELS: readonly ToolbarPanelType[];
-/** Panels available only on resource viewer pages */
-declare const RESOURCE_PANELS: readonly ToolbarPanelType[];
-interface PanelBrowseState {
-    activePanel: ToolbarPanelType | null;
-    scrollToAnnotationId: string | null;
-    panelInitialTab: {
-        tab: string;
-        generation: number;
-    } | null;
-    onScrollCompleted: () => void;
-}
-/**
- * Hook for panel navigation state management
- *
- * @subscribes browse:panel-toggle - Toggle a panel open/closed
- * @subscribes browse:panel-open - Open a panel, optionally scrolling to an annotation
- * @subscribes browse:panel-close - Close the active panel
- * @returns Panel navigation state
- */
-declare function usePanelBrowse(): PanelBrowseState;
-
-/**
- * useYieldFlow - Document generation flow hook
- *
- * Triggers yield.fromAnnotation() on the namespace API.
- * Manages generation progress state (React-specific) via EventBus subscriptions
- * from the events-stream auto-router.
- */
-
-interface YieldFlowState {
-    isGenerating: boolean;
-    generationProgress: YieldProgress | null;
-    onGenerateDocument: (referenceId: string, options: {
-        title: string;
-        storageUri: string;
-        prompt?: string;
-        language?: string;
-        temperature?: number;
-        maxTokens?: number;
-        context: GatheredContext;
-    }) => void;
-}
-declare function useYieldFlow(locale: string, resourceId: string, clearNewAnnotationId: (annotationId: AnnotationId) => void): YieldFlowState;
+declare function useHoverEmitter(annotationId: AnnotationId, hoverDelayMs?: number): HoverEmitterProps;
 
 /**
- * useContextGatherFlow - Context gather capability hook
- *
- * Manages UI state for context gathering. The actual gather trigger
- * comes from components emitting gather:requested on the EventBus.
- * This hook bridges to semiont.gather.annotation() and manages the
- * React state (loading, context, error).
+ * `ShellVM` is app-scoped — it owns toolbar panel state and lives on
+ * the `SemiontBrowser`'s own bus. Unlike session-scoped VMs, this hook
+ * does not need to wait for an active KB session; `useSemiont()`
+ * always returns the module-scoped `SemiontBrowser` singleton.
  */
-
-interface ContextGatherFlowConfig {
-    resourceId: ResourceId;
-}
-interface ContextGatherFlowState {
-    gatherContext: GatheredContext | null;
-    gatherLoading: boolean;
-    gatherError: Error | null;
-    /** The annotationId for which context was most recently gathered */
-    gatherAnnotationId: AnnotationId | null;
-}
-declare function useContextGatherFlow(config: ContextGatherFlowConfig): ContextGatherFlowState;
-
-/**
- * useBindFlow - Reference resolution flow hook
- *
- * Bridges EventBus commands to namespace API methods.
- * Components emit bind:update-body / match:search-requested on the EventBus;
- * this hook calls semiont.bind.body() / semiont.match.search() in response.
- *
- * Toast notifications for resolution errors remain here (React-specific).
- */
-
-declare function useBindFlow(rUri: ResourceId): void;
+declare function useShellVM(): ShellVM;
 
 /**
  * Subscribe to an RxJS Observable and return its current value as React state.
  *
- * - Initialises to undefined until the first emission
- * - Unsubscribes automatically on unmount or when `obs$` changes
- */
-declare function useObservable<T>(obs$: Observable<T>): T | undefined;
-
-/**
- * useStoreTokenSync — keeps observable store token getters in sync with auth
- *
- * Call once near the workspace root (inside both ApiClientProvider and AuthTokenProvider).
- * Ensures stores can make authenticated fetches as the token changes.
- *
- * @example
- * ```tsx
- * function GlobalEventsConnector() {
- *   useStoreTokenSync();
- *   useGlobalEvents();
- *   return null;
- * }
- * ```
- */
-declare function useStoreTokenSync(): void;
-
-export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminExchangePage, type AdminExchangePageProps, type AdminExchangePageTranslations, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type Annotation$k as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AssistSection, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, AuthTokenProvider, type AuthTokenProviderProps, type AvailableLocale, type BeckonFlowState, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, COMMON_PANELS, type CacheManager, CacheProvider, type CacheProviderProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type ContextGatherFlowConfig, type ContextGatherFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, EventBusProvider, type EventBusProviderProps, ExportCard, type ExportCardProps, type ExportCardTranslations, Footer, HOVER_DELAY_MS, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, type HoverHandlers, ImageURLSchema, ImageViewer, ImportCard, type ImportCardProps, type ImportCardTranslations, type ImportPreview, ImportProgress, type ImportProgressProps, type ImportProgressTranslations, JsonLdPanel, JsonLdView, KbSessionStatus, type KeyboardShortcut, KeyboardShortcutsHelpModal, KnowledgeBase, LeftSidebar, type LinkComponentProps, LinkedDataPage, type LinkedDataPageProps, type LinkedDataPageTranslations, LiveRegionProvider, type MarkFlowState, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, OpenResource, OpenResourcesManager, OpenResourcesProvider, type OverlayAnnotation, PageLayout, type PanelBrowseState, PanelHeader, PermissionDeniedModal, PopupContainer, PopupHeader, ProposeEntitiesModal, ProtectedErrorBoundary, QUERY_KEYS, RESOURCE_PANELS, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, type ReferenceWizardModalProps, ReferencesPanel, ResizeHandle, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, type SaveResourceParams, SearchModal, type SearchModalProps, type SearchPipeline, type SearchPipelineOptions, type SearchState, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, type SemiontResource$4 as SemiontResource, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, type StoredSession, type StreamStatus, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type ToolbarPanelType, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WelcomePage, type WelcomePageProps, type YieldFlowState, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createHoverHandlers, createSearchPipeline, cssVariables, defaultProtocol, faviconPaths, formatTime, generateCSSVariables, getKbSessionStatus, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, isValidHostname, jsonLightHighlightStyle, jsonLightTheme, kbBackendUrl, notifyPermissionDenied, notifySessionExpired, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAdmin, useAnnotationManager, useAnnotations, useApiClient, useAttentionStream, useAuthApi, useAuthToken, useBeckonFlow, useBindFlow, useCacheManager, useContextGatherFlow, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventBus, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGlobalEvents, useHealth, useHoverDelay, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMarkFlow, useModeration, useObservable, useObservableExternalNavigation, useObservableRouter, useOpenResources, usePanelBrowse, usePanelWidth, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceEvents, useResourceLoadingAnnouncements, useResources, useRovingTabIndex, useSearchAnnouncements, useSessionExpiry, useStoreTokenSync, useTheme, useToast, useTranslations, useYieldFlow };
+ * - For a `BehaviorSubject` (or anything with a `getValue()` method), returns
+ *   its current value synchronously at the first render. This matters for
+ *   callers that build derived objects in a `useState(factory)` initializer
+ *   at first render — they need the subject's value present immediately, not
+ *   after a second render triggered by the useEffect subscribe.
+ *
+ *   We duck-type on `.getValue` rather than using `instanceof BehaviorSubject`
+ *   because rxjs can be loaded through multiple module realms in tests (e.g.
+ *   a bundled CJS copy inside `@semiont/react-ui/dist` vs a fresh ESM import
+ *   in the test file), which makes `instanceof` unreliable.
+ * - For non-BehaviorSubject Observables, starts at `undefined` and emits
+ *   asynchronously after the subscribe.
+ * - Accepts `undefined`/`null` for cases where the observable's source isn't
+ *   ready yet (e.g. `semiont?.browse.events(rUri)` when the active session is
+ *   still loading). In that case the hook is a no-op and returns undefined.
+ * - Unsubscribes automatically on unmount or when `obs$` changes.
+ */
+declare function useObservable<T>(obs$: Observable<T> | null | undefined): T | undefined;
+
+export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminExchangePage, type AdminExchangePageProps, type AdminExchangePageTranslations, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, AssessmentEntry, AssessmentPanel, AssistSection, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, type AvailableLocale, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, ExportCard, type ExportCardProps, type ExportCardTranslations, Footer, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, ImageURLSchema, ImageViewer, ImportCard, type ImportCardProps, type ImportCardTranslations, ImportProgress, type ImportProgressProps, type ImportProgressTranslations, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LinkedDataPage, type LinkedDataPageProps, type LinkedDataPageTranslations, LiveRegionProvider, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, type OverlayAnnotation, PageLayout, PanelHeader, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, type ReferenceWizardModalProps, ReferencesPanel, ResizeHandle, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, SemiontProvider, type SemiontProviderProps, type SemiontResource$2 as SemiontResource, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WebBrowserStorage, WelcomePage, type WelcomePageProps, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, cssVariables, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionExpiry, useShellVM, useTheme, useToast, useTranslations, useViewModel };