@semiont/core 0.5.9 → 0.5.11

package/dist/index.js

@@ -1,4 +1,5 @@
-import { Subject, Observable } from 'rxjs';
+import { Subject, Observable, merge, TimeoutError, throwError, firstValueFrom } from 'rxjs';
+import { filter, map, take, timeout, catchError, defaultIfEmpty } from 'rxjs/operators';
 import { parse } from 'smol-toml';
 
 // src/branded-types.ts
@@ -138,8 +139,7 @@ var CHANNEL_SCHEMAS = {
   "yield:create-failed": "CommandError",
   "yield:update-ok": "YieldUpdateOk",
   "yield:update-failed": null,
-  // YieldUpdateOk & CommandError
-  "yield:move-ok": "YieldMoveOk",
+  // { correlationId } & CommandError
   "yield:move-failed": null,
   // { fromUri } & CommandError
   "yield:clone-token-generated": null,
@@ -177,8 +177,16 @@ var CHANNEL_SCHEMAS = {
   "mark:create-failed": "CommandError",
   "mark:delete-ok": "MarkDeleteOk",
   "mark:delete-failed": "CommandError",
+  "mark:archive-ok": null,
+  "mark:archive-failed": "CommandError",
+  "mark:unarchive-ok": null,
+  "mark:unarchive-failed": "CommandError",
+  "mark:update-entity-types-ok": null,
+  "mark:update-entity-types-failed": "CommandError",
   "mark:body-update-failed": "CommandError",
+  "frame:entity-type-add-ok": null,
   "frame:entity-type-add-failed": "CommandError",
+  "frame:tag-schema-add-ok": null,
   "frame:tag-schema-add-failed": "CommandError",
   "mark:select-comment": "SelectionData",
   "mark:select-tag": "SelectionData",
@@ -193,11 +201,6 @@ var CHANNEL_SCHEMAS = {
   // void
   "mark:progress-dismiss": null,
   // void
-  "mark:mode-toggled": null,
-  // void
-  "mark:selection-changed": "MarkSelectionChangedEvent",
-  "mark:click-changed": "MarkClickChangedEvent",
-  "mark:shape-changed": "MarkShapeChangedEvent",
   // ── BIND FLOW ───────────────────────────────────────────────────
   "bind:initiate": "BindInitiateCommand",
   "bind:update-body": "BindUpdateBodyCommand",
@@ -222,9 +225,6 @@ var CHANNEL_SCHEMAS = {
   "gather:summary-failed": null,
   // { correlationId } & CommandError
   "gather:annotation-progress": "GatherProgress",
-  "gather:annotation-finished": "GatherAnnotationFinished",
-  "gather:progress": "GatherProgress",
-  "gather:finished": "GatherFinished",
   // ── BROWSE FLOW ─────────────────────────────────────────────────
   "browse:resource-requested": "BrowseResourceRequest",
   "browse:resource-result": "BrowseResourceResult",
@@ -258,6 +258,9 @@ var CHANNEL_SCHEMAS = {
   "browse:tag-schemas-requested": "BrowseTagSchemasRequest",
   "browse:tag-schemas-result": "BrowseTagSchemasResult",
   "browse:tag-schemas-failed": null,
+  "browse:agents-requested": "BrowseAgentsRequest",
+  "browse:agents-result": "BrowseAgentsResult",
+  "browse:agents-failed": null,
   "browse:directory-requested": "BrowseDirectoryRequest",
   "browse:directory-result": "BrowseDirectoryResult",
   "browse:directory-failed": null,
@@ -305,6 +308,8 @@ var CHANNEL_SCHEMAS = {
   "job:claimed": null,
   // { correlationId; response: Record<string, unknown> }
   "job:claim-failed": null,
+  "job:cancel-ok": null,
+  "job:cancel-failed": "CommandError",
   // ── SETTINGS (frontend-only) ────────────────────────────────────
   "settings:theme-changed": "SettingsThemeChangedEvent",
   "settings:line-numbers-toggled": null,
@@ -347,8 +352,84 @@ function isStoredEvent(event) {
   return event && typeof event.id === "string" && typeof event.timestamp === "string" && typeof event.type === "string" && typeof event.metadata === "object" && typeof event.metadata.sequenceNumber === "number";
 }
 
+// src/bus-operations.ts
+var BUS_OPERATIONS = {
+  // ── BIND ────────────────────────────────────────────────────────
+  "bind:update-body": { result: "bind:body-updated", failure: "bind:body-update-failed" },
+  // ── BROWSE (reads) ──────────────────────────────────────────────
+  "browse:resource-requested": { result: "browse:resource-result", failure: "browse:resource-failed" },
+  "browse:resources-requested": { result: "browse:resources-result", failure: "browse:resources-failed" },
+  "browse:annotation-requested": { result: "browse:annotation-result", failure: "browse:annotation-failed" },
+  "browse:annotations-requested": { result: "browse:annotations-result", failure: "browse:annotations-failed" },
+  "browse:annotation-history-requested": { result: "browse:annotation-history-result", failure: "browse:annotation-history-failed" },
+  "browse:events-requested": { result: "browse:events-result", failure: "browse:events-failed" },
+  "browse:referenced-by-requested": { result: "browse:referenced-by-result", failure: "browse:referenced-by-failed" },
+  "browse:entity-types-requested": { result: "browse:entity-types-result", failure: "browse:entity-types-failed" },
+  "browse:tag-schemas-requested": { result: "browse:tag-schemas-result", failure: "browse:tag-schemas-failed" },
+  "browse:agents-requested": { result: "browse:agents-result", failure: "browse:agents-failed" },
+  "browse:directory-requested": { result: "browse:directory-result", failure: "browse:directory-failed" },
+  // dormant — backend handler complete, no client caller yet (annotation-detail capability)
+  "browse:annotation-context-requested": { result: "browse:annotation-context-result", failure: "browse:annotation-context-failed" },
+  // ── FRAME (KB schema writes) ────────────────────────────────────
+  "frame:add-entity-type": { result: "frame:entity-type-add-ok", failure: "frame:entity-type-add-failed" },
+  "frame:add-tag-schema": { result: "frame:tag-schema-add-ok", failure: "frame:tag-schema-add-failed" },
+  // ── GATHER ──────────────────────────────────────────────────────
+  // streaming: take-1 result + failure plus an intermediate progress channel
+  "gather:requested": { result: "gather:complete", failure: "gather:failed", progress: "gather:annotation-progress" },
+  "gather:resource-requested": { result: "gather:resource-complete", failure: "gather:resource-failed" },
+  // dormant — backend handler complete, no client caller yet (annotation summary)
+  "gather:summary-requested": { result: "gather:summary-result", failure: "gather:summary-failed" },
+  // ── JOB ─────────────────────────────────────────────────────────
+  "job:create": { result: "job:created", failure: "job:create-failed" },
+  "job:status-requested": { result: "job:status-result", failure: "job:status-failed" },
+  "job:cancel-requested": { result: "job:cancel-ok", failure: "job:cancel-failed" },
+  // worker-side: the worker claims a queued job (not an SDK call)
+  "job:claim": { result: "job:claimed", failure: "job:claim-failed" },
+  // ── MARK ────────────────────────────────────────────────────────
+  "mark:create-request": { result: "mark:create-ok", failure: "mark:create-failed" },
+  "mark:delete": { result: "mark:delete-ok", failure: "mark:delete-failed" },
+  "mark:archive": { result: "mark:archive-ok", failure: "mark:archive-failed" },
+  "mark:unarchive": { result: "mark:unarchive-ok", failure: "mark:unarchive-failed" },
+  "mark:update-entity-types": { result: "mark:update-entity-types-ok", failure: "mark:update-entity-types-failed" },
+  // ── MATCH ───────────────────────────────────────────────────────
+  // take-1 dressed as an Observable in the SDK; no progress channel
+  "match:search-requested": { result: "match:search-results", failure: "match:search-failed" },
+  // ── YIELD ───────────────────────────────────────────────────────
+  // live in-process (resource-operations.ts emits + awaits via race()); the
+  // client also .on()-subscribes -ok for cache invalidation
+  "yield:create": { result: "yield:create-ok", failure: "yield:create-failed" },
+  // dormant — handler in stower exists, no request emitter; client pre-subscribes -ok
+  "yield:update": { result: "yield:update-ok", failure: "yield:update-failed" },
+  "yield:clone-create": { result: "yield:clone-created", failure: "yield:clone-create-failed" },
+  "yield:clone-resource-requested": { result: "yield:clone-resource-result", failure: "yield:clone-resource-failed" },
+  "yield:clone-token-requested": { result: "yield:clone-token-generated", failure: "yield:clone-token-failed" }
+};
+
+// src/bridged-channels.ts
+var BRIDGED_BROADCASTS = [
+  "job:report-progress",
+  "job:complete",
+  "job:fail",
+  "frame:entity-type-added",
+  "frame:tag-schema-added",
+  "beckon:focus",
+  "beckon:sparkle",
+  "bus:resume-gap"
+];
+var REGISTRY_REPLIES = Object.keys(BUS_OPERATIONS).flatMap(
+  (key) => {
+    const op = BUS_OPERATIONS[key];
+    return "progress" in op ? [op.result, op.failure, op.progress] : [op.result, op.failure];
+  }
+);
+var BRIDGED_CHANNELS = [
+  ...REGISTRY_REPLIES,
+  ...BRIDGED_BROADCASTS
+];
+
 // src/bus-log.ts
 var NODE_BUS_LOG = typeof process !== "undefined" && !!process.env?.SEMIONT_BUS_LOG;
+var IS_NODE = typeof process !== "undefined" && !!process.versions?.node;
 function busLogEnabled() {
   const g = globalThis;
   if (g.__SEMIONT_BUS_LOG__) return true;
@@ -372,6 +453,21 @@ function busLog(op, channel, payload, scope) {
   const tag = `[bus ${op}] ${channel}` + (scope ? ` scope=${scope}` : "") + (cid ? ` cid=${cid}` : "") + (traceId ? ` trace=${traceId.slice(0, 8)}` : "");
   console.debug(tag, payload);
 }
+function warnUnobservedRepliesEnabled() {
+  return IS_NODE;
+}
+var unobservedReplyWarned = /* @__PURE__ */ new Set();
+function warnIfUnobservedReply(channel, payload, observerCount) {
+  if (observerCount > 0) return;
+  const cidRaw = payload?.correlationId;
+  if (typeof cidRaw !== "string" || cidRaw.length === 0) return;
+  if (BRIDGED_CHANNELS.includes(channel)) return;
+  if (unobservedReplyWarned.has(channel)) return;
+  unobservedReplyWarned.add(channel);
+  console.warn(
+    `[bus DROP] ${channel} cid=${cidRaw.slice(0, 8)} emitted with 0 subscribers and not in BRIDGED_CHANNELS \u2014 a correlation reply with no forwarder is dropped, so the awaiting client times out (no error). Bridge it by declaring its operation in BUS_OPERATIONS (packages/core/src/bus-operations.ts) \u2014 or, if it is a non-reply broadcast, add it to BRIDGED_BROADCASTS (packages/core/src/bridged-channels.ts) \u2014 so transports subscribe to it.`
+  );
+}
 
 // src/event-bus.ts
 var EventBus = class {
@@ -410,10 +506,14 @@ var EventBus = class {
     }
     if (!this.subjects.has(eventName)) {
       const subject = new Subject();
-      if (busLogEnabled()) {
+      const wantBusLog = busLogEnabled();
+      const wantDropCheck = warnUnobservedRepliesEnabled();
+      if (wantBusLog || wantDropCheck) {
+        const wrapped = subject;
         const originalNext = subject.next.bind(subject);
         subject.next = (value) => {
-          busLog("EMIT", String(eventName), value);
+          if (wantBusLog) busLog("EMIT", String(eventName), value);
+          if (wantDropCheck) warnIfUnobservedReply(String(eventName), value, wrapped.observers.length);
           originalNext(value);
         };
       }
@@ -704,12 +804,7 @@ function validateSvgMarkup(svg) {
 }
 function assembleAnnotation(request, creator) {
   const newAnnotationId = annotationId(generateUuid());
-  const posSelector = getTextPositionSelector(request.target.selector);
   const svgSelector = getSvgSelector(request.target.selector);
-  const fragmentSelector = getFragmentSelector(request.target.selector);
-  if (!posSelector && !svgSelector && !fragmentSelector) {
-    throw new Error("Either TextPositionSelector, SvgSelector, or FragmentSelector is required for creating annotations");
-  }
   if (svgSelector) {
     const svgError = validateSvgMarkup(svgSelector.value);
     if (svgError) {
@@ -1004,69 +1099,122 @@ function decodeRepresentation(buffer, mediaType) {
   return buffer.toString(encoding);
 }
 
-// src/bridged-channels.ts
-var BRIDGED_CHANNELS = [
-  "browse:resources-result",
-  "browse:resources-failed",
-  "browse:resource-result",
-  "browse:resource-failed",
-  "browse:annotations-result",
-  "browse:annotations-failed",
-  "browse:annotation-result",
-  "browse:annotation-failed",
-  "browse:annotation-history-result",
-  "browse:annotation-history-failed",
-  "browse:events-result",
-  "browse:events-failed",
-  "browse:referenced-by-result",
-  "browse:referenced-by-failed",
-  "browse:entity-types-result",
-  "browse:entity-types-failed",
-  "browse:tag-schemas-result",
-  "browse:tag-schemas-failed",
-  "browse:directory-result",
-  "browse:directory-failed",
-  "browse:annotation-context-result",
-  "browse:annotation-context-failed",
-  "mark:delete-ok",
-  "mark:delete-failed",
-  "mark:create-ok",
-  "mark:create-failed",
-  "match:search-results",
-  "match:search-failed",
-  "gather:complete",
-  "gather:failed",
-  "gather:annotation-progress",
-  "gather:annotation-finished",
-  "gather:summary-result",
-  "gather:summary-failed",
-  "bind:body-updated",
-  "bind:body-update-failed",
-  "job:report-progress",
-  "job:complete",
-  "job:fail",
-  "job:status-result",
-  "job:status-failed",
-  "job:created",
-  "job:create-failed",
-  "job:claimed",
-  "job:claim-failed",
-  "yield:create-ok",
-  "yield:create-failed",
-  "yield:update-ok",
-  "yield:update-failed",
-  "yield:clone-token-generated",
-  "yield:clone-token-failed",
-  "yield:clone-resource-result",
-  "yield:clone-resource-failed",
-  "yield:clone-created",
-  "yield:clone-create-failed",
-  "frame:entity-type-added",
-  "frame:tag-schema-added",
-  "beckon:focus",
-  "beckon:sparkle",
-  "bus:resume-gap"
-];
+// src/errors.ts
+var SemiontError = class extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "SemiontError";
+    Error.captureStackTrace(this, this.constructor);
+  }
+  code;
+  details;
+};
+var ValidationError = class extends SemiontError {
+  constructor(message, details) {
+    super(message, "VALIDATION_ERROR", details);
+    this.name = "ValidationError";
+  }
+};
+var ScriptError = class extends SemiontError {
+  constructor(message, code = "SCRIPT_ERROR", details) {
+    super(message, code, details);
+    this.name = "ScriptError";
+  }
+};
+var NotFoundError = class extends SemiontError {
+  constructor(resource, id) {
+    const message = id ? `${resource} with id '${id}' not found` : `${resource} not found`;
+    super(message, "NOT_FOUND", { resource, id });
+    this.name = "NotFoundError";
+  }
+};
+var UnauthorizedError = class extends SemiontError {
+  constructor(message = "Unauthorized", details) {
+    super(message, "UNAUTHORIZED", details);
+    this.name = "UnauthorizedError";
+  }
+};
+var ConflictError = class extends SemiontError {
+  constructor(message, details) {
+    super(message, "CONFLICT", details);
+    this.name = "ConflictError";
+  }
+};
+
+// src/bus-request.ts
+var BusRequestError = class extends SemiontError {
+  constructor(message, code, details) {
+    super(message, code, details);
+    this.name = "BusRequestError";
+  }
+};
+async function busRequest(bus, operation, payload, timeoutMs = 3e4) {
+  const correlationId = crypto.randomUUID();
+  const fullPayload = { ...payload, correlationId };
+  const { result: resultChannel, failure: failureChannel } = BUS_OPERATIONS[operation];
+  const result$ = merge(
+    bus.stream(resultChannel).pipe(
+      filter((e) => e.correlationId === correlationId),
+      map((e) => ({ ok: true, response: e.response }))
+    ),
+    bus.stream(failureChannel).pipe(
+      filter((e) => e.correlationId === correlationId),
+      map((e) => ({
+        ok: false,
+        error: new BusRequestError(e.message ?? "Bus request rejected", "bus.rejected", {
+          channel: failureChannel,
+          correlationId,
+          payload: e
+        })
+      }))
+    )
+  ).pipe(
+    take(1),
+    timeout(timeoutMs),
+    catchError((err) => {
+      if (err instanceof TimeoutError) {
+        return throwError(
+          () => new BusRequestError(
+            `Bus request timed out after ${timeoutMs}ms on ${resultChannel}`,
+            "bus.timeout",
+            { channel: operation, resultChannel, correlationId, timeoutMs }
+          )
+        );
+      }
+      return throwError(() => err);
+    }),
+    // If the stream completes with no value — the bus was disposed before a
+    // reply (e.g. during `semiont.dispose()` with a request in flight) —
+    // resolve to a typed `bus.closed` result instead of letting `firstValueFrom`
+    // throw rxjs `EmptyError`. An awaited caller then gets a clean
+    // BusRequestError; an in-flight promise nobody is awaiting simply resolves,
+    // so it can't surface as an unhandled rejection on dispose.
+    // See .plans/bugs/busrequest-emptyerror-on-dispose.md.
+    defaultIfEmpty({
+      ok: false,
+      error: new BusRequestError(
+        `Bus closed before a reply on ${resultChannel}`,
+        "bus.closed",
+        { channel: operation, resultChannel, correlationId }
+      )
+    })
+  );
+  const resultPromise = firstValueFrom(result$);
+  try {
+    await bus.emit(operation, fullPayload);
+  } catch (emitError) {
+    resultPromise.catch(() => {
+    });
+    throw emitError;
+  }
+  const result = await resultPromise;
+  if (!result.ok) {
+    throw result.error;
+  }
+  return result.response;
+}
 
 // src/fuzzy-anchor.ts
 function normalizeText(text) {
@@ -1095,13 +1243,13 @@ function levenshteinDistance(str1, str2) {
 }
 function normalizeTextWithMap(input) {
   let normalized = "";
-  const map = [];
+  const map2 = [];
   let pendingWhitespaceStart = -1;
   const flushWhitespace = () => {
     if (pendingWhitespaceStart !== -1) {
       if (normalized.length > 0) {
         normalized += " ";
-        map.push(pendingWhitespaceStart);
+        map2.push(pendingWhitespaceStart);
       }
       pendingWhitespaceStart = -1;
     }
@@ -1115,30 +1263,30 @@ function normalizeTextWithMap(input) {
     flushWhitespace();
     if (ch === "\u2018" || ch === "\u2019") {
       normalized += "'";
-      map.push(i);
+      map2.push(i);
     } else if (ch === "\u201C" || ch === "\u201D") {
       normalized += '"';
-      map.push(i);
+      map2.push(i);
     } else if (ch === "\u2014") {
       normalized += "--";
-      map.push(i);
-      map.push(i);
+      map2.push(i);
+      map2.push(i);
     } else if (ch === "\u2013") {
       normalized += "-";
-      map.push(i);
+      map2.push(i);
     } else {
       normalized += ch;
-      map.push(i);
+      map2.push(i);
     }
   }
-  map.push(input.length);
-  return { normalized, map };
+  map2.push(input.length);
+  return { normalized, map: map2 };
 }
 function buildContentCache(content) {
-  const { normalized, map } = normalizeTextWithMap(content);
+  const { normalized, map: map2 } = normalizeTextWithMap(content);
   return {
     normalizedContent: normalized,
-    normalizedMap: map,
+    normalizedMap: map2,
     lowerContent: content.toLowerCase()
   };
 }
@@ -1769,12 +1917,12 @@ function extensionForMediaType(format) {
   return capabilitiesOf(format)?.extension ?? ".dat";
 }
 var EXTENSION_TO_MEDIA_TYPE = (() => {
-  const map = /* @__PURE__ */ new Map();
+  const map2 = /* @__PURE__ */ new Map();
   for (const type of Object.keys(MEDIA_TYPES)) {
     const ext = MEDIA_TYPES[type].extension;
-    if (!map.has(ext)) map.set(ext, type);
+    if (!map2.has(ext)) map2.set(ext, type);
   }
-  return map;
+  return map2;
 })();
 var EXTENSION_ALIASES = {
   ".markdown": ".md",
@@ -1832,50 +1980,6 @@ function isDefined(value) {
   return value !== null && value !== void 0;
 }
 
-// src/errors.ts
-var SemiontError = class extends Error {
-  constructor(message, code, details) {
-    super(message);
-    this.code = code;
-    this.details = details;
-    this.name = "SemiontError";
-    Error.captureStackTrace(this, this.constructor);
-  }
-  code;
-  details;
-};
-var ValidationError = class extends SemiontError {
-  constructor(message, details) {
-    super(message, "VALIDATION_ERROR", details);
-    this.name = "ValidationError";
-  }
-};
-var ScriptError = class extends SemiontError {
-  constructor(message, code = "SCRIPT_ERROR", details) {
-    super(message, code, details);
-    this.name = "ScriptError";
-  }
-};
-var NotFoundError = class extends SemiontError {
-  constructor(resource, id) {
-    const message = id ? `${resource} with id '${id}' not found` : `${resource} not found`;
-    super(message, "NOT_FOUND", { resource, id });
-    this.name = "NotFoundError";
-  }
-};
-var UnauthorizedError = class extends SemiontError {
-  constructor(message = "Unauthorized", details) {
-    super(message, "UNAUTHORIZED", details);
-    this.name = "UnauthorizedError";
-  }
-};
-var ConflictError = class extends SemiontError {
-  constructor(message, details) {
-    super(message, "CONFLICT", details);
-    this.name = "ConflictError";
-  }
-};
-
 // src/did-utils.ts
 function userToDid(user) {
   return `did:web:${user.domain}:users:${encodeURIComponent(user.email)}`;
@@ -2270,6 +2374,40 @@ function getAllPlatformTypes() {
   return ["aws", "container", "posix", "external"];
 }
 
-export { AUTHORABLE_MEDIA_TYPES, BRIDGED_CHANNELS, CHANNEL_SCHEMAS, CONTEXT_FULL_WEIGHT, CONTEXT_PARTIAL_WEIGHT, ConfigurationError, ConflictError, EMBEDDABLE_MEDIA_TYPES, EventBus, JWTTokenSchema, LOCALES, MEDIA_TYPES, NotFoundError, PERSISTED_EVENT_TYPES, POSITION_WEIGHT_MAX, POSITION_WINDOW, RESOURCE_BROADCAST_TYPES, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseMediaType, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, capabilitiesOf, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, didToAgent, email, entityType, errField, extensionForMediaType, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPageFromFragment, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isNull, isNullish, isNumber, isObject, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isSupportedMediaType, isTag, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
+// src/knowledge-graph-views.ts
+function deriveViews(graph, mainResourceId, focalAnnotationId) {
+  const nodeById = new Map(graph.nodes.map((n) => [n.id, n]));
+  const connections = [];
+  const citedBy = [];
+  for (const edge of graph.edges) {
+    if (edge.type === "citation") {
+      if (edge.target !== mainResourceId) continue;
+      const node = nodeById.get(edge.source);
+      citedBy.push({ resourceId: edge.source, resourceName: node?.label ?? edge.source });
+    } else if (edge.source === mainResourceId) {
+      const node = nodeById.get(edge.target);
+      connections.push({
+        resourceId: edge.target,
+        resourceName: node?.label ?? edge.target,
+        entityTypes: node?.entityTypes ?? [],
+        bidirectional: edge.bidirectional ?? false
+      });
+    }
+  }
+  const siblingEntityTypes = /* @__PURE__ */ new Set();
+  for (const node of graph.nodes) {
+    if (node.type === "annotation" && node.id !== focalAnnotationId) {
+      for (const et of node.entityTypes ?? []) siblingEntityTypes.add(et);
+    }
+  }
+  return {
+    connections,
+    citedBy,
+    citedByCount: citedBy.length,
+    siblingEntityTypes: Array.from(siblingEntityTypes)
+  };
+}
+
+export { AUTHORABLE_MEDIA_TYPES, BRIDGED_CHANNELS, BusRequestError, CHANNEL_SCHEMAS, CONTEXT_FULL_WEIGHT, CONTEXT_PARTIAL_WEIGHT, ConfigurationError, ConflictError, EMBEDDABLE_MEDIA_TYPES, EventBus, JWTTokenSchema, LOCALES, MEDIA_TYPES, NotFoundError, PERSISTED_EVENT_TYPES, POSITION_WEIGHT_MAX, POSITION_WINDOW, RESOURCE_BROADCAST_TYPES, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseMediaType, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, busRequest, capabilitiesOf, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, deriveViews, didToAgent, email, entityType, errField, extensionForMediaType, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPageFromFragment, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isNull, isNullish, isNumber, isObject, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isSupportedMediaType, isTag, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, mediaTypeForExtension, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, textExtractionOf, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map