@semiont/core 0.5.3 → 0.5.4

package/dist/text-context.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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.
+ *
+ * Also provides AI offset validation and correction for handling AI-generated annotations
+ * where the model may return slightly incorrect character offsets.
+ *
+ * @see https://www.w3.org/TR/annotation-model/#text-quote-selector
+ */
+import { type MatchQuality } from './fuzzy-anchor';
+/**
+ * Extract prefix and suffix context for TextQuoteSelector
+ *
+ * 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.
+ *
+ * @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)
+ *
+ * @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..." }
+ * ```
+ */
+export declare function extractContext(content: string, start: number, end: number): {
+    prefix?: string;
+    suffix?: string;
+};
+/**
+ * Result of validating and correcting AI-provided annotation offsets
+ */
+export interface ValidatedAnnotation {
+    start: number;
+    end: number;
+    exact: string;
+    prefix?: string;
+    suffix?: string;
+    corrected: boolean;
+    fuzzyMatched?: boolean;
+    matchQuality?: MatchQuality;
+}
+/**
+ * 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)
+ *
+ * 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
+ *
+ * @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', ... }
+ * ```
+ */
+export declare function validateAndCorrectOffsets(content: string, aiStart: number, aiEnd: number, exact: string): ValidatedAnnotation;
+//# sourceMappingURL=text-context.d.ts.map

package/dist/text-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-context.d.ts","sourceRoot":"","sources":["../src/text-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA+CtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,mBAAmB,CA6CrB"}

package/dist/text-encoding.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Text encoding utilities for consistent charset handling
+ *
+ * Ensures frontend decoding matches backend decoding by respecting
+ * charset parameters in mediaType (e.g., "text/plain; charset=iso-8859-1")
+ */
+/**
+ * Extract charset from mediaType parameter
+ *
+ * @param mediaType - Media type with optional charset (e.g., "text/plain; charset=utf-8")
+ * @returns Charset name in lowercase (defaults to "utf-8")
+ *
+ * @example
+ * extractCharset("text/plain; charset=iso-8859-1") // "iso-8859-1"
+ * extractCharset("text/plain") // "utf-8"
+ */
+export declare function extractCharset(mediaType: string): string;
+/**
+ * Decode ArrayBuffer to string using charset from mediaType
+ *
+ * Uses TextDecoder with the charset extracted from mediaType parameter.
+ * This ensures the same character space is used for both annotation creation
+ * (backend) and rendering (frontend).
+ *
+ * @param buffer - Binary data to decode
+ * @param mediaType - Media type with optional charset parameter
+ * @returns Decoded string in the original character space
+ *
+ * @example
+ * const buffer = new Uint8Array([...]);
+ * const text = decodeWithCharset(buffer, "text/plain; charset=iso-8859-1");
+ */
+export declare function decodeWithCharset(buffer: ArrayBuffer, mediaType: string): string;
+//# sourceMappingURL=text-encoding.d.ts.map

package/dist/text-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-encoding.d.ts","sourceRoot":"","sources":["../src/text-encoding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUhF"}

package/dist/transport.d.ts

@@ -0,0 +1,274 @@
+/**
+ * Transport interfaces — the shared contract for any wire-or-local
+ * communication path consumed by `SemiontClient`. Concrete implementations
+ * live alongside the runtime they wrap (`HttpTransport` in
+ * `@semiont/api-client`, in-process variants in `@semiont/make-meaning`,
+ * etc.).
+ *
+ * Three interfaces:
+ *
+ *   ITransport          — bus primitives + lifecycle. Universal: every
+ *                         concrete transport implements this.
+ *   IBackendOperations  — auth, admin, exchange, system endpoints.
+ *                         HTTP-shaped today; an in-process transport may
+ *                         implement none, some, or a different set.
+ *                         Optional on `SemiontClient` — passed only when
+ *                         the host has a backend that supports them.
+ *   IContentTransport   — binary I/O (putBinary / getBinary). Narrow by
+ *                         design because binary has different backpressure
+ *                         and streaming characteristics.
+ *
+ * The behavioral guarantees every implementation must honor are documented
+ * in `docs/protocol/TRANSPORT-CONTRACT.md`.
+ */
+import type { Observable } from 'rxjs';
+import type { components, paths } from './types';
+import type { AccessToken, BaseUrl, ContentFormat, Email, GoogleCredential, RefreshToken, UserDID } from './branded-types';
+import type { AnnotationId, ResourceId } from './identifiers';
+import type { EventMap } from './bus-protocol';
+import type { EventBus } from './event-bus';
+import type { SemiontError } from './errors';
+type Agent = components['schemas']['Agent'];
+/**
+ * Six-state lifecycle for a transport's connection. Drives UI affordances
+ * (connecting spinners, reconnecting banners, etc.) and is observed via
+ * `ITransport.state$`.
+ *
+ *   initial      ─ pre-`start()`; never enters subscribers' streams
+ *                  except as the first replayed value
+ *   connecting   ─ in-flight initial open
+ *   open         ─ healthy, delivering events
+ *   reconnecting ─ open → dropped, retrying; may be transient
+ *   degraded     ─ has been reconnecting for > DEGRADED_THRESHOLD_MS;
+ *                  UI banner threshold; distinguishes brief mount-
+ *                  churn cycles from sustained disconnection
+ *   closed       ─ stop()/dispose() called; terminal
+ */
+export type ConnectionState = 'initial' | 'connecting' | 'open' | 'reconnecting' | 'degraded' | 'closed';
+type AuthResponse = components['schemas']['AuthResponse'];
+type TokenRefreshResponse = components['schemas']['TokenRefreshResponse'];
+type AdminUserStatsResponse = components['schemas']['AdminUserStatsResponse'];
+type OAuthConfigResponse = components['schemas']['OAuthConfigResponse'];
+type ResponseContent<T> = T extends {
+    responses: {
+        200: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : T extends {
+    responses: {
+        201: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : T extends {
+    responses: {
+        202: {
+            content: {
+                'application/json': infer R;
+            };
+        };
+    };
+} ? R : never;
+type RequestContent<T> = T extends {
+    requestBody?: {
+        content: {
+            'application/json': infer R;
+        };
+    };
+} ? R : never;
+export type HealthCheckResponse = ResponseContent<paths['/api/health']['get']>;
+export type StatusResponse = ResponseContent<paths['/api/status']['get']>;
+export type UserResponse = ResponseContent<paths['/api/users/me']['get']>;
+export type UpdateUserRequest = RequestContent<paths['/api/admin/users/{id}']['patch']>;
+export type UpdateUserResponse = ResponseContent<paths['/api/admin/users/{id}']['patch']>;
+export type ListUsersResponse = ResponseContent<paths['/api/admin/users']['get']>;
+export type ProgressEvent = {
+    phase: string;
+    message?: string;
+    result?: Record<string, unknown>;
+};
+export type ProgressCallback = (event: ProgressEvent) => void;
+/**
+ * Stream-shaped return type for backend download operations
+ * (`backupKnowledgeBase`, `exportKnowledgeBase`). Transport-neutral —
+ * any implementation can produce a `ReadableStream<Uint8Array>` without
+ * fabricating a fetch `Response`. HTTP wraps `response.body` and
+ * `response.headers`; in-process implementations return their own stream.
+ *
+ * The same shape `IContentTransport.getBinaryStream` already uses for
+ * binary downloads.
+ */
+export interface BackendDownload {
+    stream: ReadableStream<Uint8Array>;
+    contentType: string;
+    filename?: string;
+}
+export interface ITransport {
+    /**
+     * Base URL the transport speaks to. For HTTP this is `https://host[:port]`;
+     * for in-process transports, an opaque identifier (e.g. `local://kb-id`).
+     */
+    readonly baseUrl: BaseUrl;
+    /**
+     * Publish a payload on the named channel.
+     *
+     * `resourceScope`, when set, marks the emit as a resource-scoped
+     * broadcast — only delivered to subscribers attached to that
+     * resource's scope.
+     */
+    emit<K extends keyof EventMap>(channel: K, payload: EventMap[K], resourceScope?: ResourceId): Promise<void>;
+    on<K extends keyof EventMap>(channel: K, handler: (payload: EventMap[K]) => void): () => void;
+    stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]>;
+    /**
+     * Subscribe to a resource-scoped channel set. HTTP attaches a scope to
+     * its SSE connection; in-process transports may be a no-op because
+     * local events are delivered without scoping.
+     *
+     * Returns a disposer that detaches the scope when the last subscriber
+     * unsubscribes (ref-counted).
+     */
+    subscribeToResource(resourceId: ResourceId): () => void;
+    /**
+     * Hand the given bus to the transport so the transport can publish
+     * the events it receives into it. The reference flows
+     * client → transport (the client owns the bus); transports never
+     * construct or replace it. Concrete transports decide what "receives"
+     * means: HTTP bridges every channel it observes on its SSE wire;
+     * an in-process transport bridges from the local actor bus.
+     */
+    bridgeInto(bus: EventBus): void;
+    /**
+     * Transport-level connection state. For HTTP, reflects the SSE
+     * connection's health; for in-process transports, typically `'open'`
+     * from construction onward (no connection to lose).
+     */
+    readonly state$: Observable<ConnectionState>;
+    /**
+     * Stream of transport-level errors surfaced from typed-wire methods or
+     * other transport-mediated round-trips, just before they're thrown to
+     * the caller. Each emission is a `SemiontError` (or subclass — HTTP
+     * emits `APIError`, in-process transports emit whatever subclass is
+     * appropriate). Consumers can subscribe for global error handling
+     * (e.g. surfacing 401/403 as modals, logging) without wrapping every
+     * call site in try/catch. Distinct from bus-level errors, which are
+     * surfaced via the channel-correlation pattern in `busRequest`.
+     */
+    readonly errors$: Observable<SemiontError>;
+    dispose(): void;
+}
+/**
+ * Auth, admin, exchange, and system endpoints. HTTP-shaped today —
+ * `HttpTransport` implements both this and `ITransport`; the
+ * `SemiontClient` constructor takes a `IBackendOperations` argument
+ * separately from the bus transport so non-HTTP transports
+ * (`LocalTransport`) can implement just the bus surface and the
+ * SemiontClient cleanly omits `client.auth` / `client.admin`.
+ *
+ * Implementations should map their native error codes to
+ * `TransportErrorCode` (see `errors.ts`) so the routing layer
+ * (`SemiontBrowser`) stays transport-neutral.
+ */
+export interface IBackendOperations {
+    authenticatePassword(email: Email, password: string): Promise<AuthResponse>;
+    authenticateGoogle(credential: GoogleCredential): Promise<AuthResponse>;
+    refreshAccessToken(token: RefreshToken): Promise<TokenRefreshResponse>;
+    logout(): Promise<void>;
+    acceptTerms(): Promise<void>;
+    getCurrentUser(): Promise<UserResponse>;
+    generateMcpToken(): Promise<{
+        token: string;
+    }>;
+    getMediaToken(resourceId: ResourceId): Promise<{
+        token: string;
+    }>;
+    listUsers(): Promise<ListUsersResponse>;
+    getUserStats(): Promise<AdminUserStatsResponse>;
+    updateUser(id: UserDID, data: UpdateUserRequest): Promise<UpdateUserResponse>;
+    getOAuthConfig(): Promise<OAuthConfigResponse>;
+    backupKnowledgeBase(): Promise<BackendDownload>;
+    /**
+     * Stream of `ProgressEvent`s for a restore/import operation. The
+     * Observable emits each progress event in order and completes when
+     * the operation is done; the final event carries `phase: 'complete'`
+     * (or `'error'` / `'failed'` followed by an Observable error).
+     *
+     * The SDK wraps the contract's `Observable<ProgressEvent>` as a
+     * `StreamObservable<ProgressEvent>` so consumers can `await` for the
+     * final event or `.subscribe(...)` to render every step.
+     */
+    restoreKnowledgeBase(file: File): Observable<ProgressEvent>;
+    exportKnowledgeBase(params?: {
+        includeArchived?: boolean;
+    }): Promise<BackendDownload>;
+    importKnowledgeBase(file: File): Observable<ProgressEvent>;
+    healthCheck(): Promise<HealthCheckResponse>;
+    getStatus(): Promise<StatusResponse>;
+}
+export interface PutBinaryRequest {
+    name: string;
+    file: File | Buffer;
+    format: ContentFormat | string;
+    storageUri: string;
+    entityTypes?: string[];
+    language?: string;
+    sourceAnnotationId?: AnnotationId | string;
+    sourceResourceId?: ResourceId | string;
+    generationPrompt?: string;
+    generator?: Agent | Agent[];
+    isDraft?: boolean;
+}
+/**
+ * Optional byte-progress hook for `putBinary`. Receives raw byte counts;
+ * derived shapes (percentage, ETA) are the caller's responsibility.
+ *
+ * `totalBytes` may be 0 when the underlying transport can't determine it
+ * (chunked encoding, indeterminate streams). Consumers should render an
+ * indeterminate state in that case.
+ */
+export type PutBinaryProgress = (event: {
+    bytesUploaded: number;
+    totalBytes: number;
+}) => void;
+export interface PutBinaryOptions {
+    auth?: AccessToken;
+    /**
+     * Called as bytes flow over the wire. Honored by transports that can
+     * observe upload progress (HTTP via XHR). Transports that can't
+     * (in-process LocalContentTransport, current `ky`-based fetch path
+     * with no `onProgress`) simply ignore it.
+     */
+    onProgress?: PutBinaryProgress;
+    /**
+     * Signal that aborts the in-flight request. The XHR-based HTTP path
+     * calls `xhr.abort()` when the signal fires; in-process and
+     * non-XHR HTTP paths complete in the background after abort.
+     */
+    signal?: AbortSignal;
+}
+export interface IContentTransport {
+    putBinary(request: PutBinaryRequest, options?: PutBinaryOptions): Promise<{
+        resourceId: ResourceId;
+    }>;
+    getBinary(resourceId: ResourceId, options?: {
+        accept?: ContentFormat | string;
+        auth?: AccessToken;
+    }): Promise<{
+        data: ArrayBuffer;
+        contentType: string;
+    }>;
+    getBinaryStream(resourceId: ResourceId, options?: {
+        accept?: ContentFormat | string;
+        auth?: AccessToken;
+    }): Promise<{
+        stream: ReadableStream<Uint8Array>;
+        contentType: string;
+    }>;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/type-guards.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Common type guard utilities
+ */
+/**
+ * Check if value is a string
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Check if value is a number (not NaN)
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Check if value is an object (not null, not array)
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Check if value is an array
+ */
+export declare function isArray(value: unknown): value is unknown[];
+/**
+ * Check if value is a boolean
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Check if value is a function
+ */
+export declare function isFunction(value: unknown): value is Function;
+/**
+ * Check if value is null
+ */
+export declare function isNull(value: unknown): value is null;
+/**
+ * Check if value is undefined
+ */
+export declare function isUndefined(value: unknown): value is undefined;
+/**
+ * Check if value is null or undefined
+ */
+export declare function isNullish(value: unknown): value is null | undefined;
+/**
+ * Check if value is defined (not null or undefined)
+ */
+export declare function isDefined<T>(value: T | null | undefined): value is T;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEpE"}