@semiont/backend 0.4.2 → 0.4.3

package/dist/index.js

@@ -1580,9 +1580,9 @@ var require_Subject = __commonJS({
     var ObjectUnsubscribedError_1 = require_ObjectUnsubscribedError();
     var arrRemove_1 = require_arrRemove();
     var errorContext_1 = require_errorContext();
-    var Subject = (function(_super) {
-      __extends(Subject2, _super);
-      function Subject2() {
+    var Subject2 = (function(_super) {
+      __extends(Subject3, _super);
+      function Subject3() {
         var _this = _super.call(this) || this;
         _this.closed = false;
         _this.currentObservers = null;
@@ -1592,18 +1592,18 @@ var require_Subject = __commonJS({
         _this.thrownError = null;
         return _this;
       }
-      __name(Subject2, "Subject");
-      Subject2.prototype.lift = function(operator) {
+      __name(Subject3, "Subject");
+      Subject3.prototype.lift = function(operator) {
         var subject = new AnonymousSubject(this, this);
         subject.operator = operator;
         return subject;
       };
-      Subject2.prototype._throwIfClosed = function() {
+      Subject3.prototype._throwIfClosed = function() {
         if (this.closed) {
           throw new ObjectUnsubscribedError_1.ObjectUnsubscribedError();
         }
       };
-      Subject2.prototype.next = function(value) {
+      Subject3.prototype.next = function(value) {
         var _this = this;
         errorContext_1.errorContext(function() {
           var e_1, _a;
@@ -1631,7 +1631,7 @@ var require_Subject = __commonJS({
           }
         });
       };
-      Subject2.prototype.error = function(err) {
+      Subject3.prototype.error = function(err) {
         var _this = this;
         errorContext_1.errorContext(function() {
           _this._throwIfClosed();
@@ -1645,7 +1645,7 @@ var require_Subject = __commonJS({
           }
         });
       };
-      Subject2.prototype.complete = function() {
+      Subject3.prototype.complete = function() {
         var _this = this;
         errorContext_1.errorContext(function() {
           _this._throwIfClosed();
@@ -1658,11 +1658,11 @@ var require_Subject = __commonJS({
           }
         });
       };
-      Subject2.prototype.unsubscribe = function() {
+      Subject3.prototype.unsubscribe = function() {
         this.isStopped = this.closed = true;
         this.observers = this.currentObservers = null;
       };
-      Object.defineProperty(Subject2.prototype, "observed", {
+      Object.defineProperty(Subject3.prototype, "observed", {
         get: /* @__PURE__ */ __name(function() {
           var _a;
           return ((_a = this.observers) === null || _a === void 0 ? void 0 : _a.length) > 0;
@@ -1670,16 +1670,16 @@ var require_Subject = __commonJS({
         enumerable: false,
         configurable: true
       });
-      Subject2.prototype._trySubscribe = function(subscriber) {
+      Subject3.prototype._trySubscribe = function(subscriber) {
         this._throwIfClosed();
         return _super.prototype._trySubscribe.call(this, subscriber);
       };
-      Subject2.prototype._subscribe = function(subscriber) {
+      Subject3.prototype._subscribe = function(subscriber) {
         this._throwIfClosed();
         this._checkFinalizedStatuses(subscriber);
         return this._innerSubscribe(subscriber);
       };
-      Subject2.prototype._innerSubscribe = function(subscriber) {
+      Subject3.prototype._innerSubscribe = function(subscriber) {
         var _this = this;
         var _a = this, hasError = _a.hasError, isStopped = _a.isStopped, observers = _a.observers;
         if (hasError || isStopped) {
@@ -1692,7 +1692,7 @@ var require_Subject = __commonJS({
           arrRemove_1.arrRemove(observers, subscriber);
         });
       };
-      Subject2.prototype._checkFinalizedStatuses = function(subscriber) {
+      Subject3.prototype._checkFinalizedStatuses = function(subscriber) {
         var _a = this, hasError = _a.hasError, thrownError = _a.thrownError, isStopped = _a.isStopped;
         if (hasError) {
           subscriber.error(thrownError);
@@ -1700,17 +1700,17 @@ var require_Subject = __commonJS({
           subscriber.complete();
         }
       };
-      Subject2.prototype.asObservable = function() {
+      Subject3.prototype.asObservable = function() {
         var observable = new Observable_1.Observable();
         observable.source = this;
         return observable;
       };
-      Subject2.create = function(destination, source) {
+      Subject3.create = function(destination, source) {
         return new AnonymousSubject(destination, source);
       };
-      return Subject2;
+      return Subject3;
     })(Observable_1.Observable);
-    exports$1.Subject = Subject;
+    exports$1.Subject = Subject2;
     var AnonymousSubject = (function(_super) {
       __extends(AnonymousSubject2, _super);
       function AnonymousSubject2(destination, source) {
@@ -1737,7 +1737,7 @@ var require_Subject = __commonJS({
         return (_b = (_a = this.source) === null || _a === void 0 ? void 0 : _a.subscribe(subscriber)) !== null && _b !== void 0 ? _b : Subscription_1.EMPTY_SUBSCRIPTION;
       };
       return AnonymousSubject2;
-    })(Subject);
+    })(Subject2);
     exports$1.AnonymousSubject = AnonymousSubject;
   }
 });
@@ -12854,6 +12854,48 @@ var openapi_default = {
         ],
         description: "Annotation body type - TextualBody for textual content, SpecificResource for resource links"
       },
+      BeckonRequest: {
+        type: "object",
+        properties: {
+          resourceId: {
+            type: "string",
+            description: "Resource to direct attention at"
+          },
+          annotationId: {
+            type: "string",
+            description: "Specific annotation within the resource (optional)"
+          },
+          message: {
+            type: "string",
+            description: "Human-readable context for the participant (max 500 chars)",
+            maxLength: 500
+          }
+        },
+        required: [
+          "resourceId"
+        ]
+      },
+      BeckonResponse: {
+        type: "object",
+        properties: {
+          participant: {
+            type: "string",
+            description: "Username or agent identifier that was beckoned"
+          },
+          resourceId: {
+            type: "string",
+            description: "Resource the attention was directed at"
+          },
+          annotationId: {
+            type: "string",
+            description: "Annotation the attention was directed at (if provided)"
+          }
+        },
+        required: [
+          "participant",
+          "resourceId"
+        ]
+      },
       BulkAddEntityTypesRequest: {
         type: "object",
         properties: {
@@ -13333,6 +13375,73 @@ var openapi_default = {
           "entityTypes"
         ]
       },
+      GatherResourceStreamRequest: {
+        type: "object",
+        properties: {
+          depth: {
+            type: "integer",
+            minimum: 1,
+            maximum: 3,
+            description: "Graph traversal depth (default: 2)"
+          },
+          maxResources: {
+            type: "integer",
+            minimum: 1,
+            maximum: 20,
+            description: "Maximum related resources to include (default: 10)"
+          },
+          includeContent: {
+            type: "boolean",
+            description: "Include full resource content (default: true)"
+          },
+          includeSummary: {
+            type: "boolean",
+            description: "Include AI-generated summary (default: false)"
+          }
+        }
+      },
+      GatherAnnotationStreamRequest: {
+        type: "object",
+        properties: {
+          contextWindow: {
+            type: "integer",
+            minimum: 100,
+            maximum: 5e3,
+            description: "Characters of surrounding text context (default: 1000)"
+          }
+        }
+      },
+      BindAnnotationStreamRequest: {
+        type: "object",
+        properties: {
+          resourceId: {
+            type: "string",
+            description: "Resource ID containing the annotation (required for O(1) Layer 3 lookup)"
+          },
+          operations: {
+            type: "array",
+            items: {
+              oneOf: [
+                {
+                  $ref: "#/components/schemas/BodyOperationAdd"
+                },
+                {
+                  $ref: "#/components/schemas/BodyOperationRemove"
+                },
+                {
+                  $ref: "#/components/schemas/BodyOperationReplace"
+                }
+              ]
+            },
+            minItems: 1,
+            description: "Array of body modification operations to apply"
+          }
+        },
+        required: [
+          "resourceId",
+          "operations"
+        ]
+      },
       AnnotateHighlightsStreamRequest: {
         type: "object",
         properties: {
@@ -14220,20 +14329,12 @@ var openapi_default = {
         type: "string",
         enum: [
           "assessing",
-          "bookmarking",
-          "classifying",
           "commenting",
-          "describing",
-          "editing",
           "highlighting",
-          "identifying",
           "linking",
-          "moderating",
-          "questioning",
-          "replying",
           "tagging"
         ],
-        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"
       },
       OAuthConfigResponse: {
         type: "object",
@@ -14803,7 +14904,7 @@ var openapi_default = {
             description: "IRI of the target resource"
           },
           purpose: {
-            $ref: "#/components/schemas/Motivation",
+            $ref: "#/components/schemas/BodyPurpose",
             description: "Why this body is included"
           }
         },
@@ -14916,7 +15017,7 @@ var openapi_default = {
             description: "The text content (e.g., entity type name)"
           },
           purpose: {
-            $ref: "#/components/schemas/Motivation",
+            $ref: "#/components/schemas/BodyPurpose",
             description: "Why this body is included"
           },
           format: {
@@ -15179,6 +15280,25 @@ var openapi_default = {
           "value"
         ]
       },
+      BodyPurpose: {
+        type: "string",
+        enum: [
+          "assessing",
+          "bookmarking",
+          "classifying",
+          "commenting",
+          "describing",
+          "editing",
+          "highlighting",
+          "identifying",
+          "linking",
+          "moderating",
+          "questioning",
+          "replying",
+          "tagging"
+        ],
+        description: "W3C Web Annotation body purpose vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation"
+      },
       GatheredContext: {
         type: "object",
         description: "Context gathered for an annotation. Includes source document excerpts, metadata, and graph-derived context. Used by both Find (bind) and Generate (yield) flows.",
@@ -16467,7 +16587,7 @@ function registerCreateResource(router) {
     const arrayBuffer = await file.arrayBuffer();
     const contentBuffer = Buffer.from(arrayBuffer);
     const eventBus2 = c.get("eventBus");
-    const resourceId20 = await ResourceOperations.createResource({
+    const resourceId21 = await ResourceOperations.createResource({
       name,
       content: contentBuffer,
       format,
@@ -16477,7 +16597,7 @@ function registerCreateResource(router) {
       storageUri: storageUri || void 0
     }, userId(user.id), eventBus2);
     return c.json({
-      resourceId: resourceId20
+      resourceId: resourceId21
     }, 202);
   });
 }
@@ -19096,13 +19216,13 @@ function registerYieldResourceStream(router, jobQueue) {
 __name(registerYieldResourceStream, "registerYieldResourceStream");
 function registerGetAnnotationHistory(router) {
   router.get("/resources/:resourceId/annotations/:annotationId/history", async (c) => {
-    const { resourceId: resourceId20, annotationId: annotationId6 } = c.req.param();
+    const { resourceId: resourceId21, annotationId: annotationId6 } = c.req.param();
     const eventBus2 = c.get("eventBus");
     const correlationId = crypto.randomUUID();
     try {
       const response = await eventBusRequest(eventBus2, "browse:annotation-history-requested", {
         correlationId,
-        resourceId: resourceId(resourceId20),
+        resourceId: resourceId(resourceId21),
         annotationId: annotationId(annotationId6)
       }, "browse:annotation-history-result", "browse:annotation-history-failed");
       return c.json(response);
@@ -19211,8 +19331,8 @@ operationsRouter.get("/api/annotations/:id/context", async (c) => {
   const { id } = c.req.param();
   const query = c.req.query();
   const { kb } = c.get("makeMeaning");
-  const resourceId20 = query.resourceId;
-  if (!resourceId20) {
+  const resourceId21 = query.resourceId;
+  if (!resourceId21) {
     throw new HTTPException(400, {
       message: "resourceId query parameter is required"
     });
@@ -19230,7 +19350,7 @@ operationsRouter.get("/api/annotations/:id/context", async (c) => {
     });
   }
   try {
-    const response = await AnnotationContext.getAnnotationContext(annotationId(id), resourceId(resourceId20), contextBefore, contextAfter, kb);
+    const response = await AnnotationContext.getAnnotationContext(annotationId(id), resourceId(resourceId21), contextBefore, contextAfter, kb);
     return c.json(response);
   } catch (error) {
     if (error instanceof Error && error.message === "Annotation not found") {
@@ -19260,14 +19380,14 @@ operationsRouter.get("/api/annotations/:id/summary", async (c) => {
   const { id } = c.req.param();
   const query = c.req.query();
   const { kb, gathererInferenceClient: inferenceClient } = c.get("makeMeaning");
-  const resourceId20 = query.resourceId;
-  if (!resourceId20) {
+  const resourceId21 = query.resourceId;
+  if (!resourceId21) {
     throw new HTTPException(400, {
       message: "resourceId query parameter is required"
     });
   }
   try {
-    const response = await AnnotationContext.generateAnnotationSummary(annotationId(id), resourceId(resourceId20), kb, inferenceClient);
+    const response = await AnnotationContext.generateAnnotationSummary(annotationId(id), resourceId(resourceId21), kb, inferenceClient);
     return c.json(response);
   } catch (error) {
     if (error instanceof Error && error.message === "Annotation not found") {
@@ -19472,6 +19592,122 @@ function createJobsRouter(_jobQueue, authMiddleware2) {
 }
 __name(createJobsRouter, "createJobsRouter");
 
+// src/routes/participants/attention-channels.ts
+var import_rxjs4 = __toESM(require_cjs());
+var channels = /* @__PURE__ */ new Map();
+function getOrCreateChannel(participantId) {
+  if (!channels.has(participantId)) {
+    channels.set(participantId, new import_rxjs4.Subject());
+  }
+  return channels.get(participantId);
+}
+__name(getOrCreateChannel, "getOrCreateChannel");
+function removeChannel(participantId) {
+  channels.get(participantId)?.complete();
+  channels.delete(participantId);
+}
+__name(removeChannel, "removeChannel");
+
+// src/routes/participants/routes/beckon.ts
+function registerBeckon(router) {
+  router.post("/api/participants/:id/attention", validateRequestBody("BeckonRequest"), async (c) => {
+    const { id: participantId } = c.req.param();
+    const request = c.get("validatedBody");
+    getOrCreateChannel(participantId).next({
+      resourceId: request.resourceId,
+      ...request.annotationId ? {
+        annotationId: request.annotationId
+      } : {}
+    });
+    return c.json({
+      participant: participantId,
+      resourceId: resourceId(request.resourceId),
+      ...request.annotationId ? {
+        annotationId: request.annotationId
+      } : {}
+    }, 202);
+  });
+}
+__name(registerBeckon, "registerBeckon");
+init_logger();
+function registerAttentionStream(router) {
+  router.get("/api/participants/me/attention-stream", async (c) => {
+    const user = c.get("user");
+    const participantId = user.id;
+    const logger2 = getLogger().child({
+      component: "attention-stream",
+      participantId
+    });
+    logger2.info("Client connecting to attention stream");
+    return streamSSE(c, async (stream) => {
+      await stream.writeSSE({
+        data: JSON.stringify({
+          type: "connected",
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          message: "Attention stream connected"
+        }),
+        event: SSE_STREAM_CONNECTED,
+        id: String(Date.now())
+      });
+      let isStreamClosed = false;
+      let keepAliveInterval = null;
+      let closeStreamCallback = null;
+      const streamPromise = new Promise((resolve) => {
+        closeStreamCallback = resolve;
+      });
+      const cleanup = /* @__PURE__ */ __name(() => {
+        if (isStreamClosed) return;
+        isStreamClosed = true;
+        if (keepAliveInterval) clearInterval(keepAliveInterval);
+        subscription.unsubscribe();
+        removeChannel(participantId);
+        closeStreamCallback?.();
+      }, "cleanup");
+      const subject = getOrCreateChannel(participantId);
+      const subscription = subject.subscribe(async (signal) => {
+        if (isStreamClosed) return;
+        try {
+          await stream.writeSSE({
+            data: JSON.stringify(signal),
+            event: "beckon:focus",
+            id: String(Date.now())
+          });
+        } catch (error) {
+          logger2.error("Error writing beckon signal to attention stream", {
+            error
+          });
+          cleanup();
+        }
+      });
+      keepAliveInterval = setInterval(async () => {
+        if (isStreamClosed) {
+          if (keepAliveInterval) clearInterval(keepAliveInterval);
+          return;
+        }
+        try {
+          await stream.writeSSE({
+            data: ":keep-alive"
+          });
+        } catch {
+          cleanup();
+        }
+      }, 3e4);
+      c.req.raw.signal.addEventListener("abort", () => {
+        logger2.info("Client disconnected from attention stream");
+        cleanup();
+      });
+      return streamPromise;
+    });
+  });
+}
+__name(registerAttentionStream, "registerAttentionStream");
+
+// src/routes/participants/index.ts
+var participantsRouter = new Hono();
+participantsRouter.use("/api/participants/*", authMiddleware);
+registerBeckon(participantsRouter);
+registerAttentionStream(participantsRouter);
+
 // src/middleware/security-headers.ts
 var securityHeaders = /* @__PURE__ */ __name(() => {
   return async (c, next) => {
@@ -19636,6 +19872,7 @@ app.route("/", entityTypesRouter);
 app.route("/", globalEventsRouter);
 var jobsRouter = createJobsRouter(makeMeaning.jobQueue, authMiddleware);
 app.route("/", jobsRouter);
+app.route("/", participantsRouter);
 app.get("/api", (c) => {
   const acceptHeader = c.req.header("Accept") || "";
   const userAgent = c.req.header("User-Agent") || "";