@semiont/core 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -1768,6 +1768,65 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/resources/{id}/gather-resource-stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Gather Resource LLM Context (SSE Stream)
+         * @description Stream real-time resource LLM context gathering progress via Server-Sent Events
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["GatherResourceStreamRequest"];
+                };
+            };
+            responses: {
+                /** @description SSE stream opened successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": components["schemas"]["EventStreamResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Resource not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/resources/{resourceId}/annotations/{annotationId}/llm-context": {
         parameters: {
             query?: never;
@@ -1814,6 +1873,130 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/resources/{resourceId}/annotations/{annotationId}/gather-annotation-stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Gather Annotation LLM Context (SSE Stream)
+         * @description Stream real-time annotation LLM context gathering progress via Server-Sent Events
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    resourceId: string;
+                    /** @description Annotation ID */
+                    annotationId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["GatherAnnotationStreamRequest"];
+                };
+            };
+            responses: {
+                /** @description SSE stream opened successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": components["schemas"]["EventStreamResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Annotation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/resources/{resourceId}/annotations/{annotationId}/bind-stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bind Annotation Body (SSE Stream)
+         * @description Apply annotation body operations and stream completion via Server-Sent Events
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    resourceId: string;
+                    /** @description Annotation ID */
+                    annotationId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["BindAnnotationStreamRequest"];
+                };
+            };
+            responses: {
+                /** @description SSE stream opened successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": components["schemas"]["EventStreamResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Annotation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/resources/{id}/referenced-by": {
         parameters: {
             query?: never;
@@ -2588,6 +2771,91 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/participants/{id}/attention": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Beckon Participant
+         * @description Direct a participant's attention to a resource or annotation. Produces no persistent annotations — attention signal only. The participant may be a human username or an agent identifier.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Participant username or agent identifier */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["BeckonRequest"];
+                };
+            };
+            responses: {
+                /** @description Attention signal accepted */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["BeckonResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/participants/me/attention-stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Participant Attention Stream
+         * @description Open a persistent SSE connection to receive beckon signals directed at the authenticated participant. Signals are ephemeral — delivered if connected, dropped if not. No queue, no replay.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description SSE stream of beckon:focus events */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "text/event-stream": string;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 interface components {
     schemas: {
@@ -2773,6 +3041,22 @@ interface components {
          * @enum {string}
          */
         BodyType: "TextualBody" | "SpecificResource";
+        BeckonRequest: {
+            /** @description Resource to direct attention at */
+            resourceId: string;
+            /** @description Specific annotation within the resource (optional) */
+            annotationId?: string;
+            /** @description Human-readable context for the participant (max 500 chars) */
+            message?: string;
+        };
+        BeckonResponse: {
+            /** @description Username or agent identifier that was beckoned */
+            participant: string;
+            /** @description Resource the attention was directed at */
+            resourceId: string;
+            /** @description Annotation the attention was directed at (if provided) */
+            annotationId?: string;
+        };
         BulkAddEntityTypesRequest: {
             tags: string[];
         };
@@ -2901,6 +3185,26 @@ interface components {
             /** @description Include anaphoric/cataphoric references (e.g., 'the CEO', 'the tech giant') in addition to direct mentions */
             includeDescriptiveReferences?: boolean;
         };
+        GatherResourceStreamRequest: {
+            /** @description Graph traversal depth (default: 2) */
+            depth?: number;
+            /** @description Maximum related resources to include (default: 10) */
+            maxResources?: number;
+            /** @description Include full resource content (default: true) */
+            includeContent?: boolean;
+            /** @description Include AI-generated summary (default: false) */
+            includeSummary?: boolean;
+        };
+        GatherAnnotationStreamRequest: {
+            /** @description Characters of surrounding text context (default: 1000) */
+            contextWindow?: number;
+        };
+        BindAnnotationStreamRequest: {
+            /** @description Resource ID containing the annotation (required for O(1) Layer 3 lookup) */
+            resourceId: string;
+            /** @description Array of body modification operations to apply */
+            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
+        };
         AnnotateHighlightsStreamRequest: {
             /** @description Optional instructions to guide AI highlight annotation */
             instructions?: string;
@@ -3155,10 +3459,10 @@ interface components {
             refresh_token: string;
         };
         /**
-         * @description W3C Web Annotation motivation vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation
+         * @description Semiont-supported W3C Web Annotation motivations - https://www.w3.org/TR/annotation-vocab/#motivation
          * @enum {string}
          */
-        Motivation: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
+        Motivation: "assessing" | "commenting" | "highlighting" | "linking" | "tagging";
         OAuthConfigResponse: {
             providers: {
                 name: string;
@@ -3328,7 +3632,7 @@ interface components {
             /** @description IRI of the target resource */
             source: string;
             /** @description Why this body is included */
-            purpose?: components["schemas"]["Motivation"];
+            purpose?: components["schemas"]["BodyPurpose"];
         };
         StatusResponse: {
             status: string;
@@ -3362,7 +3666,7 @@ interface components {
             /** @description The text content (e.g., entity type name) */
             value: string;
             /** @description Why this body is included */
-            purpose?: components["schemas"]["Motivation"];
+            purpose?: components["schemas"]["BodyPurpose"];
             /** @description MIME type (defaults to text/plain) */
             format?: string;
             /** @description BCP 47 language tag */
@@ -3443,6 +3747,11 @@ interface components {
              */
             conformsTo?: string;
         };
+        /**
+         * @description W3C Web Annotation body purpose vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation
+         * @enum {string}
+         */
+        BodyPurpose: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
         /** @description Context gathered for an annotation. Includes source document excerpts, metadata, and graph-derived context. Used by both Find (bind) and Generate (yield) flows. */
         GatheredContext: {
             /** @description The annotation this context was gathered for */
@@ -4306,6 +4615,12 @@ type EventMap = {
     'bind:body-update-failed': {
         error: Error;
     };
+    'bind:finished': {
+        annotationId: AnnotationId;
+    };
+    'bind:failed': {
+        error: Error;
+    };
     'bind:search-results': {
         referenceId: string;
         results: Array<components['schemas']['ResourceDescriptor'] & {
@@ -4352,6 +4667,15 @@ type EventMap = {
         annotationId: AnnotationId;
         error: Error;
     };
+    'gather:annotation-progress': {
+        message?: string;
+        percentage?: number;
+    };
+    'gather:annotation-finished': {
+        correlationId?: string;
+        annotationId: AnnotationId;
+        response: components['schemas']['AnnotationLLMContextResponse'];
+    };
     'gather:resource-requested': {
         correlationId?: string;
         resourceId: ResourceId;
@@ -4372,6 +4696,15 @@ type EventMap = {
         resourceId: ResourceId;
         error: Error;
     };
+    'gather:progress': {
+        message?: string;
+        percentage?: number;
+    };
+    'gather:finished': {
+        correlationId?: string;
+        resourceId: ResourceId;
+        context: components['schemas']['ResourceLLMContextResponse'];
+    };
     'browse:click': {
         annotationId: string;
         motivation: Motivation;
@@ -4497,7 +4830,8 @@ type EventMap = {
         annotationId: string | null;
     };
     'beckon:focus': {
-        annotationId: string | null;
+        annotationId?: string;
+        resourceId?: string;
     };
     'beckon:sparkle': {
         annotationId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/core",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Core domain types for Semiont - Document, Annotation, and Graph models",
   "type": "module",
   "main": "dist/index.js",
@@ -64,11 +64,9 @@
     "openapi-typescript": "^7.10.1",
     "tsup": "^8.5.1",
     "tsx": "^4.19.2",
-    "typescript": "^5.6.3",
-    "vitest": "^4.0.18"
+    "typescript": "^5.6.3"
   },
   "dependencies": {
-    "@vitest/ui": "4.0.18",
     "ajv": "^8.17.1",
     "ajv-formats": "^2.1.1",
     "rxjs": "^7.8.1",