@semiont/api-client 0.2.34-build.91 → 0.2.34-build.93

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)
      *
@@ -339,7 +318,7 @@ declare class SSEClient {
     /**
      * 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 | undefined, 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 | undefined, 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 | undefined, 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)
      *
@@ -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

@@ -60,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) {
@@ -119,23 +120,15 @@ function createSSEStream(url, fetchOptions, config, logger) {
       if (typeof parsed === "object" && parsed !== null && "type" in parsed) {
         config.eventBus.get(eventType).next(parsed);
         config.eventBus.get("make-meaning:event").next(parsed);
-      } else {
-        config.eventBus.get(eventType).next(parsed);
+        return;
       }
-      if (config.eventPrefix) {
-        if (config.progressEvents.includes("*") || 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);
@@ -152,6 +145,7 @@ function createSSEStream(url, fetchOptions, config, logger) {
 }
 
 // src/sse/index.ts
+var SSE_STREAM_CONNECTED = "stream-connected";
 var SSEClient = class {
   baseUrl;
   logger;
@@ -194,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' }
@@ -217,9 +211,9 @@ 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,
       {
@@ -228,11 +222,11 @@ var SSEClient = class {
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["detection:started", "detection:progress"],
-        completeEvent: "detection:complete",
-        errorEvent: "detection:failed",
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
         eventBus: options.eventBus,
-        eventPrefix: "detection"
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -286,11 +280,11 @@ var SSEClient = class {
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["generation:started", "generation:progress"],
-        completeEvent: "generation:complete",
-        errorEvent: "generation:failed",
+        progressEvents: ["generate:progress"],
+        completeEvent: "generate:finished",
+        errorEvent: "generate:failed",
         eventBus: options.eventBus,
-        eventPrefix: "generation"
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -298,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)
@@ -307,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' }
@@ -330,9 +324,9 @@ 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,
       {
@@ -341,11 +335,11 @@ var SSEClient = class {
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["detection:started", "detection:progress"],
-        completeEvent: "detection:complete",
-        errorEvent: "detection:failed",
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
         eventBus: options.eventBus,
-        eventPrefix: "detection"
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -353,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)
@@ -362,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' }
@@ -385,9 +379,9 @@ 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,
       {
@@ -396,11 +390,11 @@ var SSEClient = class {
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["detection:started", "detection:progress"],
-        completeEvent: "detection:complete",
-        errorEvent: "detection:failed",
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
         eventBus: options.eventBus,
-        eventPrefix: "detection"
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -408,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.
    *
@@ -419,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',
@@ -444,9 +438,9 @@ 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,
       {
@@ -455,11 +449,11 @@ var SSEClient = class {
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["detection:started", "detection:progress"],
-        completeEvent: "detection:complete",
-        errorEvent: "detection:failed",
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
         eventBus: options.eventBus,
-        eventPrefix: "detection"
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -467,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.
    *
@@ -478,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',
@@ -504,9 +498,9 @@ 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,
       {
@@ -515,11 +509,11 @@ var SSEClient = class {
         body: JSON.stringify(request)
       },
       {
-        progressEvents: ["detection:started", "detection:progress"],
-        completeEvent: "detection:complete",
-        errorEvent: "detection:failed",
+        progressEvents: ["annotate:progress"],
+        completeEvent: "annotate:assist-finished",
+        errorEvent: "annotate:assist-failed",
         eventBus: options.eventBus,
-        eventPrefix: "detection"
+        eventPrefix: void 0
       },
       this.logger
     );
@@ -579,7 +573,7 @@ var SSEClient = class {
       this.logger
     );
     if (options.onConnected) {
-      const sub = options.eventBus.get("stream-connected").subscribe(() => {
+      const sub = options.eventBus.get(SSE_STREAM_CONNECTED).subscribe(() => {
         options.onConnected();
         sub.unsubscribe();
       });
@@ -1406,15 +1400,10 @@ function findTextWithContext(content, exact, prefix, suffix, positionHint) {
     index = content.indexOf(exact, index + 1);
   }
   if (occurrences.length === 0) {
-    console.warn(`[FuzzyAnchor] Exact text not found, trying fuzzy match: "${exact.substring(0, 50)}..."`);
     const fuzzyMatch = findBestTextMatch(content, exact, positionHint);
     if (fuzzyMatch) {
-      console.warn(
-        `[FuzzyAnchor] Found ${fuzzyMatch.matchQuality} match at position ${fuzzyMatch.start}`
-      );
       return { start: fuzzyMatch.start, end: fuzzyMatch.end };
     }
-    console.warn(`[FuzzyAnchor] No acceptable match found for: "${exact.substring(0, 50)}..."`);
     return null;
   }
   if (occurrences.length === 1) {
@@ -1433,23 +1422,16 @@ function findTextWithContext(content, exact, prefix, suffix, positionHint) {
         return { start: pos2, end: pos2 + exact.length };
       }
     }
-    console.warn(
-      `[FuzzyAnchor] Multiple matches found but none match prefix/suffix exactly. Exact: "${exact.substring(0, 30)}...", Prefix: "${prefix?.substring(0, 20) || "none"}", Suffix: "${suffix?.substring(0, 20) || "none"}"`
-    );
     for (const pos2 of occurrences) {
       const actualPrefix = content.substring(Math.max(0, pos2 - (prefix?.length || 0)), pos2);
       const actualSuffix = content.substring(pos2 + exact.length, pos2 + exact.length + (suffix?.length || 0));
       const fuzzyPrefixMatch = !prefix || actualPrefix.includes(prefix.trim());
       const fuzzySuffixMatch = !suffix || actualSuffix.includes(suffix.trim());
       if (fuzzyPrefixMatch && fuzzySuffixMatch) {
-        console.warn(`[FuzzyAnchor] Using fuzzy context match at position ${pos2}`);
         return { start: pos2, end: pos2 + exact.length };
       }
     }
   }
-  console.warn(
-    `[FuzzyAnchor] Multiple matches but no context match. Using first occurrence. Exact: "${exact.substring(0, 30)}..."`
-  );
   const pos = occurrences[0];
   return { start: pos, end: pos + exact.length };
 }
@@ -1713,7 +1695,6 @@ function extractContext(content, start, end) {
   return { prefix, suffix };
 }
 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) {
     const context2 = extractContext(content, aiStart, aiEnd);
@@ -1727,47 +1708,13 @@ function validateAndCorrectOffsets(content, aiStart, aiEnd, exact) {
       matchQuality: "exact"
     };
   }
-  const foundPreview = textAtOffset.length > 50 ? textAtOffset.substring(0, 50) + "..." : textAtOffset;
-  console.warn(
-    `[validateAndCorrectOffsets] \u26A0 AI offset mismatch:
-  Expected text: "${exactPreview}"
-  Found at AI offset (${aiStart}-${aiEnd}): "${foundPreview}"
-  Attempting multi-strategy search...`
-  );
   const match = findBestTextMatch(content, exact, aiStart);
   if (!match) {
-    const exactLong = exact.length > 100 ? exact.substring(0, 100) + "..." : exact;
-    console.error(
-      `[validateAndCorrectOffsets] \u2717 No acceptable match found:
-  AI offsets: start=${aiStart}, end=${aiEnd}
-  AI text: "${exactLong}"
-  Text at AI offset: "${foundPreview}"
-  All search strategies (exact, case-insensitive, fuzzy) failed.
-  This suggests the AI hallucinated text that doesn't exist in the document.`
-    );
     throw new Error(
       "Cannot find acceptable match for text in content. All search strategies failed. Text may be hallucinated."
     );
   }
   const actualText = content.substring(match.start, match.end);
-  const actualPreview = actualText.length > 50 ? actualText.substring(0, 50) + "..." : actualText;
-  const offsetDelta = match.start - aiStart;
-  const matchSymbol = match.matchQuality === "exact" ? "\u2713" : match.matchQuality === "case-insensitive" ? "\u2248" : "~";
-  console.warn(
-    `[validateAndCorrectOffsets] ${matchSymbol} Found ${match.matchQuality} match:
-  AI offsets: start=${aiStart}, end=${aiEnd}
-  Corrected: start=${match.start}, end=${match.end}
-  Offset delta: ${offsetDelta} characters
-  Actual text: "${actualPreview}"`
-  );
-  if (match.matchQuality === "fuzzy") {
-    console.warn(
-      `[validateAndCorrectOffsets] Fuzzy match details:
-  AI provided: "${exactPreview}"
-  Found in doc: "${actualPreview}"
-  Minor text differences detected - using document version`
-    );
-  }
   const context = extractContext(content, match.start, match.end);
   return {
     start: match.start,
@@ -1869,6 +1816,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