@semiont/api-client 0.2.45 → 0.3.0

package/dist/index.js

@@ -1,5 +1,7 @@
 import ky from 'ky';
-import { resourceUri } from '@semiont/core';
+import { merge, firstValueFrom } from 'rxjs';
+import { filter, map, take, timeout } from 'rxjs/operators';
+export { getFragmentSelector, getSvgSelector, getTextPositionSelector, validateSvgMarkup } from '@semiont/core';
 
 // src/client.ts
 
@@ -165,17 +167,6 @@ var SSEClient = class {
     }
     return headers;
   }
-  /**
-   * Extract resource ID from URI
-   *
-   * Handles both full URIs and plain IDs:
-   * - 'http://localhost:4000/resources/doc-123' -> 'doc-123'
-   * - 'doc-123' -> 'doc-123'
-   */
-  extractId(uri) {
-    const parts = uri.split("/");
-    return parts[parts.length - 1];
-  }
   /**
    * Detect annotations in a resource (streaming)
    *
@@ -212,8 +203,7 @@ var SSEClient = class {
    * ```
    */
   annotateReferences(resourceId, request, options) {
-    const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/annotate-references-stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/annotate-references-stream`;
     return createSSEStream(
       url,
       {
@@ -269,9 +259,7 @@ var SSEClient = class {
    * ```
    */
   yieldResourceFromAnnotation(resourceId, annotationId, request, options) {
-    const resId = this.extractId(resourceId);
-    const annId = this.extractId(annotationId);
-    const url = `${this.baseUrl}/resources/${resId}/annotations/${annId}/yield-resource-stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/yield-resource-stream`;
     return createSSEStream(
       url,
       {
@@ -325,8 +313,7 @@ var SSEClient = class {
    * ```
    */
   annotateHighlights(resourceId, request = {}, options) {
-    const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/annotate-highlights-stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/annotate-highlights-stream`;
     return createSSEStream(
       url,
       {
@@ -380,8 +367,7 @@ var SSEClient = class {
    * ```
    */
   annotateAssessments(resourceId, request = {}, options) {
-    const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/annotate-assessments-stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/annotate-assessments-stream`;
     return createSSEStream(
       url,
       {
@@ -439,8 +425,7 @@ var SSEClient = class {
    * ```
    */
   annotateComments(resourceId, request = {}, options) {
-    const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/annotate-comments-stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/annotate-comments-stream`;
     return createSSEStream(
       url,
       {
@@ -499,8 +484,7 @@ var SSEClient = class {
    * ```
    */
   annotateTags(resourceId, request, options) {
-    const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/annotate-tags-stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/annotate-tags-stream`;
     return createSSEStream(
       url,
       {
@@ -518,6 +502,35 @@ var SSEClient = class {
       this.logger
     );
   }
+  /**
+   * Search for binding candidates (streaming)
+   *
+   * Bridges bind:search-requested to the backend Binder actor via SSE.
+   * Results emit as bind:search-results on the browser EventBus.
+   *
+   * @param resourceId - Resource the annotation belongs to
+   * @param request - Search configuration (referenceId, context, limit)
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller
+   */
+  bindSearch(resourceId, request, options) {
+    const url = `${this.baseUrl}/resources/${resourceId}/bind-search-stream`;
+    return createSSEStream(
+      url,
+      {
+        method: "POST",
+        headers: this.getHeaders(options.auth),
+        body: JSON.stringify(request)
+      },
+      {
+        progressEvents: [],
+        completeEvent: "bind:search-results",
+        errorEvent: "bind:search-failed",
+        eventBus: options.eventBus
+      },
+      this.logger
+    );
+  }
   /**
    * Subscribe to resource events (long-lived stream)
    *
@@ -553,8 +566,7 @@ var SSEClient = class {
    * ```
    */
   resourceEvents(resourceId, options) {
-    const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/events/stream`;
+    const url = `${this.baseUrl}/resources/${resourceId}/events/stream`;
     const stream = createSSEStream(
       url,
       {
@@ -580,6 +592,54 @@ var SSEClient = class {
     }
     return stream;
   }
+  /**
+   * Subscribe to global system events (long-lived stream)
+   *
+   * Opens a long-lived SSE connection to receive system-level domain events
+   * (entity type additions, etc.) that are not scoped to a specific resource.
+   *
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller
+   *
+   * @example
+   * ```typescript
+   * const stream = sseClient.globalEvents({ auth: 'your-token', eventBus });
+   *
+   * // Events auto-emit to EventBus — subscribe there
+   * eventBus.get('make-meaning:event').subscribe((event) => {
+   *   if (event.type === 'entitytype.added') {
+   *     // Invalidate entity types query
+   *   }
+   * });
+   *
+   * // Close when no longer needed
+   * stream.close();
+   * ```
+   */
+  globalEvents(options) {
+    const url = `${this.baseUrl}/api/events/stream`;
+    const stream = createSSEStream(
+      url,
+      {
+        method: "GET",
+        headers: this.getHeaders(options.auth)
+      },
+      {
+        progressEvents: ["*"],
+        completeEvent: null,
+        errorEvent: null,
+        eventBus: options.eventBus
+      },
+      this.logger
+    );
+    if (options.onConnected) {
+      const sub = options.eventBus.get(SSE_STREAM_CONNECTED).subscribe(() => {
+        options.onConnected();
+        sub.unsubscribe();
+      });
+    }
+    return stream;
+  }
 };
 
 // src/client.ts
@@ -617,11 +677,11 @@ var SemiontApiClient = class {
    */
   sse;
   constructor(config) {
-    const { baseUrl, timeout = 3e4, retry = 2, logger } = config;
+    const { baseUrl, timeout: timeout2 = 3e4, retry = 2, logger } = config;
     this.logger = logger;
     this.baseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
     this.http = ky.create({
-      timeout,
+      timeout: timeout2,
       retry,
       hooks: {
         beforeRequest: [
@@ -788,8 +848,8 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async getResource(resourceUri2, options) {
-    return this.http.get(resourceUri2, {
+  async getResource(id, options) {
+    return this.http.get(`${this.baseUrl}/resources/${id}`, {
       ...options,
       auth: options?.auth
     }).json();
@@ -816,8 +876,8 @@ var SemiontApiClient = class {
    * const { data, contentType } = await client.getResourceRepresentation(rUri, { accept: 'application/pdf', auth: token });
    * ```
    */
-  async getResourceRepresentation(resourceUri2, options) {
-    const response = await this.http.get(resourceUri2, {
+  async getResourceRepresentation(id, options) {
+    const response = await this.http.get(`${this.baseUrl}/resources/${id}`, {
       headers: {
         Accept: options?.accept || "text/plain"
       },
@@ -863,8 +923,8 @@ var SemiontApiClient = class {
    * }
    * ```
    */
-  async getResourceRepresentationStream(resourceUri2, options) {
-    const response = await this.http.get(resourceUri2, {
+  async getResourceRepresentationStream(id, options) {
+    const response = await this.http.get(`${this.baseUrl}/resources/${id}`, {
       headers: {
         Accept: options?.accept || "text/plain"
       },
@@ -887,46 +947,45 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async updateResource(resourceUri2, data, options) {
-    return this.http.patch(resourceUri2, {
+  async updateResource(id, data, options) {
+    await this.http.patch(`${this.baseUrl}/resources/${id}`, {
       json: data,
       ...options,
       auth: options?.auth
-    }).json();
+    }).text();
   }
-  async getResourceEvents(resourceUri2, options) {
-    return this.http.get(`${resourceUri2}/events`, {
+  async getResourceEvents(id, options) {
+    return this.http.get(`${this.baseUrl}/resources/${id}/events`, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async getResourceAnnotations(resourceUri2, options) {
-    return this.http.get(`${resourceUri2}/annotations`, {
+  async getResourceAnnotations(id, options) {
+    return this.http.get(`${this.baseUrl}/resources/${id}/annotations`, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async getAnnotationLLMContext(resourceUri2, annotationId, options) {
+  async getAnnotationLLMContext(resourceId, annotationId, options) {
     const searchParams = new URLSearchParams();
     if (options?.contextWindow) {
       searchParams.append("contextWindow", options.contextWindow.toString());
     }
     return this.http.get(
-      `${resourceUri2}/annotations/${annotationId}/llm-context`,
+      `${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/llm-context`,
       {
         searchParams,
         auth: options?.auth
       }
     ).json();
   }
-  async getResourceReferencedBy(resourceUri2, options) {
-    return this.http.get(`${resourceUri2}/referenced-by`, {
+  async getResourceReferencedBy(id, options) {
+    return this.http.get(`${this.baseUrl}/resources/${id}/referenced-by`, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async generateCloneToken(resourceUri2, options) {
-    const id = resourceUri2.split("/").pop();
+  async generateCloneToken(id, options) {
     return this.http.post(`${this.baseUrl}/resources/${id}/clone-with-token`, {
       ...options,
       auth: options?.auth
@@ -948,69 +1007,70 @@ var SemiontApiClient = class {
   // ============================================================================
   // ANNOTATIONS
   // ============================================================================
-  async createAnnotation(resourceUri2, data, options) {
-    return this.http.post(`${resourceUri2}/annotations`, {
+  async createAnnotation(id, data, options) {
+    return this.http.post(`${this.baseUrl}/resources/${id}/annotations`, {
       json: data,
       ...options,
       auth: options?.auth
     }).json();
   }
-  async getAnnotation(annotationUri, options) {
-    return this.http.get(annotationUri, {
+  async getAnnotation(id, options) {
+    return this.http.get(`${this.baseUrl}/annotations/${id}`, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async getResourceAnnotation(annotationUri, options) {
-    return this.http.get(annotationUri, {
+  async getResourceAnnotation(resourceId, annotationId, options) {
+    return this.http.get(`${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}`, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async listAnnotations(resourceUri2, motivation, options) {
+  async listAnnotations(id, motivation, options) {
     const searchParams = new URLSearchParams();
     if (motivation) searchParams.append("motivation", motivation);
-    return this.http.get(`${resourceUri2}/annotations`, {
+    return this.http.get(`${this.baseUrl}/resources/${id}/annotations`, {
       searchParams,
       ...options,
       auth: options?.auth
     }).json();
   }
-  async deleteAnnotation(annotationUri, options) {
-    await this.http.delete(annotationUri, {
+  async deleteAnnotation(resourceId, annotationId, options) {
+    await this.http.delete(`${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}`, {
       ...options,
       auth: options?.auth
     });
   }
-  async updateAnnotationBody(annotationUri, data, options) {
-    return this.http.put(`${annotationUri}/body`, {
+  async updateAnnotationBody(resourceId, annotationId, data, options) {
+    await this.http.put(`${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/body`, {
       json: data,
       ...options,
       auth: options?.auth
-    }).json();
+    });
   }
-  async getAnnotationHistory(annotationUri, options) {
+  async getAnnotationHistory(resourceId, annotationId, options) {
+    const url = `${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/history`;
     if (options) {
-      return this.http.get(`${annotationUri}/history`, options).json();
+      return this.http.get(url, options).json();
     }
-    return this.http.get(`${annotationUri}/history`).json();
+    return this.http.get(url).json();
   }
   // ============================================================================
   // ENTITY TYPES
   // ============================================================================
   async addEntityType(type, options) {
-    return this.http.post(`${this.baseUrl}/api/entity-types`, {
-      json: { type },
+    await this.http.post(`${this.baseUrl}/api/entity-types`, {
+      json: { tag: type },
       ...options,
       auth: options?.auth
-    }).json();
+    });
   }
   async addEntityTypesBulk(types, options) {
-    return this.http.post(`${this.baseUrl}/api/entity-types/bulk`, {
+    await this.http.post(`${this.baseUrl}/api/entity-types/bulk`, {
       json: { tags: types },
       ...options,
       auth: options?.auth
-    }).json();
+    });
   }
   async listEntityTypes(options) {
     return this.http.get(`${this.baseUrl}/api/entity-types`, {
@@ -1051,6 +1111,113 @@ var SemiontApiClient = class {
     }).json();
   }
   // ============================================================================
+  // ADMIN — EXCHANGE (Backup/Restore)
+  // ============================================================================
+  /**
+   * Create a backup of the knowledge base. Returns raw Response for streaming download.
+   * Caller should use response.blob() to trigger a file download.
+   */
+  async backupKnowledgeBase(options) {
+    return fetch(`${this.baseUrl}/api/admin/exchange/backup`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.auth ? { Authorization: `Bearer ${options.auth}` } : {}
+      }
+    });
+  }
+  /**
+   * Restore knowledge base from a backup file. Parses SSE progress events and calls onProgress.
+   * Returns the final SSE event (phase: 'complete' or 'error').
+   */
+  async restoreKnowledgeBase(file, options) {
+    const formData = new FormData();
+    formData.append("file", file);
+    const response = await fetch(`${this.baseUrl}/api/admin/exchange/restore`, {
+      method: "POST",
+      headers: {
+        ...options?.auth ? { Authorization: `Bearer ${options.auth}` } : {}
+      },
+      body: formData
+    });
+    if (!response.ok) {
+      throw new Error(`Restore failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let finalResult = { phase: "unknown" };
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop();
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          const event = JSON.parse(line.slice(6));
+          options?.onProgress?.(event);
+          finalResult = event;
+        }
+      }
+    }
+    return finalResult;
+  }
+  // ============================================================================
+  // ADMIN — EXCHANGE (Linked Data Export/Import)
+  // ============================================================================
+  /**
+   * Export the knowledge base as a JSON-LD Linked Data archive. Returns raw Response for streaming download.
+   * Caller should use response.blob() to trigger a file download.
+   */
+  async exportKnowledgeBase(params, options) {
+    const query = params?.includeArchived ? "?includeArchived=true" : "";
+    return fetch(`${this.baseUrl}/api/moderate/exchange/export${query}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.auth ? { Authorization: `Bearer ${options.auth}` } : {}
+      }
+    });
+  }
+  /**
+   * Import a JSON-LD Linked Data archive into the knowledge base. Parses SSE progress events and calls onProgress.
+   * Returns the final SSE event (phase: 'complete' or 'error').
+   */
+  async importKnowledgeBase(file, options) {
+    const formData = new FormData();
+    formData.append("file", file);
+    const response = await fetch(`${this.baseUrl}/api/moderate/exchange/import`, {
+      method: "POST",
+      headers: {
+        ...options?.auth ? { Authorization: `Bearer ${options.auth}` } : {}
+      },
+      body: formData
+    });
+    if (!response.ok) {
+      throw new Error(`Import failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let finalResult = { phase: "unknown" };
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop();
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          const event = JSON.parse(line.slice(6));
+          options?.onProgress?.(event);
+          finalResult = event;
+        }
+      }
+    }
+    return finalResult;
+  }
+  // ============================================================================
   // JOB STATUS
   // ============================================================================
   async getJobStatus(id, options) {
@@ -1067,7 +1234,7 @@ var SemiontApiClient = class {
    */
   async pollJobUntilComplete(id, options) {
     const interval = options?.interval ?? 1e3;
-    const timeout = options?.timeout ?? 6e4;
+    const timeout2 = options?.timeout ?? 6e4;
     const startTime = Date.now();
     while (true) {
       const status = await this.getJobStatus(id, { auth: options?.auth });
@@ -1077,8 +1244,8 @@ var SemiontApiClient = class {
       if (status.status === "complete" || status.status === "failed" || status.status === "cancelled") {
         return status;
       }
-      if (Date.now() - startTime > timeout) {
-        throw new Error(`Job polling timeout after ${timeout}ms`);
+      if (Date.now() - startTime > timeout2) {
+        throw new Error(`Job polling timeout after ${timeout2}ms`);
       }
       await new Promise((resolve) => setTimeout(resolve, interval));
     }
@@ -1086,13 +1253,13 @@ var SemiontApiClient = class {
   // ============================================================================
   // LLM CONTEXT
   // ============================================================================
-  async getResourceLLMContext(resourceUri2, options) {
+  async getResourceLLMContext(id, options) {
     const searchParams = new URLSearchParams();
     if (options?.depth !== void 0) searchParams.append("depth", options.depth.toString());
     if (options?.maxResources !== void 0) searchParams.append("maxResources", options.maxResources.toString());
     if (options?.includeContent !== void 0) searchParams.append("includeContent", options.includeContent.toString());
     if (options?.includeSummary !== void 0) searchParams.append("includeSummary", options.includeSummary.toString());
-    return this.http.get(`${resourceUri2}/llm-context`, {
+    return this.http.get(`${this.baseUrl}/resources/${id}/llm-context`, {
       searchParams,
       auth: options?.auth
     }).json();
@@ -1113,6 +1280,273 @@ var SemiontApiClient = class {
     return this.http.get(`${this.baseUrl}/api/status`).json();
   }
 };
+async function eventBusRequest(eventBus, requestEvent, payload, successEvent, failureEvent, timeoutMs = 3e4) {
+  const correlationId = payload.correlationId;
+  const result$ = merge(
+    eventBus.get(successEvent).pipe(
+      filter((e) => e.correlationId === correlationId),
+      map((e) => ({ ok: true, response: e.response }))
+    ),
+    eventBus.get(failureEvent).pipe(
+      filter((e) => e.correlationId === correlationId),
+      map((e) => ({ ok: false, error: e.error }))
+    )
+  ).pipe(take(1), timeout(timeoutMs));
+  const resultPromise = firstValueFrom(result$);
+  eventBus.get(requestEvent).next(payload);
+  const result = await resultPromise;
+  if (!result.ok) {
+    throw result.error;
+  }
+  return result.response;
+}
+var EventBusClient = class {
+  constructor(eventBus, timeoutMs = 3e4) {
+    this.eventBus = eventBus;
+    this.timeoutMs = timeoutMs;
+  }
+  // ========================================================================
+  // Browse Flow — Resource reads
+  // ========================================================================
+  async getResource(resourceId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:resource-requested",
+      { correlationId: crypto.randomUUID(), resourceId },
+      "browse:resource-result",
+      "browse:resource-failed",
+      this.timeoutMs
+    );
+  }
+  async listResources(options) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:resources-requested",
+      { correlationId: crypto.randomUUID(), ...options },
+      "browse:resources-result",
+      "browse:resources-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Browse Flow — Annotation reads
+  // ========================================================================
+  async getAnnotations(resourceId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:annotations-requested",
+      { correlationId: crypto.randomUUID(), resourceId },
+      "browse:annotations-result",
+      "browse:annotations-failed",
+      this.timeoutMs
+    );
+  }
+  async getAnnotation(resourceId, annotationId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:annotation-requested",
+      { correlationId: crypto.randomUUID(), resourceId, annotationId },
+      "browse:annotation-result",
+      "browse:annotation-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Browse Flow — Event history
+  // ========================================================================
+  async getEvents(resourceId, options) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:events-requested",
+      { correlationId: crypto.randomUUID(), resourceId, ...options },
+      "browse:events-result",
+      "browse:events-failed",
+      this.timeoutMs
+    );
+  }
+  async getAnnotationHistory(resourceId, annotationId) {
+    return eventBusRequest(
+      this.eventBus,
+      "browse:annotation-history-requested",
+      { correlationId: crypto.randomUUID(), resourceId, annotationId },
+      "browse:annotation-history-result",
+      "browse:annotation-history-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Bind Flow — Graph queries
+  // ========================================================================
+  async getReferencedBy(resourceId, motivation) {
+    return eventBusRequest(
+      this.eventBus,
+      "bind:referenced-by-requested",
+      { correlationId: crypto.randomUUID(), resourceId, motivation },
+      "bind:referenced-by-result",
+      "bind:referenced-by-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Mark Flow — Entity types
+  // ========================================================================
+  async listEntityTypes() {
+    return eventBusRequest(
+      this.eventBus,
+      "mark:entity-types-requested",
+      { correlationId: crypto.randomUUID() },
+      "mark:entity-types-result",
+      "mark:entity-types-failed",
+      this.timeoutMs
+    );
+  }
+  addEntityType(tag, userId) {
+    this.eventBus.get("mark:add-entity-type").next({ tag, userId });
+  }
+  // ========================================================================
+  // Yield Flow — Clone tokens
+  // ========================================================================
+  async generateCloneToken(resourceId) {
+    return eventBusRequest(
+      this.eventBus,
+      "yield:clone-token-requested",
+      { correlationId: crypto.randomUUID(), resourceId },
+      "yield:clone-token-generated",
+      "yield:clone-token-failed",
+      this.timeoutMs
+    );
+  }
+  async getResourceByToken(token) {
+    return eventBusRequest(
+      this.eventBus,
+      "yield:clone-resource-requested",
+      { correlationId: crypto.randomUUID(), token },
+      "yield:clone-resource-result",
+      "yield:clone-resource-failed",
+      this.timeoutMs
+    );
+  }
+  async createResourceFromToken(options) {
+    return eventBusRequest(
+      this.eventBus,
+      "yield:clone-create",
+      { correlationId: crypto.randomUUID(), ...options },
+      "yield:clone-created",
+      "yield:clone-create-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Job Control
+  // ========================================================================
+  async getJobStatus(jobId) {
+    return eventBusRequest(
+      this.eventBus,
+      "job:status-requested",
+      { correlationId: crypto.randomUUID(), jobId },
+      "job:status-result",
+      "job:status-failed",
+      this.timeoutMs
+    );
+  }
+  // ========================================================================
+  // Gather Flow — LLM context
+  // ========================================================================
+  async getAnnotationLLMContext(annotationId, resourceId, options) {
+    const correlationId = crypto.randomUUID();
+    const result$ = merge(
+      this.eventBus.get("gather:complete").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: true, response: e.response }))
+      ),
+      this.eventBus.get("gather:failed").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: false, error: e.error }))
+      )
+    ).pipe(take(1), timeout(this.timeoutMs));
+    const resultPromise = firstValueFrom(result$);
+    this.eventBus.get("gather:requested").next({
+      correlationId,
+      annotationId,
+      resourceId,
+      options
+    });
+    const result = await resultPromise;
+    if (!result.ok) {
+      throw result.error;
+    }
+    return result.response;
+  }
+  async getResourceLLMContext(resourceId, options) {
+    const correlationId = crypto.randomUUID();
+    const result$ = merge(
+      this.eventBus.get("gather:resource-complete").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: true, response: e.context }))
+      ),
+      this.eventBus.get("gather:resource-failed").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: false, error: e.error }))
+      )
+    ).pipe(take(1), timeout(this.timeoutMs));
+    const resultPromise = firstValueFrom(result$);
+    this.eventBus.get("gather:resource-requested").next({
+      correlationId,
+      resourceId,
+      options
+    });
+    const result = await resultPromise;
+    if (!result.ok) {
+      throw result.error;
+    }
+    return result.response;
+  }
+  // ========================================================================
+  // Bind Flow — Search
+  // ========================================================================
+  async searchResources(searchTerm) {
+    const correlationId = crypto.randomUUID();
+    const referenceId = correlationId;
+    const result$ = merge(
+      this.eventBus.get("bind:search-results").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: true, results: e.results }))
+      ),
+      this.eventBus.get("bind:search-failed").pipe(
+        filter((e) => e.correlationId === correlationId),
+        map((e) => ({ ok: false, error: e.error }))
+      )
+    ).pipe(take(1), timeout(this.timeoutMs));
+    const resultPromise = firstValueFrom(result$);
+    this.eventBus.get("bind:search-requested").next({
+      correlationId,
+      referenceId,
+      context: {
+        annotation: {
+          "@context": "http://www.w3.org/ns/anno.jsonld",
+          type: "Annotation",
+          id: referenceId,
+          motivation: "linking",
+          target: referenceId,
+          body: []
+        },
+        sourceResource: {
+          "@context": "https://schema.org",
+          "@id": referenceId,
+          name: searchTerm,
+          format: "text/plain",
+          representations: []
+        },
+        sourceContext: { selected: searchTerm }
+      }
+    });
+    const result = await resultPromise;
+    if (!result.ok) {
+      throw result.error;
+    }
+    return result.results;
+  }
+};
 function getBodySource(body) {
   if (Array.isArray(body)) {
     for (const item of body) {
@@ -1120,7 +1554,7 @@ function getBodySource(body) {
         const itemType = item.type;
         const itemSource = item.source;
         if (itemType === "SpecificResource" && typeof itemSource === "string") {
-          return resourceUri(itemSource);
+          return itemSource;
         }
       }
     }
@@ -1130,7 +1564,7 @@ function getBodySource(body) {
     const bodyType = body.type;
     const bodySource = body.source;
     if (bodyType === "SpecificResource" && typeof bodySource === "string") {
-      return resourceUri(bodySource);
+      return bodySource;
     }
   }
   return null;
@@ -1161,9 +1595,9 @@ function isBodyResolved(body) {
 }
 function getTargetSource(target) {
   if (typeof target === "string") {
-    return resourceUri(target);
+    return target;
   }
-  return resourceUri(target.source);
+  return target.source;
 }
 function getTargetSelector(target) {
   if (typeof target === "string") {
@@ -1231,49 +1665,12 @@ function getPrimarySelector(selector) {
   }
   return selector;
 }
-function getTextPositionSelector(selector) {
-  if (!selector) return null;
-  const selectors = Array.isArray(selector) ? selector : [selector];
-  const found = selectors.find((s) => s.type === "TextPositionSelector");
-  if (!found) return null;
-  return found.type === "TextPositionSelector" ? found : null;
-}
 function getTextQuoteSelector(selector) {
   const selectors = Array.isArray(selector) ? selector : [selector];
   const found = selectors.find((s) => s.type === "TextQuoteSelector");
   if (!found) return null;
   return found.type === "TextQuoteSelector" ? found : null;
 }
-function getSvgSelector(selector) {
-  if (!selector) return null;
-  const selectors = Array.isArray(selector) ? selector : [selector];
-  const found = selectors.find((s) => s.type === "SvgSelector");
-  if (!found) return null;
-  return found.type === "SvgSelector" ? found : null;
-}
-function getFragmentSelector(selector) {
-  if (!selector) return null;
-  const selectors = Array.isArray(selector) ? selector : [selector];
-  const found = selectors.find((s) => s.type === "FragmentSelector");
-  if (!found) return null;
-  return found.type === "FragmentSelector" ? found : null;
-}
-function validateSvgMarkup(svg) {
-  if (!svg.includes('xmlns="http://www.w3.org/2000/svg"')) {
-    return 'SVG must include xmlns="http://www.w3.org/2000/svg" attribute';
-  }
-  if (!svg.includes("<svg") || !svg.includes("</svg>")) {
-    return "SVG must have opening and closing tags";
-  }
-  const shapeElements = ["rect", "circle", "ellipse", "polygon", "polyline", "path", "line"];
-  const hasShape = shapeElements.some(
-    (shape) => svg.includes(`<${shape}`) || svg.includes(`<${shape} `)
-  );
-  if (!hasShape) {
-    return "SVG must contain at least one shape element (rect, circle, ellipse, polygon, polyline, path, or line)";
-  }
-  return null;
-}
 function extractBoundingBox(svg) {
   const viewBoxMatch = svg.match(/<svg[^>]*viewBox="([^"]+)"/);
   if (viewBoxMatch) {
@@ -1507,13 +1904,7 @@ function getAllLocaleCodes() {
 // src/utils/resources.ts
 function getResourceId(resource) {
   if (!resource) return void 0;
-  const fullId = resource["@id"];
-  if (fullId.includes("/resources/")) {
-    const parts = fullId.split("/resources/");
-    const lastPart = parts[parts.length - 1];
-    return lastPart || void 0;
-  }
-  return void 0;
+  return resource["@id"] || void 0;
 }
 function getPrimaryRepresentation(resource) {
   if (!resource?.representations) return void 0;
@@ -1798,14 +2189,14 @@ function isValidEmail(email) {
 
 // src/mime-utils.ts
 function getExtensionForMimeType(mimeType) {
-  const map = {
+  const map2 = {
     "text/plain": "txt",
     "text/markdown": "md",
     "image/png": "png",
     "image/jpeg": "jpg",
     "application/pdf": "pdf"
   };
-  return map[mimeType] || "dat";
+  return map2[mimeType] || "dat";
 }
 function isImageMimeType(mimeType) {
   return mimeType === "image/png" || mimeType === "image/jpeg";
@@ -1826,6 +2217,6 @@ function getMimeCategory(mimeType) {
   return "unsupported";
 }
 
-export { APIError, JWTTokenSchema, LOCALES, SSEClient, SSE_STREAM_CONNECTED, SemiontApiClient, buildContentCache, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isImageMimeType, isPdfMimeType, isReference, isResolvedReference, isStubReference, isTag, isTextMimeType, isValidEmail, normalizeCoordinates, normalizeText, parseSvgSelector, scaleSvgToNative, validateAndCorrectOffsets, validateData, validateSvgMarkup, verifyPosition };
+export { APIError, EventBusClient, JWTTokenSchema, LOCALES, SSEClient, SSE_STREAM_CONNECTED, SemiontApiClient, buildContentCache, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getTargetSelector, getTargetSource, getTextQuoteSelector, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isImageMimeType, isPdfMimeType, isReference, isResolvedReference, isStubReference, isTag, isTextMimeType, isValidEmail, normalizeCoordinates, normalizeText, parseSvgSelector, scaleSvgToNative, validateAndCorrectOffsets, validateData, verifyPosition };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map