@semiont/backend 0.4.2 → 0.4.4

package/dist/index.js

@@ -2,7 +2,7 @@
 import winston from 'winston';
 import { z } from 'zod';
 import jwt from 'jsonwebtoken';
-import { email, userId, accessToken, googleCredential, annotationId, resourceId, EventBus, jobId, entityType, assembleAnnotation, userToAgent } from '@semiont/core';
+import { email, userId, accessToken, googleCredential, annotationId, resourceId, userToDid, EventBus, jobId, entityType, assembleAnnotation, userToAgent } from '@semiont/core';
 import { cors } from 'hono/cors';
 import { serve } from '@hono/node-server';
 import { Hono } from 'hono';
@@ -613,7 +613,7 @@ var require_timeoutProvider = __commonJS({
     });
     exports$1.timeoutProvider = void 0;
     exports$1.timeoutProvider = {
-      setTimeout: /* @__PURE__ */ __name(function(handler, timeout4) {
+      setTimeout: /* @__PURE__ */ __name(function(handler, timeout2) {
         var args = [];
         for (var _i = 2; _i < arguments.length; _i++) {
           args[_i - 2] = arguments[_i];
@@ -622,12 +622,12 @@ var require_timeoutProvider = __commonJS({
         if (delegate === null || delegate === void 0 ? void 0 : delegate.setTimeout) {
           return delegate.setTimeout.apply(delegate, __spreadArray([
             handler,
-            timeout4
+            timeout2
           ], __read(args)));
         }
         return setTimeout.apply(void 0, __spreadArray([
           handler,
-          timeout4
+          timeout2
         ], __read(args)));
       }, "setTimeout"),
       clearTimeout: /* @__PURE__ */ __name(function(handle) {
@@ -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;
   }
 });
@@ -2061,7 +2061,7 @@ var require_intervalProvider = __commonJS({
     });
     exports$1.intervalProvider = void 0;
     exports$1.intervalProvider = {
-      setInterval: /* @__PURE__ */ __name(function(handler, timeout4) {
+      setInterval: /* @__PURE__ */ __name(function(handler, timeout2) {
         var args = [];
         for (var _i = 2; _i < arguments.length; _i++) {
           args[_i - 2] = arguments[_i];
@@ -2070,12 +2070,12 @@ var require_intervalProvider = __commonJS({
         if (delegate === null || delegate === void 0 ? void 0 : delegate.setInterval) {
           return delegate.setInterval.apply(delegate, __spreadArray([
             handler,
-            timeout4
+            timeout2
           ], __read(args)));
         }
         return setInterval.apply(void 0, __spreadArray([
           handler,
-          timeout4
+          timeout2
         ], __read(args)));
       }, "setInterval"),
       clearInterval: /* @__PURE__ */ __name(function(handle) {
@@ -4283,7 +4283,7 @@ var require_firstValueFrom = __commonJS({
     exports$1.firstValueFrom = void 0;
     var EmptyError_1 = require_EmptyError();
     var Subscriber_1 = require_Subscriber();
-    function firstValueFrom4(source, config2) {
+    function firstValueFrom2(source, config2) {
       var hasConfig = typeof config2 === "object";
       return new Promise(function(resolve, reject) {
         var subscriber = new Subscriber_1.SafeSubscriber({
@@ -4303,8 +4303,8 @@ var require_firstValueFrom = __commonJS({
         source.subscribe(subscriber);
       });
     }
-    __name(firstValueFrom4, "firstValueFrom");
-    exports$1.firstValueFrom = firstValueFrom4;
+    __name(firstValueFrom2, "firstValueFrom");
+    exports$1.firstValueFrom = firstValueFrom2;
   }
 });
 
@@ -4402,7 +4402,7 @@ var require_timeout = __commonJS({
         this.info = info;
       }, "TimeoutErrorImpl");
     });
-    function timeout4(config2, schedulerArg) {
+    function timeout2(config2, schedulerArg) {
       var _a = isDate_1.isValidDate(config2) ? {
         first: config2
       } : typeof config2 === "number" ? {
@@ -4444,8 +4444,8 @@ var require_timeout = __commonJS({
         !seen && startTimer(first != null ? typeof first === "number" ? first : +first - scheduler.now() : each);
       });
     }
-    __name(timeout4, "timeout");
-    exports$1.timeout = timeout4;
+    __name(timeout2, "timeout");
+    exports$1.timeout = timeout2;
     function timeoutErrorFactory(info) {
       throw new exports$1.TimeoutError(info);
     }
@@ -4462,7 +4462,7 @@ var require_map = __commonJS({
     exports$1.map = void 0;
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
-    function map4(project, thisArg) {
+    function map2(project, thisArg) {
       return lift_1.operate(function(source, subscriber) {
         var index = 0;
         source.subscribe(OperatorSubscriber_1.createOperatorSubscriber(subscriber, function(value) {
@@ -4470,8 +4470,8 @@ var require_map = __commonJS({
         }));
       });
     }
-    __name(map4, "map");
-    exports$1.map = map4;
+    __name(map2, "map");
+    exports$1.map = map2;
   }
 });
 
@@ -5501,7 +5501,7 @@ var require_merge = __commonJS({
     var empty_1 = require_empty();
     var args_1 = require_args();
     var from_1 = require_from();
-    function merge4() {
+    function merge2() {
       var args = [];
       for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
@@ -5511,8 +5511,8 @@ var require_merge = __commonJS({
       var sources = args;
       return !sources.length ? empty_1.EMPTY : sources.length === 1 ? innerFrom_1.innerFrom(sources[0]) : mergeAll_1.mergeAll(concurrent)(from_1.from(sources, scheduler));
     }
-    __name(merge4, "merge");
-    exports$1.merge = merge4;
+    __name(merge2, "merge");
+    exports$1.merge = merge2;
   }
 });
 
@@ -5636,7 +5636,7 @@ var require_filter = __commonJS({
     exports$1.filter = void 0;
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
-    function filter4(predicate, thisArg) {
+    function filter2(predicate, thisArg) {
       return lift_1.operate(function(source, subscriber) {
         var index = 0;
         source.subscribe(OperatorSubscriber_1.createOperatorSubscriber(subscriber, function(value) {
@@ -5644,8 +5644,8 @@ var require_filter = __commonJS({
         }));
       });
     }
-    __name(filter4, "filter");
-    exports$1.filter = filter4;
+    __name(filter2, "filter");
+    exports$1.filter = filter2;
   }
 });
 
@@ -6901,7 +6901,7 @@ var require_take = __commonJS({
     var empty_1 = require_empty();
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
-    function take4(count) {
+    function take2(count) {
       return count <= 0 ? function() {
         return empty_1.EMPTY;
       } : lift_1.operate(function(source, subscriber) {
@@ -6916,8 +6916,8 @@ var require_take = __commonJS({
         }));
       });
     }
-    __name(take4, "take");
-    exports$1.take = take4;
+    __name(take2, "take");
+    exports$1.take = take2;
   }
 });
 
@@ -7807,7 +7807,7 @@ var require_merge2 = __commonJS({
     var mergeAll_1 = require_mergeAll();
     var args_1 = require_args();
     var from_1 = require_from();
-    function merge4() {
+    function merge2() {
       var args = [];
       for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
@@ -7820,8 +7820,8 @@ var require_merge2 = __commonJS({
         ], __read(args)), scheduler)).subscribe(subscriber);
       });
     }
-    __name(merge4, "merge");
-    exports$1.merge = merge4;
+    __name(merge2, "merge");
+    exports$1.merge = merge2;
   }
 });
 
@@ -12760,6 +12760,127 @@ var openapi_default = {
           "isNewUser"
         ]
       },
+      BrowseFilesResponse: {
+        type: "object",
+        required: [
+          "path",
+          "entries"
+        ],
+        properties: {
+          path: {
+            type: "string",
+            description: "The directory path that was listed, relative to project root"
+          },
+          entries: {
+            type: "array",
+            items: {
+              $ref: "#/components/schemas/DirectoryEntry"
+            }
+          }
+        },
+        additionalProperties: false
+      },
+      DirectoryEntry: {
+        oneOf: [
+          {
+            $ref: "#/components/schemas/FileEntry"
+          },
+          {
+            $ref: "#/components/schemas/DirEntry"
+          }
+        ]
+      },
+      FileEntry: {
+        type: "object",
+        required: [
+          "type",
+          "name",
+          "path",
+          "size",
+          "mtime",
+          "tracked"
+        ],
+        properties: {
+          type: {
+            type: "string",
+            enum: [
+              "file"
+            ]
+          },
+          name: {
+            type: "string",
+            description: "Entry name (basename)"
+          },
+          path: {
+            type: "string",
+            description: "Path relative to project root"
+          },
+          size: {
+            type: "integer",
+            description: "File size in bytes"
+          },
+          mtime: {
+            type: "string",
+            format: "date-time",
+            description: "Last modified time (ISO 8601)"
+          },
+          tracked: {
+            type: "boolean",
+            description: "True if this file is a tracked resource in the Knowledge Base"
+          },
+          resourceId: {
+            type: "string",
+            description: "Resource ID (only when tracked is true)"
+          },
+          entityTypes: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "Entity types assigned to this resource (only when tracked is true)"
+          },
+          annotationCount: {
+            type: "integer",
+            description: "Number of annotations on this resource (only when tracked is true)"
+          },
+          creator: {
+            type: "string",
+            description: "DID of the user who created the resource (only when tracked is true)"
+          }
+        },
+        additionalProperties: false
+      },
+      DirEntry: {
+        type: "object",
+        required: [
+          "type",
+          "name",
+          "path",
+          "mtime"
+        ],
+        properties: {
+          type: {
+            type: "string",
+            enum: [
+              "dir"
+            ]
+          },
+          name: {
+            type: "string",
+            description: "Entry name (basename)"
+          },
+          path: {
+            type: "string",
+            description: "Path relative to project root"
+          },
+          mtime: {
+            type: "string",
+            format: "date-time",
+            description: "Last modified time (ISO 8601)"
+          }
+        },
+        additionalProperties: false
+      },
       BodyOperationAdd: {
         type: "object",
         properties: {
@@ -12854,6 +12975,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 +13496,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: {
@@ -13370,6 +13600,10 @@ var openapi_default = {
             minimum: 1,
             maximum: 10,
             description: "Optional density: desired number of assessments per 2000 words of text (1-10)"
+          },
+          language: {
+            type: "string",
+            description: 'BCP 47 language tag for the generated assessment text (e.g. "en", "fr", "de")'
           }
         }
       },
@@ -13395,6 +13629,10 @@ var openapi_default = {
             minimum: 2,
             maximum: 12,
             description: "Optional density: desired number of comments per 2000 words of text (2-12)"
+          },
+          language: {
+            type: "string",
+            description: "BCP 47 language tag for the generated comment text (e.g. 'en', 'fr', 'de')"
           }
         }
       },
@@ -14220,20 +14458,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",
@@ -14593,6 +14823,20 @@ var openapi_default = {
               }
             ]
           },
+          generator: {
+            description: "Software agent that produced or processed this resource (W3C Web Annotation model)",
+            oneOf: [
+              {
+                $ref: "#/components/schemas/Agent"
+              },
+              {
+                type: "array",
+                items: {
+                  $ref: "#/components/schemas/Agent"
+                }
+              }
+            ]
+          },
           conformsTo: {
             description: "Profile/shape URI this resource description conforms to.",
             oneOf: [
@@ -14803,7 +15047,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 +15160,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 +15423,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.",
@@ -16255,8 +16518,8 @@ exchangeRouter.post("/api/admin/exchange/backup", async (c) => {
   (async () => {
     try {
       await exportBackup({
-        eventStore: mm.kb.eventStore,
-        content: mm.kb.content,
+        eventStore: mm.knowledgeSystem.kb.eventStore,
+        content: mm.knowledgeSystem.kb.content,
         sourceUrl
       }, nodeWritable);
     } catch (err) {
@@ -16355,8 +16618,8 @@ exchangeRouter.post("/api/moderate/exchange/export", async (c) => {
   (async () => {
     try {
       await exportLinkedData({
-        views: mm.kb.views,
-        content: mm.kb.content,
+        views: mm.knowledgeSystem.kb.views,
+        content: mm.knowledgeSystem.kb.content,
         sourceUrl,
         entityTypes,
         includeArchived
@@ -16475,7 +16738,7 @@ function registerCreateResource(router) {
       entityTypes,
       creationMethod: creationMethod || void 0,
       storageUri: storageUri || void 0
-    }, userId(user.id), eventBus2);
+    }, userId(userToDid(user)), eventBus2);
     return c.json({
       resourceId: resourceId20
     }, 202);
@@ -16792,7 +17055,7 @@ function registerGetResourceUri(router) {
     }
     const acceptHeader = c.req.header("Accept") || "application/ld+json";
     if (acceptHeader.includes("text/") || acceptHeader.includes("image/") || acceptHeader.includes("application/pdf")) {
-      const { kb } = c.get("makeMeaning");
+      const { knowledgeSystem: { kb } } = c.get("makeMeaning");
       let resource;
       try {
         resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
@@ -16906,7 +17169,7 @@ function registerUpdateResource(router) {
     const body = c.get("validatedBody");
     const user = c.get("user");
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const doc = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!doc) {
       throw new HTTPException(404, {
@@ -16915,7 +17178,7 @@ function registerUpdateResource(router) {
     }
     await ResourceOperations.updateResource({
       resourceId: resourceId(id),
-      userId: userId(user.id),
+      userId: userId(userToDid(user)),
       currentArchived: doc.archived,
       updatedArchived: body.archived,
       currentEntityTypes: doc.entityTypes,
@@ -16985,7 +17248,7 @@ function registerAnnotateReferencesStream(router, jobQueue) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!resource) {
       throw new HTTPException(404, {
@@ -16997,7 +17260,7 @@ function registerAnnotateReferencesStream(router, jobQueue) {
       metadata: {
         id: jobId(`job-${nanoid()}`),
         type: "reference-annotation",
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         userName: user.name || user.email,
         userEmail: user.email,
         userDomain: user.domain,
@@ -17187,7 +17450,7 @@ function registerAnnotateHighlightsStream(router, jobQueue) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!resource) {
       throw new HTTPException(404, {
@@ -17199,7 +17462,7 @@ function registerAnnotateHighlightsStream(router, jobQueue) {
       metadata: {
         id: jobId(`job-${nanoid()}`),
         type: "highlight-annotation",
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         userName: user.name || user.email,
         userEmail: user.email,
         userDomain: user.domain,
@@ -17375,7 +17638,7 @@ function registerAnnotateAssessmentsStream(router, jobQueue) {
   router.post("/resources/:id/annotate-assessments-stream", validateRequestBody("AnnotateAssessmentsStreamRequest"), async (c) => {
     const { id } = c.req.param();
     const body = c.get("validatedBody");
-    const { instructions, tone, density } = body;
+    const { instructions, tone, density, language } = body;
     if (density !== void 0 && (typeof density !== "number" || density < 1 || density > 10)) {
       throw new HTTPException(400, {
         message: "Invalid density. Must be a number between 1 and 10."
@@ -17397,7 +17660,7 @@ function registerAnnotateAssessmentsStream(router, jobQueue) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!resource) {
       throw new HTTPException(404, {
@@ -17409,7 +17672,7 @@ function registerAnnotateAssessmentsStream(router, jobQueue) {
       metadata: {
         id: jobId(`job-${nanoid()}`),
         type: "assessment-annotation",
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         userName: user.name || user.email,
         userEmail: user.email,
         userDomain: user.domain,
@@ -17421,7 +17684,8 @@ function registerAnnotateAssessmentsStream(router, jobQueue) {
         resourceId: resourceId(id),
         instructions,
         tone,
-        density
+        density,
+        language
       }
     };
     await jobQueue.createJob(job);
@@ -17596,7 +17860,7 @@ function registerAnnotateCommentsStream(router, jobQueue) {
   router.post("/resources/:id/annotate-comments-stream", validateRequestBody("AnnotateCommentsStreamRequest"), async (c) => {
     const { id } = c.req.param();
     const body = c.get("validatedBody");
-    const { instructions, tone, density } = body;
+    const { instructions, tone, density, language } = body;
     if (density !== void 0 && (typeof density !== "number" || density < 2 || density > 12)) {
       throw new HTTPException(400, {
         message: "Invalid density. Must be a number between 2 and 12."
@@ -17618,7 +17882,7 @@ function registerAnnotateCommentsStream(router, jobQueue) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!resource) {
       throw new HTTPException(404, {
@@ -17630,7 +17894,7 @@ function registerAnnotateCommentsStream(router, jobQueue) {
       metadata: {
         id: jobId(`job-${nanoid()}`),
         type: "comment-annotation",
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         userName: user.name || user.email,
         userEmail: user.email,
         userDomain: user.domain,
@@ -17642,7 +17906,8 @@ function registerAnnotateCommentsStream(router, jobQueue) {
         resourceId: resourceId(id),
         instructions,
         tone,
-        density
+        density,
+        language
       }
     };
     await jobQueue.createJob(job);
@@ -18010,7 +18275,7 @@ function registerAnnotateTagsStream(router, jobQueue) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!resource) {
       throw new HTTPException(404, {
@@ -18022,7 +18287,7 @@ function registerAnnotateTagsStream(router, jobQueue) {
       metadata: {
         id: jobId(`job-${nanoid()}`),
         type: "tag-annotation",
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         userName: user.name || user.email,
         userEmail: user.email,
         userDomain: user.domain,
@@ -18198,134 +18463,6 @@ function registerAnnotateTagsStream(router, jobQueue) {
   });
 }
 __name(registerAnnotateTagsStream, "registerAnnotateTagsStream");
-
-// src/routes/resources/routes/llm-context.ts
-var import_rxjs2 = __toESM(require_cjs());
-var import_operators2 = __toESM(require_operators());
-function registerGetResourceLLMContext(router) {
-  router.get("/resources/:id/llm-context", async (c) => {
-    const { id } = c.req.param();
-    const query = c.req.query();
-    const eventBus2 = c.get("eventBus");
-    const depth = query.depth ? Number(query.depth) : 2;
-    const maxResources = query.maxResources ? Number(query.maxResources) : 10;
-    const includeContent = query.includeContent === "false" ? false : true;
-    const includeSummary = query.includeSummary === "true" ? true : false;
-    if (depth < 1 || depth > 3) {
-      throw new HTTPException(400, {
-        message: 'Query parameter "depth" must be between 1 and 3'
-      });
-    }
-    if (maxResources < 1 || maxResources > 20) {
-      throw new HTTPException(400, {
-        message: 'Query parameter "maxResources" must be between 1 and 20'
-      });
-    }
-    eventBus2.get("gather:resource-requested").next({
-      resourceId: resourceId(id),
-      options: {
-        depth,
-        maxResources,
-        includeContent,
-        includeSummary
-      }
-    });
-    try {
-      const result = await (0, import_rxjs2.firstValueFrom)((0, import_rxjs2.merge)(eventBus2.get("gather:resource-complete").pipe((0, import_operators2.filter)((e) => e.resourceId === id), (0, import_operators2.map)((e) => ({
-        ok: true,
-        context: e.context
-      }))), eventBus2.get("gather:resource-failed").pipe((0, import_operators2.filter)((e) => e.resourceId === id), (0, import_operators2.map)((e) => ({
-        ok: false,
-        error: e.error
-      })))).pipe((0, import_operators2.take)(1), (0, import_operators2.timeout)(3e4)));
-      if (!result.ok) {
-        throw result.error;
-      }
-      return c.json(result.context);
-    } catch (error) {
-      if (error instanceof Error) {
-        if (error.message === "Resource not found") {
-          throw new HTTPException(404, {
-            message: "Resource not found"
-          });
-        }
-        if (error.name === "TimeoutError") {
-          throw new HTTPException(504, {
-            message: "Context gathering timed out"
-          });
-        }
-      }
-      throw error;
-    }
-  });
-}
-__name(registerGetResourceLLMContext, "registerGetResourceLLMContext");
-
-// src/routes/resources/routes/annotation-llm-context.ts
-var import_rxjs3 = __toESM(require_cjs());
-var import_operators3 = __toESM(require_operators());
-function registerGetAnnotationLLMContext(router) {
-  router.get("/resources/:resourceId/annotations/:annotationId/llm-context", async (c) => {
-    const { resourceId: resourceIdParam, annotationId: annotationIdParam } = c.req.param();
-    const query = c.req.query();
-    const eventBus2 = c.get("eventBus");
-    const includeSourceContext = query.includeSourceContext === "false" ? false : true;
-    const includeTargetContext = query.includeTargetContext === "false" ? false : true;
-    const contextWindow = query.contextWindow ? Number(query.contextWindow) : 1e3;
-    if (contextWindow < 100 || contextWindow > 5e3) {
-      throw new HTTPException(400, {
-        message: 'Query parameter "contextWindow" must be between 100 and 5000'
-      });
-    }
-    eventBus2.get("gather:requested").next({
-      annotationId: annotationId(annotationIdParam),
-      resourceId: resourceId(resourceIdParam),
-      options: {
-        includeSourceContext,
-        includeTargetContext,
-        contextWindow
-      }
-    });
-    try {
-      const result = await (0, import_rxjs3.firstValueFrom)((0, import_rxjs3.merge)(eventBus2.get("gather:complete").pipe((0, import_operators3.filter)((e) => e.annotationId === annotationIdParam), (0, import_operators3.map)((e) => ({
-        ok: true,
-        response: e.response
-      }))), eventBus2.get("gather:failed").pipe((0, import_operators3.filter)((e) => e.annotationId === annotationIdParam), (0, import_operators3.map)((e) => ({
-        ok: false,
-        error: e.error
-      })))).pipe((0, import_operators3.take)(1), (0, import_operators3.timeout)(3e4)));
-      if (!result.ok) {
-        throw result.error;
-      }
-      return c.json(result.response);
-    } catch (error) {
-      if (error instanceof Error) {
-        if (error.message === "Annotation not found") {
-          throw new HTTPException(404, {
-            message: "Annotation not found"
-          });
-        }
-        if (error.message === "Source resource not found") {
-          throw new HTTPException(404, {
-            message: "Source resource not found"
-          });
-        }
-        if (error.message === "Source content not found") {
-          throw new HTTPException(404, {
-            message: "Source content not found"
-          });
-        }
-        if (error.name === "TimeoutError") {
-          throw new HTTPException(504, {
-            message: "Context gathering timed out"
-          });
-        }
-      }
-      throw error;
-    }
-  });
-}
-__name(registerGetAnnotationLLMContext, "registerGetAnnotationLLMContext");
 function registerGetReferencedBy(router) {
   router.get("/resources/:id/referenced-by", async (c) => {
     const { id } = c.req.param();
@@ -18333,11 +18470,11 @@ function registerGetReferencedBy(router) {
     const eventBus2 = c.get("eventBus");
     const correlationId = crypto.randomUUID();
     try {
-      const response = await eventBusRequest(eventBus2, "bind:referenced-by-requested", {
+      const response = await eventBusRequest(eventBus2, "browse:referenced-by-requested", {
         correlationId,
         resourceId: resourceId(id),
         motivation
-      }, "bind:referenced-by-result", "bind:referenced-by-failed");
+      }, "browse:referenced-by-result", "browse:referenced-by-failed");
       return c.json(response);
     } catch (error) {
       if (error instanceof Error && error.name === "TimeoutError") {
@@ -18372,7 +18509,7 @@ function registerBindSearchStream(router) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resource = await ResourceContext.getResourceMetadata(resourceId(id), kb);
     if (!resource) {
       throw new HTTPException(404, {
@@ -18400,7 +18537,7 @@ function registerBindSearchStream(router) {
         if (closeStreamCallback) closeStreamCallback();
       }, "cleanup");
       try {
-        subscriptions.push(eventBus2.get("bind:search-results").subscribe(async (event) => {
+        subscriptions.push(eventBus2.get("match:search-results").subscribe(async (event) => {
           if (event.correlationId !== correlationId) return;
           if (isStreamClosed) return;
           logger2.info("Bind search completed", {
@@ -18413,7 +18550,7 @@ function registerBindSearchStream(router) {
                 referenceId: event.referenceId,
                 results: event.results
               }),
-              event: "bind:search-results",
+              event: "match:search-results",
               id: String(Date.now())
             });
           } catch (error) {
@@ -18421,7 +18558,7 @@ function registerBindSearchStream(router) {
           }
           cleanup();
         }));
-        subscriptions.push(eventBus2.get("bind:search-failed").subscribe(async (event) => {
+        subscriptions.push(eventBus2.get("match:search-failed").subscribe(async (event) => {
           if (event.correlationId !== correlationId) return;
           if (isStreamClosed) return;
           logger2.error("Bind search failed", {
@@ -18434,7 +18571,7 @@ function registerBindSearchStream(router) {
                 referenceId: event.referenceId,
                 error: event.error.message
               }),
-              event: "bind:search-failed",
+              event: "match:search-failed",
               id: String(Date.now())
             });
           } catch (error) {
@@ -18442,7 +18579,7 @@ function registerBindSearchStream(router) {
           }
           cleanup();
         }));
-        eventBus2.get("bind:search-requested").next({
+        eventBus2.get("match:search-requested").next({
           correlationId,
           referenceId,
           context,
@@ -18460,7 +18597,7 @@ function registerBindSearchStream(router) {
               referenceId,
               error: error instanceof Error ? error.message : "Search failed"
             }),
-            event: "bind:search-failed",
+            event: "match:search-failed",
             id: String(Date.now())
           });
         } catch (sseError) {
@@ -18516,7 +18653,7 @@ function registerTokenRoutes(router) {
         token: body.token,
         name: body.name,
         content: body.content,
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         archiveOriginal: body.archiveOriginal
       }, "yield:clone-created", "yield:clone-create-failed");
       return c.json({
@@ -18659,7 +18796,7 @@ function registerGetEventStream(router) {
     logger2.info("Client connecting to resource events stream", {
       resourceId: rId
     });
-    const { eventStore } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb: { eventStore } } } = c.get("makeMeaning");
     const query = new EventQuery(eventStore.log.storage);
     const events = await query.getResourceEvents(rId);
     if (events.length === 0) {
@@ -18808,7 +18945,7 @@ function registerCreateAnnotation(router) {
     const eventBus2 = c.get("eventBus");
     eventBus2.get("mark:create").next({
       annotation,
-      userId: userId(user.id),
+      userId: userId(userToDid(user)),
       resourceId: resourceId(id)
     });
     return c.json({
@@ -18854,7 +18991,7 @@ function registerDeleteAnnotation(router) {
     const eventBus2 = c.get("eventBus");
     eventBus2.get("mark:delete").next({
       annotationId: annotationId(annotationIdParam),
-      userId: userId(user.id),
+      userId: userId(userToDid(user)),
       resourceId: resourceId(resourceIdParam)
     });
     return c.body(null, 202);
@@ -18870,7 +19007,7 @@ function registerUpdateAnnotationBody(router) {
     eventBus2.get("mark:update-body").next({
       annotationId: annotationId(annotationIdParam),
       resourceId: resourceId(resourceIdParam),
-      userId: userId(user.id),
+      userId: userId(userToDid(user)),
       operations: request.operations
     });
     return c.body(null, 202);
@@ -18897,7 +19034,7 @@ function registerYieldResourceStream(router, jobQueue) {
       });
     }
     const eventBus2 = c.get("eventBus");
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     logger2.info("Starting resource generation", {
       language: body.language
     });
@@ -18933,7 +19070,7 @@ function registerYieldResourceStream(router, jobQueue) {
       metadata: {
         id: jobId(`job-${nanoid()}`),
         type: "generation",
-        userId: userId(user.id),
+        userId: userId(userToDid(user)),
         userName: user.name || user.email,
         userEmail: user.email,
         userDomain: user.domain,
@@ -19094,6 +19231,121 @@ function registerYieldResourceStream(router, jobQueue) {
   });
 }
 __name(registerYieldResourceStream, "registerYieldResourceStream");
+init_logger();
+function registerGatherAnnotationStream(router) {
+  router.post("/resources/:resourceId/annotations/:annotationId/gather-annotation-stream", validateRequestBody("GatherAnnotationStreamRequest"), async (c) => {
+    const { resourceId: resourceIdParam, annotationId: annotationIdParam } = c.req.param();
+    const body = c.get("validatedBody");
+    const contextWindow = body.contextWindow ?? 1e3;
+    const eventBus2 = c.get("eventBus");
+    const logger2 = getLogger().child({
+      component: "gather-annotation-stream",
+      resourceId: resourceIdParam,
+      annotationId: annotationIdParam
+    });
+    const user = c.get("user");
+    if (!user) {
+      throw new HTTPException(401, {
+        message: "Authentication required"
+      });
+    }
+    eventBus2.get("gather:requested").next({
+      annotationId: annotationId(annotationIdParam),
+      resourceId: resourceId(resourceIdParam),
+      options: {
+        includeSourceContext: true,
+        includeTargetContext: true,
+        contextWindow
+      }
+    });
+    logger2.info("Emitted gather:requested", {
+      annotationId: annotationIdParam,
+      contextWindow
+    });
+    c.header("X-Accel-Buffering", "no");
+    c.header("Cache-Control", "no-cache, no-transform");
+    return streamSSE(c, async (stream) => {
+      let isStreamClosed = false;
+      const subscriptions = [];
+      let keepAliveInterval = null;
+      const streamPromise = new Promise((resolve) => {
+        const cleanup = /* @__PURE__ */ __name(() => {
+          if (isStreamClosed) return;
+          isStreamClosed = true;
+          if (keepAliveInterval) clearInterval(keepAliveInterval);
+          subscriptions.forEach((sub) => sub.unsubscribe());
+          resolve();
+        }, "cleanup");
+        subscriptions.push(eventBus2.get("gather:annotation-progress").subscribe(async (event) => {
+          if (isStreamClosed) return;
+          try {
+            await writeTypedSSE(stream, {
+              data: JSON.stringify({
+                message: event.message,
+                percentage: event.percentage
+              }),
+              event: "gather:annotation-progress",
+              id: String(Date.now())
+            });
+          } catch {
+            cleanup();
+          }
+        }));
+        subscriptions.push(eventBus2.get("gather:complete").subscribe(async (event) => {
+          if (event.annotationId !== annotationIdParam) return;
+          if (isStreamClosed) return;
+          try {
+            await writeTypedSSE(stream, {
+              data: JSON.stringify({
+                annotationId: event.annotationId,
+                response: event.response
+              }),
+              event: "gather:annotation-finished",
+              id: String(Date.now())
+            });
+          } catch {
+          }
+          cleanup();
+        }));
+        subscriptions.push(eventBus2.get("gather:failed").subscribe(async (event) => {
+          if (event.annotationId !== annotationIdParam) return;
+          if (isStreamClosed) return;
+          try {
+            await writeTypedSSE(stream, {
+              data: JSON.stringify({
+                annotationId: event.annotationId,
+                error: event.error
+              }),
+              event: "gather:failed",
+              id: String(Date.now())
+            });
+          } catch {
+          }
+          cleanup();
+        }));
+        keepAliveInterval = setInterval(async () => {
+          if (isStreamClosed) {
+            clearInterval(keepAliveInterval);
+            return;
+          }
+          try {
+            await stream.writeSSE({
+              data: ":keep-alive"
+            });
+          } catch {
+            cleanup();
+          }
+        }, 3e4);
+        c.req.raw.signal.addEventListener("abort", () => {
+          logger2.info("Client disconnected from gather stream");
+          cleanup();
+        });
+      });
+      return streamPromise;
+    });
+  });
+}
+__name(registerGatherAnnotationStream, "registerGatherAnnotationStream");
 function registerGetAnnotationHistory(router) {
   router.get("/resources/:resourceId/annotations/:annotationId/history", async (c) => {
     const { resourceId: resourceId20, annotationId: annotationId6 } = c.req.param();
@@ -19141,8 +19393,6 @@ function createResourcesRouter(jobQueue) {
   registerAnnotateAssessmentsStream(resourcesRouter2, jobQueue);
   registerAnnotateCommentsStream(resourcesRouter2, jobQueue);
   registerAnnotateTagsStream(resourcesRouter2, jobQueue);
-  registerGetResourceLLMContext(resourcesRouter2);
-  registerGetAnnotationLLMContext(resourcesRouter2);
   registerGetReferencedBy(resourcesRouter2);
   registerBindSearchStream(resourcesRouter2);
   registerGetResourceAnnotations(resourcesRouter2);
@@ -19150,6 +19400,7 @@ function createResourcesRouter(jobQueue) {
   registerGetAnnotation(resourcesRouter2);
   registerUpdateAnnotationBody(resourcesRouter2);
   registerYieldResourceStream(resourcesRouter2, jobQueue);
+  registerGatherAnnotationStream(resourcesRouter2);
   registerGetAnnotationHistory(resourcesRouter2);
   registerDeleteAnnotation(resourcesRouter2);
   registerGetEvents(resourcesRouter2);
@@ -19170,7 +19421,7 @@ function registerGetAnnotationUri(router) {
   router.get("/annotations/:id", async (c) => {
     const { id } = c.req.param();
     const query = c.req.query();
-    const { kb } = c.get("makeMeaning");
+    const { knowledgeSystem: { kb } } = c.get("makeMeaning");
     const resourceIdParam = query.resourceId;
     if (!resourceIdParam) {
       throw new HTTPException(400, {
@@ -19210,7 +19461,7 @@ var operationsRouter = createAnnotationRouter();
 operationsRouter.get("/api/annotations/:id/context", async (c) => {
   const { id } = c.req.param();
   const query = c.req.query();
-  const { kb } = c.get("makeMeaning");
+  const { knowledgeSystem: { kb } } = c.get("makeMeaning");
   const resourceId20 = query.resourceId;
   if (!resourceId20) {
     throw new HTTPException(400, {
@@ -19259,7 +19510,7 @@ operationsRouter.get("/api/annotations/:id/context", async (c) => {
 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 { knowledgeSystem: { gatherer } } = c.get("makeMeaning");
   const resourceId20 = query.resourceId;
   if (!resourceId20) {
     throw new HTTPException(400, {
@@ -19267,7 +19518,7 @@ operationsRouter.get("/api/annotations/:id/summary", async (c) => {
     });
   }
   try {
-    const response = await AnnotationContext.generateAnnotationSummary(annotationId(id), resourceId(resourceId20), kb, inferenceClient);
+    const response = await gatherer.generateAnnotationSummary(annotationId(id), resourceId(resourceId20));
     return c.json(response);
   } catch (error) {
     if (error instanceof Error && error.message === "Annotation not found") {
@@ -19300,9 +19551,9 @@ entityTypesRouter.use("/api/entity-types/*", authMiddleware);
 entityTypesRouter.get("/api/entity-types", async (c) => {
   const eventBus2 = c.get("eventBus");
   const correlationId = crypto.randomUUID();
-  const response = await eventBusRequest(eventBus2, "mark:entity-types-requested", {
+  const response = await eventBusRequest(eventBus2, "browse:entity-types-requested", {
     correlationId
-  }, "mark:entity-types-result", "mark:entity-types-failed");
+  }, "browse:entity-types-result", "browse:entity-types-failed");
   return c.json(response, 200);
 });
 entityTypesRouter.post("/api/entity-types", validateRequestBody("AddEntityTypeRequest"), async (c) => {
@@ -19316,7 +19567,7 @@ entityTypesRouter.post("/api/entity-types", validateRequestBody("AddEntityTypeRe
   const eventBus2 = c.get("eventBus");
   eventBus2.get("mark:add-entity-type").next({
     tag: body.tag,
-    userId: userId(user.id)
+    userId: userId(userToDid(user))
   });
   return c.body(null, 202);
 });
@@ -19332,7 +19583,7 @@ entityTypesRouter.post("/api/entity-types/bulk", validateRequestBody("BulkAddEnt
   for (const tag of body.tags) {
     eventBus2.get("mark:add-entity-type").next({
       tag,
-      userId: userId(user.id)
+      userId: userId(userToDid(user))
     });
   }
   return c.body(null, 202);
@@ -19346,7 +19597,7 @@ globalEventsRouter.use("/api/events/stream", authMiddleware);
 globalEventsRouter.get("/api/events/stream", async (c) => {
   const logger2 = getRouteLogger4();
   logger2.info("Client connecting to global events stream");
-  const { eventStore } = c.get("makeMeaning");
+  const { knowledgeSystem: { kb: { eventStore } } } = c.get("makeMeaning");
   return streamSSE(c, async (stream) => {
     await stream.writeSSE({
       data: JSON.stringify({
@@ -19472,6 +19723,162 @@ function createJobsRouter(_jobQueue, authMiddleware2) {
 }
 __name(createJobsRouter, "createJobsRouter");
 
+// src/routes/participants/attention-channels.ts
+var import_rxjs2 = __toESM(require_cjs());
+var channels = /* @__PURE__ */ new Map();
+function getOrCreateChannel(participantId) {
+  if (!channels.has(participantId)) {
+    channels.set(participantId, new import_rxjs2.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);
+var browseRouter = new Hono();
+browseRouter.use("/api/browse/*", authMiddleware);
+browseRouter.get("/api/browse/files", async (c) => {
+  const reqPath = c.req.query("path") ?? "";
+  const sort = c.req.query("sort");
+  if (sort !== void 0 && sort !== "name" && sort !== "mtime" && sort !== "annotationCount") {
+    throw new HTTPException(400, {
+      message: 'Invalid sort value. Must be "name", "mtime", or "annotationCount".'
+    });
+  }
+  const eventBus2 = c.get("eventBus");
+  const correlationId = crypto.randomUUID();
+  try {
+    const response = await eventBusRequest(eventBus2, "browse:directory-requested", {
+      correlationId,
+      path: reqPath,
+      sort
+    }, "browse:directory-result", "browse:directory-failed");
+    return c.json(response);
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.name === "TimeoutError") {
+        throw new HTTPException(504, {
+          message: "Request timed out"
+        });
+      }
+      if (error.message === "path not found") {
+        throw new HTTPException(404, {
+          message: error.message
+        });
+      }
+      if (error.message === "path escapes project root") {
+        throw new HTTPException(400, {
+          message: error.message
+        });
+      }
+    }
+    throw error;
+  }
+});
+
 // src/middleware/security-headers.ts
 var securityHeaders = /* @__PURE__ */ __name(() => {
   return async (c, next) => {
@@ -19636,6 +20043,8 @@ app.route("/", entityTypesRouter);
 app.route("/", globalEventsRouter);
 var jobsRouter = createJobsRouter(makeMeaning.jobQueue, authMiddleware);
 app.route("/", jobsRouter);
+app.route("/", participantsRouter);
+app.route("/", browseRouter);
 app.get("/api", (c) => {
   const acceptHeader = c.req.header("Accept") || "";
   const userAgent = c.req.header("User-Agent") || "";
@@ -19648,7 +20057,8 @@ app.get("/api", (c) => {
   return c.redirect(redirectUrl);
 });
 app.get("/api/openapi.json", (c) => {
-  const openApiPath = path.join(__dirname$1, "../../../specs/openapi.json");
+  const distPath = path.join(__dirname$1, "openapi.json");
+  const openApiPath = fs.existsSync(distPath) ? distPath : path.join(__dirname$1, "../../../specs/openapi.json");
   const openApiContent = fs.readFileSync(openApiPath, "utf-8");
   const openApiSpec = JSON.parse(openApiContent);
   const port2 = backendService.port || 4e3;
@@ -19715,7 +20125,7 @@ if (config.env?.NODE_ENV !== "test") {
       });
     }
     try {
-      const entityTypes = await makeMeaning.graphDb.getEntityTypes();
+      const entityTypes = await makeMeaning.knowledgeSystem.kb.graph.getEntityTypes();
       logger.info("Loaded entity types from graph database", {
         count: entityTypes.length
       });