@semiont/api-client 0.2.34-build.90 → 0.2.34-build.92

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as _semiont_core from '@semiont/core';
-import { BaseUrl, ResourceUri, EntityType, AccessToken, AnnotationUri, components, Email, paths, RefreshToken, GoogleCredential, ContentFormat, SearchQuery, CloneToken, ResourceAnnotationUri, Motivation, UserDID, JobId } from '@semiont/core';
+import { BaseUrl, Logger, ResourceUri, EntityType, AccessToken, AnnotationUri, components, Email, paths, RefreshToken, GoogleCredential, ContentFormat, SearchQuery, CloneToken, ResourceAnnotationUri, Motivation, UserDID, JobId } from '@semiont/core';
+export { Logger } from '@semiont/core';
 export { BoundingBox, FragmentSelector, JWTTokenSchema, LOCALES, LocaleInfo, MatchQuality, Point, Selector, SvgSelector, TextPosition, TextPositionSelector, TextQuoteSelector, ValidatedAnnotation, ValidationFailure, ValidationResult, ValidationSuccess, createCircleSvg, createPolygonSvg, createRectangleSvg, decodeRepresentation, decodeWithCharset, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findTextWithContext, formatLocaleDisplay, getAllLocaleCodes, getAnnotationExactText, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getNodeEncoding, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, hasTargetSelector, isArchived, isAssessment, isBodyResolved, isComment, isDraft, isHighlight, isReference, isResolvedReference, isStubReference, isTag, isValidEmail, normalizeCoordinates, normalizeText, parseSvgSelector, scaleSvgToNative, validateAndCorrectOffsets, validateData, validateSvgMarkup, verifyPosition } from './utils/index.js';
 
 /**
@@ -12,7 +13,7 @@ export { BoundingBox, FragmentSelector, JWTTokenSchema, LOCALES, LocaleInfo, Mat
 /**
  * Progress event for reference/linking detection stream
  *
- * Sent by POST /resources/:id/detect-annotations-stream
+ * Sent by POST /resources/:id/annotate-references-stream
  *
  * @example
  * ```typescript
@@ -134,37 +135,15 @@ interface SSEStream {
 }
 
 /**
- * Logger interface for API client observability
- *
- * This interface is intentionally framework-agnostic to work with any logger
- * (winston, pino, bunyan, or simple console).
- *
- * Example usage:
- * ```typescript
- * import winston from 'winston';
- *
- * const logger = winston.createLogger({
- *   level: 'debug',
- *   transports: [new winston.transports.Console()]
- * });
- *
- * const client = new SemiontApiClient({
- *   baseUrl: 'http://localhost:4000',
- *   logger
- * });
- * ```
+ * SSE meta event for stream connection lifecycle
+ * Internal to SSE infrastructure, not part of core event protocol
  */
-interface Logger {
-    debug(message: string, meta?: any): void;
-    info(message: string, meta?: any): void;
-    warn(message: string, meta?: any): void;
-    error(message: string, meta?: any): void;
-}
-
+declare const SSE_STREAM_CONNECTED: "stream-connected";
+type SSEStreamConnected = typeof SSE_STREAM_CONNECTED;
 /**
- * Request body for reference detection stream
+ * Request body for reference annotation stream
  */
-interface DetectReferencesStreamRequest {
+interface AnnotateReferencesStreamRequest {
     entityTypes: EntityType[];
     includeDescriptiveReferences?: boolean;
 }
@@ -174,35 +153,35 @@ interface DetectReferencesStreamRequest {
  */
 type GenerateResourceStreamRequest = components['schemas']['GenerateResourceStreamRequest'];
 /**
- * Request body for highlight detection stream
+ * Request body for highlight annotation stream
  */
-interface DetectHighlightsStreamRequest {
+interface AnnotateHighlightsStreamRequest {
     instructions?: string;
     /** Desired number of highlights per 2000 words (1-15) */
     density?: number;
 }
 /**
- * Request body for assessment detection stream
+ * Request body for assessment annotation stream
  */
-interface DetectAssessmentsStreamRequest {
+interface AnnotateAssessmentsStreamRequest {
     instructions?: string;
     tone?: 'analytical' | 'critical' | 'balanced' | 'constructive';
     /** Desired number of assessments per 2000 words (1-10) */
     density?: number;
 }
 /**
- * Request body for comment detection stream
+ * Request body for comment annotation stream
  */
-interface DetectCommentsStreamRequest {
+interface AnnotateCommentsStreamRequest {
     instructions?: string;
     tone?: 'scholarly' | 'explanatory' | 'conversational' | 'technical';
     /** Desired number of comments per 2000 words (2-12) */
     density?: number;
 }
 /**
- * Request body for tag detection stream
+ * Request body for tag annotation stream
  */
-interface DetectTagsStreamRequest {
+interface AnnotateTagsStreamRequest {
     schemaId: string;
     categories: string[];
 }
@@ -235,7 +214,7 @@ interface SSERequestOptions {
  *   baseUrl: 'http://localhost:4000'
  * });
  *
- * const stream = sseClient.detectReferences(
+ * const stream = sseClient.annotateReferences(
  *   'http://localhost:4000/resources/doc-123',
  *   { entityTypes: ['Person', 'Organization'] },
  *   { auth: 'your-token' }
@@ -274,7 +253,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.detectReferences(
+     * const stream = sseClient.annotateReferences(
      *   'http://localhost:4000/resources/doc-123',
      *   { entityTypes: ['Person', 'Organization'] },
      *   { auth: 'your-token' }
@@ -297,7 +276,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectReferences(resourceId: ResourceUri, request: DetectReferencesStreamRequest, options?: SSERequestOptions): SSEStream;
+    annotateReferences(resourceId: ResourceUri, request: AnnotateReferencesStreamRequest, options: SSERequestOptions): SSEStream;
     /**
      * Generate resource from annotation (streaming)
      *
@@ -335,11 +314,11 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    generateResourceFromAnnotation(resourceId: ResourceUri, annotationId: AnnotationUri, request: GenerateResourceStreamRequest, options?: SSERequestOptions): SSEStream;
+    generateResourceFromAnnotation(resourceId: ResourceUri, annotationId: AnnotationUri, request: GenerateResourceStreamRequest, options: SSERequestOptions): SSEStream;
     /**
      * Detect highlights in a resource (streaming)
      *
-     * Streams highlight detection progress via Server-Sent Events.
+     * Streams highlight annotation progress via Server-Sent Events.
      *
      * @param resourceId - Resource URI or ID
      * @param request - Detection configuration (optional instructions)
@@ -348,7 +327,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.detectHighlights(
+     * const stream = sseClient.annotateHighlights(
      *   'http://localhost:4000/resources/doc-123',
      *   { instructions: 'Focus on key technical points' },
      *   { auth: 'your-token' }
@@ -371,11 +350,11 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectHighlights(resourceId: ResourceUri, request?: DetectHighlightsStreamRequest, options?: SSERequestOptions): SSEStream;
+    annotateHighlights(resourceId: ResourceUri, request: AnnotateHighlightsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
     /**
      * Detect assessments in a resource (streaming)
      *
-     * Streams assessment detection progress via Server-Sent Events.
+     * Streams assessment annotation progress via Server-Sent Events.
      *
      * @param resourceId - Resource URI or ID
      * @param request - Detection configuration (optional instructions)
@@ -384,7 +363,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.detectAssessments(
+     * const stream = sseClient.annotateAssessments(
      *   'http://localhost:4000/resources/doc-123',
      *   { instructions: 'Evaluate claims for accuracy' },
      *   { auth: 'your-token' }
@@ -407,11 +386,11 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectAssessments(resourceId: ResourceUri, request?: DetectAssessmentsStreamRequest, options?: SSERequestOptions): SSEStream;
+    annotateAssessments(resourceId: ResourceUri, request: AnnotateAssessmentsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
     /**
      * Detect comments in a resource (streaming)
      *
-     * Streams comment detection progress via Server-Sent Events.
+     * Streams comment annotation progress via Server-Sent Events.
      * Uses AI to identify passages that would benefit from explanatory comments
      * and creates comment annotations with contextual information.
      *
@@ -422,7 +401,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.detectComments(
+     * const stream = sseClient.annotateComments(
      *   'http://localhost:4000/resources/doc-123',
      *   {
      *     instructions: 'Focus on technical terminology',
@@ -447,11 +426,11 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectComments(resourceId: ResourceUri, request?: DetectCommentsStreamRequest, options?: SSERequestOptions): SSEStream;
+    annotateComments(resourceId: ResourceUri, request: AnnotateCommentsStreamRequest | undefined, options: SSERequestOptions): SSEStream;
     /**
      * Detect tags in a resource (streaming)
      *
-     * Streams tag detection progress via Server-Sent Events.
+     * Streams tag annotation progress via Server-Sent Events.
      * Uses AI to identify passages serving specific structural roles
      * (e.g., IRAC, IMRAD, Toulmin) and creates tag annotations with dual-body structure.
      *
@@ -462,7 +441,7 @@ declare class SSEClient {
      *
      * @example
      * ```typescript
-     * const stream = sseClient.detectTags(
+     * const stream = sseClient.annotateTags(
      *   'http://localhost:4000/resources/doc-123',
      *   {
      *     schemaId: 'legal-irac',
@@ -488,7 +467,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    detectTags(resourceId: ResourceUri, request: DetectTagsStreamRequest, options?: SSERequestOptions): SSEStream;
+    annotateTags(resourceId: ResourceUri, request: AnnotateTagsStreamRequest, options: SSERequestOptions): SSEStream;
     /**
      * Subscribe to resource events (long-lived stream)
      *
@@ -523,7 +502,7 @@ declare class SSEClient {
      * stream.close();
      * ```
      */
-    resourceEvents(resourceId: ResourceUri, options?: SSERequestOptions & {
+    resourceEvents(resourceId: ResourceUri, options: SSERequestOptions & {
         onConnected?: () => void;
     }): SSEStream;
 }
@@ -813,4 +792,4 @@ declare function isPdfMimeType(mimeType: string): boolean;
 type MimeCategory = 'text' | 'image' | 'unsupported';
 declare function getMimeCategory(mimeType: string): MimeCategory;
 
-export { APIError, type DetectReferencesStreamRequest, type GenerateResourceStreamRequest, type GenerationProgress, type Logger, type MimeCategory, type ReferenceDetectionProgress, type RequestOptions, SSEClient, type SSEClientConfig, type SSEStream, SemiontApiClient, type SemiontApiClientConfig, getExtensionForMimeType, getMimeCategory, isImageMimeType, isPdfMimeType, isTextMimeType };
+export { APIError, type AnnotateReferencesStreamRequest, type GenerateResourceStreamRequest, type GenerationProgress, type MimeCategory, type ReferenceDetectionProgress, type RequestOptions, SSEClient, type SSEClientConfig, type SSEStream, type SSEStreamConnected, SSE_STREAM_CONNECTED, SemiontApiClient, type SemiontApiClientConfig, getExtensionForMimeType, getMimeCategory, isImageMimeType, isPdfMimeType, isTextMimeType };

package/dist/index.js

@@ -6,7 +6,6 @@ import { resourceUri } from '@semiont/core';
 // src/sse/stream.ts
 function createSSEStream(url, fetchOptions, config, logger) {
   const abortController = new AbortController();
-  const customHandlers = /* @__PURE__ */ new Map();
   let closed = false;
   const connect = async () => {
     try {
@@ -61,7 +60,8 @@ function createSSEStream(url, fetchOptions, config, logger) {
       while (true) {
         const { done, value } = await reader.read();
         if (done || closed) break;
-        buffer += decoder.decode(value, { stream: true });
+        const chunk = decoder.decode(value, { stream: true });
+        buffer += chunk;
         const lines = buffer.split("\n");
         buffer = lines.pop() || "";
         for (const line of lines) {
@@ -117,27 +117,18 @@ function createSSEStream(url, fetchOptions, config, logger) {
         event: eventType || "message",
         hasData: !!data
       });
-      if (config.customEventHandler) {
-        const handler = customHandlers.get(eventType);
-        if (handler) {
-          handler(parsed);
-          return;
-        }
+      if (typeof parsed === "object" && parsed !== null && "type" in parsed) {
+        config.eventBus.get(eventType).next(parsed);
+        config.eventBus.get("make-meaning:event").next(parsed);
+        return;
       }
-      if (config.eventBus && config.eventPrefix) {
-        if (config.progressEvents.includes(eventType)) {
-          config.eventBus.get(`${config.eventPrefix}:progress`).next(parsed);
-        }
-        if (config.completeEvent && eventType === config.completeEvent) {
-          config.eventBus.get(`${config.eventPrefix}:complete`).next(parsed);
-          closed = true;
-          abortController.abort();
-        }
-        if (config.errorEvent && eventType === config.errorEvent) {
-          config.eventBus.get(`${config.eventPrefix}:failed`).next({ error: new Error(parsed.message || "Stream error") });
-          closed = true;
-          abortController.abort();
-        }
+      config.eventBus.get(eventType).next(parsed);
+      if (config.completeEvent && eventType === config.completeEvent) {
+        closed = true;
+        abortController.abort();
+      } else if (config.errorEvent && eventType === config.errorEvent) {
+        closed = true;
+        abortController.abort();
       }
     } catch (error) {
       console.error("[SSE] Failed to parse event data:", error);
@@ -149,15 +140,12 @@ function createSSEStream(url, fetchOptions, config, logger) {
   return {
     close() {
       abortController.abort();
-    },
-    // Internal method for custom event handlers (used by resourceEvents)
-    on(event, callback) {
-      customHandlers.set(event, callback);
     }
   };
 }
 
 // src/sse/index.ts
+var SSE_STREAM_CONNECTED = "stream-connected";
 var SSEClient = class {
   baseUrl;
   logger;
@@ -200,7 +188,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.detectReferences(
+   * const stream = sseClient.annotateReferences(
    *   'http://localhost:4000/resources/doc-123',
    *   { entityTypes: ['Person', 'Organization'] },
    *   { auth: 'your-token' }
@@ -223,22 +211,22 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  detectReferences(resourceId, request, options) {
+  annotateReferences(resourceId, request, options) {
     const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/detect-annotations-stream`;
+    const url = `${this.baseUrl}/resources/${id}/annotate-references-stream`;
     return createSSEStream(
       url,
       {
         method: "POST",
-        headers: this.getHeaders(options?.auth),
+        headers: this.getHeaders(options.auth),
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["reference-detection-started", "reference-detection-progress"],
-        completeEvent: "reference-detection-complete",
-        errorEvent: "reference-detection-error",
-        eventBus: options?.eventBus,
-        eventPrefix: "detection"
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -288,15 +276,15 @@ var SSEClient = class {
       url,
       {
         method: "POST",
-        headers: this.getHeaders(options?.auth),
+        headers: this.getHeaders(options.auth),
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["generation-started", "generation-progress"],
-        completeEvent: "generation-complete",
-        errorEvent: "generation-error",
-        eventBus: options?.eventBus,
-        eventPrefix: "generation"
+        progressEvents: ["generate:progress"],
+        completeEvent: "generate:finished",
+        errorEvent: "generate:failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -304,7 +292,7 @@ var SSEClient = class {
   /**
    * Detect highlights in a resource (streaming)
    *
-   * Streams highlight detection progress via Server-Sent Events.
+   * Streams highlight annotation progress via Server-Sent Events.
    *
    * @param resourceId - Resource URI or ID
    * @param request - Detection configuration (optional instructions)
@@ -313,7 +301,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.detectHighlights(
+   * const stream = sseClient.annotateHighlights(
    *   'http://localhost:4000/resources/doc-123',
    *   { instructions: 'Focus on key technical points' },
    *   { auth: 'your-token' }
@@ -336,22 +324,22 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  detectHighlights(resourceId, request = {}, options) {
+  annotateHighlights(resourceId, request = {}, options) {
     const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/detect-highlights-stream`;
+    const url = `${this.baseUrl}/resources/${id}/annotate-highlights-stream`;
     return createSSEStream(
       url,
       {
         method: "POST",
-        headers: this.getHeaders(options?.auth),
+        headers: this.getHeaders(options.auth),
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["highlight-detection-started", "highlight-detection-progress"],
-        completeEvent: "highlight-detection-complete",
-        errorEvent: "highlight-detection-error",
-        eventBus: options?.eventBus,
-        eventPrefix: "detection"
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -359,7 +347,7 @@ var SSEClient = class {
   /**
    * Detect assessments in a resource (streaming)
    *
-   * Streams assessment detection progress via Server-Sent Events.
+   * Streams assessment annotation progress via Server-Sent Events.
    *
    * @param resourceId - Resource URI or ID
    * @param request - Detection configuration (optional instructions)
@@ -368,7 +356,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.detectAssessments(
+   * const stream = sseClient.annotateAssessments(
    *   'http://localhost:4000/resources/doc-123',
    *   { instructions: 'Evaluate claims for accuracy' },
    *   { auth: 'your-token' }
@@ -391,22 +379,22 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  detectAssessments(resourceId, request = {}, options) {
+  annotateAssessments(resourceId, request = {}, options) {
     const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/detect-assessments-stream`;
+    const url = `${this.baseUrl}/resources/${id}/annotate-assessments-stream`;
     return createSSEStream(
       url,
       {
         method: "POST",
-        headers: this.getHeaders(options?.auth),
+        headers: this.getHeaders(options.auth),
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["assessment-detection-started", "assessment-detection-progress"],
-        completeEvent: "assessment-detection-complete",
-        errorEvent: "assessment-detection-error",
-        eventBus: options?.eventBus,
-        eventPrefix: "detection"
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -414,7 +402,7 @@ var SSEClient = class {
   /**
    * Detect comments in a resource (streaming)
    *
-   * Streams comment detection progress via Server-Sent Events.
+   * Streams comment annotation progress via Server-Sent Events.
    * Uses AI to identify passages that would benefit from explanatory comments
    * and creates comment annotations with contextual information.
    *
@@ -425,7 +413,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.detectComments(
+   * const stream = sseClient.annotateComments(
    *   'http://localhost:4000/resources/doc-123',
    *   {
    *     instructions: 'Focus on technical terminology',
@@ -450,22 +438,22 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  detectComments(resourceId, request = {}, options) {
+  annotateComments(resourceId, request = {}, options) {
     const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/detect-comments-stream`;
+    const url = `${this.baseUrl}/resources/${id}/annotate-comments-stream`;
     return createSSEStream(
       url,
       {
         method: "POST",
-        headers: this.getHeaders(options?.auth),
+        headers: this.getHeaders(options.auth),
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["comment-detection-started", "comment-detection-progress"],
-        completeEvent: "comment-detection-complete",
-        errorEvent: "comment-detection-error",
-        eventBus: options?.eventBus,
-        eventPrefix: "detection"
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -473,7 +461,7 @@ var SSEClient = class {
   /**
    * Detect tags in a resource (streaming)
    *
-   * Streams tag detection progress via Server-Sent Events.
+   * Streams tag annotation progress via Server-Sent Events.
    * Uses AI to identify passages serving specific structural roles
    * (e.g., IRAC, IMRAD, Toulmin) and creates tag annotations with dual-body structure.
    *
@@ -484,7 +472,7 @@ var SSEClient = class {
    *
    * @example
    * ```typescript
-   * const stream = sseClient.detectTags(
+   * const stream = sseClient.annotateTags(
    *   'http://localhost:4000/resources/doc-123',
    *   {
    *     schemaId: 'legal-irac',
@@ -510,22 +498,22 @@ var SSEClient = class {
    * stream.close();
    * ```
    */
-  detectTags(resourceId, request, options) {
+  annotateTags(resourceId, request, options) {
     const id = this.extractId(resourceId);
-    const url = `${this.baseUrl}/resources/${id}/detect-tags-stream`;
+    const url = `${this.baseUrl}/resources/${id}/annotate-tags-stream`;
     return createSSEStream(
       url,
       {
         method: "POST",
-        headers: this.getHeaders(options?.auth),
+        headers: this.getHeaders(options.auth),
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["tag-detection-started", "tag-detection-progress"],
-        completeEvent: "tag-detection-complete",
-        errorEvent: "tag-detection-error",
-        eventBus: options?.eventBus,
-        eventPrefix: "detection"
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
+        eventBus: options.eventBus,
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -571,24 +559,23 @@ var SSEClient = class {
       url,
       {
         method: "GET",
-        headers: this.getHeaders(options?.auth)
+        headers: this.getHeaders(options.auth)
       },
       {
         progressEvents: ["*"],
-        // Accept all event types
+        // Accept all event types (long-lived stream)
         completeEvent: null,
-        // Long-lived stream - no completion
-        errorEvent: "error",
-        // Generic error event
-        customEventHandler: true
-        // Use custom event handling
+        // Never completes (long-lived)
+        errorEvent: null,
+        // No error event (errors throw)
+        eventBus: options.eventBus
       },
       this.logger
     );
-    if (options?.onConnected) {
-      stream.on?.("stream-connected", options.onConnected);
-    } else {
-      stream.on?.("stream-connected", () => {
+    if (options.onConnected) {
+      const sub = options.eventBus.get(SSE_STREAM_CONNECTED).subscribe(() => {
+        options.onConnected();
+        sub.unsubscribe();
       });
     }
     return stream;
@@ -1723,7 +1710,6 @@ function validateAndCorrectOffsets(content, aiStart, aiEnd, exact) {
   const exactPreview = exact.length > 50 ? exact.substring(0, 50) + "..." : exact;
   const textAtOffset = content.substring(aiStart, aiEnd);
   if (textAtOffset === exact) {
-    console.log(`[validateAndCorrectOffsets] \u2713 Offsets correct for: "${exactPreview}"`);
     const context2 = extractContext(content, aiStart, aiEnd);
     return {
       start: aiStart,
@@ -1877,6 +1863,6 @@ function getMimeCategory(mimeType) {
   return "unsupported";
 }
 
-export { APIError, JWTTokenSchema, LOCALES, SSEClient, SemiontApiClient, 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, JWTTokenSchema, LOCALES, SSEClient, SSE_STREAM_CONNECTED, SemiontApiClient, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map