@semiont/core 0.5.9 → 0.5.11

package/dist/index.d.ts

@@ -1814,17 +1814,6 @@ interface components {
             };
             resource: components["schemas"]["ResourceDescriptor"];
         };
-        AnnotationLLMContextResponse: {
-            annotation: components["schemas"]["Annotation"];
-            sourceResource: components["schemas"]["ResourceDescriptor"];
-            targetResource?: components["schemas"]["ResourceDescriptor"] | null;
-            /** @description Gathered context for this annotation */
-            context?: components["schemas"]["GatheredContext"];
-            targetContext?: {
-                content: string;
-                summary?: string;
-            };
-        };
         /** @description W3C Web Annotation target object - source is required, selector is optional */
         AnnotationTarget: {
             /** @description IRI of the resource being annotated */
@@ -1994,22 +1983,7 @@ interface components {
         };
         CreateAnnotationRequest: {
             motivation: components["schemas"]["Motivation"];
-            target: {
-                source: string;
-                selector: components["schemas"]["TextPositionSelector"] | {
-                    /** @enum {string} */
-                    type: "TextQuoteSelector";
-                    exact: string;
-                    prefix?: string;
-                    suffix?: string;
-                } | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | {
-                    /** @enum {string} */
-                    type: "TextQuoteSelector";
-                    exact: string;
-                    prefix?: string;
-                    suffix?: string;
-                } | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
-            };
+            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"][];
         };
@@ -2022,23 +1996,11 @@ interface components {
             success: boolean;
             message: string;
         };
-        /** @description Progress payload emitted on gather:annotation-progress and gather:progress SSE channels during LLM context gathering. */
+        /** @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 gather:annotation-finished SSE channel. */
-        GatherAnnotationFinished: {
-            correlationId: string;
-            annotationId: string;
-            response: components["schemas"]["AnnotationLLMContextResponse"];
-        };
-        /** @description Completion payload emitted on gather:finished SSE channel for resource-level context gathering. */
-        GatherFinished: {
-            correlationId: string;
-            resourceId: string;
-            response: components["schemas"]["ResourceLLMContextResponse"];
-        };
         /** @description Search results payload emitted on match:search-results SSE channel. */
         MatchSearchResult: {
             correlationId: string;
@@ -2333,8 +2295,7 @@ interface components {
         };
         JobStatusResponse: {
             jobId: string;
-            /** @enum {string} */
-            type: "reference-annotation" | "generation" | "highlight-annotation" | "assessment-annotation" | "comment-annotation" | "tag-annotation";
+            type: components["schemas"]["JobType"];
             /** @enum {string} */
             status: "pending" | "running" | "complete" | "failed" | "cancelled";
             userId: string;
@@ -2345,6 +2306,35 @@ interface components {
             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;
@@ -2498,37 +2488,6 @@ interface components {
             /** @description Entity types on the matched passage */
             entityTypes?: string[];
         };
-        ResourceLLMContextResponse: {
-            mainResource: components["schemas"]["ResourceDescriptor"];
-            relatedResources: components["schemas"]["ResourceDescriptor"][];
-            annotations: components["schemas"]["Annotation"][];
-            graph: {
-                nodes: {
-                    id: string;
-                    type: string;
-                    label: string;
-                    metadata: {
-                        [key: string]: unknown;
-                    };
-                }[];
-                edges: {
-                    source: string;
-                    target: string;
-                    type: string;
-                    metadata: {
-                        [key: string]: unknown;
-                    };
-                }[];
-            };
-            summary?: string;
-            suggestedReferences?: string[];
-            /** @description The content of the main resource (included if includeContent=true) */
-            mainResourceContent?: string;
-            /** @description Map of resource IDs to their content (included if includeContent=true) */
-            relatedResourcesContent?: {
-                [key: string]: string;
-            };
-        };
         SpecificResource: {
             /** @enum {string} */
             type: "SpecificResource";
@@ -2645,12 +2604,10 @@ interface components {
         BeckonSparkleEvent: {
             annotationId: string;
         };
-        /** @description Success result emitted on the bind:body-updated bus channel after bind:update-body has been applied. */
+        /** @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 */
+            /** @description Correlation id echoed from the originating bind:update-body command so busRequest can match the reply. */
             correlationId: string;
-            /** @description Branded AnnotationId of the annotation whose body was updated */
-            annotationId: string;
         };
         /** @description Command payload sent on the bind:initiate bus channel to start a bind flow. */
         BindInitiateCommand: {
@@ -2693,6 +2650,17 @@ interface components {
          * @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;
@@ -2861,6 +2829,12 @@ interface components {
             correlationId: string;
             response: components["schemas"]["GetTagSchemasResponse"];
         };
+        /** @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 W3C Web Annotation FragmentSelector for media fragment identifiers (RFC 3778 for PDFs) */
         FragmentSelector: {
             /** @enum {string} */
@@ -2882,8 +2856,8 @@ interface components {
             correlationId: string;
             /** @description Branded AnnotationId of the annotation whose context was gathered */
             annotationId: string;
-            /** @description The gathered annotation context */
-            response: components["schemas"]["AnnotationLLMContextResponse"];
+            /** @description The gathered annotation context (unified GatheredContext, focus.kind:'annotation') */
+            response: components["schemas"]["GatheredContext"];
         };
         /** @description Request payload sent on the gather:requested bus channel to gather context for an annotation. */
         GatherAnnotationRequest: {
@@ -2903,66 +2877,75 @@ interface components {
                 contextWindow?: number;
             };
         };
-        /** @description Context gathered for an annotation. Includes source document excerpts, metadata, and graph-derived context. Used by both Find (bind) and Generate (yield) flows. */
+        /** @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 annotation this context was gathered for */
-            annotation: components["schemas"]["Annotation"];
-            /** @description The resource containing the annotation */
-            sourceResource: components["schemas"]["ResourceDescriptor"];
-            /** @description Text context from the source document */
-            sourceContext?: {
-                /** @description Text appearing before the selected passage */
-                before?: string;
-                /** @description The selected text passage (the annotation target) */
-                selected: string;
-                /** @description Text appearing after the selected passage */
-                after?: string;
+            /** @description The gather anchor. Discriminated on `kind`. */
+            focus: {
+                /** @enum {string} */
+                kind: "annotation";
+                /** @description The annotation this context was gathered for */
+                annotation: components["schemas"]["Annotation"];
+                /** @description The resource containing the annotation */
+                sourceResource: components["schemas"]["ResourceDescriptor"];
+                /** @description Text context around the annotation target */
+                selected?: {
+                    /** @description Text appearing before the selected passage */
+                    before?: string;
+                    /** @description The selected text passage (the annotation target) */
+                    text: string;
+                    /** @description Text appearing after the selected passage */
+                    after?: string;
+                };
+                /** @description User-provided hint to supplement or replace the selected text for search and generation */
+                userHint?: string;
+                /** @description The resource the annotation links to, if it is a resolved reference. Dormant capability — produced/exposed but not yet consumed (see LINK-TARGET-CONTEXT.md). */
+                targetResource?: components["schemas"]["ResourceDescriptor"];
+                /** @description Context about the annotation's link target. Dormant — see LINK-TARGET-CONTEXT.md. */
+                targetContext?: {
+                    content: string;
+                    summary?: string;
+                };
+            } | {
+                /** @enum {string} */
+                kind: "resource";
+                /** @description The resource this context was gathered for */
+                resource: components["schemas"]["ResourceDescriptor"];
+                summary?: string;
+                suggestedReferences?: string[];
+                /** @description Resource content (included when requested) */
+                content?: {
+                    /** @description Content of the focal resource */
+                    main?: string;
+                    /** @description Map of related resource IDs to their content */
+                    related?: {
+                        [key: string]: string;
+                    };
+                };
+            };
+            /** @description Knowledge graph backbone — resources AND annotations as typed nodes. The flattened views (connections, citedBy, siblings) are derived from this. */
+            graph: components["schemas"]["KnowledgeGraph"];
+            /** @description Semantically similar passages from across the knowledge base, found via vector search */
+            semanticContext?: {
+                /** @description Passages ranked by cosine similarity to the focal text */
+                similar: components["schemas"]["SemanticMatch"][];
+                /** @description Entity types excluded from this recall — a record of how `similar` was filtered (e.g. ['Question'] so answer-generation never surfaces prior questions). Absent when no exclusion was applied. */
+                excludedEntityTypes?: string[];
             };
-            /** @description Context metadata about the annotation and its source */
-            metadata?: {
+            /** @description Context metadata about the focal anchor and its source */
+            metadata: {
                 /** @description Type of source resource (e.g., 'document', 'image', 'video') */
                 resourceType?: string;
                 /** @description BCP 47 language tag of source content */
                 language?: string;
-                /** @description Entity types associated with the annotation */
+                /** @description Entity types associated with the focal anchor */
                 entityTypes?: string[];
-            };
-            /** @description User-provided textual hint to supplement or replace the selected text for search and generation */
-            userHint?: string;
-            /** @description Graph-derived context from the knowledge base */
-            graphContext?: {
-                /** @description Resources connected to the source resource via annotations */
-                connections?: {
-                    /** @description ID of the connected resource */
-                    resourceId: string;
-                    /** @description Name of the connected resource */
-                    resourceName: string;
-                    /** @description Entity types on the connected resource */
-                    entityTypes?: string[];
-                    /** @description Whether the connection goes both ways */
-                    bidirectional: boolean;
-                }[];
-                /** @description Number of other resources that reference the source resource */
-                citedByCount?: number;
-                /** @description Resources that reference the source resource */
-                citedBy?: {
-                    resourceId: string;
-                    resourceName: string;
-                }[];
-                /** @description Entity types from other annotations on the same resource */
-                siblingEntityTypes?: string[];
-                /** @description Global frequency counts for entity types (for IDF-like weighting) */
+                /** @description Global frequency counts for entity types (for IDF-like weighting). A KB-wide statistic, not a neighborhood property — kept here rather than on the graph. */
                 entityTypeFrequencies?: {
                     [key: string]: number;
                 };
-                /** @description LLM-generated summary of the annotation's relationships in the knowledge graph */
-                inferredRelationshipSummary?: string;
-            };
-            /** @description Semantically similar passages from across the knowledge base, found via vector search */
-            semanticContext?: {
-                /** @description Passages ranked by cosine similarity to the focal text */
-                similar: components["schemas"]["SemanticMatch"][];
             };
+            /** @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: {
@@ -2970,8 +2953,8 @@ interface components {
             correlationId: string;
             /** @description Branded ResourceId of the resource whose context was gathered */
             resourceId: string;
-            /** @description The gathered resource context */
-            response: components["schemas"]["ResourceLLMContextResponse"];
+            /** @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: {
@@ -2989,6 +2972,8 @@ interface components {
                 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 */
@@ -3004,6 +2989,8 @@ interface components {
         };
         /** @description Request to cancel a job */
         JobCancelRequest: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. Absent for the local cancelRequest UI signal. */
+            correlationId?: string;
             /** @enum {string} */
             jobType: "annotation" | "generation";
         };
@@ -3015,8 +3002,9 @@ interface components {
         /** @description Command to create a new job via the event bus */
         JobCreateCommand: {
             correlationId: string;
-            /** @enum {string} */
-            jobType: "reference-annotation" | "highlight-annotation" | "assessment-annotation" | "comment-annotation" | "tag-annotation" | "generation";
+            /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
+            _userId?: string;
+            jobType: components["schemas"]["JobType"];
             resourceId: string;
             params: {
                 [key: string]: unknown;
@@ -3167,18 +3155,24 @@ interface components {
         };
         /** @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 Bus command to archive a resource and optionally remove its file. */
         MarkArchiveCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. */
+            correlationId?: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
             resourceId: string;
@@ -3203,10 +3197,6 @@ interface components {
                 categories?: string[];
             };
         };
-        /** @description Emitted when the mark click action changes */
-        MarkClickChangedEvent: {
-            action: string;
-        };
         /** @description Bus command to create an annotation on a resource. */
         MarkCreateCommand: {
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
@@ -3216,9 +3206,14 @@ interface components {
             annotation: components["schemas"]["Annotation"];
             resourceId: string;
         };
-        /** @description Success response after creating an annotation. */
+        /** @description Success reply after creating an annotation, matched to the originating command by correlationId. */
         MarkCreateOk: {
-            annotationId: string;
+            /** @description Correlation id echoed from the mark:create-request command so busRequest can match the reply. */
+            correlationId?: string;
+            /** @description The created annotation's identity. */
+            response: {
+                annotationId: string;
+            };
         };
         /** @description Raw annotation creation intent — bus handler assembles the W3C annotation */
         MarkCreateRequest: {
@@ -3228,31 +3223,34 @@ interface components {
         };
         /** @description Bus command to delete an annotation. */
         MarkDeleteCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. */
+            correlationId?: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
             annotationId: string;
             resourceId?: string;
         };
-        /** @description Success response after deleting an annotation. */
+        /** @description Success reply after deleting an annotation, matched to the originating command by correlationId. */
         MarkDeleteOk: {
-            annotationId: string;
+            /** @description Correlation id echoed from the mark:delete command so busRequest can match the reply. */
+            correlationId?: string;
+            /** @description The deleted annotation's identity. */
+            response: {
+                annotationId: string;
+            };
         };
         /** @description Emitted when the user requests a new mark (annotation) on a resource */
         MarkRequestedEvent: {
+            /** @description The '@id' of the resource the mark belongs to (W3C target.source). Routes the event to the right viewer/state unit when a host mounts many viewers on one session. */
+            source: string;
             /** @description One or more W3C selectors */
             selector: components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
             motivation: components["schemas"]["Motivation"];
         };
-        /** @description Emitted when the active mark selection changes */
-        MarkSelectionChangedEvent: {
-            motivation: string | null;
-        };
-        /** @description Emitted when the mark shape changes */
-        MarkShapeChangedEvent: {
-            shape: string;
-        };
         /** @description Emitted when a mark is submitted with its annotation body */
         MarkSubmitEvent: {
+            /** @description The '@id' of the resource the mark belongs to (W3C target.source). Routes the submit to the state unit bound to that resource — without it, N mounted units each create the annotation (N copies on N resources). */
+            source: string;
             motivation: components["schemas"]["Motivation"];
             /** @description One or more W3C selectors */
             selector: components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
@@ -3261,6 +3259,8 @@ interface components {
         };
         /** @description Bus command to unarchive a previously archived resource. */
         MarkUnarchiveCommand: {
+            /** @description Correlation id for request/reply matching, set by the SDK's busRequest so the confirmed-write ack/failure routes back. */
+            correlationId?: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
             resourceId: string;
@@ -3278,6 +3278,8 @@ interface components {
         };
         /** @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;
@@ -3355,7 +3357,7 @@ interface components {
         YieldCloneCreated: {
             correlationId: string;
             response: {
-                resourceId?: string;
+                resourceId: string;
             };
         };
         /** @description Bus command to request cloning a resource using a clone token. */
@@ -3370,6 +3372,8 @@ interface components {
         };
         /** @description Bus command to create a yielded resource in the knowledge base. */
         YieldCreateCommand: {
+            /** @description Correlation id for request/reply matching, set by busRequest so the yield:create-ok / yield:create-failed reply routes back to the awaiting caller. */
+            correlationId?: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
             name: string;
@@ -3388,14 +3392,14 @@ interface components {
             generator?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
             noGit?: boolean;
         };
-        /** @description Success response after creating a yielded resource. */
+        /** @description Success reply after creating a yielded resource, matched to the originating command by correlationId. */
         YieldCreateOk: {
-            resourceId: string;
-            resource: components["schemas"]["ResourceDescriptor"];
-        };
-        /** @description Success response after moving a yielded resource. */
-        YieldMoveOk: {
-            resourceId: string;
+            /** @description Correlation id echoed from the yield:create command so busRequest can match the reply. */
+            correlationId?: string;
+            /** @description The created resource's identity. */
+            response: {
+                resourceId: string;
+            };
         };
         /** @description Bus command to move (rename) a yielded resource. */
         YieldMvCommand: {
@@ -3407,6 +3411,8 @@ interface components {
         };
         /** @description Bus command to update a yielded resource's storage content. */
         YieldUpdateCommand: {
+            /** @description Correlation id for request/reply matching, set by busRequest so the yield:update-ok / yield:update-failed reply routes back to the awaiting caller. */
+            correlationId?: string;
             /** @description Authenticated user's DID, injected by the /bus/emit gateway. Clients do not set this. */
             _userId?: string;
             resourceId: string;
@@ -3415,9 +3421,14 @@ interface components {
             byteSize: number;
             noGit?: boolean;
         };
-        /** @description Success response after updating a yielded resource. */
+        /** @description Success reply after updating a yielded resource, matched to the originating command by correlationId. */
         YieldUpdateOk: {
-            resourceId: string;
+            /** @description Correlation id echoed from the yield:update command so busRequest can match the reply. */
+            correlationId?: string;
+            /** @description The updated resource's identity. */
+            response: {
+                resourceId: string;
+            };
         };
     };
     responses: never;
@@ -3791,8 +3802,7 @@ type EventMap = {
     'yield:create-ok': components['schemas']['YieldCreateOk'];
     'yield:create-failed': components['schemas']['CommandError'];
     'yield:update-ok': components['schemas']['YieldUpdateOk'];
-    'yield:update-failed': components['schemas']['YieldUpdateOk'] & components['schemas']['CommandError'];
-    'yield:move-ok': components['schemas']['YieldMoveOk'];
+    'yield:update-failed': components['schemas']['CommandError'];
     'yield:move-failed': {
         fromUri: string;
     } & components['schemas']['CommandError'];
@@ -3832,6 +3842,18 @@ type EventMap = {
     'mark:create-failed': components['schemas']['CommandError'];
     'mark:delete-ok': components['schemas']['MarkDeleteOk'];
     'mark:delete-failed': components['schemas']['CommandError'];
+    'mark:archive-ok': {
+        correlationId?: string;
+    };
+    'mark:archive-failed': components['schemas']['CommandError'];
+    'mark:unarchive-ok': {
+        correlationId?: string;
+    };
+    'mark:unarchive-failed': components['schemas']['CommandError'];
+    'mark:update-entity-types-ok': {
+        correlationId?: string;
+    };
+    'mark:update-entity-types-failed': components['schemas']['CommandError'];
     'mark:body-update-failed': components['schemas']['CommandError'];
     'mark:select-comment': components['schemas']['SelectionData'];
     'mark:select-tag': components['schemas']['SelectionData'];
@@ -3843,15 +3865,17 @@ type EventMap = {
     'mark:assist-request': components['schemas']['MarkAssistRequestEvent'];
     'mark:assist-cancelled': void;
     'mark:progress-dismiss': void;
-    'mark:mode-toggled': void;
-    'mark:selection-changed': components['schemas']['MarkSelectionChangedEvent'];
-    'mark:click-changed': components['schemas']['MarkClickChangedEvent'];
-    'mark:shape-changed': components['schemas']['MarkShapeChangedEvent'];
     'frame:entity-type-added': StoredEvent<EventOfType<'frame:entity-type-added'>>;
     'frame:tag-schema-added': StoredEvent<EventOfType<'frame:tag-schema-added'>>;
     'frame:add-entity-type': components['schemas']['FrameAddEntityTypeCommand'];
     'frame:add-tag-schema': components['schemas']['FrameAddTagSchemaCommand'];
+    'frame:entity-type-add-ok': {
+        correlationId?: string;
+    };
     'frame:entity-type-add-failed': components['schemas']['CommandError'];
+    'frame:tag-schema-add-ok': {
+        correlationId?: string;
+    };
     'frame:tag-schema-add-failed': components['schemas']['CommandError'];
     'bind:initiate': BindInitiateCommand;
     'bind:update-body': BindUpdateBodyCommand;
@@ -3881,9 +3905,6 @@ type EventMap = {
         correlationId: string;
     } & components['schemas']['CommandError'];
     'gather:annotation-progress': components['schemas']['GatherProgress'];
-    'gather:annotation-finished': components['schemas']['GatherAnnotationFinished'];
-    'gather:progress': components['schemas']['GatherProgress'];
-    'gather:finished': components['schemas']['GatherFinished'];
     'browse:resource-requested': components['schemas']['BrowseResourceRequest'];
     'browse:resource-result': components['schemas']['BrowseResourceResult'];
     'browse:resource-failed': {
@@ -3937,6 +3958,11 @@ type EventMap = {
     'browse:tag-schemas-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
+    'browse:agents-requested': components['schemas']['BrowseAgentsRequest'];
+    'browse:agents-result': components['schemas']['BrowseAgentsResult'];
+    'browse:agents-failed': {
+        correlationId: string;
+    } & components['schemas']['CommandError'];
     'browse:directory-requested': components['schemas']['BrowseDirectoryRequest'];
     'browse:directory-result': components['schemas']['BrowseDirectoryResult'];
     'browse:directory-failed': {
@@ -3988,6 +4014,13 @@ type EventMap = {
     'job:claim-failed': {
         correlationId: string;
     } & components['schemas']['CommandError'];
+    'job:cancel-ok': {
+        correlationId?: string;
+        response: {
+            cancelled: number;
+        };
+    };
+    'job:cancel-failed': components['schemas']['CommandError'];
     'settings:theme-changed': components['schemas']['SettingsThemeChangedEvent'];
     'settings:line-numbers-toggled': void;
     'settings:locale-changed': components['schemas']['SettingsLocaleChangedEvent'];
@@ -4021,7 +4054,22 @@ type EventMap = {
         reason: string;
     };
 };
-/** Any valid channel name on the EventBus. */
+/**
+ * Any valid channel name on the EventBus — `keyof EventMap`, the root channel
+ * type. Two subsets matter, and confusing them is a silent-failure trap:
+ *
+ * - `EmittableChannel` (below) — channels with a non-null `CHANNEL_SCHEMAS`
+ *   entry; what you EMIT (the `/bus/emit` gateway validates the payload).
+ * - `BridgedChannel` (`bridged-channels.ts`) — the transport fan-in set; the
+ *   only channels a client can SUBSCRIBE to over a concrete transport.
+ *
+ * Request/reply (`busRequest`) emits on an `EmittableChannel` and subscribes on
+ * `BridgedChannel` replies. A reply channel that is a valid `EventName` but NOT
+ * in `BRIDGED_CHANNELS` is never delivered → the request times out with no
+ * compile or runtime error (see
+ * `.plans/bugs/gather-resource-complete-not-bridged.md`). `busRequest` now types
+ * its reply params `BridgedChannel` so that omission is a compile error.
+ */
 type EventName = keyof EventMap;
 /**
  * Genuine resource-bound broadcast event types.
@@ -4080,7 +4128,6 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'yield:create-failed': "CommandError";
     readonly 'yield:update-ok': "YieldUpdateOk";
     readonly 'yield:update-failed': null;
-    readonly 'yield:move-ok': "YieldMoveOk";
     readonly 'yield:move-failed': null;
     readonly 'yield:clone-token-generated': null;
     readonly 'yield:clone-token-failed': null;
@@ -4110,8 +4157,16 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'mark:create-failed': "CommandError";
     readonly 'mark:delete-ok': "MarkDeleteOk";
     readonly 'mark:delete-failed': "CommandError";
+    readonly 'mark:archive-ok': null;
+    readonly 'mark:archive-failed': "CommandError";
+    readonly 'mark:unarchive-ok': null;
+    readonly 'mark:unarchive-failed': "CommandError";
+    readonly 'mark:update-entity-types-ok': null;
+    readonly 'mark:update-entity-types-failed': "CommandError";
     readonly 'mark:body-update-failed': "CommandError";
+    readonly 'frame:entity-type-add-ok': null;
     readonly 'frame:entity-type-add-failed': "CommandError";
+    readonly 'frame:tag-schema-add-ok': null;
     readonly 'frame:tag-schema-add-failed': "CommandError";
     readonly 'mark:select-comment': "SelectionData";
     readonly 'mark:select-tag': "SelectionData";
@@ -4123,10 +4178,6 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'mark:assist-request': "MarkAssistRequestEvent";
     readonly 'mark:assist-cancelled': null;
     readonly 'mark:progress-dismiss': null;
-    readonly 'mark:mode-toggled': null;
-    readonly 'mark:selection-changed': "MarkSelectionChangedEvent";
-    readonly 'mark:click-changed': "MarkClickChangedEvent";
-    readonly 'mark:shape-changed': "MarkShapeChangedEvent";
     readonly 'bind:initiate': "BindInitiateCommand";
     readonly 'bind:update-body': "BindUpdateBodyCommand";
     readonly 'bind:body-updated': "BindBodyUpdated";
@@ -4144,9 +4195,6 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'gather:summary-result': null;
     readonly 'gather:summary-failed': null;
     readonly 'gather:annotation-progress': "GatherProgress";
-    readonly 'gather:annotation-finished': "GatherAnnotationFinished";
-    readonly 'gather:progress': "GatherProgress";
-    readonly 'gather:finished': "GatherFinished";
     readonly 'browse:resource-requested': "BrowseResourceRequest";
     readonly 'browse:resource-result': "BrowseResourceResult";
     readonly 'browse:resource-failed': null;
@@ -4177,6 +4225,9 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'browse:tag-schemas-requested': "BrowseTagSchemasRequest";
     readonly 'browse:tag-schemas-result': "BrowseTagSchemasResult";
     readonly 'browse:tag-schemas-failed': null;
+    readonly 'browse:agents-requested': "BrowseAgentsRequest";
+    readonly 'browse:agents-result': "BrowseAgentsResult";
+    readonly 'browse:agents-failed': null;
     readonly 'browse:directory-requested': "BrowseDirectoryRequest";
     readonly 'browse:directory-result': "BrowseDirectoryResult";
     readonly 'browse:directory-failed': null;
@@ -4214,6 +4265,8 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'job:create-failed': null;
     readonly 'job:claimed': null;
     readonly 'job:claim-failed': null;
+    readonly 'job:cancel-ok': null;
+    readonly 'job:cancel-failed': "CommandError";
     readonly 'settings:theme-changed': "SettingsThemeChangedEvent";
     readonly 'settings:line-numbers-toggled': null;
     readonly 'settings:locale-changed': "SettingsLocaleChangedEvent";
@@ -4242,6 +4295,14 @@ type EmittableChannel = {
 type Selector = components['schemas']['TextPositionSelector'] | components['schemas']['TextQuoteSelector'] | components['schemas']['SvgSelector'] | components['schemas']['FragmentSelector'];
 type GatheredContext = components['schemas']['GatheredContext'];
 type SelectionData = components['schemas']['SelectionData'];
+type JobType = components['schemas']['JobType'];
+/**
+ * One entry of the collaborator directory (`browse:agents-result`): a typed
+ * `Agent` plus, for software agents drawn from the KB's worker config, the
+ * job types it serves. Persons and actor-role-only agents omit
+ * `servesJobTypes`. See .plans/COLLABORATOR-DIRECTORY.md.
+ */
+type CollaboratorEntry = components['schemas']['CollaboratorEntry'];
 
 /**
  * Event Type Guards and Extraction Utilities
@@ -4699,7 +4760,9 @@ declare function validateSvgMarkup(svg: string): string | null;
  * Generates a bare annotation ID (no URL prefix). URIs are constructed
  * at the API boundary when returning responses to clients.
  *
- * Throws on invalid input (missing selector, missing motivation, invalid SVG).
+ * Throws on invalid input (missing motivation, invalid SVG markup). The target
+ * selector is OPTIONAL — a source-only target annotates the whole resource (W3C;
+ * e.g. resource-level edges), per RESOURCE-LEVEL-ANCHOR.
  */
 declare function assembleAnnotation(request: CreateAnnotationRequest, creator: Agent$2): AssembledAnnotation;
 /**
@@ -5320,23 +5383,229 @@ interface IContentTransport {
     dispose(): void;
 }
 
+declare const BUS_OPERATIONS: {
+    readonly 'bind:update-body': {
+        readonly result: "bind:body-updated";
+        readonly failure: "bind:body-update-failed";
+    };
+    readonly 'browse:resource-requested': {
+        readonly result: "browse:resource-result";
+        readonly failure: "browse:resource-failed";
+    };
+    readonly 'browse:resources-requested': {
+        readonly result: "browse:resources-result";
+        readonly failure: "browse:resources-failed";
+    };
+    readonly 'browse:annotation-requested': {
+        readonly result: "browse:annotation-result";
+        readonly failure: "browse:annotation-failed";
+    };
+    readonly 'browse:annotations-requested': {
+        readonly result: "browse:annotations-result";
+        readonly failure: "browse:annotations-failed";
+    };
+    readonly 'browse:annotation-history-requested': {
+        readonly result: "browse:annotation-history-result";
+        readonly failure: "browse:annotation-history-failed";
+    };
+    readonly 'browse:events-requested': {
+        readonly result: "browse:events-result";
+        readonly failure: "browse:events-failed";
+    };
+    readonly 'browse:referenced-by-requested': {
+        readonly result: "browse:referenced-by-result";
+        readonly failure: "browse:referenced-by-failed";
+    };
+    readonly 'browse:entity-types-requested': {
+        readonly result: "browse:entity-types-result";
+        readonly failure: "browse:entity-types-failed";
+    };
+    readonly 'browse:tag-schemas-requested': {
+        readonly result: "browse:tag-schemas-result";
+        readonly failure: "browse:tag-schemas-failed";
+    };
+    readonly 'browse:agents-requested': {
+        readonly result: "browse:agents-result";
+        readonly failure: "browse:agents-failed";
+    };
+    readonly 'browse:directory-requested': {
+        readonly result: "browse:directory-result";
+        readonly failure: "browse:directory-failed";
+    };
+    readonly 'browse:annotation-context-requested': {
+        readonly result: "browse:annotation-context-result";
+        readonly failure: "browse:annotation-context-failed";
+    };
+    readonly 'frame:add-entity-type': {
+        readonly result: "frame:entity-type-add-ok";
+        readonly failure: "frame:entity-type-add-failed";
+    };
+    readonly 'frame:add-tag-schema': {
+        readonly result: "frame:tag-schema-add-ok";
+        readonly failure: "frame:tag-schema-add-failed";
+    };
+    readonly 'gather:requested': {
+        readonly result: "gather:complete";
+        readonly failure: "gather:failed";
+        readonly progress: "gather:annotation-progress";
+    };
+    readonly 'gather:resource-requested': {
+        readonly result: "gather:resource-complete";
+        readonly failure: "gather:resource-failed";
+    };
+    readonly 'gather:summary-requested': {
+        readonly result: "gather:summary-result";
+        readonly failure: "gather:summary-failed";
+    };
+    readonly 'job:create': {
+        readonly result: "job:created";
+        readonly failure: "job:create-failed";
+    };
+    readonly 'job:status-requested': {
+        readonly result: "job:status-result";
+        readonly failure: "job:status-failed";
+    };
+    readonly 'job:cancel-requested': {
+        readonly result: "job:cancel-ok";
+        readonly failure: "job:cancel-failed";
+    };
+    readonly 'job:claim': {
+        readonly result: "job:claimed";
+        readonly failure: "job:claim-failed";
+    };
+    readonly 'mark:create-request': {
+        readonly result: "mark:create-ok";
+        readonly failure: "mark:create-failed";
+    };
+    readonly 'mark:delete': {
+        readonly result: "mark:delete-ok";
+        readonly failure: "mark:delete-failed";
+    };
+    readonly 'mark:archive': {
+        readonly result: "mark:archive-ok";
+        readonly failure: "mark:archive-failed";
+    };
+    readonly 'mark:unarchive': {
+        readonly result: "mark:unarchive-ok";
+        readonly failure: "mark:unarchive-failed";
+    };
+    readonly 'mark:update-entity-types': {
+        readonly result: "mark:update-entity-types-ok";
+        readonly failure: "mark:update-entity-types-failed";
+    };
+    readonly 'match:search-requested': {
+        readonly result: "match:search-results";
+        readonly failure: "match:search-failed";
+    };
+    readonly 'yield:create': {
+        readonly result: "yield:create-ok";
+        readonly failure: "yield:create-failed";
+    };
+    readonly 'yield:update': {
+        readonly result: "yield:update-ok";
+        readonly failure: "yield:update-failed";
+    };
+    readonly 'yield:clone-create': {
+        readonly result: "yield:clone-created";
+        readonly failure: "yield:clone-create-failed";
+    };
+    readonly 'yield:clone-resource-requested': {
+        readonly result: "yield:clone-resource-result";
+        readonly failure: "yield:clone-resource-failed";
+    };
+    readonly 'yield:clone-token-requested': {
+        readonly result: "yield:clone-token-generated";
+        readonly failure: "yield:clone-token-failed";
+    };
+};
+/** The request-channel key of a registered operation — what `busRequest` takes. */
+type BusOperationKey = keyof typeof BUS_OPERATIONS;
+
 /**
  * BRIDGED_CHANNELS
  *
  * The set of bus channels that any concrete transport bridges into the
  * caller-supplied bus via `bridgeInto`. Transport-neutral: every concrete
- * `ITransport` shares the same set; HTTP delivers them via SSE,
- * in-process transports forward them directly from the local actor bus.
+ * `ITransport` shares the same set; HTTP delivers them via SSE, in-process
+ * transports forward them directly from the local actor bus.
+ *
+ * This is the *fan-in* set — channels for events the transport receives and
+ * pushes onto the client's bus. It is not the same as the channels the client
+ * emits (which is open-ended).
+ *
+ * It is DERIVED, not hand-listed: the request/reply replies come from
+ * `BUS_OPERATIONS` (bus-operations.ts), so no operation's reply can be
+ * forgotten here — that was the recurring unbridged-reply bug class. The only
+ * hand-maintained part is `BRIDGED_BROADCASTS`: the genuine non-request/reply
+ * minority (lifecycle events and UI/infra signals that no single requester
+ * owns). See .plans/BUS-OPERATIONS-REGISTRY.md.
+ *
+ * Resource-scoped channels (joined/left via `subscribeToResource`) are tracked
+ * separately by transports that care about scope (HTTP).
+ */
+/**
+ * Bridged channels with no owning operation: job-lifecycle events (multi-viewer,
+ * no single requester owns the reply), KB-global frame domain events, UI signals,
+ * and SSE infrastructure. A reply channel must NOT go here — declare its
+ * operation in `BUS_OPERATIONS` instead.
+ */
+declare const BRIDGED_BROADCASTS: readonly ["job:report-progress", "job:complete", "job:fail", "frame:entity-type-added", "frame:tag-schema-added", "beckon:focus", "beckon:sparkle", "bus:resume-gap"];
+type OpSpecs = (typeof BUS_OPERATIONS)[keyof typeof BUS_OPERATIONS];
+type ProgressChannel<O> = O extends {
+    progress: infer P extends EventName;
+} ? P : never;
+/** The union of every reply channel declared in the registry. */
+type RegistryReply = OpSpecs['result'] | OpSpecs['failure'] | ProgressChannel<OpSpecs>;
+declare const BRIDGED_CHANNELS: readonly BridgedChannel[];
+/**
+ * The SUBSCRIBE-side subset of `EventName` — the channels a client can receive
+ * over a concrete transport. See the family note on `EventName` in
+ * bus-protocol.ts (emit on an `EmittableChannel`, subscribe on a `BridgedChannel`).
+ */
+type BridgedChannel = RegistryReply | (typeof BRIDGED_BROADCASTS)[number];
+
+/**
+ * The value a registered operation resolves to: the `response` field of its
+ * result channel's payload, or `void` for a result channel that carries no
+ * `response` (a confirmed-write ack with no data). Inferred from the registry,
+ * so callers never annotate `busRequest`'s return type. Relies on the reply-shape
+ * standard — see .plans/REPLY-SHAPE-STANDARD.md.
+ */
+type BusReply<Op extends BusOperationKey> = EventMap[(typeof BUS_OPERATIONS)[Op]['result'] & EventName] extends {
+    response: infer R;
+} ? R : void;
+type BusRequestErrorCode = 'bus.timeout' | 'bus.rejected' | 'bus.closed' | 'bus.bad-payload' | 'bus.unauthorized' | 'bus.forbidden' | 'bus.not-found';
+declare class BusRequestError extends SemiontError {
+    code: BusRequestErrorCode;
+    constructor(message: string, code: BusRequestErrorCode, details?: Record<string, unknown>);
+}
+/**
+ * Subset of ITransport that `busRequest` needs: a way to send a command and
+ * a way to observe channels. Generic enough that an in-process transport
+ * can satisfy it without round-tripping through HTTP.
+ */
+interface BusRequestPrimitive {
+    emit<K extends keyof EventMap>(channel: K, payload: EventMap[K]): Promise<void>;
+    stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]>;
+}
+/**
+ * Request/reply over the bus, keyed by the operation's request channel.
  *
- * Note: this is the *fan-in* set — channels for events the transport
- * receives and pushes onto the client's bus. It is not the same as the
- * channels the client emits (which is open-ended).
+ * The `operation` is a `BusOperationKey` (a request channel declared in
+ * `BUS_OPERATIONS`); the matching `result`/`failure` reply channels are looked
+ * up from the registry, so a caller cannot pass a mismatched or unbridged reply
+ * pair — the recurring unbridged-reply bug class is unrepresentable. Every
+ * registry reply derives into `BRIDGED_CHANNELS` (see bridged-channels.ts), so
+ * the transport always subscribes to it (cf.
+ * .plans/bugs/gather-resource-complete-not-bridged.md, where the `gather:resource-*`
+ * pair shipped unbridged with no compile/runtime signal).
  *
- * Resource-scoped channels (joined/left via `subscribeToResource`) are
- * tracked separately by transports that care about scope (HTTP).
+ * The return type is INFERRED from the registry (`BusReply<Op>` = the result
+ * channel's `response` type, or `void`) — callers never annotate it. Every reply
+ * is `{ correlationId, response: T }` (data) or `{ correlationId }` (void); see
+ * .plans/REPLY-SHAPE-STANDARD.md. `busRequest` reads `e.response`.
  */
-declare const BRIDGED_CHANNELS: readonly ["browse:resources-result", "browse:resources-failed", "browse:resource-result", "browse:resource-failed", "browse:annotations-result", "browse:annotations-failed", "browse:annotation-result", "browse:annotation-failed", "browse:annotation-history-result", "browse:annotation-history-failed", "browse:events-result", "browse:events-failed", "browse:referenced-by-result", "browse:referenced-by-failed", "browse:entity-types-result", "browse:entity-types-failed", "browse:tag-schemas-result", "browse:tag-schemas-failed", "browse:directory-result", "browse:directory-failed", "browse:annotation-context-result", "browse:annotation-context-failed", "mark:delete-ok", "mark:delete-failed", "mark:create-ok", "mark:create-failed", "match:search-results", "match:search-failed", "gather:complete", "gather:failed", "gather:annotation-progress", "gather:annotation-finished", "gather:summary-result", "gather:summary-failed", "bind:body-updated", "bind:body-update-failed", "job:report-progress", "job:complete", "job:fail", "job:status-result", "job:status-failed", "job:created", "job:create-failed", "job:claimed", "job:claim-failed", "yield:create-ok", "yield:create-failed", "yield:update-ok", "yield:update-failed", "yield:clone-token-generated", "yield:clone-token-failed", "yield:clone-resource-result", "yield:clone-resource-failed", "yield:clone-created", "yield:clone-create-failed", "frame:entity-type-added", "frame:tag-schema-added", "beckon:focus", "beckon:sparkle", "bus:resume-gap"];
-type BridgedChannel = typeof BRIDGED_CHANNELS[number];
+declare function busRequest<Op extends BusOperationKey>(bus: BusRequestPrimitive, operation: Op, payload: Record<string, unknown>, timeoutMs?: number): Promise<BusReply<Op>>;
 
 /**
  * Fuzzy Anchoring for W3C Web Annotation TextQuoteSelector
@@ -6003,6 +6272,33 @@ interface GoogleAuthRequest {
  */
 declare function generateUuid(): string;
 
+/**
+ * Marker for the state-unit pattern: a stateful, lifecycled object with an
+ * RxJS-shaped public surface, constructed by a factory function
+ * (`createFooStateUnit`), with internal state held in a closure.
+ *
+ * The structural contract is `dispose()` — the rest of the pattern
+ * (closure-based identity, Observable public surface, internal Subjects
+ * exposed as `.asObservable()` views, no leaked subscriptions, composition
+ * by parameter rather than ownership) is convention, made executable by the
+ * axiom harness in `@semiont/core/testing` (`assertStateUnitAxioms`).
+ *
+ * Lives in `@semiont/core` (not sdk) so every layer can share one definition
+ * without dependency cycles — `http-transport`'s `ActorStateUnit` sits below
+ * sdk and would otherwise have to re-declare it. See
+ * `packages/sdk/docs/STATE-UNITS.md` for the full pattern and rationale, and
+ * `.plans/STATE-UNIT-AXIOMS.md` for the axiom ledger.
+ */
+interface StateUnit {
+    /**
+     * Idempotent, total teardown. Completes every Subject the unit owns,
+     * unsubscribes every internal subscription, releases timers / abort
+     * controllers / network handles. Safe to call multiple times — the
+     * second call is a no-op.
+     */
+    dispose(): void;
+}
+
 /**
  * Common type guard utilities
  */
@@ -6805,5 +7101,36 @@ declare function isValidPlatformType(value: string): value is PlatformType;
  */
 declare function getAllPlatformTypes(): PlatformType[];
 
-export { AUTHORABLE_MEDIA_TYPES, BRIDGED_CHANNELS, 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, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseMediaType, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, capabilitiesOf, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, 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, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
-export type { AccessToken, AnchorConfidence, AnchorMethod, AnchorSelectors, AnchorStrategy, AnchoringModel, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, CloneToken, 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, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, 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, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, 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 };
+/**
+ * Knowledge-graph view derivation (CONTEXT-UNIFICATION P3, Q1=A).
+ *
+ * A pure function over the core `KnowledgeGraph` type, so both `@semiont/make-meaning` (the matcher)
+ * and `@semiont/jobs` (the generation prompt builder) can share one derivation. `buildKnowledgeGraph`
+ * — which queries the graph DB — stays in make-meaning; this only transforms an already-built graph.
+ *
+ * Reports the graph as-is (Option A): missing-view citers are kept (the citation edge reflects a real
+ * reference event); the only filter is excluding the focal annotation from siblings (an annotation
+ * isn't its own sibling). Peer connections are edges out of `mainResourceId`; citations and
+ * `annotation-of` edges point INTO it. The graph is a projection of the event log (the system of
+ * record), read here because it is the queryable projection at gather time.
+ */
+
+type KnowledgeGraph = components['schemas']['KnowledgeGraph'];
+interface GraphViews {
+    connections: {
+        resourceId: string;
+        resourceName: string;
+        entityTypes: string[];
+        bidirectional: boolean;
+    }[];
+    citedBy: {
+        resourceId: string;
+        resourceName: string;
+    }[];
+    citedByCount: number;
+    siblingEntityTypes: string[];
+}
+declare function deriveViews(graph: KnowledgeGraph, mainResourceId: string, focalAnnotationId?: string): GraphViews;
+
+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, 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, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
+export type { AccessToken, AnchorConfidence, AnchorMethod, 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, 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 };