@semiont/core 0.5.20 → 0.5.21

package/dist/index.d.ts

@@ -1865,6 +1865,20 @@ interface components {
         BeckonSparkleEvent: {
             annotationId: string;
         };
+        /** @description One edit to a linking annotation's body list: add or remove a body item, or replace an existing one. */
+        BindBodyOperation: {
+            /**
+             * @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 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. */
@@ -1891,20 +1905,8 @@ interface components {
             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 Ordered body-list edits to apply. */
+            operations: components["schemas"]["BindBodyOperation"][];
         };
         BodyOperationAdd: {
             /** @enum {string} */
@@ -2356,6 +2358,15 @@ interface components {
             /** @description The gathered annotation context (unified GatheredContext, focus.kind:'annotation') */
             response: components["schemas"]["GatheredContext"];
         };
+        /** @description Optional configuration for an annotation-focus gather, which windows text around a mark. Distinct from the resource-focus options (depth / maxResources / includeContent / includeSummary), which traverse the resource graph. */
+        GatherAnnotationOptions: {
+            /** @description Whether to include source context in the gathered result */
+            includeSourceContext?: boolean;
+            /** @description Whether to include target context in the gathered result */
+            includeTargetContext?: boolean;
+            /** @description Characters of surrounding text context to include */
+            contextWindow?: number;
+        };
         /** @description Request payload sent on the gather:requested bus channel to gather context for an annotation. */
         GatherAnnotationRequest: {
             /** @description Client-generated correlation ID to thread the response back to the originating request */
@@ -2364,15 +2375,7 @@ interface components {
             annotationId: string;
             /** @description Branded ResourceId of the resource the annotation belongs to */
             resourceId: string;
-            /** @description Optional gathering configuration */
-            options?: {
-                /** @description Whether to include source context in the gathered result */
-                includeSourceContext?: boolean;
-                /** @description Whether to include target context in the gathered result */
-                includeTargetContext?: boolean;
-                /** @description Characters of surrounding text context to include */
-                contextWindow?: number;
-            };
+            options?: components["schemas"]["GatherAnnotationOptions"];
         };
         /** @description Progress payload emitted on the gather:annotation-progress SSE channel during LLM context gathering. */
         GatherProgress: {
@@ -2972,12 +2975,8 @@ interface components {
         MatchSearchResult: {
             correlationId: string;
             referenceId: string;
-            response: (components["schemas"]["ResourceDescriptor"] & {
-                /** @description Relevance score */
-                score?: number;
-                /** @description Human-readable reason for the match */
-                matchReason?: string;
-            })[];
+            /** @description The scored candidates, best first. */
+            response: components["schemas"]["ScoredResource"][];
         };
         MediaTokenRequest: {
             /** @description The resource ID to generate a media token for */
@@ -3179,6 +3178,13 @@ interface components {
             contentChecksum: string;
             contentByteSize?: number;
         };
+        /** @description A resource returned by a search, carrying its relevance score and the reason it matched. */
+        ScoredResource: components["schemas"]["ResourceDescriptor"] & {
+            /** @description Relevance score assigned by the matcher; higher is a better candidate. */
+            score?: number;
+            /** @description Human-readable reason for the match. */
+            matchReason?: 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 */
@@ -3787,6 +3793,23 @@ interface ResourceAnnotations {
     updatedAt: string;
 }
 
+/**
+ * Viewport-space rectangle of a clicked annotation element — runtime-only
+ * view geometry riding UI events (never wire vocabulary; deliberately not in
+ * the OpenAPI schemas). Structurally satisfied by a DOM `DOMRect`, spelled
+ * out here because this package compiles without the DOM lib.
+ */
+interface AnchorRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+
 /**
  * Bus Protocol
  *
@@ -3830,22 +3853,6 @@ type BindUpdateBodyCommand = components['schemas']['BindUpdateBodyCommand'] & {
  * - Commands/reads/results/UI: OpenAPI schema refs — plain strings
  * - void: UI-only signals with no payload
  */
-/**
- * Viewport-space rectangle of a clicked annotation element — runtime-only
- * view geometry riding UI events (never wire vocabulary; deliberately not in
- * the OpenAPI schemas). Structurally satisfied by a DOM `DOMRect`, spelled
- * out here because this package compiles without the DOM lib.
- */
-interface AnchorRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}
 type EventMap = {
     'yield:created': StoredEvent<EventOfType<'yield:created'>>;
     'yield:cloned': StoredEvent<EventOfType<'yield:cloned'>>;
@@ -4183,6 +4190,7 @@ type EventMap = {
         reason: string;
     };
 };
+
 /**
  * Any valid channel name on the EventBus — `keyof EventMap`, the root channel
  * type. Two subsets matter, and confusing them is a silent-failure trap: