@semiont/core 0.5.5 → 0.5.6

package/dist/index.d.ts

@@ -4123,23 +4123,13 @@ type EventName = keyof EventMap;
  * for one caller) does NOT belong here. Those are per-caller correlation-ID
  * responses and publish globally — the caller filters by `correlationId`.
  *
- * The frontend's `subscribeToResource(id)` wires these channels via
- * `scope=id&scoped=<channel>` so the SSE route delivers them to that
- * participant. WorkerStateUnit uses this list to decide which emitted events to
- * scope to their resource.
- */
-/**
- * Audit note (SIMPLE-BUS Phase 3 close): `yield:progress` was
- * considered for inclusion but has only one consumer — the
- * yield-initiator's Observable in `packages/api-client/src/namespaces/yield.ts`.
- * No viewer of the resource other than the initiator subscribes to
- * progress. Scoping therefore serves no fan-out-narrowing purpose for
- * that channel, so it stays global (as a correlation-ID-shaped
- * response, filtered by `referenceId`). Only `yield:finished` and
- * `yield:failed` have a genuine multi-participant consumer (the
- * ResourceViewerPage toast on the source resource).
- */
-declare const RESOURCE_BROADCAST_TYPES: readonly ["job:complete", "job:fail"];
+ * The SDK's resource-scoped `browse.*` live queries wire these channels —
+ * subscribing acquires the scope via the transport's `subscribeToResource`
+ * (`scope=id&scoped=<channel>`) so the SSE route delivers them to that
+ * participant (freshness follows observation; #847). WorkerStateUnit uses this
+ * list to decide which emitted events to scope to their resource.
+ */
+declare const RESOURCE_BROADCAST_TYPES: readonly [];
 type ResourceBroadcastType = typeof RESOURCE_BROADCAST_TYPES[number];
 /**
  * Authoritative map from bus channel to OpenAPI schema name.
@@ -4956,6 +4946,45 @@ declare function extractBoundingBox(svg: string): {
     height: number;
 } | null;
 
+/**
+ * PDF viewrect FragmentSelector codec.
+ *
+ * `PdfCoordinate` is a bounding rectangle in PDF point space: origin at the
+ * bottom-left of the page, Y increasing upward. The Y-flip to canvas pixels
+ * lives in the browser (`react-ui`); the server has no canvas.
+ *
+ * These functions are the viewrect peer of the W3C `FragmentSelector` wrapper in
+ * `web-annotation-utils`: they serialize/parse the RFC 3778
+ * `page=N&viewrect=left,top,width,height` value. `@semiont/content` (geometry
+ * from the text layer), `@semiont/jobs` (serialization at write time), and the
+ * browser canvas all import them from here — no package reaches into the UI.
+ *
+ * RFC 3778 PDF Fragment Identifiers: https://tools.ietf.org/html/rfc3778
+ */
+/**
+ * A bounding rectangle in PDF point coordinates.
+ * Origin at the bottom-left of the page; Y increases upward.
+ */
+interface PdfCoordinate {
+    page: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Serialize a PdfCoordinate to an RFC 3778 FragmentSelector value.
+ * Format: `page=N&viewrect=left,top,width,height` (all in PDF points).
+ */
+declare function createFragmentSelector(coord: PdfCoordinate): string;
+/**
+ * Parse an RFC 3778 FragmentSelector value into PDF coordinates.
+ * Returns null when the value is not a well-formed page + viewrect fragment.
+ */
+declare function parseFragmentSelector(fragment: string): PdfCoordinate | null;
+/** Extract the 1-indexed page number from a FragmentSelector value. */
+declare function getPageFromFragment(fragment: string): number | null;
+
 /**
  * Helper functions for working with W3C ResourceDescriptor
  */
@@ -5226,6 +5255,12 @@ interface ITransport {
      *
      * Returns a disposer that detaches the scope when the last subscriber
      * unsubscribes (ref-counted).
+     *
+     * SDK-internal: this is the scope primitive the SDK's resource-scoped
+     * `browse.*` live queries drive on subscribe/teardown (freshness follows
+     * observation; #847) — it is not part of the application-facing surface.
+     * Single-scope at a time; multi-scope is deferred
+     * (`.plans/MULTI-RESOURCE-SCOPE.md`).
      */
     subscribeToResource(resourceId: ResourceId): () => void;
     /**
@@ -5408,20 +5443,33 @@ declare function normalizeText(text: string): string;
  * Pre-computed content strings for batch fuzzy matching.
  * Avoids recomputing normalizeText(content) and content.toLowerCase()
  * for every annotation when processing many annotations against the same content.
+ *
+ * `normalizedMap[i]` is the original-content index that normalized
+ * character `i` came from. It has length `normalizedContent.length + 1`;
+ * the final entry is `content.length` so a match that ends at the end of
+ * the normalized string maps back to the end of the original. This map is
+ * how `findBestTextMatch` recovers the *original* offset of a normalized
+ * match — counting char-by-char with `normalizeText(singleChar)` is
+ * wrong, because a lone whitespace char trims to `''` (contributing 0)
+ * while in a full-string normalize it collapses to a single space
+ * (contributing 1). That discrepancy shifted recovered offsets by the
+ * number of whitespace runs before the match.
  */
 interface ContentCache {
     normalizedContent: string;
+    normalizedMap: number[];
     lowerContent: string;
 }
 /**
  * Build a ContentCache for a given content string.
- * Call once per content, pass to findBestTextMatch/findTextWithContext for all annotations.
+ * Call once per content, pass to findBestTextMatch/anchorAnnotation for all annotations.
  */
 declare function buildContentCache(content: string): ContentCache;
 /**
  * Find best match for text in content using multi-strategy search
  *
- * Shared core logic used by both findTextWithContext and validateAndCorrectOffsets.
+ * Shared core logic used by both anchorAnnotation (render-time) and
+ * reconcileSelector (write-time).
  *
  * @param content - Full text content to search within
  * @param searchText - The text to find
@@ -5434,37 +5482,91 @@ declare function findBestTextMatch(content: string, searchText: string, position
     end: number;
     matchQuality: MatchQuality;
 } | null;
-/**
- * Find text using exact match with optional prefix/suffix context
- *
- * When the exact text appears multiple times in the content, prefix and suffix
- * are used to disambiguate and find the correct occurrence.
- *
- * If exact text is not found, uses multi-strategy fuzzy matching (normalization,
- * case-insensitive, Levenshtein distance) to locate changed text.
- *
- * @param content - Full text content to search within
- * @param exact - The exact text to find
- * @param prefix - Optional text that should appear immediately before the match
- * @param suffix - Optional text that should appear immediately after the match
- * @param positionHint - Optional position hint (from TextPositionSelector) for fuzzy search
- * @returns Position of the matched text, or null if not found
- *
- * @example
- * ```typescript
- * const content = "The cat sat. The cat ran.";
- * // Find second "The cat" occurrence
- * const pos = findTextWithContext(content, "The cat", "sat. ", " ran");
- * // Returns { start: 13, end: 20 }
- * ```
- */
-declare function findTextWithContext(content: string, exact: string, prefix: string | undefined, suffix: string | undefined, positionHint: number | undefined, cache: ContentCache): TextPosition | null;
 /**
  * Verify that a position correctly points to the exact text
  * Useful for debugging and validation
  */
 declare function verifyPosition(content: string, position: TextPosition, expectedExact: string): boolean;
 
+/**
+ * Anchor a W3C Web Annotation to its rendered text.
+ *
+ * Render-time cleverness is deliberately limited to **verbatim** quote
+ * matching. The annotation's two selectors are written to agree (the
+ * write-side `reconcileSelector` + `buildTextAnnotation` invariant
+ * guarantee `content.substring(start, end) === exact`). At render time the
+ * only legitimate discrepancy is *positional drift*: the document grew or
+ * shrank above the span after the annotation was written, so the offset is
+ * stale but the exact text still exists, byte-identical, elsewhere. That is
+ * the W3C-intended role of `TextQuoteSelector`, and it is safe because it
+ * demands identical text — no normalization, no fuzzy matching, no
+ * judgment call.
+ *
+ * Anything that would require *fuzzy* recovery (smart-quote folding,
+ * whitespace collapse, Levenshtein) is out of scope here: a non-verbatim
+ * mismatch means the content representation diverged or the stored record
+ * is wrong, both of which are deterministic and belong upstream (canonical
+ * content, or a corrected annotation event). The renderer does not guess —
+ * it renders at the stored offset and flags the anchor low-confidence so
+ * the discrepancy surfaces for an upstream fix.
+ *
+ * Returns `null` only when nothing usable is present; otherwise always
+ * returns a position with a `strategy` and `confidence`.
+ */
+type AnchorStrategy = 
+/** Position hint pointed exactly at the exact text. Unambiguous. */
+'fast-path'
+/** Exact text appears once verbatim in the content. No tiebreak needed. */
+ | 'unique-occurrence'
+/** Multiple verbatim occurrences; prefix+suffix uniquely identified one. */
+ | 'context-disambiguated'
+/** Multiple verbatim candidates; position closest to hint chosen. */
+ | 'position-tiebreaker'
+/** Exact text not found verbatim (or no quote); raw stored offset used,
+ *  flagged for upstream correction. */
+ | 'position-fallback';
+type AnchorConfidence = 'high' | 'medium' | 'low';
+interface RenderedAnchor {
+    start: number;
+    end: number;
+    strategy: AnchorStrategy;
+    confidence: AnchorConfidence;
+}
+interface AnchorSelectors {
+    position?: {
+        start: number;
+        end: number;
+    };
+    quote?: {
+        exact: string;
+        prefix?: string;
+        suffix?: string;
+    };
+}
+/**
+ * Distance window for the position tiebreaker. Candidates closer than this
+ * to the hint receive a non-zero position score; further candidates fall
+ * back to zero. Tuned for typical document sizes; calibration tests pin
+ * the boundary behaviour rather than the exact value.
+ */
+declare const POSITION_WINDOW = 1024;
+/**
+ * Score weights — kept as named constants so the calibration tests can
+ * import them and pin the *relationships* rather than the magnitudes.
+ *
+ * Invariant: a full-context match always outranks any position score.
+ * (`CONTEXT_FULL_WEIGHT * 2 > POSITION_WEIGHT_MAX`, accounting for
+ * prefix+suffix each contributing the full weight.)
+ */
+declare const CONTEXT_FULL_WEIGHT = 10;
+declare const CONTEXT_PARTIAL_WEIGHT = 5;
+declare const POSITION_WEIGHT_MAX = 5;
+/**
+ * Locate the best-effort anchor for an annotation against the content the
+ * renderer is about to display. Verbatim-only — see the module doc.
+ */
+declare function anchorAnnotation(content: string, selectors: AnchorSelectors): RenderedAnchor | null;
+
 /**
  * Locale information
  * Copied from SDK for frontend use
@@ -5541,89 +5643,86 @@ declare function normalizeCoordinates(point: Point, displayWidth: number, displa
 declare function scaleSvgToNative(svg: string, displayWidth: number, displayHeight: number, imageWidth: number, imageHeight: number): string;
 
 /**
- * Text context extraction utilities for W3C Web Annotation TextQuoteSelector
- *
- * Provides robust prefix/suffix context extraction with word boundary detection
- * to ensure fuzzy anchoring works correctly when the same text appears multiple times.
+ * Selector reconciliation for write-time annotation construction.
  *
- * Also provides AI offset validation and correction for handling AI-generated annotations
- * where the model may return slightly incorrect character offsets.
+ * LLM-produced text offsets are guides, not authoritative anchors.
+ * `reconcileSelector` takes whatever the LLM emitted and produces a
+ * `TextQuoteSelector`-equivalent `start`/`end`/`exact`/`prefix`/`suffix`
+ * that is provably consistent with the source content:
  *
- * @see https://www.w3.org/TR/annotation-model/#text-quote-selector
- */
-
-/**
- * Extract prefix and suffix context for TextQuoteSelector
+ *   - `content.substring(start, end) === exact`
+ *   - `content.substring(start - prefix.length, start) === prefix`
+ *   - `content.substring(end, end + suffix.length) === suffix`
  *
- * Extracts up to 64 characters before and after the selected text,
- * extending to word boundaries to avoid cutting words in half.
- * This ensures prefix/suffix are meaningful context for fuzzy anchoring.
+ * No caller spreads LLM-emitted prefix/suffix into the stored selector.
+ * The shared helper extracts both from source at the corrected position,
+ * so the no-overlap invariant holds by construction.
  *
- * @param content - Full text content
- * @param start - Start offset of selection
- * @param end - End offset of selection
- * @returns Object with prefix and suffix (undefined if at boundaries)
+ * Returns `null` when the LLM emitted text that doesn't appear in the
+ * source. Callers filter; the helper doesn't decide for them.
  *
- * @example
- * ```typescript
- * const content = "The United States Congress...";
- * const context = extractContext(content, 4, 17); // "United States"
- * // Returns: { prefix: "The ", suffix: " Congress..." }
- * // NOT: { prefix: "nited ", suffix: "gress..." }
- * ```
+ * @see https://www.w3.org/TR/annotation-model/#text-quote-selector
  */
-declare function extractContext(content: string, start: number, end: number): {
-    prefix?: string;
-    suffix?: string;
-};
+
 /**
- * Result of validating and correcting AI-provided annotation offsets
- */
-interface ValidatedAnnotation {
+ * How the reconciliation arrived at the chosen offset. Carried into the
+ * worker log so operators can audit ambiguous matches; the
+ * `first-of-many` flag, in particular, is the signal that an annotation
+ * *may* be anchored at the wrong occurrence and warrants review.
+ */
+type AnchorMethod = 
+/** Exact text appears once in the source — anchored unambiguously. */
+'unique-match'
+/** Multiple occurrences; LLM-emitted prefix/suffix picked one. */
+ | 'context-recovered'
+/** Exact text not found verbatim; fuzzy match recovered it. */
+ | 'fuzzy-match'
+/** Multiple occurrences, no context disambiguated — risky fallback. */
+ | 'first-of-many';
+interface ReconciledSelector {
     start: number;
     end: number;
+    /** Always a substring of the source content — never the LLM's emission. */
     exact: string;
+    /** Extracted from source via extractContext — never the LLM's emission. */
     prefix?: string;
+    /** Extracted from source via extractContext — never the LLM's emission. */
     suffix?: string;
-    corrected: boolean;
-    fuzzyMatched?: boolean;
+    anchorMethod: AnchorMethod;
+    /** Present when the fuzzy fallback recovered the match, naming how. */
     matchQuality?: MatchQuality;
 }
+interface LlmSelectorInput {
+    exact: string;
+    /** LLM-emitted context for disambiguation only — not for storage. */
+    prefix?: string;
+    /** LLM-emitted context for disambiguation only — not for storage. */
+    suffix?: string;
+}
 /**
- * Validate and correct AI-provided annotation offsets with fuzzy matching tolerance
- *
- * AI models sometimes return offsets that don't match the actual text position,
- * or provide text with minor variations (case differences, whitespace, typos).
- *
- * This function uses a multi-strategy approach:
- * 1. Check if AI's offsets are exactly correct
- * 2. Try exact case-sensitive search
- * 3. Try case-insensitive search
- * 4. Try fuzzy matching with Levenshtein distance (5% tolerance)
+ * Extract prefix and suffix context for a `TextQuoteSelector` from
+ * source content. Used internally by `reconcileSelector` after offsets
+ * are reconciled, and exported for callers (e.g. UI-side selection
+ * capture) that need the same extraction semantics.
  *
- * This ensures we're maximally tolerant of AI errors while still maintaining
- * annotation quality and logging what corrections were made.
- *
- * @param content - Full text content
- * @param aiStart - Start offset from AI
- * @param aiEnd - End offset from AI
- * @param exact - The exact text that should be at this position (from AI)
- * @returns Validated annotation with corrected offsets and context
- * @throws Error if no acceptable match can be found
+ * Extracts up to 64 characters before and after the selected text,
+ * extending up to 32 additional chars to reach a word boundary so the
+ * prefix/suffix is meaningful context rather than mid-word fragments.
+ */
+declare function extractContext(content: string, start: number, end: number): {
+    prefix?: string;
+    suffix?: string;
+};
+/**
+ * Reconcile LLM-emitted offsets against the source. Returns a selector
+ * whose `start`/`end` are verified to bracket `exact` in `content`, and
+ * whose `prefix`/`suffix` are extracted from source — never carried
+ * verbatim from the LLM.
  *
- * @example
- * ```typescript
- * // AI said start=1143, but actual text is at 1161
- * const result = validateAndCorrectOffsets(
- *   content,
- *   1143,
- *   1289,
- *   "the question \"whether..."
- * );
- * // Returns: { start: 1161, end: 1303, exact: "...", corrected: true, matchQuality: 'exact', ... }
- * ```
+ * Returns `null` if `exact` cannot be found anywhere in the content,
+ * even via fuzzy match. Callers filter null and log the drop.
  */
-declare function validateAndCorrectOffsets(content: string, aiStart: number, aiEnd: number, exact: string): ValidatedAnnotation;
+declare function reconcileSelector(content: string, llm: LlmSelectorInput): ReconciledSelector | null;
 
 /**
  * Text encoding utilities for consistent charset handling
@@ -6625,5 +6724,5 @@ declare function getAllPlatformTypes(): PlatformType[];
 declare const CORE_TYPES_VERSION = "0.1.0";
 declare const SDK_VERSION = "0.1.0";
 
-export { BRIDGED_CHANNELS, CHANNEL_SCHEMAS, CORE_TYPES_VERSION, ConfigurationError, ConflictError, EventBus, JWTTokenSchema, LOCALES, NotFoundError, PERSISTED_EVENT_TYPES, RESOURCE_BROADCAST_TYPES, SDK_VERSION, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, cloneToken, createCircleSvg, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, didToAgent, email, entityType, errField, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, findTextWithContext, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, 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, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isImageMimeType, isNull, isNullish, isNumber, isObject, isPdfMimeType, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isTag, isTextMimeType, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, normalizeCoordinates, normalizeText, parseEnvironment, parseSvgSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, userDID, userId, userToAgent, userToDid, validateAndCorrectOffsets, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
-export type { AccessToken, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, CloneToken, ConnectionState, ContentCache, ContentFormat, CreateAnnotationInternal, DatabaseServiceConfig, Email, EmbeddingServiceConfig, EmittableChannel, EntityType, EntityTypeStats, Environment, EnvironmentConfig, EventBase, EventInput, EventMap, EventMetadata, EventName, EventOfType, EventQuery, EventSignature, FragmentSelector, FrontendServiceConfig, GatheredContext, GoogleAuthRequest, GoogleCredential, GraphConnection, GraphDatabaseType, GraphPath, GraphServiceConfig, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, ListUsersResponse, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MimeCategory, Motivation, OllamaProviderConfig, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, RefreshToken, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StatusResponse, StoredEvent, StoredEventLike, SvgSelector, TagCategory, TagSchema, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidatedAnnotation, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };
+export { BRIDGED_CHANNELS, CHANNEL_SCHEMAS, CONTEXT_FULL_WEIGHT, CONTEXT_PARTIAL_WEIGHT, CORE_TYPES_VERSION, ConfigurationError, ConflictError, EventBus, JWTTokenSchema, LOCALES, NotFoundError, PERSISTED_EVENT_TYPES, POSITION_WEIGHT_MAX, POSITION_WINDOW, RESOURCE_BROADCAST_TYPES, SDK_VERSION, ScopedEventBus, ScriptError, SemiontError, UnauthorizedError, ValidationError, accessToken, agentToDid, anchorAnnotation, annotationId, annotationUri, applyBodyOperations, assembleAnnotation, authCode, baseUrl, buildContentCache, burstBuffer, busLog, busLogEnabled, cloneToken, createCircleSvg, createFragmentSelector, createPolygonSvg, createRectangleSvg, createTomlConfigLoader, decodeRepresentation, decodeWithCharset, didToAgent, email, entityType, errField, extractBoundingBox, extractCharset, extractContext, findBestTextMatch, findBodyItem, formatLocaleDisplay, generateUuid, getAllLocaleCodes, getAllPlatformTypes, getAnnotationExactText, getAnnotationUriFromEvent, getBodySource, getBodyType, getChecksum, getCommentText, getCreator, getDerivedFrom, getExactText, getExtensionForMimeType, getFragmentSelector, getLanguage, getLocaleEnglishName, getLocaleInfo, getLocaleNativeName, getMimeCategory, getNodeEncoding, getPageFromFragment, getPrimaryMediaType, getPrimaryRepresentation, getPrimarySelector, getResourceEntityTypes, getResourceId, getStorageUri, getSvgSelector, getTargetSelector, getTargetSource, getTextPositionSelector, getTextQuoteSelector, googleCredential, hasTargetSelector, isAnnotationId, isArchived, isArray, isAssessment, isBodyResolved, isBoolean, isComment, isDefined, isDraft, isEventRelatedToAnnotation, isFunction, isHighlight, isImageMimeType, isNull, isNullish, isNumber, isObject, isPdfMimeType, isReference, isResolvedReference, isResourceId, isStoredEvent, isString, isStubReference, isTag, isTextMimeType, isUndefined, isValidEmail, isValidPlatformType, jobId, loadTomlConfig, mcpToken, normalizeCoordinates, normalizeText, parseEnvironment, parseFragmentSelector, parseSvgSelector, reconcileSelector, refreshToken, resourceAnnotationUri, resourceId, resourceUri, scaleSvgToNative, searchQuery, serializePerKey, setBusLogTraceIdProvider, softwareToAgent, userDID, userId, userToAgent, userToDid, validateData, validateEnvironment, validateSvgMarkup, verifyPosition };
+export type { AccessToken, AnchorConfidence, AnchorMethod, AnchorSelectors, AnchorStrategy, Annotation, AnnotationCategory, AnnotationId, AnnotationUri, AnthropicProviderConfig, AppConfig, AssembledAnnotation, AuthCode, BackendDownload, BackendServiceConfig, BaseUrl, BodyItem, BodyItemIdentity, BodyOperation, BoundingBox, Brand, BridgedChannel, BurstBufferOptions, BusOp, CloneToken, ConnectionState, ContentCache, ContentFormat, CreateAnnotationInternal, DatabaseServiceConfig, Email, EmbeddingServiceConfig, EmittableChannel, EntityType, EntityTypeStats, Environment, EnvironmentConfig, EventBase, EventInput, EventMap, EventMetadata, EventName, EventOfType, EventQuery, EventSignature, FragmentSelector, FrontendServiceConfig, GatheredContext, GoogleAuthRequest, GoogleCredential, GraphConnection, GraphDatabaseType, GraphPath, GraphServiceConfig, HealthCheckResponse, IBackendOperations, IContentTransport, ITransport, InferenceProvidersConfig, JobId, ListUsersResponse, LlmSelectorInput, LocaleInfo, Logger, MCPToken, MatchQuality, McpServiceConfig, MimeCategory, Motivation, OllamaProviderConfig, PdfCoordinate, PersistedEvent, PersistedEventType, PlatformType, Point, ProgressCallback, ProgressEvent, PutBinaryOptions, PutBinaryProgress, PutBinaryRequest, ReconciledSelector, RefreshToken, RenderedAnchor, ResourceAnnotationUri, ResourceAnnotations, ResourceBroadcastType, ResourceDescriptor, ResourceFilter, ResourceId, ResourceUri, SearchQuery, SelectionData, Selector, SemiontConfig, ServicePlatformConfig, ServicesConfig, SiteConfig, StatusResponse, StoredEvent, StoredEventLike, SvgSelector, TagCategory, TagSchema, TextPosition, TextPositionSelector, TextQuoteSelector, ActorInferenceConfig as TomlActorInferenceConfig, TomlFileReader, InferenceConfig as TomlInferenceConfig, WorkerInferenceConfig as TomlWorkerInferenceConfig, TransportErrorCode, UpdateResourceInput, UpdateUserRequest, UpdateUserResponse, UserDID, UserId, UserResponse, ValidationFailure, ValidationResult, ValidationSuccess, VectorsServiceConfig, components, operations, paths };