@semiont/api-client 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -185,6 +185,19 @@ interface AnnotateTagsStreamRequest {
     schemaId: string;
     categories: string[];
 }
+/**
+ * Request body for resource gather stream
+ */
+type GatherResourceStreamRequest = components['schemas']['GatherResourceStreamRequest'];
+/**
+ * Request body for annotation gather stream
+ */
+type GatherAnnotationStreamRequest = components['schemas']['GatherAnnotationStreamRequest'];
+/**
+ * Request body for bind annotation stream
+ * Uses generated type from OpenAPI schema
+ */
+type BindAnnotationStreamRequest = components['schemas']['BindAnnotationStreamRequest'];
 /**
  * Request body for bind search stream
  */
@@ -223,7 +236,7 @@ interface SSERequestOptions {
  *   baseUrl: 'http://localhost:4000'
  * });
  *
- * const stream = sseClient.annotateReferences(
+ * const stream = sseClient.markReferences(
  *   'http://localhost:4000/resources/doc-123',
  *   { entityTypes: ['Person', 'Organization'] },
  *   { auth: 'your-token' }
@@ -254,7 +267,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.annotateReferences(
+     * const stream = sseClient.markReferences(
      *   'http://localhost:4000/resources/doc-123',
      *   { entityTypes: ['Person', 'Organization'] },
      *   { auth: 'your-token' }
@@ -277,7 +290,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    annotateReferences(resourceId: ResourceId, request: AnnotateReferencesStreamRequest, options: SSERequestOptions): SSEStream;
+    markReferences(resourceId: ResourceId, request: AnnotateReferencesStreamRequest, options: SSERequestOptions): SSEStream;
     /**
      * Generate resource from annotation (streaming)
      *
@@ -291,7 +304,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.yieldResourceFromAnnotation(
+     * const stream = sseClient.yieldResource(
      *   'http://localhost:4000/resources/doc-123',
      *   'http://localhost:4000/annotations/ann-456',
      *   { language: 'es', title: 'Spanish Summary' },
@@ -315,7 +328,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    yieldResourceFromAnnotation(resourceId: ResourceId, annotationId: AnnotationId, request: YieldResourceStreamRequest, options: SSERequestOptions): SSEStream;
+    yieldResource(resourceId: ResourceId, annotationId: AnnotationId, request: YieldResourceStreamRequest, options: SSERequestOptions): SSEStream;
     /**
      * Detect highlights in a resource (streaming)
      *
@@ -328,7 +341,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.annotateHighlights(
+     * const stream = sseClient.markHighlights(
      *   'http://localhost:4000/resources/doc-123',
      *   { instructions: 'Focus on key technical points' },
      *   { auth: 'your-token' }
@@ -351,7 +364,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    annotateHighlights(resourceId: ResourceId, request: AnnotateHighlightsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
+    markHighlights(resourceId: ResourceId, request: AnnotateHighlightsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
     /**
      * Detect assessments in a resource (streaming)
      *
@@ -364,7 +377,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.annotateAssessments(
+     * const stream = sseClient.markAssessments(
      *   'http://localhost:4000/resources/doc-123',
      *   { instructions: 'Evaluate claims for accuracy' },
      *   { auth: 'your-token' }
@@ -387,7 +400,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    annotateAssessments(resourceId: ResourceId, request: AnnotateAssessmentsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
+    markAssessments(resourceId: ResourceId, request: AnnotateAssessmentsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
     /**
      * Detect comments in a resource (streaming)
      *
@@ -402,7 +415,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.annotateComments(
+     * const stream = sseClient.markComments(
      *   'http://localhost:4000/resources/doc-123',
      *   {
      *     instructions: 'Focus on technical terminology',
@@ -427,7 +440,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    annotateComments(resourceId: ResourceId, request: AnnotateCommentsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
+    markComments(resourceId: ResourceId, request: AnnotateCommentsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
     /**
      * Detect tags in a resource (streaming)
      *
@@ -442,7 +455,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.annotateTags(
+     * const stream = sseClient.markTags(
      *   'http://localhost:4000/resources/doc-123',
      *   {
      *     schemaId: 'legal-irac',
@@ -468,7 +481,42 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    annotateTags(resourceId: ResourceId, request: AnnotateTagsStreamRequest, options: SSERequestOptions): SSEStream;
+    markTags(resourceId: ResourceId, request: AnnotateTagsStreamRequest, options: SSERequestOptions): SSEStream;
+    /**
+     * Gather LLM context for a resource (streaming)
+     *
+     * Streams resource LLM context gathering progress via Server-Sent Events.
+     *
+     * @param resourceId - Resource URI or ID
+     * @param request - Gather configuration (depth, maxResources, includeContent, includeSummary)
+     * @param options - Request options (auth token, eventBus)
+     * @returns SSE stream controller with progress/complete/error callbacks
+     */
+    gatherResource(resourceId: ResourceId, request: GatherResourceStreamRequest, options: SSERequestOptions): SSEStream;
+    /**
+     * Gather LLM context for an annotation (streaming)
+     *
+     * Streams annotation LLM context gathering progress via Server-Sent Events.
+     *
+     * @param resourceId - Resource URI or ID
+     * @param annotationId - Annotation URI or ID
+     * @param request - Gather configuration (contextWindow)
+     * @param options - Request options (auth token, eventBus)
+     * @returns SSE stream controller with progress/complete/error callbacks
+     */
+    gatherAnnotation(resourceId: ResourceId, annotationId: AnnotationId, request: GatherAnnotationStreamRequest, options: SSERequestOptions): SSEStream;
+    /**
+     * Bind annotation body (streaming)
+     *
+     * Applies annotation body operations and streams completion via Server-Sent Events.
+     *
+     * @param resourceId - Resource URI or ID
+     * @param annotationId - Annotation URI or ID
+     * @param request - Bind operations (resourceId + operations array)
+     * @param options - Request options (auth token, eventBus)
+     * @returns SSE stream controller with complete/error callbacks
+     */
+    bindAnnotation(resourceId: ResourceId, annotationId: AnnotationId, request: BindAnnotationStreamRequest, options: SSERequestOptions): SSEStream;
     /**
      * Search for binding candidates (streaming)
      *
@@ -545,6 +593,21 @@ declare class SSEClient {
     globalEvents(options: SSERequestOptions & {
         onConnected?: () => void;
     }): SSEStream;
+    /**
+     * Subscribe to participant attention stream (long-lived stream)
+     *
+     * Opens a participant-scoped SSE connection to receive cross-participant
+     * beckon signals. Signals are delivered as 'beckon:focus' events routed
+     * to the EventBus — the existing scroll/highlight machinery handles them.
+     *
+     * Signals are ephemeral — delivered if connected, dropped if not.
+     *
+     * @param options - Request options (auth token, eventBus)
+     * @returns SSE stream controller
+     */
+    attentionStream(options: SSERequestOptions & {
+        onConnected?: () => void;
+    }): SSEStream;
 }
 
 /**
@@ -653,7 +716,7 @@ declare class SemiontApiClient {
      * @param data.sourceResourceId - Optional source resource ID
      * @param options - Request options including auth
      */
-    createResource(data: {
+    yieldResource(data: {
         name: string;
         file: File | Buffer;
         format: string;
@@ -666,7 +729,7 @@ declare class SemiontApiClient {
     }, options?: RequestOptions): Promise<{
         resourceId: string;
     }>;
-    getResource(id: ResourceId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{id}']['get']>>;
+    browseResource(id: ResourceId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{id}']['get']>>;
     /**
      * Get resource representation using W3C content negotiation
      * Returns raw binary content (images, PDFs, text, etc.) with content type
@@ -739,17 +802,16 @@ declare class SemiontApiClient {
         stream: ReadableStream<Uint8Array>;
         contentType: string;
     }>;
-    listResources(limit?: number, archived?: boolean, query?: SearchQuery, options?: RequestOptions): Promise<ResponseContent<paths['/resources']['get']>>;
+    browseResources(limit?: number, archived?: boolean, query?: SearchQuery, options?: RequestOptions): Promise<ResponseContent<paths['/resources']['get']>>;
     updateResource(id: ResourceId, data: RequestContent<paths['/resources/{id}']['patch']>, options?: RequestOptions): Promise<void>;
     getResourceEvents(id: ResourceId, options?: RequestOptions): Promise<{
         events: any[];
     }>;
-    getResourceAnnotations(id: ResourceId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{id}/annotations']['get']>>;
-    getAnnotationLLMContext(resourceId: ResourceId, annotationId: AnnotationId, options?: {
+    gatherAnnotation(resourceId: ResourceId, annotationId: AnnotationId, options?: {
         contextWindow?: number;
         auth?: AccessToken;
     }): Promise<ResponseContent<paths['/resources/{resourceId}/annotations/{annotationId}/llm-context']['get']>>;
-    getResourceReferencedBy(id: ResourceId, options?: RequestOptions): Promise<{
+    browseReferences(id: ResourceId, options?: RequestOptions): Promise<{
         referencedBy: any[];
     }>;
     generateCloneToken(id: ResourceId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{id}/clone-with-token']['post']>>;
@@ -757,18 +819,19 @@ declare class SemiontApiClient {
     createResourceFromToken(data: RequestContent<paths['/api/clone-tokens/create-resource']['post']>, options?: RequestOptions): Promise<{
         resourceId: string;
     }>;
-    createAnnotation(id: ResourceId, data: RequestContent<paths['/resources/{id}/annotations']['post']>, options?: RequestOptions): Promise<{
+    markAnnotation(id: ResourceId, data: RequestContent<paths['/resources/{id}/annotations']['post']>, options?: RequestOptions): Promise<{
         annotationId: string;
     }>;
     getAnnotation(id: AnnotationId, options?: RequestOptions): Promise<ResponseContent<paths['/annotations/{id}']['get']>>;
-    getResourceAnnotation(resourceId: ResourceId, annotationId: AnnotationId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{resourceId}/annotations/{annotationId}']['get']>>;
-    listAnnotations(id: ResourceId, motivation?: Motivation, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{id}/annotations']['get']>>;
+    browseAnnotation(resourceId: ResourceId, annotationId: AnnotationId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{resourceId}/annotations/{annotationId}']['get']>>;
+    browseAnnotations(id: ResourceId, motivation?: Motivation, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{id}/annotations']['get']>>;
     deleteAnnotation(resourceId: ResourceId, annotationId: AnnotationId, options?: RequestOptions): Promise<void>;
-    updateAnnotationBody(resourceId: ResourceId, annotationId: AnnotationId, data: RequestContent<paths['/resources/{resourceId}/annotations/{annotationId}/body']['put']>, options?: RequestOptions): Promise<void>;
+    bindAnnotation(resourceId: ResourceId, annotationId: AnnotationId, data: RequestContent<paths['/resources/{resourceId}/annotations/{annotationId}/body']['put']>, options?: RequestOptions): Promise<void>;
     getAnnotationHistory(resourceId: ResourceId, annotationId: AnnotationId, options?: RequestOptions): Promise<ResponseContent<paths['/resources/{resourceId}/annotations/{annotationId}/history']['get']>>;
     addEntityType(type: EntityType, options?: RequestOptions): Promise<void>;
     addEntityTypesBulk(types: EntityType[], options?: RequestOptions): Promise<void>;
     listEntityTypes(options?: RequestOptions): Promise<ResponseContent<paths['/api/entity-types']['get']>>;
+    beckonAttention(participantId: string, data: RequestContent<paths['/api/participants/{id}/attention']['post']>, options?: RequestOptions): Promise<ResponseContent<paths['/api/participants/{id}/attention']['post']>>;
     listUsers(options?: RequestOptions): Promise<ResponseContent<paths['/api/admin/users']['get']>>;
     getUserStats(options?: RequestOptions): Promise<ResponseContent<paths['/api/admin/users/stats']['get']>>;
     /**
@@ -832,7 +895,7 @@ declare class SemiontApiClient {
         onProgress?: (status: ResponseContent<paths['/api/jobs/{id}']['get']>) => void;
         auth?: AccessToken;
     }): Promise<ResponseContent<paths['/api/jobs/{id}']['get']>>;
-    getResourceLLMContext(id: ResourceId, options?: {
+    gatherResource(id: ResourceId, options?: {
         depth?: number;
         maxResources?: number;
         includeContent?: boolean;
@@ -860,8 +923,8 @@ declare class SemiontApiClient {
  * const eventBus = new EventBus();
  * const client = new EventBusClient(eventBus);
  *
- * const resources = await client.listResources({ limit: 10 });
- * const resource = await client.getResource(resourceId('doc-123'));
+ * const resources = await client.browseResources({ limit: 10 });
+ * const resource = await client.browseResource(resourceId('doc-123'));
  * ```
  */
 
@@ -869,8 +932,8 @@ declare class EventBusClient {
     private eventBus;
     private timeoutMs;
     constructor(eventBus: EventBus, timeoutMs?: number);
-    getResource(resourceId: ResourceId): Promise<components['schemas']['GetResourceResponse']>;
-    listResources(options?: {
+    browseResource(resourceId: ResourceId): Promise<components['schemas']['GetResourceResponse']>;
+    browseResources(options?: {
         search?: string;
         archived?: boolean;
         entityType?: string;
@@ -900,12 +963,12 @@ declare class EventBusClient {
         resourceId: ResourceId;
     }>;
     getJobStatus(jobId: JobId): Promise<components['schemas']['JobStatusResponse']>;
-    getAnnotationLLMContext(annotationId: AnnotationId, resourceId: ResourceId, options?: {
+    gatherAnnotation(annotationId: AnnotationId, resourceId: ResourceId, options?: {
         includeSourceContext?: boolean;
         includeTargetContext?: boolean;
         contextWindow?: number;
     }): Promise<components['schemas']['AnnotationLLMContextResponse']>;
-    getResourceLLMContext(resourceId: ResourceId, options: {
+    gatherResource(resourceId: ResourceId, options: {
         depth: number;
         maxResources: number;
         includeContent: boolean;

package/dist/index.js

@@ -179,7 +179,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.annotateReferences(
+   * const stream = sseClient.markReferences(
    *   'http://localhost:4000/resources/doc-123',
    *   { entityTypes: ['Person', 'Organization'] },
    *   { auth: 'your-token' }
@@ -202,7 +202,7 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  annotateReferences(resourceId, request, options) {
+  markReferences(resourceId, request, options) {
     const url = `${this.baseUrl}/resources/${resourceId}/annotate-references-stream`;
     return createSSEStream(
       url,
@@ -234,7 +234,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.yieldResourceFromAnnotation(
+   * const stream = sseClient.yieldResource(
    *   'http://localhost:4000/resources/doc-123',
    *   'http://localhost:4000/annotations/ann-456',
    *   { language: 'es', title: 'Spanish Summary' },
@@ -258,7 +258,7 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  yieldResourceFromAnnotation(resourceId, annotationId, request, options) {
+  yieldResource(resourceId, annotationId, request, options) {
     const url = `${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/yield-resource-stream`;
     return createSSEStream(
       url,
@@ -289,7 +289,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.annotateHighlights(
+   * const stream = sseClient.markHighlights(
    *   'http://localhost:4000/resources/doc-123',
    *   { instructions: 'Focus on key technical points' },
    *   { auth: 'your-token' }
@@ -312,7 +312,7 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  annotateHighlights(resourceId, request = {}, options) {
+  markHighlights(resourceId, request = {}, options) {
     const url = `${this.baseUrl}/resources/${resourceId}/annotate-highlights-stream`;
     return createSSEStream(
       url,
@@ -343,7 +343,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.annotateAssessments(
+   * const stream = sseClient.markAssessments(
    *   'http://localhost:4000/resources/doc-123',
    *   { instructions: 'Evaluate claims for accuracy' },
    *   { auth: 'your-token' }
@@ -366,7 +366,7 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  annotateAssessments(resourceId, request = {}, options) {
+  markAssessments(resourceId, request = {}, options) {
     const url = `${this.baseUrl}/resources/${resourceId}/annotate-assessments-stream`;
     return createSSEStream(
       url,
@@ -399,7 +399,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.annotateComments(
+   * const stream = sseClient.markComments(
    *   'http://localhost:4000/resources/doc-123',
    *   {
    *     instructions: 'Focus on technical terminology',
@@ -424,7 +424,7 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  annotateComments(resourceId, request = {}, options) {
+  markComments(resourceId, request = {}, options) {
     const url = `${this.baseUrl}/resources/${resourceId}/annotate-comments-stream`;
     return createSSEStream(
       url,
@@ -457,7 +457,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.annotateTags(
+   * const stream = sseClient.markTags(
    *   'http://localhost:4000/resources/doc-123',
    *   {
    *     schemaId: 'legal-irac',
@@ -483,7 +483,7 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  annotateTags(resourceId, request, options) {
+  markTags(resourceId, request, options) {
     const url = `${this.baseUrl}/resources/${resourceId}/annotate-tags-stream`;
     return createSSEStream(
       url,
@@ -502,6 +502,95 @@ var SSEClient = class {
       this.logger
     );
   }
+  /**
+   * Gather LLM context for a resource (streaming)
+   *
+   * Streams resource LLM context gathering progress via Server-Sent Events.
+   *
+   * @param resourceId - Resource URI or ID
+   * @param request - Gather configuration (depth, maxResources, includeContent, includeSummary)
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller with progress/complete/error callbacks
+   */
+  gatherResource(resourceId, request, options) {
+    const url = `${this.baseUrl}/resources/${resourceId}/gather-resource-stream`;
+    return createSSEStream(
+      url,
+      {
+        method: "POST",
+        headers: this.getHeaders(options.auth),
+        body: JSON.stringify(request)
+      },
+      {
+        progressEvents: ["gather:progress"],
+        completeEvent: "gather:finished",
+        errorEvent: "gather:failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
+      },
+      this.logger
+    );
+  }
+  /**
+   * Gather LLM context for an annotation (streaming)
+   *
+   * Streams annotation LLM context gathering progress via Server-Sent Events.
+   *
+   * @param resourceId - Resource URI or ID
+   * @param annotationId - Annotation URI or ID
+   * @param request - Gather configuration (contextWindow)
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller with progress/complete/error callbacks
+   */
+  gatherAnnotation(resourceId, annotationId, request, options) {
+    const url = `${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/gather-annotation-stream`;
+    return createSSEStream(
+      url,
+      {
+        method: "POST",
+        headers: this.getHeaders(options.auth),
+        body: JSON.stringify(request)
+      },
+      {
+        progressEvents: ["gather:annotation-progress"],
+        completeEvent: "gather:annotation-finished",
+        errorEvent: "gather:failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
+      },
+      this.logger
+    );
+  }
+  /**
+   * Bind annotation body (streaming)
+   *
+   * Applies annotation body operations and streams completion via Server-Sent Events.
+   *
+   * @param resourceId - Resource URI or ID
+   * @param annotationId - Annotation URI or ID
+   * @param request - Bind operations (resourceId + operations array)
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller with complete/error callbacks
+   */
+  bindAnnotation(resourceId, annotationId, request, options) {
+    const url = `${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/bind-stream`;
+    return createSSEStream(
+      url,
+      {
+        method: "POST",
+        headers: this.getHeaders(options.auth),
+        body: JSON.stringify(request)
+      },
+      {
+        progressEvents: [],
+        completeEvent: "bind:finished",
+        errorEvent: "bind:failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
+      },
+      this.logger
+    );
+  }
   /**
    * Search for binding candidates (streaming)
    *
@@ -640,6 +729,42 @@ var SSEClient = class {
     }
     return stream;
   }
+  /**
+   * Subscribe to participant attention stream (long-lived stream)
+   *
+   * Opens a participant-scoped SSE connection to receive cross-participant
+   * beckon signals. Signals are delivered as 'beckon:focus' events routed
+   * to the EventBus — the existing scroll/highlight machinery handles them.
+   *
+   * Signals are ephemeral — delivered if connected, dropped if not.
+   *
+   * @param options - Request options (auth token, eventBus)
+   * @returns SSE stream controller
+   */
+  attentionStream(options) {
+    const url = `${this.baseUrl}/api/participants/me/attention-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
@@ -815,7 +940,7 @@ var SemiontApiClient = class {
    * @param data.sourceResourceId - Optional source resource ID
    * @param options - Request options including auth
    */
-  async createResource(data, options) {
+  async yieldResource(data, options) {
     const formData = new FormData();
     formData.append("name", data.name);
     formData.append("format", data.format);
@@ -849,7 +974,7 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async getResource(id, options) {
+  async browseResource(id, options) {
     return this.http.get(`${this.baseUrl}/resources/${id}`, {
       ...options,
       auth: options?.auth
@@ -937,7 +1062,7 @@ var SemiontApiClient = class {
     }
     return { stream: response.body, contentType };
   }
-  async listResources(limit, archived, query, options) {
+  async browseResources(limit, archived, query, options) {
     const searchParams = new URLSearchParams();
     if (limit) searchParams.append("limit", limit.toString());
     if (archived !== void 0) searchParams.append("archived", archived.toString());
@@ -961,13 +1086,7 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async getResourceAnnotations(id, options) {
-    return this.http.get(`${this.baseUrl}/resources/${id}/annotations`, {
-      ...options,
-      auth: options?.auth
-    }).json();
-  }
-  async getAnnotationLLMContext(resourceId, annotationId, options) {
+  async gatherAnnotation(resourceId, annotationId, options) {
     const searchParams = new URLSearchParams();
     if (options?.contextWindow) {
       searchParams.append("contextWindow", options.contextWindow.toString());
@@ -980,7 +1099,7 @@ var SemiontApiClient = class {
       }
     ).json();
   }
-  async getResourceReferencedBy(id, options) {
+  async browseReferences(id, options) {
     return this.http.get(`${this.baseUrl}/resources/${id}/referenced-by`, {
       ...options,
       auth: options?.auth
@@ -1008,7 +1127,7 @@ var SemiontApiClient = class {
   // ============================================================================
   // ANNOTATIONS
   // ============================================================================
-  async createAnnotation(id, data, options) {
+  async markAnnotation(id, data, options) {
     return this.http.post(`${this.baseUrl}/resources/${id}/annotations`, {
       json: data,
       ...options,
@@ -1021,13 +1140,13 @@ var SemiontApiClient = class {
       auth: options?.auth
     }).json();
   }
-  async getResourceAnnotation(resourceId, annotationId, options) {
+  async browseAnnotation(resourceId, annotationId, options) {
     return this.http.get(`${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}`, {
       ...options,
       auth: options?.auth
     }).json();
   }
-  async listAnnotations(id, motivation, options) {
+  async browseAnnotations(id, motivation, options) {
     const searchParams = new URLSearchParams();
     if (motivation) searchParams.append("motivation", motivation);
     return this.http.get(`${this.baseUrl}/resources/${id}/annotations`, {
@@ -1042,7 +1161,7 @@ var SemiontApiClient = class {
       auth: options?.auth
     });
   }
-  async updateAnnotationBody(resourceId, annotationId, data, options) {
+  async bindAnnotation(resourceId, annotationId, data, options) {
     await this.http.put(`${this.baseUrl}/resources/${resourceId}/annotations/${annotationId}/body`, {
       json: data,
       ...options,
@@ -1080,6 +1199,16 @@ var SemiontApiClient = class {
     }).json();
   }
   // ============================================================================
+  // PARTICIPANTS
+  // ============================================================================
+  async beckonAttention(participantId, data, options) {
+    return this.http.post(`${this.baseUrl}/api/participants/${participantId}/attention`, {
+      json: data,
+      ...options,
+      auth: options?.auth
+    }).json();
+  }
+  // ============================================================================
   // ADMIN
   // ============================================================================
   async listUsers(options) {
@@ -1254,7 +1383,7 @@ var SemiontApiClient = class {
   // ============================================================================
   // LLM CONTEXT
   // ============================================================================
-  async getResourceLLMContext(id, options) {
+  async gatherResource(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());
@@ -1309,7 +1438,7 @@ var EventBusClient = class {
   // ========================================================================
   // Browse Flow — Resource reads
   // ========================================================================
-  async getResource(resourceId) {
+  async browseResource(resourceId) {
     return eventBusRequest(
       this.eventBus,
       "browse:resource-requested",
@@ -1319,7 +1448,7 @@ var EventBusClient = class {
       this.timeoutMs
     );
   }
-  async listResources(options) {
+  async browseResources(options) {
     return eventBusRequest(
       this.eventBus,
       "browse:resources-requested",
@@ -1453,7 +1582,7 @@ var EventBusClient = class {
   // ========================================================================
   // Gather Flow — LLM context
   // ========================================================================
-  async getAnnotationLLMContext(annotationId, resourceId, options) {
+  async gatherAnnotation(annotationId, resourceId, options) {
     const correlationId = crypto.randomUUID();
     const result$ = merge(
       this.eventBus.get("gather:complete").pipe(
@@ -1478,7 +1607,7 @@ var EventBusClient = class {
     }
     return result.response;
   }
-  async getResourceLLMContext(resourceId, options) {
+  async gatherResource(resourceId, options) {
     const correlationId = crypto.randomUUID();
     const result$ = merge(
       this.eventBus.get("gather:resource-complete").pipe(