@semiont/core 0.5.20 → 0.5.22

package/dist/testing.d.ts

@@ -293,6 +293,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. */
@@ -319,20 +333,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} */
@@ -669,8 +671,8 @@ interface components {
             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 The KB's did:web identifier, from its committed .semiont/config — "did:web:" + the [site] domain, verbatim. REQUIRED: a KB that declares no domain has no identity to publish, and the launcher refuses to start it rather than inventing or defaulting one. NOT unique within a document: a did names the knowledge base, not a running copy of it, so a local clone and a codespace of the same repo legitimately share one and both are published. host:port is the unique field (at most one entry per address), so consumers look up by ADDRESS and use the did to VERIFY that the copy they reached is the KB they meant — an address alone cannot say which KB is which, and an identity alone cannot say which copy. */
+            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. */
@@ -784,6 +786,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 */
@@ -792,15 +803,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: {
@@ -1400,12 +1403,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 */
@@ -1607,6 +1606,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 */
@@ -1673,6 +1679,8 @@ interface components {
             projectName?: string;
             /** @description Current git branch of the knowledge base repository */
             gitBranch?: string;
+            /** @description The knowledge base's did:web identity — 'did:web:' + the committed [site] domain, byte-identical to the string the launcher publishes in its discovery document. REQUIRED: a KB that declares no domain does not run (the launcher refuses to start it, and the backend refuses to boot), so a response without this field means the caller reached something that bypassed both. Identifies WHICH knowledge base this is; it does NOT identify which running copy — one KB reachable at two addresses (a local clone and a codespace of one repo) reports the same did at both. Use it to verify what you connected to, not to select among discovered entries. */
+            did: string;
         };
         /** @description A persisted domain event with metadata. Flat shape — event fields and metadata are peers. */
         StoredEventResponse: {
@@ -2075,6 +2083,23 @@ type StoredEvent<T extends EventBase = PersistedEvent> = T & {
     signature?: EventSignature;
 };
 
+/**
+ * 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
  *
@@ -2118,22 +2143,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'>>;