@semiont/backend 0.4.12 → 0.4.13

package/dist/index.js

@@ -268,11 +268,11 @@ var init_jwt = __esm({
           throw error;
         }
       }
-      static generateMediaToken(resourceId21, userId14) {
-        const payload = { purpose: "media", sub: resourceId21, userId: userId14 };
+      static generateMediaToken(resourceId22, userId15) {
+        const payload = { purpose: "media", sub: resourceId22, userId: userId15 };
         return jwt.sign(payload, this.getSecret(), { expiresIn: "5m" });
       }
-      static verifyMediaToken(token, resourceId21) {
+      static verifyMediaToken(token, resourceId22) {
         let decoded;
         try {
           decoded = jwt.verify(token, this.getSecret());
@@ -281,7 +281,7 @@ var init_jwt = __esm({
           throw new Error("Invalid media token");
         }
         if (decoded["purpose"] !== "media") throw new Error("Invalid media token");
-        if (decoded["sub"] !== resourceId21) throw new Error("Media token resource mismatch");
+        if (decoded["sub"] !== resourceId22) throw new Error("Media token resource mismatch");
       }
       static isAllowedDomain(email) {
         const parts = email.split("@");
@@ -9982,7 +9982,9 @@ function makeMeaningConfigFrom(config2) {
   const meta = config2._metadata;
   return {
     services: {
-      graph: config2.services?.graph
+      graph: config2.services?.graph,
+      vectors: config2.services?.vectors,
+      embedding: config2.services?.embedding
     },
     actors: meta?.actors,
     workers: meta?.workers
@@ -10003,15 +10005,17 @@ rootRouter.get("/", (c) => {
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Semiont</title>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500&family=Orbitron:wght@700&display=swap" rel="stylesheet">
   <style>
     * { margin: 0; padding: 0; box-sizing: border-box; }
+    @keyframes fadeIn {
+      from { opacity: 0; transform: translateY(0.5rem); }
+      to { opacity: 1; transform: translateY(0); }
+    }
     body {
+      animation: fadeIn 0.4s ease-out;
       background: #ffffff;
       color: #111827;
-      font-family: 'Inter', -apple-system, sans-serif;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
       min-height: 100vh;
       display: flex;
       flex-direction: column;
@@ -10020,22 +10024,33 @@ rootRouter.get("/", (c) => {
       gap: 0.75rem;
     }
     h1 {
-      font-family: 'Orbitron', sans-serif;
-      font-size: 3rem;
-      font-weight: 700;
-      letter-spacing: 0.15em;
-      color: #0066cc;
+      font-size: 2.5rem;
+      font-weight: 800;
+      letter-spacing: 0.2em;
+      color: #0f172a;
     }
     h2 {
-      font-family: 'Inter', sans-serif;
       font-size: 0.9rem;
       font-weight: 500;
       letter-spacing: 0.3em;
       color: #6b7280;
       text-transform: uppercase;
     }
+    .tagline {
+      font-size: 0.85rem;
+      font-weight: 400;
+      letter-spacing: 0.2em;
+      color: #9ca3af;
+      text-transform: lowercase;
+      font-style: italic;
+    }
+    hr {
+      width: 4rem;
+      border: none;
+      border-top: 2px solid #e5e7eb;
+      margin: 1rem 0;
+    }
     .meta {
-      margin-top: 1.5rem;
       font-size: 0.8rem;
       color: #9ca3af;
       display: flex;
@@ -10043,22 +10058,49 @@ rootRouter.get("/", (c) => {
       align-items: center;
       gap: 0.25rem;
     }
-    a {
+    nav {
+      display: flex;
+      gap: 1.5rem;
+      margin-top: 0.5rem;
+    }
+    nav a {
       color: #0066cc;
       text-decoration: none;
-      font-size: 0.8rem;
+      font-size: 0.85rem;
+      padding: 0.4rem 0.75rem;
+      border: 1px solid #e5e7eb;
+      border-radius: 0.375rem;
+      transition: background 0.15s, border-color 0.15s;
+    }
+    nav a:hover {
+      background: #f3f4f6;
+      border-color: #0066cc;
+    }
+    @media (prefers-color-scheme: dark) {
+      body { background: #111827; color: #f3f4f6; }
+      h1 { color: #e2e8f0; }
+      h2 { color: #9ca3af; }
+      .tagline { color: #6b7280; }
+      hr { border-top-color: #374151; }
+      .meta { color: #6b7280; }
+      nav a { color: #60a5fa; border-color: #374151; }
+      nav a:hover { background: #1f2937; border-color: #60a5fa; }
     }
-    a:hover { text-decoration: underline; }
   </style>
 </head>
 <body>
   <h1>SEMIONT</h1>
   <h2>knowledge base</h2>
+  <p class="tagline">make meaning</p>
+  <hr>
   <div class="meta">
     ${siteName ? `<span>${siteName}</span>` : ""}
     ${projectName ? `<span>${projectName}${projectVersion ? " v" + projectVersion : ""}</span>` : ""}
-    <a href="/api/health">/api/health</a>
   </div>
+  <nav>
+    <a href="/api/docs">API Docs</a>
+    <a href="/api/health">Health</a>
+  </nav>
 </body>
 </html>`;
   return c.html(html);
@@ -13062,6 +13104,39 @@ var openapi_default = {
           }
         }
       },
+      SemanticMatch: {
+        type: "object",
+        properties: {
+          text: {
+            type: "string",
+            description: "The chunk text that matched"
+          },
+          resourceId: {
+            type: "string",
+            description: "Source resource ID"
+          },
+          annotationId: {
+            type: "string",
+            description: "Source annotation ID, if the match is from an annotation"
+          },
+          score: {
+            type: "number",
+            description: "Cosine similarity score (0-1)"
+          },
+          entityTypes: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: "Entity types on the matched passage"
+          }
+        },
+        required: [
+          "text",
+          "resourceId",
+          "score"
+        ]
+      },
       ResourceLLMContextResponse: {
         type: "object",
         properties: {
@@ -13750,6 +13825,22 @@ var openapi_default = {
                 description: "LLM-generated summary of the annotation's relationships in the knowledge graph"
               }
             }
+          },
+          semanticContext: {
+            type: "object",
+            description: "Semantically similar passages from across the knowledge base, found via vector search",
+            properties: {
+              similar: {
+                type: "array",
+                items: {
+                  $ref: "#/components/schemas/SemanticMatch"
+                },
+                description: "Passages ranked by cosine similarity to the focal text"
+              }
+            },
+            required: [
+              "similar"
+            ]
           }
         },
         required: [
@@ -14003,10 +14094,10 @@ var OAuthService = class {
     }
     return user;
   }
-  static async acceptTerms(userId14) {
+  static async acceptTerms(userId15) {
     const prisma2 = DatabaseConnection.getClient();
     const user = await prisma2.user.update({
-      where: { id: userId14 },
+      where: { id: userId15 },
       data: {
         termsAcceptedAt: /* @__PURE__ */ new Date()
       }
@@ -14023,10 +14114,10 @@ var authMiddleware = async (c, next) => {
   if (c.req.method === "GET") {
     const mediaTokenParam = c.req.query("token");
     const match = c.req.path.match(MEDIA_TOKEN_PATH);
-    const resourceId21 = match?.[1];
-    if (mediaTokenParam && resourceId21) {
+    const resourceId22 = match?.[1];
+    if (mediaTokenParam && resourceId22) {
       try {
-        JWTService.verifyMediaToken(mediaTokenParam, resourceId21);
+        JWTService.verifyMediaToken(mediaTokenParam, resourceId22);
         c.set("token", mediaTokenParam);
         await next();
         return;
@@ -14947,7 +15038,7 @@ function registerCreateResource(router) {
     const arrayBuffer = await file.arrayBuffer();
     const contentBuffer = Buffer.from(arrayBuffer);
     const eventBus2 = c.get("eventBus");
-    const resourceId21 = await ResourceOperations.createResource(
+    const resourceId22 = await ResourceOperations.createResource(
       {
         name,
         content: contentBuffer,
@@ -14960,7 +15051,7 @@ function registerCreateResource(router) {
       userId(userToDid(user)),
       eventBus2
     );
-    return c.json({ resourceId: resourceId21 }, 202);
+    return c.json({ resourceId: resourceId22 }, 202);
   });
 }
 var SSE_STREAM_CONNECTED = "stream-connected";
@@ -16724,7 +16815,7 @@ function registerGetEvents(router) {
     const queryParams = c.req.query();
     const eventBus2 = c.get("eventBus");
     const type = queryParams.type;
-    const userId14 = queryParams.userId;
+    const userId15 = queryParams.userId;
     const limit = queryParams.limit ? Number(queryParams.limit) : 100;
     if (type && !isValidEventType(type)) {
       throw new HTTPException(400, { message: `Invalid event type. Must be one of: ${eventTypes.join(", ")}` });
@@ -16737,7 +16828,7 @@ function registerGetEvents(router) {
       const response = await eventBusRequest(
         eventBus2,
         "browse:events-requested",
-        { correlationId, resourceId: resourceId(id), type, userId: userId14, limit },
+        { correlationId, resourceId: resourceId(id), type, userId: userId15, limit },
         "browse:events-result",
         "browse:events-failed"
       );
@@ -16961,6 +17052,102 @@ function registerUpdateAnnotationBody(router) {
   );
 }
 init_logger();
+var BIND_TIMEOUT_MS = 1e4;
+function registerBindAnnotationStream(router) {
+  router.post(
+    "/resources/:resourceId/annotations/:annotationId/bind-stream",
+    validateRequestBody("BindAnnotationStreamRequest"),
+    async (c) => {
+      const { resourceId: resourceIdParam, annotationId: annotationIdParam } = c.req.param();
+      const request = c.get("validatedBody");
+      const user = c.get("user");
+      if (!user) {
+        throw new HTTPException(401, { message: "Authentication required" });
+      }
+      const eventBus2 = c.get("eventBus");
+      const { knowledgeSystem: { kb: { eventStore } } } = c.get("makeMeaning");
+      const logger2 = getLogger().child({
+        component: "bind-annotation-stream",
+        resourceId: resourceIdParam,
+        annotationId: annotationIdParam
+      });
+      logger2.info("Starting bind stream", { operationCount: request.operations.length });
+      const rId = resourceId(resourceIdParam);
+      const aid = annotationId(annotationIdParam);
+      return streamSSE(c, async (stream) => {
+        let isStreamClosed = false;
+        let closeStreamCallback = null;
+        let timeoutHandle = null;
+        let subscription = null;
+        const streamPromise = new Promise((resolve) => {
+          closeStreamCallback = resolve;
+        });
+        const cleanup = () => {
+          if (isStreamClosed) return;
+          isStreamClosed = true;
+          if (timeoutHandle) clearTimeout(timeoutHandle);
+          if (subscription) subscription.unsubscribe();
+          if (closeStreamCallback) closeStreamCallback();
+        };
+        try {
+          subscription = eventStore.bus.subscriptions.subscribe(rId, async (storedEvent) => {
+            if (isStreamClosed) return;
+            if (storedEvent.event.type !== "annotation.body.updated") return;
+            if (storedEvent.event.payload?.annotationId !== annotationIdParam) return;
+            logger2.info("Bind completed", { annotationId: annotationIdParam });
+            try {
+              await stream.writeSSE({
+                data: JSON.stringify({ annotationId: String(aid) }),
+                event: "bind:finished",
+                id: String(Date.now())
+              });
+            } catch {
+              logger2.warn("Client disconnected before bind:finished");
+            }
+            cleanup();
+          });
+          timeoutHandle = setTimeout(async () => {
+            if (isStreamClosed) return;
+            logger2.warn("Bind timed out", { timeoutMs: BIND_TIMEOUT_MS });
+            try {
+              await stream.writeSSE({
+                data: JSON.stringify({ error: "Bind operation timed out" }),
+                event: "bind:failed",
+                id: String(Date.now())
+              });
+            } catch {
+            }
+            cleanup();
+          }, BIND_TIMEOUT_MS);
+          c.req.raw.signal.addEventListener("abort", () => {
+            logger2.info("Client disconnected from bind stream");
+            cleanup();
+          });
+          eventBus2.get("mark:update-body").next({
+            annotationId: aid,
+            resourceId: rId,
+            userId: userId(userToDid(user)),
+            operations: request.operations
+          });
+          logger2.info("Emitted mark:update-body");
+        } catch (error) {
+          logger2.error("Bind stream error", { error: error instanceof Error ? error.message : String(error) });
+          try {
+            await stream.writeSSE({
+              data: JSON.stringify({ error: error instanceof Error ? error.message : "Bind failed" }),
+              event: "bind:failed",
+              id: String(Date.now())
+            });
+          } catch {
+          }
+          cleanup();
+        }
+        return streamPromise;
+      });
+    }
+  );
+}
+init_logger();
 function registerYieldResourceStream(router, jobQueue) {
   router.post(
     "/resources/:resourceId/annotations/:annotationId/yield-resource-stream",
@@ -17276,14 +17463,14 @@ function registerGatherAnnotationStream(router) {
 }
 function registerGetAnnotationHistory(router) {
   router.get("/resources/:resourceId/annotations/:annotationId/history", async (c) => {
-    const { resourceId: resourceId21, annotationId: annotationId7 } = c.req.param();
+    const { resourceId: resourceId22, annotationId: annotationId8 } = 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(resourceId21), annotationId: annotationId(annotationId7) },
+        { correlationId, resourceId: resourceId(resourceId22), annotationId: annotationId(annotationId8) },
         "browse:annotation-history-result",
         "browse:annotation-history-failed"
       );
@@ -17322,6 +17509,7 @@ function createResourcesRouter(jobQueue) {
   registerCreateAnnotation(resourcesRouter2);
   registerGetAnnotation(resourcesRouter2);
   registerUpdateAnnotationBody(resourcesRouter2);
+  registerBindAnnotationStream(resourcesRouter2);
   registerYieldResourceStream(resourcesRouter2, jobQueue);
   registerGatherAnnotationStream(resourcesRouter2);
   registerGetAnnotationHistory(resourcesRouter2);
@@ -17372,8 +17560,8 @@ operationsRouter.get("/api/annotations/:id/context", async (c) => {
   const { id } = c.req.param();
   const query = c.req.query();
   const { knowledgeSystem: { kb } } = c.get("makeMeaning");
-  const resourceId21 = query.resourceId;
-  if (!resourceId21) {
+  const resourceId22 = query.resourceId;
+  if (!resourceId22) {
     throw new HTTPException(400, { message: "resourceId query parameter is required" });
   }
   const contextBefore = query.contextBefore ? Number(query.contextBefore) : 100;
@@ -17387,7 +17575,7 @@ operationsRouter.get("/api/annotations/:id/context", async (c) => {
   try {
     const response = await AnnotationContext.getAnnotationContext(
       annotationId(id),
-      resourceId(resourceId21),
+      resourceId(resourceId22),
       contextBefore,
       contextAfter,
       kb
@@ -17413,14 +17601,14 @@ operationsRouter.get("/api/annotations/:id/summary", async (c) => {
   const { id } = c.req.param();
   const query = c.req.query();
   const { knowledgeSystem: { gatherer } } = c.get("makeMeaning");
-  const resourceId21 = query.resourceId;
-  if (!resourceId21) {
+  const resourceId22 = query.resourceId;
+  if (!resourceId22) {
     throw new HTTPException(400, { message: "resourceId query parameter is required" });
   }
   try {
     const response = await gatherer.generateAnnotationSummary(
       annotationId(id),
-      resourceId(resourceId21)
+      resourceId(resourceId22)
     );
     return c.json(response);
   } catch (error) {