@semiont/core 0.5.17 → 0.5.18

package/dist/index.d.ts

@@ -1693,22 +1693,6 @@ interface components {
                 updatedAt: string;
             };
         };
-        AdminUsersListResponse: {
-            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;
-            }[];
-        };
         AdminUserStatsResponse: {
             success: boolean;
             stats: {
@@ -1728,6 +1712,22 @@ interface components {
                 }[];
             };
         };
+        AdminUsersListResponse: {
+            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;
+            }[];
+        };
         /** @description Web Annotation / W3C PROV Agent. Discriminated by @type — Person, Organization, or Software. Each branch carries fields appropriate to its kind. Software peers are first-class participants, not a sub-class of Person. */
         Agent: ({
             /** @constant */
@@ -1803,8 +1803,19 @@ interface components {
             /** @description PROV-O wasAttributedTo — all parties responsible for this annotation. For human-prompted AI work this combines `creator` (the Person) and `generator` (the Software). For purely manual annotations it equals `[creator]`; for autonomous-agent work it equals `[generator]` (and `creator` may be the same Software). */
             wasAttributedTo?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
         };
+        /** @description Payload for mark:added domain event */
+        AnnotationAddedPayload: {
+            annotation: components["schemas"]["Annotation"];
+            /** @description SHA-256 of resource content at annotation time */
+            contentChecksum?: string;
+        };
         /** @description Phase 2: Body can be TextualBody (for entity tags, descriptions) or SpecificResource (for links) */
         AnnotationBody: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
+        /** @description Payload for mark:body-updated domain event */
+        AnnotationBodyUpdatedPayload: {
+            annotationId: string;
+            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
+        };
         AnnotationContextResponse: {
             annotation: components["schemas"]["Annotation"];
             context: {
@@ -1814,6 +1825,10 @@ interface components {
             };
             resource: components["schemas"]["ResourceDescriptor"];
         };
+        /** @description Payload for mark:removed domain event */
+        AnnotationRemovedPayload: {
+            annotationId: string;
+        };
         /** @description W3C Web Annotation target object - source is required, selector is optional */
         AnnotationTarget: {
             /** @description IRI of the resource being annotated */
@@ -1837,96 +1852,59 @@ interface components {
             refreshToken: string;
             isNewUser: boolean;
         };
-        BrowseFilesResponse: {
-            /** @description The directory path that was listed, relative to project root */
-            path: string;
-            entries: components["schemas"]["DirectoryEntry"][];
-        };
-        /** @description Emit an event on the Semiont bus. Channel names come from bus-protocol.ts; payload shape is validated against the channel's registered schema (CHANNEL_SCHEMAS). An optional scope routes resource-scoped broadcasts (e.g. mark:added, job:complete) to per-resource subscribers via eventBus.scope(scope); leave it unset for unscoped/global events. */
-        BusEmitRequest: {
-            /** @description Channel name from bus-protocol.ts EventMap */
-            channel: string;
-            /** @description Channel-specific payload, validated against CHANNEL_SCHEMAS */
-            payload: {
-                [key: string]: unknown;
-            };
-            /** @description Optional resource scope for broadcast channels (e.g. resourceId). Publishers only — frontends must never set this. */
-            scope?: string;
-        };
-        /** @description User's cookie consent preferences. `necessary` is always true — necessary cookies cannot be disabled. Timestamps and version are stamped server-side. */
-        CookieConsent: {
-            /** @enum {boolean} */
-            necessary: true;
-            analytics: boolean;
-            marketing: boolean;
-            preferences: boolean;
-            /** Format: date-time */
-            timestamp: string;
-            version: string;
+        /** @description Emitted when an annotation receives focus for beckoning */
+        BeckonFocusEvent: {
+            annotationId?: string;
+            resourceId?: string;
         };
-        /** @description Request body for POST /api/cookies/consent. All four preference fields must be booleans; `necessary` must be true. */
-        CookieConsentRequest: {
-            /** @enum {boolean} */
-            necessary: true;
-            analytics: boolean;
-            marketing: boolean;
-            preferences: boolean;
+        /** @description Emitted when an annotation is hovered over for beckoning */
+        BeckonHoverEvent: {
+            annotationId: string | null;
         };
-        /** @description Standard envelope for cookie consent endpoints. On success `success: true` and `consent` carries the current preferences; on error `success: false` and `error` carries a human-readable message. */
-        CookieConsentResponse: {
-            success: boolean;
-            consent?: components["schemas"]["CookieConsent"];
-            error?: string;
+        /** @description Emitted when a sparkle effect is triggered on an annotation */
+        BeckonSparkleEvent: {
+            annotationId: string;
         };
-        /** @description GDPR data export of a user's cookie-related data. The response is returned as a file download (Content-Disposition: attachment). */
-        CookieExportResponse: {
-            user: {
-                id: string;
-                email: string;
-            };
-            consent: components["schemas"]["CookieConsent"];
-            /** Format: date-time */
-            exportDate: string;
-            dataRetentionPolicy: string;
+        /** @description Void success reply emitted on the bind:body-updated channel after bind:update-body has been applied, matched to the originating command by correlationId. */
+        BindBodyUpdated: {
+            /** @description Correlation id echoed from the originating bind:update-body command so busRequest can match the reply. */
+            correlationId: string;
         };
-        DirectoryEntry: components["schemas"]["FileEntry"] | components["schemas"]["DirEntry"];
-        FileEntry: {
-            /** @enum {string} */
-            type: "file";
-            /** @description Entry name (basename) */
-            name: string;
-            /** @description Path relative to project root */
-            path: string;
-            /** @description File size in bytes */
-            size: number;
-            /**
-             * Format: date-time
-             * @description Last modified time (ISO 8601)
-             */
-            mtime: string;
-            /** @description True if this file is a tracked resource in the Knowledge Base */
-            tracked: boolean;
-            /** @description Resource ID (only when tracked is true) */
-            resourceId?: string;
-            /** @description Entity types assigned to this resource (only when tracked is true) */
-            entityTypes?: string[];
-            /** @description Number of annotations on this resource (only when tracked is true) */
-            annotationCount?: number;
-            /** @description DID of the user who created the resource (only when tracked is true) */
-            creator?: string;
+        /** @description Command payload sent on the bind:initiate bus channel to start a bind flow. */
+        BindInitiateCommand: {
+            /** @description Branded AnnotationId of the annotation being bound */
+            annotationId: string;
+            /** @description Branded ResourceId of the resource being bound to */
+            resourceId: string;
+            /** @description Default title for the bound annotation */
+            defaultTitle: string;
+            /** @description Entity types to associate with the annotation */
+            entityTypes: string[];
         };
-        DirEntry: {
-            /** @enum {string} */
-            type: "dir";
-            /** @description Entry name (basename) */
-            name: string;
-            /** @description Path relative to project root */
-            path: string;
-            /**
-             * Format: date-time
-             * @description Last modified time (ISO 8601)
-             */
-            mtime: string;
+        /** @description Command payload sent on the bind:update-body bus channel to modify annotation bodies. */
+        BindUpdateBodyCommand: {
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+            /** @description Client-supplied id used to match this command to its result event(s) on the events-stream. Generated by the route handler if absent. */
+            correlationId: string;
+            /** @description Branded AnnotationId of the annotation whose body is being updated */
+            annotationId: string;
+            /** @description Branded ResourceId of the resource the annotation belongs to */
+            resourceId: string;
+            /** @description List of body mutation operations to apply */
+            operations: {
+                /**
+                 * @description The type of body operation
+                 * @enum {string}
+                 */
+                op: "add" | "remove" | "replace";
+                /** @description Body item for add operations */
+                item?: components["schemas"]["AnnotationBody"];
+                /** @description Previous body item for replace operations */
+                oldItem?: components["schemas"]["AnnotationBody"];
+                /** @description Replacement body item for replace operations */
+                newItem?: components["schemas"]["AnnotationBody"];
+            }[];
         };
         BodyOperationAdd: {
             /** @enum {string} */
@@ -1944,731 +1922,38 @@ interface components {
             oldItem: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
             newItem: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
         };
-        CloneResourceWithTokenResponse: {
-            /** @description Generated clone token */
-            token: string;
-            /** @description ISO 8601 timestamp when token expires */
-            expiresAt: string;
-            resource: components["schemas"]["ResourceDescriptor"];
-        };
-        /** @description Error response for failed bus commands. Replaces native Error objects on the EventBus so payloads are serializable and OpenAPI-typed. */
-        CommandError: {
-            /** @description Optional correlation id echoed from the originating command. When present, the failure event can be matched back to the specific command that failed. */
-            correlationId?: string;
-            /** @description Human-readable error message */
-            message: string;
-            /** @description Optional additional context (stack trace, field name, etc.) */
-            details?: string;
-        };
-        /**
-         * @description Content format as a MIME type, optionally with parameters. The base type (everything before the first ';') MUST be a SupportedMediaType; parameters such as charset are preserved as metadata. Semantic validation happens in code at the create/yield boundary — there is deliberately no pattern here, the vocabulary lives in SupportedMediaType. Examples: text/plain, text/plain; charset=iso-8859-1, text/markdown; charset=windows-1252, image/png, application/pdf
-         * @example text/plain; charset=utf-8
-         */
-        ContentFormat: string;
         /**
-         * @description Base MIME types (no parameters) admitted by Semiont. Membership is the create/yield gate — every member is storable, nameable, and uploadable. What more the system can do with a type (render, annotate, extract text, author) is curated per type in @semiont/core's media-type registry, which is keyed by this enum.
+         * @description W3C Web Annotation body purpose vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation
          * @enum {string}
          */
-        SupportedMediaType: "text/plain" | "text/markdown" | "text/html" | "text/css" | "text/csv" | "text/xml" | "application/json" | "application/xml" | "application/yaml" | "application/x-yaml" | "application/pdf" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/zip" | "application/gzip" | "application/x-tar" | "application/x-7z-compressed" | "application/octet-stream" | "application/wasm" | "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/svg+xml" | "image/bmp" | "image/tiff" | "image/x-icon" | "video/mp4" | "video/mpeg" | "video/webm" | "video/ogg" | "video/quicktime" | "video/x-msvideo" | "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/webm" | "audio/aac" | "audio/flac" | "text/javascript" | "application/javascript" | "text/x-typescript" | "application/typescript" | "text/x-python" | "text/x-java" | "text/x-c" | "text/x-c++" | "text/x-csharp" | "text/x-go" | "text/x-rust" | "text/x-ruby" | "text/x-php" | "text/x-swift" | "text/x-kotlin" | "text/x-shell" | "font/woff" | "font/woff2" | "font/ttf" | "font/otf";
-        ContextualSummaryResponse: {
-            summary: string;
-            relevantFields: {
-                [key: string]: unknown;
-            };
-            context: {
-                before?: string;
-                selected: string;
-                after?: string;
-            };
+        BodyPurpose: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
+        /** @description Request to browse the KB's collaborator directory (its declared Agents) */
+        BrowseAgentsRequest: {
+            correlationId: string;
         };
-        CreateAnnotationRequest: {
-            motivation: components["schemas"]["Motivation"];
-            target: components["schemas"]["AnnotationTarget"];
-            /** @description Optional body. Omit for annotations whose motivation alone is meaningful (highlighting) or whose user-supplied content is empty. Shape matches Annotation.body. */
-            body?: components["schemas"]["AnnotationBody"] | components["schemas"]["AnnotationBody"][];
+        /** @description Result of browsing the collaborator directory */
+        BrowseAgentsResult: {
+            correlationId: string;
+            response: {
+                agents: components["schemas"]["CollaboratorEntry"][];
+            };
         };
-        /** @description Response body for POST /resources (202 Accepted). Resource creation is asynchronous — the backend writes content to disk, emits yield:create on the bus, and returns the newly-minted resourceId immediately. Consumers watch SSE domain events (yield:created) to observe the fully-persisted state. */
-        CreateResourceResponse: {
-            /** @description The id of the newly-created resource. Assigned by Stower when it persists yield:create. */
+        /** @description Request to get contextual text around an annotation */
+        BrowseAnnotationContextRequest: {
+            correlationId: string;
+            annotationId: string;
             resourceId: string;
+            contextBefore?: number;
+            contextAfter?: number;
         };
-        DeleteUserResponse: {
-            success: boolean;
-            message: string;
-        };
-        /** @description Progress payload emitted on the gather:annotation-progress SSE channel during LLM context gathering. */
-        GatherProgress: {
-            message?: string;
-            percentage?: number;
+        /** @description Request to browse the history of an annotation */
+        BrowseAnnotationHistoryRequest: {
+            correlationId: string;
+            resourceId: string;
+            annotationId: string;
         };
-        /** @description Search results payload emitted on match:search-results SSE channel. */
-        MatchSearchResult: {
-            correlationId: string;
-            referenceId: string;
-            response: (components["schemas"]["ResourceDescriptor"] & {
-                /** @description Relevance score */
-                score?: number;
-                /** @description Human-readable reason for the match */
-                matchReason?: string;
-            })[];
-        };
-        /** @description Error payload emitted on match:search-failed SSE channel. */
-        MatchSearchFailed: {
-            correlationId: string;
-            referenceId: string;
-            error: string;
-        };
-        /** @description Metadata added at persistence time. Part of every StoredEvent. Integrity is provided by git at the commit level (when gitSync is enabled), not by in-event metadata fields. */
-        EventMetadata: {
-            /** @description Monotonic position in the event log (ordering authority) */
-            sequenceNumber: number;
-            /** @description Optional correlation id propagated from a command. Lets clients match command-result events back to the POST that initiated them. Set by EventStore.appendEvent's options when a route handler passes one through. */
-            correlationId?: string;
-        };
-        /** @description Selection data for user-initiated annotations. Captures the text range and optional selector information from a user's highlight in the UI. */
-        SelectionData: {
-            /** @description The exact selected text */
-            exact: string;
-            /** @description Start character offset */
-            start: number;
-            /** @description End character offset */
-            end: number;
-            /** @description SVG selector for non-text selections (e.g. PDF regions) */
-            svgSelector?: string;
-            /** @description Fragment selector (e.g. page=2) */
-            fragmentSelector?: string;
-            /** @description Specification the fragment selector conforms to */
-            conformsTo?: string;
-            /** @description Text before the selection (for disambiguation) */
-            prefix?: string;
-            /** @description Text after the selection (for disambiguation) */
-            suffix?: string;
-        };
-        /** @description A persisted domain event with metadata. Flat shape — event fields and metadata are peers. */
-        StoredEventResponse: {
-            /** @description Unique event ID (UUID) */
-            id: string;
-            /** @description Event type (flow verb name, e.g. mark:added) */
-            type: string;
-            /**
-             * Format: date-time
-             * @description When the event occurred
-             */
-            timestamp: string;
-            /** @description DID of the user who triggered the event */
-            userId: string;
-            /** @description Resource this event affects (absent for system events) */
-            resourceId?: string;
-            /** @description Event schema version */
-            version: number;
-            /** @description Event-type-specific payload */
-            payload: {
-                [key: string]: unknown;
-            };
-            metadata: components["schemas"]["EventMetadata"];
-        };
-        /** @description Wire format emitted by GET /resources/:id/events/stream. Extends StoredEventResponse with optional enrichment fields populated from the materialized view at SSE-write time. Subscribers can read the enrichment fields directly to update local caches without an additional fetch. */
-        EnrichedResourceEvent: components["schemas"]["StoredEventResponse"] & {
-            /** @description Populated for events that mutate an annotation (mark:added, mark:body-updated, mark:removed). Carries the post-materialization annotation as it exists in the view, so subscribers can update local caches in-place without refetching. Absent for events that don't touch annotations. */
-            annotation?: components["schemas"]["Annotation"];
-        };
-        /** @description Payload for yield:created domain event */
-        ResourceCreatedPayload: {
-            name: string;
-            format: components["schemas"]["ContentFormat"];
-            /** @description SHA-256 of content */
-            contentChecksum: string;
-            contentByteSize?: number;
-            entityTypes?: string[];
-            /** @description Working-tree URI (e.g. file://docs/overview.md) */
-            storageUri?: string;
-            language?: string;
-            isDraft?: boolean;
-            generatedFrom?: {
-                resourceId: string;
-                annotationId: string;
-            };
-            generationPrompt?: string;
-            generator?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
-        };
-        /** @description Payload for yield:cloned domain event */
-        ResourceClonedPayload: {
-            name: string;
-            format: components["schemas"]["ContentFormat"];
-            contentChecksum: string;
-            contentByteSize?: number;
-            parentResourceId: string;
-            entityTypes?: string[];
-            language?: string;
-        };
-        /** @description Payload for yield:updated domain event */
-        ResourceUpdatedPayload: {
-            /** @description SHA-256 of new content */
-            contentChecksum: string;
-            contentByteSize?: number;
-        };
-        /** @description Payload for yield:moved domain event */
-        ResourceMovedPayload: {
-            /** @description Previous file:// URI */
-            fromUri: string;
-            /** @description New file:// URI */
-            toUri: string;
-        };
-        /** @description Payload for mark:archived domain event */
-        ResourceArchivedPayload: {
-            reason?: string;
-        };
-        /** @description Payload for mark:unarchived domain event (empty payload) */
-        ResourceUnarchivedPayload: Record<string, never>;
-        /** @description Payload for yield:representation-added domain event */
-        RepresentationAddedPayload: {
-            representation: components["schemas"]["Representation"];
-        };
-        /** @description Payload for yield:representation-removed domain event */
-        RepresentationRemovedPayload: {
-            /** @description Checksum of the representation to remove */
-            checksum: string;
-        };
-        /** @description Payload for mark:added domain event */
-        AnnotationAddedPayload: {
-            annotation: components["schemas"]["Annotation"];
-            /** @description SHA-256 of resource content at annotation time */
-            contentChecksum?: string;
-        };
-        /** @description Payload for mark:removed domain event */
-        AnnotationRemovedPayload: {
-            annotationId: string;
-        };
-        /** @description Payload for mark:body-updated domain event */
-        AnnotationBodyUpdatedPayload: {
-            annotationId: string;
-            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
-        };
-        /** @description Payload for frame:entity-type-added domain event (system-level, no resourceId — fan-out is global) */
-        EntityTypeAddedPayload: {
-            entityType: string;
-        };
-        /** @description Payload for frame:tag-schema-added domain event (system-level, no resourceId — fan-out is global to the KB). */
-        TagSchemaAddedPayload: {
-            schema: components["schemas"]["TagSchema"];
-        };
-        /** @description Payload for mark:entity-tag-added and mark:entity-tag-removed domain events */
-        EntityTagChangedPayload: {
-            entityType: string;
-        };
-        /**
-         * @description Type of background job
-         * @enum {string}
-         */
-        JobType: "reference-annotation" | "generation" | "highlight-annotation" | "assessment-annotation" | "comment-annotation" | "tag-annotation";
-        /** @description Payload for job:started domain event */
-        JobStartedPayload: {
-            jobId: string;
-            jobType: components["schemas"]["JobType"];
-            /** @description Annotation this job is attached to, when applicable */
-            annotationId?: string;
-            totalSteps?: number;
-        };
-        /** @description Payload for job:progress domain event */
-        JobProgressPayload: {
-            jobId: string;
-            jobType: components["schemas"]["JobType"];
-            percentage: number;
-            /** @description Human-readable current step */
-            currentStep?: string;
-            processedSteps?: number;
-            totalSteps?: number;
-            /** @description For detection: entities found so far */
-            foundCount?: number;
-            message?: string;
-            /** @description Full progress object for extensibility */
-            progress?: {
-                [key: string]: unknown;
-            };
-        };
-        /** @description Payload for job:completed domain event */
-        JobCompletedPayload: {
-            jobId: string;
-            jobType: components["schemas"]["JobType"];
-            /** @description Annotation this job was attached to, when applicable */
-            annotationId?: string;
-            totalSteps?: number;
-            /** @description For detection: total entities found */
-            foundCount?: number;
-            /** @description For generation: ID of generated resource */
-            resultResourceId?: string;
-            /** @description For generation: URI of annotation that triggered generation */
-            annotationUri?: string;
-            message?: string;
-            /** @description Full result object for extensibility */
-            result?: {
-                [key: string]: unknown;
-            };
-        };
-        /** @description Payload for job:failed domain event */
-        JobFailedPayload: {
-            jobId: string;
-            jobType: components["schemas"]["JobType"];
-            /** @description Annotation this job was attached to, when applicable */
-            annotationId?: string;
-            error: string;
-            details?: string;
-        };
-        ErrorResponse: {
-            error: string;
-            code?: string;
-            details?: unknown;
-        };
-        EventStreamResponse: {
-            event: string;
-            data: string;
-            id?: string;
-        };
-        GetAnnotationHistoryResponse: {
-            events: components["schemas"]["StoredEventResponse"][];
-            total: number;
-            annotationId: string;
-            resourceId: string;
-        };
-        GetAnnotationResponse: {
-            annotation: components["schemas"]["Annotation"];
-            resource: components["schemas"]["ResourceDescriptor"] | null;
-            resolvedResource: components["schemas"]["ResourceDescriptor"] | null;
-        };
-        GetAnnotationsResponse: {
-            annotations: components["schemas"]["Annotation"][];
-            /** @description Total number of annotations */
-            total: number;
-            /** @description Motivation filter applied (if any) */
-            motivation?: components["schemas"]["Motivation"] | null;
-        };
-        GetEntityTypesResponse: {
-            entityTypes: string[];
-        };
-        GetEventsResponse: {
-            events: components["schemas"]["StoredEventResponse"][];
-            total: number;
-            resourceId: string;
-        };
-        GetReferencedByResponse: {
-            referencedBy: {
-                /** @description Reference annotation ID */
-                id: string;
-                /** @description Name of resource containing the reference */
-                resourceName: string;
-                target: {
-                    /** @description ID of resource containing the reference */
-                    source: string;
-                    selector: {
-                        /** @description The selected text that references this resource */
-                        exact: string;
-                    };
-                };
-            }[];
-        };
-        GetResourceByTokenResponse: {
-            sourceResource: components["schemas"]["ResourceDescriptor"];
-            /** @description ISO 8601 timestamp when token expires */
-            expiresAt: string;
-        };
-        GetResourceResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            /** @description All annotations for the resource (highlights, references, assessments, etc.) */
-            annotations: components["schemas"]["Annotation"][];
-            /** @description Annotations that reference this resource from other resources */
-            entityReferences: components["schemas"]["Annotation"][];
-        };
-        GetTagSchemasResponse: {
-            tagSchemas: components["schemas"]["TagSchema"][];
-        };
-        GoogleAuthRequest: {
-            access_token: string;
-        };
-        HealthResponse: {
-            status: string;
-            message: string;
-            version: string;
-            timestamp: string;
-            /** @enum {string} */
-            database: "connected" | "disconnected" | "unknown";
-            environment: string;
-        };
-        JobStatusResponse: {
-            jobId: string;
-            type: components["schemas"]["JobType"];
-            /** @enum {string} */
-            status: "pending" | "running" | "complete" | "failed" | "cancelled";
-            userId: string;
-            created: string;
-            startedAt?: string;
-            completedAt?: string;
-            error?: string;
-            progress?: unknown;
-            result?: unknown;
-        };
-        /** @description Knowledge graph gathered for an LLM context — a shared backbone in which resources AND annotations are typed nodes, connected by typed (optionally bidirectional) edges. Flattened views the matcher/generation read (connections, citedBy, siblings) are derived from these nodes/edges. */
-        KnowledgeGraph: {
-            nodes: {
-                /** @description Node identifier — a ResourceId or AnnotationId */
-                id: string;
-                /**
-                 * @description Whether this node is a resource or an annotation
-                 * @enum {string}
-                 */
-                type: "resource" | "annotation";
-                label: string;
-                /** @description Entity types on the node (resources) or carried by the annotation */
-                entityTypes?: string[];
-                metadata?: {
-                    [key: string]: unknown;
-                };
-            }[];
-            edges: {
-                source: string;
-                target: string;
-                /** @description Edge kind (e.g. citation, annotation-of, sibling) */
-                type: string;
-                /** @description Whether the connection goes both ways */
-                bidirectional?: boolean;
-                metadata?: {
-                    [key: string]: unknown;
-                };
-            }[];
-        };
-        ListResourcesResponse: {
-            resources: components["schemas"]["ResourceDescriptor"][];
-            total: number;
-            offset: number;
-            limit: number;
-        };
-        PasswordAuthRequest: {
-            /**
-             * Format: email
-             * @description User email address
-             */
-            email: string;
-            /** @description User password (minimum 8 characters) */
-            password: string;
-        };
-        /**
-         * @description Semiont-supported W3C Web Annotation motivations - https://www.w3.org/TR/annotation-vocab/#motivation
-         * @enum {string}
-         */
-        Motivation: "assessing" | "commenting" | "highlighting" | "linking" | "tagging";
-        OAuthConfigResponse: {
-            providers: {
-                name: string;
-                isConfigured: boolean;
-                clientId: string;
-            }[];
-            allowedDomains: string[];
-        };
-        /** @description A specific, byte-addressable rendition of a resource (file/asset/variant). */
-        Representation: {
-            /**
-             * Format: uri
-             * @description Stable ID for this representation.
-             */
-            "@id"?: string;
-            /** @description Type(s), e.g., schema:MediaObject. */
-            "@type"?: string | string[];
-            /** @description MIME/media type (e.g., text/markdown, image/png). */
-            mediaType: string;
-            /** @description Working-tree URI identifying where the bytes live. Only file:// is supported (e.g. file://docs/overview.md). */
-            storageUri?: string;
-            filename?: string;
-            /** @description Size of the payload in bytes. */
-            byteSize?: number;
-            /** @description Integrity hash (e.g., sha256:abcd…). */
-            checksum?: string;
-            /** @description Compression/transfer encoding if applicable. */
-            encoding?: string;
-            /** @description IETF BCP 47 language tag (e.g., en, es-ES). */
-            language?: string;
-            /** @description Pixels (images/video). */
-            width?: number;
-            /** @description Pixels (images/video). */
-            height?: number;
-            /** @description Seconds (audio/video). */
-            duration?: number;
-            /** Format: date-time */
-            created?: string;
-            /** Format: date-time */
-            modified?: string;
-            /** @description Profile/shape the bytes conform to (e.g., a JSON profile or SVG profile). */
-            conformsTo?: string | string[];
-            tags?: string[];
-            /**
-             * @description Semantics of this rendition relative to the resource (e.g., original, thumbnail, preview, derived).
-             * @enum {string}
-             */
-            rel?: "original" | "thumbnail" | "preview" | "optimized" | "derived" | "other";
-        } & {
-            [key: string]: unknown;
-        };
-        /** @description Metadata about a resource (1:1 with its URI). JSON-LD subject is @id. Link to concrete bytes via representations. */
-        ResourceDescriptor: {
-            /** @description JSON-LD context; URI, object, or array of these. */
-            "@context": string | {
-                [key: string]: unknown;
-            } | (string | {
-                [key: string]: unknown;
-            })[];
-            /** @description Canonical URI/URN of the resource being described. */
-            "@id": string;
-            /** @description Type(s) of the resource (IRIs/CURIEs via @context). */
-            "@type"?: string | string[];
-            name: string;
-            description?: string;
-            /** @description Persistent identifiers (e.g., DOI, URN). */
-            identifier?: string | string[] | ({
-                /** Format: uri */
-                "@id"?: string;
-                value?: string;
-                scheme?: string;
-            } & {
-                [key: string]: unknown;
-            });
-            /** @description Topics (IRIs or strings). */
-            about?: string | string[];
-            /** @description Equivalent/authoritative references. */
-            sameAs?: string[];
-            isPartOf?: string[];
-            hasPart?: string[];
-            /** Format: uri */
-            license?: string;
-            version?: string;
-            /** Format: date-time */
-            dateCreated?: string;
-            /** Format: date-time */
-            dateModified?: string;
-            /** @description W3C PROV - source resources this was derived from */
-            wasDerivedFrom?: string | string[];
-            /** @description W3C PROV - agents responsible for this resource */
-            wasAttributedTo?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
-            /** @description Software agent that produced or processed this resource (W3C Web Annotation model) */
-            generator?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
-            /** @description Profile/shape URI this resource description conforms to. */
-            conformsTo?: string | string[];
-            /** @description Convenience set summarizing media types across representations. */
-            availableFormats?: string[];
-            /** @description Managed or referenced byte-level renditions of this resource. */
-            representations: components["schemas"]["Representation"] | components["schemas"]["Representation"][];
-            /** @description Application-specific: Whether this resource is archived */
-            archived?: boolean;
-            /** @description Application-specific: Entity types for this resource */
-            entityTypes?: string[];
-            /** @description Application-specific: Whether this resource is a draft */
-            isDraft?: boolean;
-            /** @description Application-specific: ID of annotation that triggered generation */
-            sourceAnnotationId?: string;
-            /** @description Application-specific: ID of source resource for clones/derivatives */
-            sourceResourceId?: string;
-            /**
-             * Format: uri
-             * @description Original URI from a source knowledge base when this resource was imported
-             */
-            originatedFrom?: string;
-            /** @description Working-tree URI for this resource (e.g. file://docs/overview.md). Stable across updates and moves. */
-            storageUri?: string;
-            /** @description SHA-256 hex hash of the current content. Updated on resource.created, resource.updated, resource.cloned events. */
-            currentChecksum?: string;
-        } & {
-            [key: string]: unknown;
-        };
-        SemanticMatch: {
-            /** @description The chunk text that matched */
-            text: string;
-            /** @description Source resource ID */
-            resourceId: string;
-            /** @description Source annotation ID, if the match is from an annotation */
-            annotationId?: string;
-            /** @description Cosine similarity score (0-1) */
-            score: number;
-            /** @description Entity types on the matched passage */
-            entityTypes?: string[];
-        };
-        SpecificResource: {
-            /** @enum {string} */
-            type: "SpecificResource";
-            /** @description IRI of the target resource */
-            source: string;
-            /** @description Why this body is included */
-            purpose?: components["schemas"]["BodyPurpose"];
-        };
-        StatusResponse: {
-            status: string;
-            version: string;
-            features: {
-                semanticContent: string;
-                collaboration: string;
-                rbac: string;
-            };
-            message: string;
-            authenticatedAs?: string;
-            /** @description Name of the knowledge base project */
-            projectName?: string;
-            /** @description Current git branch of the knowledge base repository */
-            gitBranch?: string;
-        };
-        TextPositionSelector: {
-            /** @enum {string} */
-            type: "TextPositionSelector";
-            /** @description Character offset from resource start */
-            start: number;
-            /** @description Character offset from resource start */
-            end: number;
-        };
-        TextQuoteSelector: {
-            /** @enum {string} */
-            type: "TextQuoteSelector";
-            exact: string;
-            prefix?: string;
-            suffix?: string;
-        };
-        TextualBody: {
-            /** @enum {string} */
-            type: "TextualBody";
-            /** @description The text content (e.g., entity type name) */
-            value: string;
-            /** @description Why this body is included */
-            purpose?: components["schemas"]["BodyPurpose"];
-            /** @description MIME type (defaults to text/plain) */
-            format?: string;
-            /** @description BCP 47 language tag */
-            language?: string;
-        };
-        TokenRefreshRequest: {
-            /**
-             * @description Refresh token obtained during login
-             * @example eyJhbGciOiJIUzI1NiIs...
-             */
-            refreshToken: string;
-        };
-        TokenRefreshResponse: {
-            access_token: string;
-        };
-        UpdateAnnotationBodyRequest: {
-            /** @description Resource ID containing the annotation (required for O(1) Layer 3 lookup) */
-            resourceId: string;
-            /** @description Array of body modification operations to apply */
-            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
-        };
-        UpdateUserRequest: {
-            isAdmin?: boolean;
-            isActive?: boolean;
-            name?: string;
-        };
-        UpdateUserResponse: {
-            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;
-            };
-        };
-        UserResponse: {
-            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;
-            /** @description The validated JWT token string for the current session */
-            token: string;
-        };
-        /** @description Emitted when an annotation receives focus for beckoning */
-        BeckonFocusEvent: {
-            annotationId?: string;
-            resourceId?: string;
-        };
-        /** @description Emitted when an annotation is hovered over for beckoning */
-        BeckonHoverEvent: {
-            annotationId: string | null;
-        };
-        /** @description Emitted when a sparkle effect is triggered on an annotation */
-        BeckonSparkleEvent: {
-            annotationId: string;
-        };
-        /** @description Void success reply emitted on the bind:body-updated channel after bind:update-body has been applied, matched to the originating command by correlationId. */
-        BindBodyUpdated: {
-            /** @description Correlation id echoed from the originating bind:update-body command so busRequest can match the reply. */
-            correlationId: string;
-        };
-        /** @description Command payload sent on the bind:initiate bus channel to start a bind flow. */
-        BindInitiateCommand: {
-            /** @description Branded AnnotationId of the annotation being bound */
-            annotationId: string;
-            /** @description Branded ResourceId of the resource being bound to */
-            resourceId: string;
-            /** @description Default title for the bound annotation */
-            defaultTitle: string;
-            /** @description Entity types to associate with the annotation */
-            entityTypes: string[];
-        };
-        /** @description Command payload sent on the bind:update-body bus channel to modify annotation bodies. */
-        BindUpdateBodyCommand: {
-            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
-            _userId?: string;
-            /** @description Client-supplied id used to match this command to its result event(s) on the events-stream. Generated by the route handler if absent. */
-            correlationId: string;
-            /** @description Branded AnnotationId of the annotation whose body is being updated */
-            annotationId: string;
-            /** @description Branded ResourceId of the resource the annotation belongs to */
-            resourceId: string;
-            /** @description List of body mutation operations to apply */
-            operations: {
-                /**
-                 * @description The type of body operation
-                 * @enum {string}
-                 */
-                op: "add" | "remove" | "replace";
-                /** @description Body item for add operations */
-                item?: components["schemas"]["AnnotationBody"];
-                /** @description Previous body item for replace operations */
-                oldItem?: components["schemas"]["AnnotationBody"];
-                /** @description Replacement body item for replace operations */
-                newItem?: components["schemas"]["AnnotationBody"];
-            }[];
-        };
-        /**
-         * @description W3C Web Annotation body purpose vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation
-         * @enum {string}
-         */
-        BodyPurpose: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
-        /** @description Request to browse the KB's collaborator directory (its declared Agents) */
-        BrowseAgentsRequest: {
-            correlationId: string;
-        };
-        /** @description Result of browsing the collaborator directory */
-        BrowseAgentsResult: {
-            correlationId: string;
-            response: {
-                agents: components["schemas"]["CollaboratorEntry"][];
-            };
-        };
-        /** @description Request to browse the history of an annotation */
-        BrowseAnnotationHistoryRequest: {
-            correlationId: string;
-            resourceId: string;
-            annotationId: string;
-        };
-        /** @description Result of browsing annotation history */
-        BrowseAnnotationHistoryResult: {
+        /** @description Result of browsing annotation history */
+        BrowseAnnotationHistoryResult: {
             correlationId: string;
             response: components["schemas"]["GetAnnotationHistoryResponse"];
         };
@@ -2683,14 +1968,6 @@ interface components {
             correlationId: string;
             response: components["schemas"]["GetAnnotationResponse"];
         };
-        /** @description Request to get contextual text around an annotation */
-        BrowseAnnotationContextRequest: {
-            correlationId: string;
-            annotationId: string;
-            resourceId: string;
-            contextBefore?: number;
-            contextAfter?: number;
-        };
         /** @description Request to browse annotations for a resource */
         BrowseAnnotationsRequest: {
             correlationId: string;
@@ -2752,6 +2029,11 @@ interface components {
             url: string;
             resourceId?: string;
         };
+        BrowseFilesResponse: {
+            /** @description The directory path that was listed, relative to project root */
+            path: string;
+            entries: components["schemas"]["DirectoryEntry"][];
+        };
         /** @description Emitted when a link is clicked in the browse panel */
         BrowseLinkClickedEvent: {
             href: string;
@@ -2767,6 +2049,10 @@ interface components {
         BrowsePanelToggleEvent: {
             panel: string;
         };
+        /** @description Emitted when navigation to a reference resource is requested */
+        BrowseReferenceNavigateEvent: {
+            resourceId: string;
+        };
         /** @description Request to browse annotations that reference a resource */
         BrowseReferencedByRequest: {
             correlationId: string;
@@ -2778,10 +2064,6 @@ interface components {
             correlationId: string;
             response: components["schemas"]["GetReferencedByResponse"];
         };
-        /** @description Emitted when navigation to a reference resource is requested */
-        BrowseReferenceNavigateEvent: {
-            resourceId: string;
-        };
         /** @description Emitted when a resource is closed in the browse panel */
         BrowseResourceCloseEvent: {
             resourceId: string;
@@ -2829,12 +2111,211 @@ interface components {
             correlationId: string;
             response: components["schemas"]["GetTagSchemasResponse"];
         };
+        /** @description Emit an event on the Semiont bus. Channel names come from bus-protocol.ts; payload shape is validated against the channel's registered schema (CHANNEL_SCHEMAS). An optional scope routes resource-scoped broadcasts (e.g. mark:added, job:complete) to per-resource subscribers via eventBus.scope(scope); leave it unset for unscoped/global events. */
+        BusEmitRequest: {
+            /** @description Channel name from bus-protocol.ts EventMap */
+            channel: string;
+            /** @description Channel-specific payload, validated against CHANNEL_SCHEMAS */
+            payload: {
+                [key: string]: unknown;
+            };
+            /** @description Optional resource scope for broadcast channels (e.g. resourceId). Publishers only — frontends must never set this. */
+            scope?: string;
+        };
+        CloneResourceWithTokenResponse: {
+            /** @description Generated clone token */
+            token: string;
+            /** @description ISO 8601 timestamp when token expires */
+            expiresAt: string;
+            resource: components["schemas"]["ResourceDescriptor"];
+        };
         /** @description One collaborator in the KB's directory: a W3C Agent plus, for software agents declared in the KB's worker inference config, the job types it serves. Actor-role-only agents (gatherer/matcher) and Persons omit servesJobTypes. */
         CollaboratorEntry: {
             agent: components["schemas"]["Agent"];
             /** @description Job types this agent is declared to serve (from the KB's workers.* config sections). Absent for Persons and for agents declared only under actor roles. */
             servesJobTypes?: components["schemas"]["JobType"][];
         };
+        /** @description Error response for failed bus commands. Replaces native Error objects on the EventBus so payloads are serializable and OpenAPI-typed. */
+        CommandError: {
+            /** @description Optional correlation id echoed from the originating command. When present, the failure event can be matched back to the specific command that failed. */
+            correlationId?: string;
+            /** @description Human-readable error message */
+            message: string;
+            /** @description Optional additional context (stack trace, field name, etc.) */
+            details?: string;
+        };
+        /**
+         * @description Content format as a MIME type, optionally with parameters. The base type (everything before the first ';') MUST be a SupportedMediaType; parameters such as charset are preserved as metadata. Semantic validation happens in code at the create/yield boundary — there is deliberately no pattern here, the vocabulary lives in SupportedMediaType. Examples: text/plain, text/plain; charset=iso-8859-1, text/markdown; charset=windows-1252, image/png, application/pdf
+         * @example text/plain; charset=utf-8
+         */
+        ContentFormat: string;
+        ContextualSummaryResponse: {
+            summary: string;
+            relevantFields: {
+                [key: string]: unknown;
+            };
+            context: {
+                before?: string;
+                selected: string;
+                after?: string;
+            };
+        };
+        /** @description User's cookie consent preferences. `necessary` is always true — necessary cookies cannot be disabled. Timestamps and version are stamped server-side. */
+        CookieConsent: {
+            /** @enum {boolean} */
+            necessary: true;
+            analytics: boolean;
+            marketing: boolean;
+            preferences: boolean;
+            /** Format: date-time */
+            timestamp: string;
+            version: string;
+        };
+        /** @description Request body for POST /api/cookies/consent. All four preference fields must be booleans; `necessary` must be true. */
+        CookieConsentRequest: {
+            /** @enum {boolean} */
+            necessary: true;
+            analytics: boolean;
+            marketing: boolean;
+            preferences: boolean;
+        };
+        /** @description Standard envelope for cookie consent endpoints. On success `success: true` and `consent` carries the current preferences; on error `success: false` and `error` carries a human-readable message. */
+        CookieConsentResponse: {
+            success: boolean;
+            consent?: components["schemas"]["CookieConsent"];
+            error?: string;
+        };
+        /** @description GDPR data export of a user's cookie-related data. The response is returned as a file download (Content-Disposition: attachment). */
+        CookieExportResponse: {
+            user: {
+                id: string;
+                email: string;
+            };
+            consent: components["schemas"]["CookieConsent"];
+            /** Format: date-time */
+            exportDate: string;
+            dataRetentionPolicy: string;
+        };
+        CreateAnnotationRequest: {
+            motivation: components["schemas"]["Motivation"];
+            target: components["schemas"]["AnnotationTarget"];
+            /** @description Optional body. Omit for annotations whose motivation alone is meaningful (highlighting) or whose user-supplied content is empty. Shape matches Annotation.body. */
+            body?: components["schemas"]["AnnotationBody"] | components["schemas"]["AnnotationBody"][];
+        };
+        /** @description Response body for POST /resources (202 Accepted). Resource creation is asynchronous — the backend writes content to disk, emits yield:create on the bus, and returns the newly-minted resourceId immediately. Consumers watch SSE domain events (yield:created) to observe the fully-persisted state. */
+        CreateResourceResponse: {
+            /** @description The id of the newly-created resource. Assigned by Stower when it persists yield:create. */
+            resourceId: string;
+        };
+        DeleteUserResponse: {
+            success: boolean;
+            message: string;
+        };
+        DirEntry: {
+            /** @enum {string} */
+            type: "dir";
+            /** @description Entry name (basename) */
+            name: string;
+            /** @description Path relative to project root */
+            path: string;
+            /**
+             * Format: date-time
+             * @description Last modified time (ISO 8601)
+             */
+            mtime: string;
+        };
+        DirectoryEntry: components["schemas"]["FileEntry"] | components["schemas"]["DirEntry"];
+        /**
+         * DiscoveredKB
+         * @description One knowledge base the Semiont launcher manages on this machine, as published in the discovery document (see DiscoveryDocument). Endpoints and identity only — never credentials; login remains the consumer's per-KB business.
+         */
+        DiscoveredKB: {
+            /** @description Hostname the KB is reachable on from this machine (today always "localhost" — local stacks bind locally and codespace KBs arrive through a local port forward) */
+            host: string;
+            /** @description Local TCP port of the KB's API (the backend port for a local stack; the allocated forward port for a codespace stack) */
+            port: number;
+            /**
+             * @description Where the stack actually runs. "local": containers on this machine. "codespace": a GitHub-hosted VM whose KB is port-forwarded here.
+             * @enum {string}
+             */
+            placement: "local" | "codespace";
+            /** @description owner/name GitHub slug — present for codespace placements, where the repo is the stack's identity */
+            repo?: string;
+            /** @description The KB's did:web identifier as recorded from its committed .semiont/config — the permanent identity stamped into its event log. Prefer this as a merge key: ports are reallocated across restarts; the did follows the KB. */
+            did?: string;
+            /** @description Human-readable site name from the KB's .semiont/config, for display */
+            siteName?: string;
+            /** @description The agent that owns this entry's lifecycle (the launcher writes "semiont-launcher"). Consumers treat managed entries as authoritative for themselves — upsert on appearance, remove on disappearance — and never touch entries they did not write. */
+            managedBy: string;
+        };
+        /**
+         * DiscoveryDocument
+         * @description The launcher's KB discovery document — the schema authority for <stateDir>/discovery/kbs.json, which the semiont launcher (Go, apps/launcher) regenerates on every stack mutation and the frontend container mounts read-only at /discovery. NOT an API endpoint: a static document fetched same-origin by browsers (via the frontend's static server) or read from disk by local Node consumers. An empty kbs list is meaningful ("the launcher manages nothing right now") and distinct from an absent file. Design record: .plans/BROWSER-KB-DISCOVERY.md.
+         */
+        DiscoveryDocument: {
+            /**
+             * @description Document schema version. Consumers MUST check it and ignore documents they do not understand.
+             * @enum {integer}
+             */
+            version: 1;
+            /** @description Every KB the launcher currently manages, local and forwarded */
+            kbs: components["schemas"]["DiscoveredKB"][];
+        };
+        /** @description Wire format emitted by GET /resources/:id/events/stream. Extends StoredEventResponse with optional enrichment fields populated from the materialized view at SSE-write time. Subscribers can read the enrichment fields directly to update local caches without an additional fetch. */
+        EnrichedResourceEvent: components["schemas"]["StoredEventResponse"] & {
+            /** @description Populated for events that mutate an annotation (mark:added, mark:body-updated, mark:removed). Carries the post-materialization annotation as it exists in the view, so subscribers can update local caches in-place without refetching. Absent for events that don't touch annotations. */
+            annotation?: components["schemas"]["Annotation"];
+        };
+        /** @description Payload for mark:entity-tag-added and mark:entity-tag-removed domain events */
+        EntityTagChangedPayload: {
+            entityType: string;
+        };
+        /** @description Payload for frame:entity-type-added domain event (system-level, no resourceId — fan-out is global) */
+        EntityTypeAddedPayload: {
+            entityType: string;
+        };
+        ErrorResponse: {
+            error: string;
+            code?: string;
+            details?: unknown;
+        };
+        /** @description Metadata added at persistence time. Part of every StoredEvent. Integrity is provided by git at the commit level (when gitSync is enabled), not by in-event metadata fields. */
+        EventMetadata: {
+            /** @description Monotonic position in the event log (ordering authority) */
+            sequenceNumber: number;
+            /** @description Optional correlation id propagated from a command. Lets clients match command-result events back to the POST that initiated them. Set by EventStore.appendEvent's options when a route handler passes one through. */
+            correlationId?: string;
+        };
+        EventStreamResponse: {
+            event: string;
+            data: string;
+            id?: string;
+        };
+        FileEntry: {
+            /** @enum {string} */
+            type: "file";
+            /** @description Entry name (basename) */
+            name: string;
+            /** @description Path relative to project root */
+            path: string;
+            /** @description File size in bytes */
+            size: number;
+            /**
+             * Format: date-time
+             * @description Last modified time (ISO 8601)
+             */
+            mtime: string;
+            /** @description True if this file is a tracked resource in the Knowledge Base */
+            tracked: boolean;
+            /** @description Resource ID (only when tracked is true) */
+            resourceId?: string;
+            /** @description Entity types assigned to this resource (only when tracked is true) */
+            entityTypes?: string[];
+            /** @description Number of annotations on this resource (only when tracked is true) */
+            annotationCount?: number;
+            /** @description DID of the user who created the resource (only when tracked is true) */
+            creator?: string;
+        };
         /** @description W3C Web Annotation FragmentSelector for media fragment identifiers (RFC 3778 for PDFs) */
         FragmentSelector: {
             /** @enum {string} */
@@ -2850,6 +2331,22 @@ interface components {
              */
             conformsTo?: string;
         };
+        /** @description Bus command to add a new entity type to the KB's vocabulary. Carried on the `frame:add-entity-type` channel — Frame is the schema-layer flow that owns vocabulary writes. */
+        FrameAddEntityTypeCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. Absent for in-process (bootstrap/replay/import) emits, which race the frame:entity-type-added domain event instead. */
+            correlationId?: string;
+            tag: string;
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+        };
+        /** @description Bus command to register a tag schema with the KB's runtime registry. Carried on the `frame:add-tag-schema` channel — Frame is the schema-layer flow that owns vocabulary writes. Most-recent registration of a given `schema.id` wins; the projection reflects the latest content. Identical re-registrations are silent; differing content overwrites and logs a warning. */
+        FrameAddTagSchemaCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. Absent for in-process emits. */
+            correlationId?: string;
+            schema: components["schemas"]["TagSchema"];
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+        };
         /** @description Completion payload emitted on the gather:annotation-complete bus channel when annotation context gathering finishes. */
         GatherAnnotationComplete: {
             /** @description Client-generated correlation ID to thread the response back to the originating request */
@@ -2877,6 +2374,46 @@ interface components {
                 contextWindow?: number;
             };
         };
+        /** @description Progress payload emitted on the gather:annotation-progress SSE channel during LLM context gathering. */
+        GatherProgress: {
+            message?: string;
+            percentage?: number;
+        };
+        /** @description Completion payload emitted on the gather:resource-complete bus channel when resource context gathering finishes. */
+        GatherResourceComplete: {
+            /** @description Client-generated correlation ID to thread the response back to the originating request */
+            correlationId: string;
+            /** @description Branded ResourceId of the resource whose context was gathered */
+            resourceId: string;
+            /** @description The gathered resource context (unified GatheredContext, focus.kind:'resource') */
+            response: components["schemas"]["GatheredContext"];
+        };
+        /** @description Request payload sent on the gather:resource-requested bus channel to gather context for a resource. */
+        GatherResourceRequest: {
+            /** @description Client-generated correlation ID to thread the response back to the originating request */
+            correlationId: string;
+            /** @description Branded ResourceId of the resource to gather context for */
+            resourceId: string;
+            /** @description Gathering configuration */
+            options: {
+                /** @description Depth of resource graph traversal */
+                depth: number;
+                /** @description Maximum number of related resources to include */
+                maxResources: number;
+                /** @description Whether to include resource content in the gathered result */
+                includeContent: boolean;
+                /** @description Whether to include resource summaries in the gathered result */
+                includeSummary: boolean;
+                /** @description Entity types to exclude from the semantic recall built into this context (caller-supplied; e.g. a chat consumer passes ['Question'] so prior questions never ground answer generation). Optional; default none. */
+                excludeEntityTypes?: string[];
+            };
+        };
+        /** @description Request to generate an AI summary of an annotation */
+        GatherSummaryRequest: {
+            correlationId: string;
+            annotationId: string;
+            resourceId: string;
+        };
         /** @description Context gathered for a gather.* call — consumed by yield.* (generation) and the matcher. A shared base (graph, semanticContext, metadata, inferredRelationshipSummary) plus a discriminated `focus` that names the anchor: an annotation or a whole resource. */
         GatheredContext: {
             /** @description The gather anchor. Discriminated on `kind`. */
@@ -2947,41 +2484,75 @@ interface components {
             /** @description LLM-generated summary of the focal anchor's relationships in the knowledge graph */
             inferredRelationshipSummary?: string;
         };
-        /** @description Completion payload emitted on the gather:resource-complete bus channel when resource context gathering finishes. */
-        GatherResourceComplete: {
-            /** @description Client-generated correlation ID to thread the response back to the originating request */
-            correlationId: string;
-            /** @description Branded ResourceId of the resource whose context was gathered */
+        GetAnnotationHistoryResponse: {
+            events: components["schemas"]["StoredEventResponse"][];
+            total: number;
+            annotationId: string;
             resourceId: string;
-            /** @description The gathered resource context (unified GatheredContext, focus.kind:'resource') */
-            response: components["schemas"]["GatheredContext"];
         };
-        /** @description Request payload sent on the gather:resource-requested bus channel to gather context for a resource. */
-        GatherResourceRequest: {
-            /** @description Client-generated correlation ID to thread the response back to the originating request */
-            correlationId: string;
-            /** @description Branded ResourceId of the resource to gather context for */
-            resourceId: string;
-            /** @description Gathering configuration */
-            options: {
-                /** @description Depth of resource graph traversal */
-                depth: number;
-                /** @description Maximum number of related resources to include */
-                maxResources: number;
-                /** @description Whether to include resource content in the gathered result */
-                includeContent: boolean;
-                /** @description Whether to include resource summaries in the gathered result */
-                includeSummary: boolean;
-                /** @description Entity types to exclude from the semantic recall built into this context (caller-supplied; e.g. a chat consumer passes ['Question'] so prior questions never ground answer generation). Optional; default none. */
-                excludeEntityTypes?: string[];
-            };
+        GetAnnotationResponse: {
+            annotation: components["schemas"]["Annotation"];
+            resource: components["schemas"]["ResourceDescriptor"] | null;
+            resolvedResource: components["schemas"]["ResourceDescriptor"] | null;
         };
-        /** @description Request to generate an AI summary of an annotation */
-        GatherSummaryRequest: {
-            correlationId: string;
-            annotationId: string;
+        GetAnnotationsResponse: {
+            annotations: components["schemas"]["Annotation"][];
+            /** @description Total number of annotations */
+            total: number;
+            /** @description Motivation filter applied (if any) */
+            motivation?: components["schemas"]["Motivation"] | null;
+        };
+        GetEntityTypesResponse: {
+            entityTypes: string[];
+        };
+        GetEventsResponse: {
+            events: components["schemas"]["StoredEventResponse"][];
+            total: number;
             resourceId: string;
         };
+        GetReferencedByResponse: {
+            referencedBy: {
+                /** @description Reference annotation ID */
+                id: string;
+                /** @description Name of resource containing the reference */
+                resourceName: string;
+                target: {
+                    /** @description ID of resource containing the reference */
+                    source: string;
+                    selector: {
+                        /** @description The selected text that references this resource */
+                        exact: string;
+                    };
+                };
+            }[];
+        };
+        GetResourceByTokenResponse: {
+            sourceResource: components["schemas"]["ResourceDescriptor"];
+            /** @description ISO 8601 timestamp when token expires */
+            expiresAt: string;
+        };
+        GetResourceResponse: {
+            resource: components["schemas"]["ResourceDescriptor"];
+            /** @description All annotations for the resource (highlights, references, assessments, etc.) */
+            annotations: components["schemas"]["Annotation"][];
+            /** @description Annotations that reference this resource from other resources */
+            entityReferences: components["schemas"]["Annotation"][];
+        };
+        GetTagSchemasResponse: {
+            tagSchemas: components["schemas"]["TagSchema"][];
+        };
+        GoogleAuthRequest: {
+            access_token: string;
+        };
+        HealthResponse: {
+            status: string;
+            message: string;
+            version: string;
+            timestamp: string;
+            /** @enum {string} */
+            database: "connected" | "disconnected" | "unknown";
+            environment: string;
+        };
         /** @description Result of a completed assessment-annotation job. */
         JobAssessmentAnnotationResult: {
             assessmentsFound: number;
@@ -2999,6 +2570,41 @@ interface components {
             correlationId: string;
             jobId: string;
         };
+        /** @description Result of a completed comment-annotation job. */
+        JobCommentAnnotationResult: {
+            commentsFound: number;
+            commentsCreated: number;
+        };
+        /** @description Command to mark a job as complete */
+        JobCompleteCommand: {
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+            resourceId: string;
+            jobId: string;
+            jobType: components["schemas"]["JobType"];
+            /** @description Annotation this job is attached to, when applicable. Lets the UI route completion feedback (toast, resolve state) to a specific annotation. */
+            annotationId?: string;
+            result?: components["schemas"]["JobResult"];
+        };
+        /** @description Payload for job:completed domain event */
+        JobCompletedPayload: {
+            jobId: string;
+            jobType: components["schemas"]["JobType"];
+            /** @description Annotation this job was attached to, when applicable */
+            annotationId?: string;
+            totalSteps?: number;
+            /** @description For detection: total entities found */
+            foundCount?: number;
+            /** @description For generation: ID of generated resource */
+            resultResourceId?: string;
+            /** @description For generation: URI of annotation that triggered generation */
+            annotationUri?: string;
+            message?: string;
+            /** @description Full result object for extensibility */
+            result?: {
+                [key: string]: unknown;
+            };
+        };
         /** @description Command to create a new job via the event bus */
         JobCreateCommand: {
             correlationId: string;
@@ -3017,32 +2623,25 @@ interface components {
                 jobId: string;
             };
         };
-        /** @description Result of a completed comment-annotation job. */
-        JobCommentAnnotationResult: {
-            commentsFound: number;
-            commentsCreated: number;
-        };
-        /** @description Command to mark a job as complete */
-        JobCompleteCommand: {
+        /** @description Command to mark a job as failed */
+        JobFailCommand: {
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
             resourceId: string;
             jobId: string;
             jobType: components["schemas"]["JobType"];
-            /** @description Annotation this job is attached to, when applicable. Lets the UI route completion feedback (toast, resolve state) to a specific annotation. */
+            /** @description Annotation this job is attached to, when applicable. Lets the UI route failure feedback (error toast, revert state) to a specific annotation. */
             annotationId?: string;
-            result?: components["schemas"]["JobResult"];
+            error: string;
         };
-        /** @description Command to mark a job as failed */
-        JobFailCommand: {
-            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
-            _userId?: string;
-            resourceId: string;
+        /** @description Payload for job:failed domain event */
+        JobFailedPayload: {
             jobId: string;
             jobType: components["schemas"]["JobType"];
-            /** @description Annotation this job is attached to, when applicable. Lets the UI route failure feedback (error toast, revert state) to a specific annotation. */
+            /** @description Annotation this job was attached to, when applicable */
             annotationId?: string;
             error: string;
+            details?: string;
         };
         /** @description Result of a completed generation job. resourceId is assigned by Stower when yield:create is processed; the worker emits job:complete with only resourceName, and Stower populates resourceId on the persisted payload. */
         JobGenerationResult: {
@@ -3093,6 +2692,23 @@ interface components {
                 value: string;
             }[];
         };
+        /** @description Payload for job:progress domain event */
+        JobProgressPayload: {
+            jobId: string;
+            jobType: components["schemas"]["JobType"];
+            percentage: number;
+            /** @description Human-readable current step */
+            currentStep?: string;
+            processedSteps?: number;
+            totalSteps?: number;
+            /** @description For detection: entities found so far */
+            foundCount?: number;
+            message?: string;
+            /** @description Full progress object for extensibility */
+            progress?: {
+                [key: string]: unknown;
+            };
+        };
         /** @description Event indicating a job has been queued */
         JobQueuedEvent: {
             jobId: string;
@@ -3134,11 +2750,32 @@ interface components {
             /** @description Annotation this job is attached to, when applicable. Set for annotation-scoped jobs like generation (from a specific reference). Unset for resource-scoped jobs like bulk reference/tag/highlight detection. */
             annotationId?: string;
         };
+        /** @description Payload for job:started domain event */
+        JobStartedPayload: {
+            jobId: string;
+            jobType: components["schemas"]["JobType"];
+            /** @description Annotation this job is attached to, when applicable */
+            annotationId?: string;
+            totalSteps?: number;
+        };
         /** @description Request to check the status of a job */
         JobStatusRequest: {
             correlationId: string;
             jobId: string;
         };
+        JobStatusResponse: {
+            jobId: string;
+            type: components["schemas"]["JobType"];
+            /** @enum {string} */
+            status: "pending" | "running" | "complete" | "failed" | "cancelled";
+            userId: string;
+            created: string;
+            startedAt?: string;
+            completedAt?: string;
+            error?: string;
+            progress?: unknown;
+            result?: unknown;
+        };
         /** @description Result of a job status request */
         JobStatusResult: {
             correlationId: string;
@@ -3153,21 +2790,45 @@ interface components {
                 [key: string]: number;
             };
         };
-        /** @description Bus command to add a new entity type to the KB's vocabulary. Carried on the `frame:add-entity-type` channel — Frame is the schema-layer flow that owns vocabulary writes. */
-        FrameAddEntityTypeCommand: {
-            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. Absent for in-process (bootstrap/replay/import) emits, which race the frame:entity-type-added domain event instead. */
-            correlationId?: string;
-            tag: string;
-            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
-            _userId?: string;
+        /**
+         * @description Type of background job
+         * @enum {string}
+         */
+        JobType: "reference-annotation" | "generation" | "highlight-annotation" | "assessment-annotation" | "comment-annotation" | "tag-annotation";
+        /** @description Knowledge graph gathered for an LLM context — a shared backbone in which resources AND annotations are typed nodes, connected by typed (optionally bidirectional) edges. Flattened views the matcher/generation read (connections, citedBy, siblings) are derived from these nodes/edges. */
+        KnowledgeGraph: {
+            nodes: {
+                /** @description Node identifier — a ResourceId or AnnotationId */
+                id: string;
+                /**
+                 * @description Whether this node is a resource or an annotation
+                 * @enum {string}
+                 */
+                type: "resource" | "annotation";
+                label: string;
+                /** @description Entity types on the node (resources) or carried by the annotation */
+                entityTypes?: string[];
+                metadata?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            edges: {
+                source: string;
+                target: string;
+                /** @description Edge kind (e.g. citation, annotation-of, sibling) */
+                type: string;
+                /** @description Whether the connection goes both ways */
+                bidirectional?: boolean;
+                metadata?: {
+                    [key: string]: unknown;
+                };
+            }[];
         };
-        /** @description Bus command to register a tag schema with the KB's runtime registry. Carried on the `frame:add-tag-schema` channel — Frame is the schema-layer flow that owns vocabulary writes. Most-recent registration of a given `schema.id` wins; the projection reflects the latest content. Identical re-registrations are silent; differing content overwrites and logs a warning. */
-        FrameAddTagSchemaCommand: {
-            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. Absent for in-process emits. */
-            correlationId?: string;
-            schema: components["schemas"]["TagSchema"];
-            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
-            _userId?: string;
+        ListResourcesResponse: {
+            resources: components["schemas"]["ResourceDescriptor"][];
+            total: number;
+            offset: number;
+            limit: number;
         };
         /** @description Bus command to archive a resource and optionally remove its file. */
         MarkArchiveCommand: {
@@ -3266,48 +2927,288 @@ interface components {
             resourceId: string;
             storageUri?: string;
         };
-        /** @description Bus command to update an annotation's body with patch operations. */
-        MarkUpdateBodyCommand: {
-            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
-            _userId?: string;
-            /** @description Correlation id threaded from the originating route through to event metadata. Lets the events-stream deliver matched results to the client that initiated the bind. */
-            correlationId?: string;
-            annotationId: string;
-            resourceId: string;
-            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
+        /** @description Bus command to update an annotation's body with patch operations. */
+        MarkUpdateBodyCommand: {
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+            /** @description Correlation id threaded from the originating route through to event metadata. Lets the events-stream deliver matched results to the client that initiated the bind. */
+            correlationId?: string;
+            annotationId: string;
+            resourceId: string;
+            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
+        };
+        /** @description Bus command to replace the entity types on a resource. */
+        MarkUpdateEntityTypesCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. */
+            correlationId?: string;
+            resourceId: string;
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+            currentEntityTypes: string[];
+            updatedEntityTypes: string[];
+        };
+        /** @description Error payload emitted on match:search-failed SSE channel. */
+        MatchSearchFailed: {
+            correlationId: string;
+            referenceId: string;
+            error: string;
+        };
+        /** @description Request payload sent on the match:search-request bus channel to find candidate matches. */
+        MatchSearchRequest: {
+            /** @description Client-generated correlation ID to thread the response back to the originating request */
+            correlationId: string;
+            /** @description Resource ID the reference annotation belongs to. Used to scope result events on the EventBus so the events-stream delivers them to participants viewing this resource. */
+            resourceId: string;
+            /** @description Annotation ID of the reference to search candidates for */
+            referenceId: string;
+            /** @description Gathered context for the reference annotation */
+            context: components["schemas"]["GatheredContext"];
+            /** @description Maximum number of candidate results to return */
+            limit?: number;
+            /** @description Enable semantic similarity scoring in addition to keyword matching */
+            useSemanticScoring?: boolean;
+        };
+        /** @description Search results payload emitted on match:search-results SSE channel. */
+        MatchSearchResult: {
+            correlationId: string;
+            referenceId: string;
+            response: (components["schemas"]["ResourceDescriptor"] & {
+                /** @description Relevance score */
+                score?: number;
+                /** @description Human-readable reason for the match */
+                matchReason?: string;
+            })[];
+        };
+        MediaTokenRequest: {
+            /** @description The resource ID to generate a media token for */
+            resourceId: string;
+        };
+        MediaTokenResponse: {
+            /** @description Short-lived media token for use as ?token= query parameter on resource URLs */
+            token: string;
+        };
+        /**
+         * @description Semiont-supported W3C Web Annotation motivations - https://www.w3.org/TR/annotation-vocab/#motivation
+         * @enum {string}
+         */
+        Motivation: "assessing" | "commenting" | "highlighting" | "linking" | "tagging";
+        OAuthConfigResponse: {
+            providers: {
+                name: string;
+                isConfigured: boolean;
+                clientId: string;
+            }[];
+            allowedDomains: string[];
+        };
+        PasswordAuthRequest: {
+            /**
+             * Format: email
+             * @description User email address
+             */
+            email: string;
+            /** @description User password (minimum 8 characters) */
+            password: string;
+        };
+        /** @description A specific, byte-addressable rendition of a resource (file/asset/variant). */
+        Representation: {
+            /**
+             * Format: uri
+             * @description Stable ID for this representation.
+             */
+            "@id"?: string;
+            /** @description Type(s), e.g., schema:MediaObject. */
+            "@type"?: string | string[];
+            /** @description MIME/media type (e.g., text/markdown, image/png). */
+            mediaType: string;
+            /** @description Working-tree URI identifying where the bytes live. Only file:// is supported (e.g. file://docs/overview.md). */
+            storageUri?: string;
+            filename?: string;
+            /** @description Size of the payload in bytes. */
+            byteSize?: number;
+            /** @description Integrity hash (e.g., sha256:abcd…). */
+            checksum?: string;
+            /** @description Compression/transfer encoding if applicable. */
+            encoding?: string;
+            /** @description IETF BCP 47 language tag (e.g., en, es-ES). */
+            language?: string;
+            /** @description Pixels (images/video). */
+            width?: number;
+            /** @description Pixels (images/video). */
+            height?: number;
+            /** @description Seconds (audio/video). */
+            duration?: number;
+            /** Format: date-time */
+            created?: string;
+            /** Format: date-time */
+            modified?: string;
+            /** @description Profile/shape the bytes conform to (e.g., a JSON profile or SVG profile). */
+            conformsTo?: string | string[];
+            tags?: string[];
+            /**
+             * @description Semantics of this rendition relative to the resource (e.g., original, thumbnail, preview, derived).
+             * @enum {string}
+             */
+            rel?: "original" | "thumbnail" | "preview" | "optimized" | "derived" | "other";
+        } & {
+            [key: string]: unknown;
+        };
+        /** @description Payload for yield:representation-added domain event */
+        RepresentationAddedPayload: {
+            representation: components["schemas"]["Representation"];
+        };
+        /** @description Payload for yield:representation-removed domain event */
+        RepresentationRemovedPayload: {
+            /** @description Checksum of the representation to remove */
+            checksum: string;
+        };
+        /** @description Payload for mark:archived domain event */
+        ResourceArchivedPayload: {
+            reason?: string;
+        };
+        /** @description Payload for yield:cloned domain event */
+        ResourceClonedPayload: {
+            name: string;
+            format: components["schemas"]["ContentFormat"];
+            contentChecksum: string;
+            contentByteSize?: number;
+            parentResourceId: string;
+            entityTypes?: string[];
+            language?: string;
+        };
+        /** @description Payload for yield:created domain event */
+        ResourceCreatedPayload: {
+            name: string;
+            format: components["schemas"]["ContentFormat"];
+            /** @description SHA-256 of content */
+            contentChecksum: string;
+            contentByteSize?: number;
+            entityTypes?: string[];
+            /** @description Working-tree URI (e.g. file://docs/overview.md) */
+            storageUri?: string;
+            language?: string;
+            isDraft?: boolean;
+            generatedFrom?: {
+                resourceId: string;
+                annotationId: string;
+            };
+            generationPrompt?: string;
+            generator?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
+        };
+        /** @description Metadata about a resource (1:1 with its URI). JSON-LD subject is @id. Link to concrete bytes via representations. */
+        ResourceDescriptor: {
+            /** @description JSON-LD context; URI, object, or array of these. */
+            "@context": string | {
+                [key: string]: unknown;
+            } | (string | {
+                [key: string]: unknown;
+            })[];
+            /** @description Canonical URI/URN of the resource being described. */
+            "@id": string;
+            /** @description Type(s) of the resource (IRIs/CURIEs via @context). */
+            "@type"?: string | string[];
+            name: string;
+            description?: string;
+            /** @description Persistent identifiers (e.g., DOI, URN). */
+            identifier?: string | string[] | ({
+                /** Format: uri */
+                "@id"?: string;
+                value?: string;
+                scheme?: string;
+            } & {
+                [key: string]: unknown;
+            });
+            /** @description Topics (IRIs or strings). */
+            about?: string | string[];
+            /** @description Equivalent/authoritative references. */
+            sameAs?: string[];
+            isPartOf?: string[];
+            hasPart?: string[];
+            /** Format: uri */
+            license?: string;
+            version?: string;
+            /** Format: date-time */
+            dateCreated?: string;
+            /** Format: date-time */
+            dateModified?: string;
+            /** @description W3C PROV - source resources this was derived from */
+            wasDerivedFrom?: string | string[];
+            /** @description W3C PROV - agents responsible for this resource */
+            wasAttributedTo?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
+            /** @description Software agent that produced or processed this resource (W3C Web Annotation model) */
+            generator?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
+            /** @description Profile/shape URI this resource description conforms to. */
+            conformsTo?: string | string[];
+            /** @description Convenience set summarizing media types across representations. */
+            availableFormats?: string[];
+            /** @description Managed or referenced byte-level renditions of this resource. */
+            representations: components["schemas"]["Representation"] | components["schemas"]["Representation"][];
+            /** @description Application-specific: Whether this resource is archived */
+            archived?: boolean;
+            /** @description Application-specific: Entity types for this resource */
+            entityTypes?: string[];
+            /** @description Application-specific: Whether this resource is a draft */
+            isDraft?: boolean;
+            /** @description Application-specific: ID of annotation that triggered generation */
+            sourceAnnotationId?: string;
+            /** @description Application-specific: ID of source resource for clones/derivatives */
+            sourceResourceId?: string;
+            /**
+             * Format: uri
+             * @description Original URI from a source knowledge base when this resource was imported
+             */
+            originatedFrom?: string;
+            /** @description Working-tree URI for this resource (e.g. file://docs/overview.md). Stable across updates and moves. */
+            storageUri?: string;
+            /** @description SHA-256 hex hash of the current content. Updated on resource.created, resource.updated, resource.cloned events. */
+            currentChecksum?: string;
+        } & {
+            [key: string]: unknown;
+        };
+        /** @description Payload for yield:moved domain event */
+        ResourceMovedPayload: {
+            /** @description Previous file:// URI */
+            fromUri: string;
+            /** @description New file:// URI */
+            toUri: string;
         };
-        /** @description Bus command to replace the entity types on a resource. */
-        MarkUpdateEntityTypesCommand: {
-            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. */
-            correlationId?: string;
-            resourceId: string;
-            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
-            _userId?: string;
-            currentEntityTypes: string[];
-            updatedEntityTypes: string[];
+        /** @description Payload for mark:unarchived domain event (empty payload) */
+        ResourceUnarchivedPayload: Record<string, never>;
+        /** @description Payload for yield:updated domain event */
+        ResourceUpdatedPayload: {
+            /** @description SHA-256 of new content */
+            contentChecksum: string;
+            contentByteSize?: number;
         };
-        /** @description Request payload sent on the match:search-request bus channel to find candidate matches. */
-        MatchSearchRequest: {
-            /** @description Client-generated correlation ID to thread the response back to the originating request */
-            correlationId: string;
-            /** @description Resource ID the reference annotation belongs to. Used to scope result events on the EventBus so the events-stream delivers them to participants viewing this resource. */
-            resourceId: string;
-            /** @description Annotation ID of the reference to search candidates for */
-            referenceId: string;
-            /** @description Gathered context for the reference annotation */
-            context: components["schemas"]["GatheredContext"];
-            /** @description Maximum number of candidate results to return */
-            limit?: number;
-            /** @description Enable semantic similarity scoring in addition to keyword matching */
-            useSemanticScoring?: boolean;
+        /** @description Selection data for user-initiated annotations. Captures the text range and optional selector information from a user's highlight in the UI. */
+        SelectionData: {
+            /** @description The exact selected text */
+            exact: string;
+            /** @description Start character offset */
+            start: number;
+            /** @description End character offset */
+            end: number;
+            /** @description SVG selector for non-text selections (e.g. PDF regions) */
+            svgSelector?: string;
+            /** @description Fragment selector (e.g. page=2) */
+            fragmentSelector?: string;
+            /** @description Specification the fragment selector conforms to */
+            conformsTo?: string;
+            /** @description Text before the selection (for disambiguation) */
+            prefix?: string;
+            /** @description Text after the selection (for disambiguation) */
+            suffix?: string;
         };
-        MediaTokenRequest: {
-            /** @description The resource ID to generate a media token for */
+        SemanticMatch: {
+            /** @description The chunk text that matched */
+            text: string;
+            /** @description Source resource ID */
             resourceId: string;
-        };
-        MediaTokenResponse: {
-            /** @description Short-lived media token for use as ?token= query parameter on resource URLs */
-            token: string;
+            /** @description Source annotation ID, if the match is from an annotation */
+            annotationId?: string;
+            /** @description Cosine similarity score (0-1) */
+            score: number;
+            /** @description Entity types on the matched passage */
+            entityTypes?: string[];
         };
         /** @description Emitted when the hover delay setting changes */
         SettingsHoverDelayChangedEvent: {
@@ -3322,6 +3223,57 @@ interface components {
             /** @enum {string} */
             theme: "light" | "dark" | "system";
         };
+        SpecificResource: {
+            /** @enum {string} */
+            type: "SpecificResource";
+            /** @description IRI of the target resource */
+            source: string;
+            /** @description Why this body is included */
+            purpose?: components["schemas"]["BodyPurpose"];
+        };
+        StatusResponse: {
+            status: string;
+            version: string;
+            features: {
+                semanticContent: string;
+                collaboration: string;
+                rbac: string;
+            };
+            message: string;
+            authenticatedAs?: string;
+            /** @description Name of the knowledge base project */
+            projectName?: string;
+            /** @description Current git branch of the knowledge base repository */
+            gitBranch?: string;
+        };
+        /** @description A persisted domain event with metadata. Flat shape — event fields and metadata are peers. */
+        StoredEventResponse: {
+            /** @description Unique event ID (UUID) */
+            id: string;
+            /** @description Event type (flow verb name, e.g. mark:added) */
+            type: string;
+            /**
+             * Format: date-time
+             * @description When the event occurred
+             */
+            timestamp: string;
+            /** @description DID of the user who triggered the event */
+            userId: string;
+            /** @description Resource this event affects (absent for system events) */
+            resourceId?: string;
+            /** @description Event schema version */
+            version: number;
+            /** @description Event-type-specific payload */
+            payload: {
+                [key: string]: unknown;
+            };
+            metadata: components["schemas"]["EventMetadata"];
+        };
+        /**
+         * @description Base MIME types (no parameters) admitted by Semiont. Membership is the create/yield gate — every member is storable, nameable, and uploadable. What more the system can do with a type (render, annotate, extract text, author) is curated per type in @semiont/core's media-type registry, which is keyed by this enum.
+         * @enum {string}
+         */
+        SupportedMediaType: "text/plain" | "text/markdown" | "text/html" | "text/css" | "text/csv" | "text/xml" | "application/json" | "application/xml" | "application/yaml" | "application/x-yaml" | "application/pdf" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/zip" | "application/gzip" | "application/x-tar" | "application/x-7z-compressed" | "application/octet-stream" | "application/wasm" | "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/svg+xml" | "image/bmp" | "image/tiff" | "image/x-icon" | "video/mp4" | "video/mpeg" | "video/webm" | "video/ogg" | "video/quicktime" | "video/x-msvideo" | "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/webm" | "audio/aac" | "audio/flac" | "text/javascript" | "application/javascript" | "text/x-typescript" | "application/typescript" | "text/x-python" | "text/x-java" | "text/x-c" | "text/x-c++" | "text/x-csharp" | "text/x-go" | "text/x-rust" | "text/x-ruby" | "text/x-php" | "text/x-swift" | "text/x-kotlin" | "text/x-shell" | "font/woff" | "font/woff2" | "font/ttf" | "font/otf";
         SvgSelector: {
             /** @enum {string} */
             type: "SvgSelector";
@@ -3343,6 +3295,90 @@ interface components {
             domain: string;
             tags: components["schemas"]["TagCategory"][];
         };
+        /** @description Payload for frame:tag-schema-added domain event (system-level, no resourceId — fan-out is global to the KB). */
+        TagSchemaAddedPayload: {
+            schema: components["schemas"]["TagSchema"];
+        };
+        TextPositionSelector: {
+            /** @enum {string} */
+            type: "TextPositionSelector";
+            /** @description Character offset from resource start */
+            start: number;
+            /** @description Character offset from resource start */
+            end: number;
+        };
+        TextQuoteSelector: {
+            /** @enum {string} */
+            type: "TextQuoteSelector";
+            exact: string;
+            prefix?: string;
+            suffix?: string;
+        };
+        TextualBody: {
+            /** @enum {string} */
+            type: "TextualBody";
+            /** @description The text content (e.g., entity type name) */
+            value: string;
+            /** @description Why this body is included */
+            purpose?: components["schemas"]["BodyPurpose"];
+            /** @description MIME type (defaults to text/plain) */
+            format?: string;
+            /** @description BCP 47 language tag */
+            language?: string;
+        };
+        TokenRefreshRequest: {
+            /**
+             * @description Refresh token obtained during login
+             * @example eyJhbGciOiJIUzI1NiIs...
+             */
+            refreshToken: string;
+        };
+        TokenRefreshResponse: {
+            access_token: string;
+        };
+        UpdateAnnotationBodyRequest: {
+            /** @description Resource ID containing the annotation (required for O(1) Layer 3 lookup) */
+            resourceId: string;
+            /** @description Array of body modification operations to apply */
+            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
+        };
+        UpdateUserRequest: {
+            isAdmin?: boolean;
+            isActive?: boolean;
+            name?: string;
+        };
+        UpdateUserResponse: {
+            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;
+            };
+        };
+        UserResponse: {
+            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;
+            /** @description The validated JWT token string for the current session */
+            token: string;
+        };
         /** @description Bus command to rebuild the graph projection from the event log — the whole graph when resourceId is absent, one resource when present. Served by the Weaver; replaces direct rebuild access, which does not survive the Weaver's container split. */
         WeaveRebuildCommand: {
             /** @description Correlation id for request/reply matching, set by busRequest so the ok/failed reply routes back. */
@@ -4386,6 +4422,13 @@ type JobType = components['schemas']['JobType'];
  * `servesJobTypes`. See .plans/COLLABORATOR-DIRECTORY.md.
  */
 type CollaboratorEntry = components['schemas']['CollaboratorEntry'];
+/**
+ * The launcher's published KB-discovery view (BROWSER-KB-DISCOVERY): the
+ * document at `DISCOVERY_URL_PATH` and its entries. Endpoints and identity
+ * only — never credentials.
+ */
+type DiscoveryDocument = components['schemas']['DiscoveryDocument'];
+type DiscoveredKB = components['schemas']['DiscoveredKB'];
 
 /**
  * Event Type Guards and Extraction Utilities
@@ -7267,5 +7310,18 @@ declare function isTransientFetchError(error: unknown): boolean;
  */
 declare function retryWithBackoff<T>(fn: () => Promise<T>, isRetryable: (error: unknown) => boolean, policy: RetryPolicy, onRetry?: (info: RetryAttemptInfo) => void): Promise<T>;
 
-export { AUTHORABLE_MEDIA_TYPES, BRIDGED_CHANNELS, BusRequestError, CHANNEL_SCHEMAS, CONTEXT_FULL_WEIGHT, CONTEXT_PARTIAL_WEIGHT, ConfigurationError, ConflictError, EMBEDDABLE_MEDIA_TYPES, EventBus, JWTTokenSchema, LOCALES, MEDIA_TYPES, NotFoundError, PERSISTED_EVENT_TYPES, POSITION_WEIGHT_MAX, POSITION_WINDOW, RESOURCE_BROADCAST_TYPES, STARTUP_FETCH_RETRY, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseMediaType, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, busRequest, capabilitiesOf, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, deriveViews, didToAgent, email, entityType, errField, extensionForMediaType, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPageFromFragment, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isNull, isNullish, isNumber, isObject, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isSupportedMediaType, isTag, isTransientFetchError, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, retryWithBackoff, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
-export type { AccessToken, AnchorConfidence, AnchorMethod, AnchorRect, AnchorSelectors, AnchorStrategy, AnchoringModel, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, BusRequestErrorCode, BusRequestPrimitive, CloneToken, CollaboratorEntry, ConnectionState, ContentCache, ContentFormat, CreateAnnotationInternal, DatabaseServiceConfig, Email, EmbeddingServiceConfig, EmittableChannel, EntityType, EntityTypeStats, Environment, EnvironmentConfig, EventBase, EventInput, EventMap, EventMetadata, EventName, EventOfType, EventQuery, EventSignature, FragmentSelector, FrontendServiceConfig, GatheredContext, GoogleAuthRequest, GoogleCredential, GraphConnection, GraphDatabaseType, GraphPath, GraphServiceConfig, GraphViews, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, JobType, ListUsersResponse, LlmSelectorInput, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MediaTypeCapabilities, Motivation, OllamaProviderConfig, PdfCoordinate, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, ReconciledSelector, RefreshToken, RenderMode, RenderedAnchor, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, RetryAttemptInfo, RetryPolicy, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StateUnit, StatusResponse, StoredEvent, StoredEventLike, SupportedMediaType, SvgSelector, TagCategory, TagSchema, TextExtraction, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };
+/**
+ * Browser ↔ launcher KB discovery (BROWSER-KB-DISCOVERY).
+ *
+ * The launcher publishes its export view at `<stateDir>/discovery/kbs.json`,
+ * mounted read-only into the frontend container at `/discovery` and served
+ * by the frontend image at this URL path. One TS-side name for that URL: the
+ * frontend server's tests fetch this constant, so prefix/filename drift
+ * between the server and consumers is a failing test — mirroring for the URL
+ * what the DiscoveryDocument schema does for the payload. (The launcher's Go
+ * side keeps its own constant; the plan doc is the cross-language record.)
+ */
+declare const DISCOVERY_URL_PATH = "/discovery/kbs.json";
+
+export { AUTHORABLE_MEDIA_TYPES, BRIDGED_CHANNELS, BusRequestError, CHANNEL_SCHEMAS, CONTEXT_FULL_WEIGHT, CONTEXT_PARTIAL_WEIGHT, ConfigurationError, ConflictError, DISCOVERY_URL_PATH, EMBEDDABLE_MEDIA_TYPES, EventBus, JWTTokenSchema, LOCALES, MEDIA_TYPES, NotFoundError, PERSISTED_EVENT_TYPES, POSITION_WEIGHT_MAX, POSITION_WINDOW, RESOURCE_BROADCAST_TYPES, STARTUP_FETCH_RETRY, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseMediaType, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, busRequest, capabilitiesOf, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, deriveViews, didToAgent, email, entityType, errField, extensionForMediaType, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPageFromFragment, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isNull, isNullish, isNumber, isObject, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isSupportedMediaType, isTag, isTransientFetchError, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, retryWithBackoff, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
+export type { AccessToken, AnchorConfidence, AnchorMethod, AnchorRect, AnchorSelectors, AnchorStrategy, AnchoringModel, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, BusRequestErrorCode, BusRequestPrimitive, CloneToken, CollaboratorEntry, ConnectionState, ContentCache, ContentFormat, CreateAnnotationInternal, DatabaseServiceConfig, DiscoveredKB, DiscoveryDocument, Email, EmbeddingServiceConfig, EmittableChannel, EntityType, EntityTypeStats, Environment, EnvironmentConfig, EventBase, EventInput, EventMap, EventMetadata, EventName, EventOfType, EventQuery, EventSignature, FragmentSelector, FrontendServiceConfig, GatheredContext, GoogleAuthRequest, GoogleCredential, GraphConnection, GraphDatabaseType, GraphPath, GraphServiceConfig, GraphViews, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, JobType, ListUsersResponse, LlmSelectorInput, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MediaTypeCapabilities, Motivation, OllamaProviderConfig, PdfCoordinate, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, ReconciledSelector, RefreshToken, RenderMode, RenderedAnchor, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, RetryAttemptInfo, RetryPolicy, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StateUnit, StatusResponse, StoredEvent, StoredEventLike, SupportedMediaType, SvgSelector, TagCategory, TagSchema, TextExtraction, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };