@semiont/core 0.5.19 → 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} */
@@ -2043,7 +2045,7 @@ interface components {
         BrowsePanelOpenEvent: {
             panel: string;
             scrollToAnnotationId?: string;
-            motivation?: string;
+            motivation?: components["schemas"]["Motivation"];
         };
         /** @description Emitted when a browse panel is toggled */
         BrowsePanelToggleEvent: {
@@ -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'>>;
@@ -3924,8 +3931,23 @@ type EventMap = {
     'mark:cancel-pending': void;
     'mark:submit': components['schemas']['MarkSubmitEvent'];
     'mark:assist-request': components['schemas']['MarkAssistRequestEvent'];
-    'mark:assist-cancelled': void;
     'mark:progress-dismiss': void;
+    'mark:assist-timeout': {
+        resourceId: string;
+        motivation: components['schemas']['Motivation'];
+    };
+    'mark:create-error': {
+        resourceId: string;
+        message: string;
+    };
+    'mark:delete-error': {
+        resourceId: string;
+        message: string;
+    };
+    'bind:body-error': {
+        resourceId: string;
+        message: string;
+    };
     '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'];
@@ -4168,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:
@@ -4290,8 +4313,11 @@ declare const CHANNEL_SCHEMAS: {
     readonly 'mark:cancel-pending': null;
     readonly 'mark:submit': "MarkSubmitEvent";
     readonly 'mark:assist-request': "MarkAssistRequestEvent";
-    readonly 'mark:assist-cancelled': null;
     readonly 'mark:progress-dismiss': null;
+    readonly 'mark:assist-timeout': null;
+    readonly 'mark:create-error': null;
+    readonly 'mark:delete-error': null;
+    readonly 'bind:body-error': null;
     readonly 'bind:initiate': "BindInitiateCommand";
     readonly 'bind:update-body': "BindUpdateBodyCommand";
     readonly 'bind:body-updated': "BindBodyUpdated";

package/dist/index.js

@@ -197,10 +197,16 @@ var CHANNEL_SCHEMAS = {
   // void
   "mark:submit": "MarkSubmitEvent",
   "mark:assist-request": "MarkAssistRequestEvent",
-  "mark:assist-cancelled": null,
-  // void
   "mark:progress-dismiss": null,
   // void
+  "mark:assist-timeout": null,
+  // { resourceId; motivation } — client-local UI signal
+  "mark:create-error": null,
+  // { resourceId; message } — client-local UI signal
+  "mark:delete-error": null,
+  // { resourceId; message } — client-local UI signal
+  "bind:body-error": null,
+  // { resourceId; message } — client-local UI signal
   // ── BIND FLOW ───────────────────────────────────────────────────
   "bind:initiate": "BindInitiateCommand",
   "bind:update-body": "BindUpdateBodyCommand",