@semiont/api-client 0.2.33 → 0.2.34-build.89

package/dist/index-CJqmerJr.d.ts

@@ -1,3859 +0,0 @@
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-interface paths {
-    "/resources/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Resource by URI (W3C Content Negotiation)
-         * @description W3C-compliant globally resolvable resource URI with content negotiation. Returns JSON-LD metadata (Accept: application/ld+json), raw representation (Accept: text/plain, text/markdown, etc.), or redirects to frontend (?view=semiont). Requires authentication.
-         */
-        get: {
-            parameters: {
-                query?: {
-                    /** @description Optional view parameter. If set to 'semiont', redirects to frontend viewer. */
-                    view?: "semiont";
-                };
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Resource metadata (JSON-LD) or raw representation */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/ld+json": components["schemas"]["GetResourceResponse"];
-                        "text/plain": string;
-                        "text/markdown": string;
-                    };
-                };
-                /** @description Redirect to frontend viewer (when ?view=semiont) */
-                302: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        /**
-         * Update Resource
-         * @description Update resource metadata (append-only operations - name and content are immutable)
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["UpdateResourceRequest"];
-                };
-            };
-            responses: {
-                /** @description Resource updated successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetResourceResponse"];
-                    };
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        trace?: never;
-    };
-    "/annotations/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Annotation by URI (W3C Content Negotiation)
-         * @description W3C-compliant globally resolvable annotation URI with content negotiation. Returns JSON-LD for API clients (Accept: application/ld+json or application/json). Redirects to frontend for browsers (Accept: text/html or browser User-Agent). Requires authentication and resourceId query parameter.
-         */
-        get: {
-            parameters: {
-                query: {
-                    /** @description Resource ID or URI containing the annotation */
-                    resourceId: string;
-                };
-                header?: never;
-                path: {
-                    /** @description Annotation ID */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Annotation representation (JSON-LD) */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/ld+json": components["schemas"]["GetAnnotationResponse"];
-                    };
-                };
-                /** @description Redirect to frontend (for browsers) */
-                302: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Missing resourceId parameter */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/annotations/{id}/context": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Annotation Context
-         * @description Get the text context around an annotation with configurable before/after window
-         */
-        get: {
-            parameters: {
-                query: {
-                    /** @description Resource ID containing the annotation */
-                    resourceId: string;
-                    /** @description Number of characters before the selection */
-                    contextBefore?: number;
-                    /** @description Number of characters after the selection */
-                    contextAfter?: number;
-                };
-                header?: never;
-                path: {
-                    /** @description Annotation ID */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Annotation context */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AnnotationContextResponse"];
-                    };
-                };
-                /** @description Invalid query parameters */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/annotations/{id}/summary": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Annotation Summary
-         * @description Get an AI-generated summary of the annotation in context
-         */
-        get: {
-            parameters: {
-                query: {
-                    /** @description Resource ID containing the annotation */
-                    resourceId: string;
-                };
-                header?: never;
-                path: {
-                    /** @description Annotation ID */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description AI-generated annotation summary */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ContextualSummaryResponse"];
-                    };
-                };
-                /** @description Missing resourceId parameter */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/health": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Health Check
-         * @description Check if the API is operational and database is connected
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Health status of the API */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["HealthResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/tokens/password": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Password Authentication
-         * @description Authenticate with email and password for users with password provider
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["PasswordAuthRequest"];
-                };
-            };
-            responses: {
-                /** @description Authentication successful */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AuthResponse"];
-                    };
-                };
-                /** @description Bad request - invalid input or OAuth user attempting password auth */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Unauthorized - invalid credentials */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - account not active */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/tokens/google": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Google OAuth Authentication
-         * @description Authenticate with Google OAuth access token
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["GoogleAuthRequest"];
-                };
-            };
-            responses: {
-                /** @description Successful authentication */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AuthResponse"];
-                    };
-                };
-                /** @description Invalid request or authentication failed */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/tokens/refresh": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Refresh Access Token
-         * @description Exchange a refresh token for a new access token
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["TokenRefreshRequest"];
-                };
-            };
-            responses: {
-                /** @description New access token generated */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GoogleAuthRequest"];
-                    };
-                };
-                /** @description Invalid or expired refresh token */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/tokens/mcp-generate": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Generate MCP Token
-         * @description Generate a short-lived token for MCP server
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description MCP token generated */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["MCPGenerateResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/users/me": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Current User
-         * @description Get information about the authenticated user
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description User information */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["UserResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/users/accept-terms": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Accept Terms
-         * @description Mark terms as accepted for the current user
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Terms accepted successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AcceptTermsResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/users/logout": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Logout
-         * @description Logout the current user
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Logged out successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AcceptTermsResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/status": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Service Status
-         * @description Get service status and feature availability
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Service status information */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["StatusResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/admin/users": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List All Users
-         * @description Get a list of all users (admin only)
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description List of users */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AdminUsersListResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/admin/users/stats": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * User Statistics
-         * @description Get user statistics (admin only)
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description User statistics */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AdminUserStatsResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/admin/users/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
-        /**
-         * Delete User
-         * @description Delete a user account (admin only, cannot delete own account)
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description User deleted successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AcceptTermsResponse"];
-                    };
-                };
-                /** @description Cannot delete own account */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description User not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        /**
-         * Update User
-         * @description Update user properties (admin only)
-         */
-        patch: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["UpdateUserRequest"];
-                };
-            };
-            responses: {
-                /** @description User updated successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AdminUpdateUserResponse"];
-                    };
-                };
-                /** @description Invalid request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description User not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        trace?: never;
-    };
-    "/api/admin/oauth/config": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get OAuth Configuration
-         * @description Get OAuth provider configuration (admin only, read-only)
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OAuth configuration */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["OAuthConfigResponse"];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List Resources
-         * @description List all resources with optional filters
-         */
-        get: {
-            parameters: {
-                query?: {
-                    offset?: number | null;
-                    limit?: number | null;
-                    entityType?: string;
-                    archived?: "true" | "false" | boolean;
-                    search?: string;
-                    /** @description Search query */
-                    q?: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Resources listed successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ListResourcesResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Create Resource
-         * @description Create a new resource
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "multipart/form-data": {
-                        /** @description Resource name */
-                        name: string;
-                        /**
-                         * Format: binary
-                         * @description Binary content of the resource
-                         */
-                        file: string;
-                        /** @description MIME type (e.g., text/markdown, image/png) */
-                        format: string;
-                        /** @description JSON-encoded array of entity types */
-                        entityTypes?: string;
-                        /** @description ISO 639-1 language code */
-                        language?: string;
-                        /** @description How the resource was created */
-                        creationMethod?: string;
-                        /** @description Source annotation ID (for generated resources) */
-                        sourceAnnotationId?: string;
-                        /** @description Source resource ID (for cloned resources) */
-                        sourceResourceId?: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Resource created successfully */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CreateResourceResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/detect-annotations-stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Detect Annotations with Progress (SSE)
-         * @description Stream real-time entity detection progress via Server-Sent Events
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["DetectReferencesStreamRequest"];
-                };
-            };
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/detect-highlights-stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Detect Highlights with Progress (SSE)
-         * @description Stream real-time highlight detection progress via Server-Sent Events
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["DetectHighlightsStreamRequest"];
-                };
-            };
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/detect-assessments-stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Detect Assessments with Progress (SSE)
-         * @description Stream real-time assessment detection progress via Server-Sent Events
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["DetectAssessmentsStreamRequest"];
-                };
-            };
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/detect-comments-stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Detect Comments with Progress (SSE)
-         * @description Stream real-time comment detection progress via Server-Sent Events
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["DetectCommentsStreamRequest"];
-                };
-            };
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/detect-tags-stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Detect Tags with Progress (SSE)
-         * @description Stream real-time tag detection progress via Server-Sent Events. Identifies passages serving specific structural roles (IRAC, IMRAD, Toulmin frameworks).
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["DetectTagsStreamRequest"];
-                };
-            };
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Resource not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/llm-context": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Resource LLM Context
-         * @description Get resource with full context for LLM processing
-         */
-        get: {
-            parameters: {
-                query?: {
-                    depth?: number;
-                    maxResources?: number;
-                    includeContent?: "true" | "false" | boolean;
-                    includeSummary?: "true" | "false" | boolean;
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description LLM context */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ResourceLLMContextResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{resourceId}/annotations/{annotationId}/llm-context": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Annotation LLM Context
-         * @description Get annotation with full context for LLM processing
-         */
-        get: {
-            parameters: {
-                query?: {
-                    includeSourceContext?: "true" | "false" | boolean;
-                    includeTargetContext?: "true" | "false" | boolean;
-                    contextWindow?: number;
-                };
-                header?: never;
-                path: {
-                    resourceId: string;
-                    annotationId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Annotation LLM context */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AnnotationLLMContextResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/referenced-by": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Referenced By
-         * @description Get resources that reference this resource
-         */
-        get: {
-            parameters: {
-                query?: {
-                    /** @description Filter incoming references by W3C motivation type (e.g., 'linking', 'commenting', 'highlighting') */
-                    motivation?: components["schemas"]["Motivation"];
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Resources that reference this resource */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetReferencedByResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/clone-tokens/{token}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Resource by Clone Token
-         * @description Retrieve a resource using a clone token
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    token: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Resource retrieved successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetResourceByTokenResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/clone-tokens/create-resource": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Create Resource from Clone Token
-         * @description Create a new resource using a clone token
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["CreateResourceFromTokenRequest"];
-                };
-            };
-            responses: {
-                /** @description Resource created successfully */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CreateResourceResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/clone-with-token": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Clone Resource with Token
-         * @description Generate a temporary token for cloning a resource
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Clone token generated successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CloneResourceWithTokenResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/annotations": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Resource Annotations
-         * @description Get all annotations (both highlights and references) in a resource
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Resource annotations */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CreateResourceResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Create Annotation
-         * @description Create a new annotation/reference in a resource
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["CreateAnnotationRequest"];
-                };
-            };
-            responses: {
-                /** @description Annotation created successfully */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["CreateAnnotationResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/events": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Resource Event History
-         * @description Get full event history for a resource with optional filtering
-         */
-        get: {
-            parameters: {
-                query?: {
-                    type?: "resource.created" | "resource.cloned" | "resource.archived" | "resource.unarchived" | "annotation.added" | "annotation.removed" | "annotation.body.updated" | "entitytag.added" | "entitytag.removed" | "entitytype.added";
-                    userId?: string;
-                    limit?: number;
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Events retrieved successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetEventsResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{id}/events/stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Subscribe to Resource Events (SSE)
-         * @description Open a Server-Sent Events stream to receive real-time resource events
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{resourceId}/annotations/{annotationId}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Annotation
-         * @description Get a specific annotation from a resource using nested path
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    resourceId: string;
-                    /** @description Annotation ID */
-                    annotationId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Annotation retrieved successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetAnnotationResponse"];
-                    };
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        /**
-         * Delete Annotation
-         * @description Delete an annotation from a resource
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    resourceId: string;
-                    /** @description Annotation ID */
-                    annotationId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Annotation deleted successfully */
-                204: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{resourceId}/annotations/{annotationId}/body": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        /**
-         * Update Annotation Body
-         * @description Apply fine-grained operations to modify annotation body items (add, remove, or replace TextualBody and SpecificResource items)
-         */
-        put: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    resourceId: string;
-                    /** @description Annotation ID */
-                    annotationId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["UpdateAnnotationBodyRequest"];
-                };
-            };
-            responses: {
-                /** @description Annotation body updated successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["UpdateAnnotationBodyResponse"];
-                    };
-                };
-            };
-        };
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{resourceId}/annotations/{annotationId}/generate-resource-stream": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Generate Resource (SSE Stream)
-         * @description Stream real-time resource generation progress via Server-Sent Events
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    resourceId: string;
-                    /** @description Annotation ID */
-                    annotationId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["GenerateResourceStreamRequest"];
-                };
-            };
-            responses: {
-                /** @description SSE stream opened successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "text/event-stream": components["schemas"]["EventStreamResponse"];
-                    };
-                };
-                /** @description Authentication required */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/resources/{resourceId}/annotations/{annotationId}/history": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Annotation History
-         * @description Get full event history for a specific annotation (highlight or reference)
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    resourceId: string;
-                    annotationId: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Annotation history retrieved successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetAnnotationHistoryResponse"];
-                    };
-                };
-                /** @description Annotation not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/entity-types": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Entity Types
-         * @description Get list of available entity types for references
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Entity types retrieved successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["GetEntityTypesResponse"];
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Add Entity Type
-         * @description Add a new entity type to the collection (append-only, requires moderator/admin)
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["AddEntityTypeRequest"];
-                };
-            };
-            responses: {
-                /** @description Entity type added successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AddEntityTypeResponse"];
-                    };
-                };
-                /** @description Forbidden - Moderator or Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/entity-types/bulk": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Bulk Add Entity Types
-         * @description Add multiple entity types to the collection (append-only, requires moderator/admin)
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["BulkAddEntityTypesRequest"];
-                };
-            };
-            responses: {
-                /** @description Entity types added successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AddEntityTypeResponse"];
-                    };
-                };
-                /** @description Forbidden - Moderator or Admin access required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/jobs/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Job Status
-         * @description Get the current status and progress of an async job
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Job status retrieved successfully */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["JobStatusResponse"];
-                    };
-                };
-                /** @description Job not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-}
-type webhooks = Record<string, never>;
-interface components {
-    schemas: {
-        AcceptTermsResponse: {
-            success: boolean;
-            message: string;
-        };
-        AddEntityTypeRequest: {
-            tag: string;
-        };
-        AddEntityTypeResponse: {
-            success: boolean;
-            entityTypes: string[];
-        };
-        AdminUpdateUserResponse: {
-            success: boolean;
-            user: {
-                id: string;
-                email: string;
-                name: string | null;
-                image: string | null;
-                domain: string;
-                provider: string;
-                isAdmin: boolean;
-                isActive: boolean;
-                lastLogin: string | null;
-                created: string;
-                updatedAt: string;
-            };
-        };
-        AdminUsersListResponse: {
-            success: boolean;
-            users: {
-                id: string;
-                email: string;
-                name: string | null;
-                image: string | null;
-                domain: string;
-                provider: string;
-                isAdmin: boolean;
-                isActive: boolean;
-                lastLogin: string | null;
-                created: string;
-                updatedAt: string;
-            }[];
-        };
-        AdminUserStatsResponse: {
-            success: boolean;
-            stats: {
-                totalUsers: number;
-                activeUsers: number;
-                adminUsers: number;
-                regularUsers: number;
-                domainBreakdown: {
-                    domain: string;
-                    count: number;
-                }[];
-                recentSignups: {
-                    id: string;
-                    email: string;
-                    name: string | null;
-                    created: string;
-                }[];
-            };
-        };
-        /** @description Minimal Person/Organization for attribution (W3C PROV compatible) */
-        Agent: {
-            /**
-             * Format: uri
-             * @description Unique identifier for the agent
-             */
-            "@id"?: string;
-            /** @description Type(s) of agent (Person, Organization, Software) */
-            "@type"?: string | string[];
-            name: string;
-            nickname?: string;
-            email?: string;
-            email_sha1?: string;
-            homepage?: string;
-        } & {
-            [key: string]: unknown;
-        };
-        Annotation: {
-            /**
-             * @description W3C Web Annotation JSON-LD context
-             * @default http://www.w3.org/ns/anno.jsonld
-             * @constant
-             */
-            "@context": "http://www.w3.org/ns/anno.jsonld";
-            /**
-             * @description W3C Annotation type
-             * @default Annotation
-             * @constant
-             */
-            type: "Annotation";
-            id: string;
-            motivation: components["schemas"]["Motivation"];
-            /** @description W3C Web Annotation target - can be a simple IRI string (entire resource) or an object with source and optional selector (fragment) */
-            target: string | components["schemas"]["AnnotationTarget"];
-            /** @description W3C Web Annotation body - can be empty array, single body, or array of bodies */
-            body: components["schemas"]["AnnotationBody"][] | components["schemas"]["AnnotationBody"] | components["schemas"]["AnnotationBody"][];
-            creator?: components["schemas"]["Agent"];
-            created?: string;
-            modified?: string;
-            generator?: components["schemas"]["Agent"];
-        };
-        /** @description Phase 2: Body can be TextualBody (for entity tags, descriptions) or SpecificResource (for links) */
-        AnnotationBody: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
-        AnnotationContextResponse: {
-            annotation: components["schemas"]["Annotation"];
-            context: {
-                before?: string;
-                selected: string;
-                after?: string;
-            };
-            resource: components["schemas"]["ResourceDescriptor"];
-        };
-        AnnotationLLMContextResponse: {
-            annotation: components["schemas"]["Annotation"];
-            sourceResource: components["schemas"]["ResourceDescriptor"];
-            targetResource?: components["schemas"]["ResourceDescriptor"] | null;
-            /** @description Generation context for this annotation */
-            context?: components["schemas"]["GenerationContext"];
-            /** @description DEPRECATED: Use 'context' instead. Legacy source context format. */
-            sourceContext?: {
-                before: string;
-                selected: string;
-                after: string;
-            };
-            targetContext?: {
-                content: string;
-                summary?: string;
-            };
-            suggestedResolution?: {
-                resourceId: string;
-                resourceName: string;
-                confidence: number;
-                reasoning: string;
-            };
-        };
-        /** @description W3C Web Annotation target object - source is required, selector is optional */
-        AnnotationTarget: {
-            /** @description IRI of the resource being annotated */
-            source: string;
-            /** @description Optional selector to identify a specific segment of the source resource */
-            selector?: components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | components["schemas"]["TextQuoteSelector"] | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
-        };
-        AsyncJobResponse: {
-            jobId: string;
-            /** @enum {string} */
-            status: "pending" | "running" | "complete" | "failed" | "cancelled";
-            /** @enum {string} */
-            type: "detection" | "generation";
-            created: string;
-        };
-        AuthResponse: {
-            success: boolean;
-            user: {
-                id: string;
-                email: string;
-                name: string | null;
-                image: string | null;
-                domain: string;
-                isAdmin: boolean;
-            };
-            token: string;
-            isNewUser: boolean;
-        };
-        BodyOperationAdd: {
-            /** @constant */
-            op: "add";
-            item: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
-        };
-        BodyOperationRemove: {
-            /** @constant */
-            op: "remove";
-            item: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
-        };
-        BodyOperationReplace: {
-            /** @constant */
-            op: "replace";
-            oldItem: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
-            newItem: components["schemas"]["TextualBody"] | components["schemas"]["SpecificResource"];
-        };
-        /**
-         * @description Annotation body type - TextualBody for textual content, SpecificResource for resource links
-         * @enum {string}
-         */
-        BodyType: "TextualBody" | "SpecificResource";
-        BulkAddEntityTypesRequest: {
-            tags: string[];
-        };
-        CloneResourceWithTokenResponse: {
-            /** @description Generated clone token */
-            token: string;
-            /** @description ISO 8601 timestamp when token expires */
-            expiresAt: string;
-            resource: components["schemas"]["ResourceDescriptor"];
-        };
-        /**
-         * @description Content format as MIME type, optionally with charset parameter (e.g., 'text/plain', 'text/plain; charset=iso-8859-1')
-         * @example text/plain
-         * @example text/plain; charset=utf-8
-         * @example text/plain; charset=iso-8859-1
-         * @example text/markdown
-         * @example text/markdown; charset=windows-1252
-         * @example image/png
-         * @example image/jpeg
-         * @example application/pdf
-         */
-        ContentFormat: string;
-        ContextualSummaryResponse: {
-            summary: string;
-            relevantFields: {
-                [key: string]: unknown;
-            };
-            context: {
-                before?: string;
-                selected: string;
-                after?: string;
-            };
-        };
-        CreateAnnotationRequest: {
-            motivation: components["schemas"]["Motivation"];
-            target: {
-                source: string;
-                selector: components["schemas"]["TextPositionSelector"] | {
-                    /** @enum {string} */
-                    type: "TextQuoteSelector";
-                    exact: string;
-                    prefix?: string;
-                    suffix?: string;
-                } | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"] | (components["schemas"]["TextPositionSelector"] | {
-                    /** @enum {string} */
-                    type: "TextQuoteSelector";
-                    exact: string;
-                    prefix?: string;
-                    suffix?: string;
-                } | components["schemas"]["SvgSelector"] | components["schemas"]["FragmentSelector"])[];
-            };
-            body: unknown[] | components["schemas"]["AnnotationBody"] | components["schemas"]["AnnotationBody"][];
-        };
-        CreateAnnotationResponse: {
-            annotation: components["schemas"]["Annotation"];
-        };
-        CreateFromAnnotationRequest: {
-            /** @description ID of the resource containing the annotation */
-            resourceId: string;
-            name: string;
-            content: string;
-            format: components["schemas"]["ContentFormat"];
-        };
-        CreateFromAnnotationResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            annotations: components["schemas"]["Annotation"][];
-        };
-        CreateJobResponse: {
-            jobId: string;
-            /** @enum {string} */
-            type: "detection" | "generation";
-            /** @enum {string} */
-            status: "pending" | "running" | "complete" | "failed" | "cancelled";
-            created: string;
-            resourceId?: string;
-        };
-        CreateResourceFromAnnotationResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            annotation: components["schemas"]["Annotation"];
-        };
-        CreateResourceFromSelectionRequest: {
-            /** @description ID of the resource containing the annotation */
-            resourceId: string;
-            content: string;
-            name: string;
-            format: components["schemas"]["ContentFormat"];
-            entityTypes?: string[];
-            metadata?: {
-                [key: string]: unknown;
-            };
-            prompt?: string;
-            language?: string;
-        };
-        CreateResourceFromSelectionResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            annotation: components["schemas"]["Annotation"];
-        };
-        CreateResourceFromTokenRequest: {
-            /** @description Clone token */
-            token: string;
-            /** @description Name for the new resource */
-            name: string;
-            /** @description Content for the new resource */
-            content: string;
-            /** @description Whether to archive the original resource */
-            archiveOriginal?: boolean;
-        };
-        CreateResourceFromTokenResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            annotations: components["schemas"]["Annotation"][];
-        };
-        CreateResourceRequest: {
-            name: string;
-            content: string;
-            format: components["schemas"]["ContentFormat"];
-            entityTypes: string[];
-            language?: string;
-            creationMethod?: string;
-            sourceAnnotationId?: string;
-            sourceResourceId?: string;
-        };
-        CreateResourceResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            annotations: components["schemas"]["Annotation"][];
-        };
-        DeleteAnnotationRequest: {
-            /**
-             * Format: uri
-             * @description Resource URI containing the annotation (required for O(1) Layer 3 lookup)
-             */
-            resourceId: string;
-        };
-        DeleteUserResponse: {
-            success: boolean;
-            message: string;
-        };
-        DetectReferencesStreamRequest: {
-            /** @description Entity types to detect (e.g., 'Person', 'Organization', 'Location') */
-            entityTypes: string[];
-            /** @description Include anaphoric/cataphoric references (e.g., 'the CEO', 'the tech giant') in addition to direct mentions */
-            includeDescriptiveReferences?: boolean;
-        };
-        DetectHighlightsStreamRequest: {
-            /** @description Optional instructions to guide AI highlight detection */
-            instructions?: string;
-            /** @description Optional density: desired number of highlights per 2000 words of text (1-15) */
-            density?: number;
-        };
-        DetectAssessmentsStreamRequest: {
-            /** @description Optional instructions to guide AI assessment detection */
-            instructions?: string;
-            /**
-             * @description Optional tone/style for generated assessments
-             * @enum {string}
-             */
-            tone?: "analytical" | "critical" | "balanced" | "constructive";
-            /** @description Optional density: desired number of assessments per 2000 words of text (1-10) */
-            density?: number;
-        };
-        DetectCommentsStreamRequest: {
-            /** @description Optional instructions to guide AI comment detection */
-            instructions?: string;
-            /**
-             * @description Optional tone/style for generated comments
-             * @enum {string}
-             */
-            tone?: "scholarly" | "explanatory" | "conversational" | "technical";
-            /** @description Optional density: desired number of comments per 2000 words of text (2-12) */
-            density?: number;
-        };
-        DetectTagsStreamRequest: {
-            /** @description Tag schema ID (e.g., 'legal-irac', 'scientific-imrad', 'argument-toulmin') */
-            schemaId: string;
-            /** @description Categories to detect from the selected schema (e.g., ['Issue', 'Rule', 'Application', 'Conclusion']) */
-            categories: string[];
-        };
-        ErrorResponse: {
-            error: string;
-            code?: string;
-            details?: unknown;
-        };
-        EventStreamResponse: {
-            event: string;
-            data: string;
-            id?: string;
-        };
-        GenerateResourceFromAnnotationRequest: {
-            /** @description Optional name for the generated resource */
-            name?: string;
-            /** @description Entity types for the generated resource */
-            entityTypes?: string[];
-            /** @description Optional AI prompt for generation */
-            prompt?: string;
-            /** @description Language code (e.g., 'en', 'es') */
-            language?: string;
-        };
-        GenerateResourceFromAnnotationResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            annotation: components["schemas"]["Annotation"];
-            generated: boolean;
-        };
-        GenerateResourceRequest: {
-            /** @description Resource ID containing the annotation */
-            resourceId: string;
-            /** @description Custom title for generated resource */
-            title?: string;
-            /** @description Custom prompt for content generation */
-            prompt?: string;
-            /** @description Language locale (e.g., "es", "fr", "ja") */
-            language?: string;
-        };
-        GenerateResourceStreamRequest: {
-            /** @description Custom title for generated resource */
-            title?: string;
-            /** @description Custom prompt for content generation */
-            prompt?: string;
-            /** @description Language locale for generated content (e.g., "es", "fr", "ja") */
-            language?: string;
-            /** @description Generation context including source document excerpts and metadata */
-            context: components["schemas"]["GenerationContext"];
-            /** @description Inference temperature (0.0 = focused, 1.0 = creative) */
-            temperature?: number;
-            /** @description Maximum tokens to generate */
-            maxTokens?: number;
-        };
-        GetAnnotationHistoryResponse: {
-            events: {
-                id: string;
-                type: string;
-                timestamp: string;
-                userId: string;
-                resourceId: string;
-                payload: {
-                    name: string;
-                    format: components["schemas"]["ContentFormat"];
-                    contentChecksum: string;
-                    /** @enum {string} */
-                    creationMethod: "api" | "upload" | "ui" | "reference" | "clone" | "generated";
-                    entityTypes?: string[];
-                    metadata?: {
-                        [key: string]: unknown;
-                    };
-                } | {
-                    name: string;
-                    format: components["schemas"]["ContentFormat"];
-                    contentChecksum: string;
-                    parentResourceId: string;
-                    /** @enum {string} */
-                    creationMethod: "api" | "upload" | "ui" | "reference" | "clone" | "generated";
-                    entityTypes?: string[];
-                    metadata?: {
-                        [key: string]: unknown;
-                    };
-                } | {
-                    reason?: string;
-                } | Record<string, never> | {
-                    /** @description W3C Annotation (creator/created fields are optional in events - they're derived from event userId/timestamp) */
-                    annotation: components["schemas"]["Annotation"];
-                } | {
-                    /** @description Unified annotation ID */
-                    annotationId: string;
-                } | {
-                    /** @description Unified annotation ID */
-                    annotationId: string;
-                    /** @description For linking motivation */
-                    targetResourceId: string;
-                } | {
-                    entityType: string;
-                } | {
-                    entityType: string;
-                };
-                metadata: {
-                    sequenceNumber: number;
-                    prevEventHash?: string;
-                    checksum?: string;
-                };
-            }[];
-            total: number;
-            annotationId: string;
-            resourceId: string;
-        };
-        GetAnnotationResponse: {
-            annotation: components["schemas"]["Annotation"];
-            resource: components["schemas"]["ResourceDescriptor"] | null;
-            resolvedResource: components["schemas"]["ResourceDescriptor"] | null;
-        };
-        GetAnnotationsResponse: {
-            annotations: components["schemas"]["Annotation"][];
-            /** @description Total number of annotations */
-            total: number;
-            /** @description Motivation filter applied (if any) */
-            motivation?: components["schemas"]["Motivation"] | null;
-        };
-        GetEntityTypesResponse: {
-            entityTypes: string[];
-        };
-        GetEventsResponse: {
-            events: {
-                event: {
-                    id: string;
-                    type: string;
-                    timestamp: string;
-                    userId: string;
-                    resourceId: string;
-                    payload?: unknown;
-                };
-                metadata: {
-                    sequenceNumber: number;
-                    prevEventHash?: string;
-                    checksum?: string;
-                };
-            }[];
-            total: number;
-            resourceId: string;
-        };
-        GetReferencedByResponse: {
-            referencedBy: {
-                /** @description Reference annotation ID */
-                id: string;
-                /** @description Name of resource containing the reference */
-                resourceName: string;
-                target: {
-                    /** @description ID of resource containing the reference */
-                    source: string;
-                    selector: {
-                        /** @description The selected text that references this resource */
-                        exact: string;
-                    };
-                };
-            }[];
-        };
-        GetResourceByTokenResponse: {
-            sourceResource: components["schemas"]["ResourceDescriptor"];
-            /** @description ISO 8601 timestamp when token expires */
-            expiresAt: string;
-        };
-        GetResourceResponse: {
-            resource: components["schemas"]["ResourceDescriptor"];
-            /** @description All annotations for the resource (highlights, references, assessments, etc.) */
-            annotations: components["schemas"]["Annotation"][];
-            /** @description Annotations that reference this resource from other resources */
-            entityReferences: components["schemas"]["Annotation"][];
-        };
-        GoogleAuthRequest: {
-            access_token: string;
-        };
-        HealthResponse: {
-            status: string;
-            message: string;
-            version: string;
-            timestamp: string;
-            /** @enum {string} */
-            database: "connected" | "disconnected" | "unknown";
-            environment: string;
-        };
-        JobStatusResponse: {
-            jobId: string;
-            /** @enum {string} */
-            type: "detection" | "generation" | "highlight-detection" | "assessment-detection" | "comment-detection" | "tag-detection";
-            /** @enum {string} */
-            status: "pending" | "running" | "complete" | "failed" | "cancelled";
-            userId: string;
-            created: string;
-            startedAt?: string;
-            completedAt?: string;
-            error?: string;
-            progress?: unknown;
-            result?: unknown;
-        };
-        ListAnnotationsResponse: {
-            annotations: components["schemas"]["Annotation"][];
-            total: number;
-            offset: number;
-            limit: number;
-        };
-        ListResourcesResponse: {
-            resources: components["schemas"]["ResourceDescriptor"][];
-            total: number;
-            offset: number;
-            limit: number;
-        };
-        PasswordAuthRequest: {
-            /**
-             * Format: email
-             * @description User email address
-             */
-            email: string;
-            /** @description User password (minimum 8 characters) */
-            password: string;
-        };
-        MCPGenerateResponse: {
-            refresh_token: string;
-        };
-        /**
-         * @description W3C Web Annotation motivation vocabulary - https://www.w3.org/TR/annotation-vocab/#motivation
-         * @enum {string}
-         */
-        Motivation: "assessing" | "bookmarking" | "classifying" | "commenting" | "describing" | "editing" | "highlighting" | "identifying" | "linking" | "moderating" | "questioning" | "replying" | "tagging";
-        OAuthConfigResponse: {
-            providers: {
-                name: string;
-                isConfigured: boolean;
-                clientId: string;
-            }[];
-            allowedDomains: string[];
-        };
-        /** @description A specific, byte-addressable rendition of a resource (file/asset/variant). */
-        Representation: {
-            /**
-             * Format: uri
-             * @description Stable ID for this representation.
-             */
-            "@id"?: string;
-            /** @description Type(s), e.g., schema:MediaObject. */
-            "@type"?: string | string[];
-            /** @description MIME/media type (e.g., text/markdown, image/png). */
-            mediaType: string;
-            /** @description Where the bytes live (s3://, file://, https://, ipfs://, etc.). */
-            storageUri?: string;
-            filename?: string;
-            /** @description Size of the payload in bytes. */
-            byteSize?: number;
-            /** @description Integrity hash (e.g., sha256:abcd…). */
-            checksum?: string;
-            /** @description Compression/transfer encoding if applicable. */
-            encoding?: string;
-            /** @description IETF BCP 47 language tag (e.g., en, es-ES). */
-            language?: string;
-            /** @description Pixels (images/video). */
-            width?: number;
-            /** @description Pixels (images/video). */
-            height?: number;
-            /** @description Seconds (audio/video). */
-            duration?: number;
-            /** Format: date-time */
-            created?: string;
-            /** Format: date-time */
-            modified?: string;
-            /** @description Profile/shape the bytes conform to (e.g., a JSON profile or SVG profile). */
-            conformsTo?: string | string[];
-            tags?: string[];
-            /**
-             * @description Semantics of this rendition relative to the resource (e.g., original, thumbnail, preview, derived).
-             * @enum {string}
-             */
-            rel?: "original" | "thumbnail" | "preview" | "optimized" | "derived" | "other";
-        } & {
-            [key: string]: unknown;
-        };
-        ResolveAnnotationRequest: {
-            /** @description Target resource ID to resolve reference to */
-            resourceId: string;
-        };
-        ResolveAnnotationResponse: {
-            annotation: components["schemas"]["Annotation"];
-            targetResource?: components["schemas"]["ResourceDescriptor"] | null;
-        };
-        /** @description Metadata about a resource (1:1 with its URI). JSON-LD subject is @id. Link to concrete bytes via representations. */
-        ResourceDescriptor: {
-            /** @description JSON-LD context; URI, object, or array of these. */
-            "@context": string | {
-                [key: string]: unknown;
-            } | (string | {
-                [key: string]: unknown;
-            })[];
-            /**
-             * Format: uri
-             * @description Canonical URI/URN of the resource being described.
-             */
-            "@id": string;
-            /** @description Type(s) of the resource (IRIs/CURIEs via @context). */
-            "@type"?: string | string[];
-            name: string;
-            description?: string;
-            /** @description Persistent identifiers (e.g., DOI, URN). */
-            identifier?: string | string[] | ({
-                /** Format: uri */
-                "@id"?: string;
-                value?: string;
-                scheme?: string;
-            } & {
-                [key: string]: unknown;
-            });
-            /** @description Topics (IRIs or strings). */
-            about?: string | string[];
-            /** @description Equivalent/authoritative references. */
-            sameAs?: string[];
-            isPartOf?: string[];
-            hasPart?: string[];
-            /** Format: uri */
-            license?: string;
-            version?: string;
-            /** Format: date-time */
-            dateCreated?: string;
-            /** Format: date-time */
-            dateModified?: string;
-            /** @description W3C PROV - source resources this was derived from */
-            wasDerivedFrom?: string | string[];
-            /** @description W3C PROV - agents responsible for this resource */
-            wasAttributedTo?: components["schemas"]["Agent"] | components["schemas"]["Agent"][];
-            /** @description Profile/shape URI this resource description conforms to. */
-            conformsTo?: string | string[];
-            /** @description Convenience set summarizing media types across representations. */
-            availableFormats?: string[];
-            /** @description Managed or referenced byte-level renditions of this resource. */
-            representations: components["schemas"]["Representation"] | components["schemas"]["Representation"][];
-            /** @description Application-specific: Whether this resource is archived */
-            archived?: boolean;
-            /** @description Application-specific: Entity types for this resource */
-            entityTypes?: string[];
-            /** @description Application-specific: Whether this resource is a draft */
-            isDraft?: boolean;
-            /**
-             * @description Application-specific: How this resource was created
-             * @enum {string}
-             */
-            creationMethod?: "api" | "upload" | "ui" | "reference" | "clone" | "generated";
-            /** @description Application-specific: ID of annotation that triggered generation */
-            sourceAnnotationId?: string;
-            /** @description Application-specific: ID of source resource for clones/derivatives */
-            sourceResourceId?: string;
-        } & {
-            [key: string]: unknown;
-        };
-        ResourceLLMContextResponse: {
-            mainResource: components["schemas"]["ResourceDescriptor"];
-            relatedResources: components["schemas"]["ResourceDescriptor"][];
-            annotations: components["schemas"]["Annotation"][];
-            graph: {
-                nodes: {
-                    id: string;
-                    type: string;
-                    label: string;
-                    metadata: {
-                        [key: string]: unknown;
-                    };
-                }[];
-                edges: {
-                    source: string;
-                    target: string;
-                    type: string;
-                    metadata: {
-                        [key: string]: unknown;
-                    };
-                }[];
-            };
-            summary?: string;
-            suggestedReferences?: string[];
-            /** @description The content of the main resource (included if includeContent=true) */
-            mainResourceContent?: string;
-            /** @description Map of resource IDs to their content (included if includeContent=true) */
-            relatedResourcesContent?: {
-                [key: string]: string;
-            };
-        };
-        SpecificResource: {
-            /** @constant */
-            type: "SpecificResource";
-            /** @description IRI of the target resource */
-            source: string;
-            /** @description Why this body is included */
-            purpose?: components["schemas"]["Motivation"];
-        };
-        StatusResponse: {
-            status: string;
-            version: string;
-            features: {
-                semanticContent: string;
-                collaboration: string;
-                rbac: string;
-            };
-            message: string;
-            authenticatedAs?: string;
-        };
-        TextPositionSelector: {
-            /** @enum {string} */
-            type: "TextPositionSelector";
-            /** @description Character offset from resource start */
-            start: number;
-            /** @description Character offset from resource start */
-            end: number;
-        };
-        TextQuoteSelector: {
-            /** @enum {string} */
-            type: "TextQuoteSelector";
-            exact: string;
-            prefix?: string;
-            suffix?: string;
-        };
-        TextualBody: {
-            /** @constant */
-            type: "TextualBody";
-            /** @description The text content (e.g., entity type name) */
-            value: string;
-            /** @description Why this body is included */
-            purpose?: components["schemas"]["Motivation"];
-            /** @description MIME type (defaults to text/plain) */
-            format?: string;
-            /** @description BCP 47 language tag */
-            language?: string;
-        };
-        TokenRefreshRequest: {
-            /**
-             * @description Refresh token obtained during login
-             * @example eyJhbGciOiJIUzI1NiIs...
-             */
-            refreshToken: string;
-        };
-        TokenRefreshResponse: {
-            access_token: string;
-        };
-        UpdateAnnotationBodyRequest: {
-            /** @description Resource ID containing the annotation (required for O(1) Layer 3 lookup) */
-            resourceId: string;
-            /** @description Array of body modification operations to apply */
-            operations: (components["schemas"]["BodyOperationAdd"] | components["schemas"]["BodyOperationRemove"] | components["schemas"]["BodyOperationReplace"])[];
-        };
-        UpdateAnnotationBodyResponse: {
-            annotation: components["schemas"]["Annotation"];
-        };
-        UpdateResourceRequest: {
-            entityTypes?: string[];
-            archived?: boolean;
-        };
-        UpdateUserRequest: {
-            isAdmin?: boolean;
-            isActive?: boolean;
-            name?: string;
-        };
-        UpdateUserResponse: {
-            success: boolean;
-            user: {
-                id: string;
-                email: string;
-                name?: string | null;
-                image?: string | null;
-                domain: string;
-                provider: string;
-                isAdmin: boolean;
-                isActive: boolean;
-                lastLogin?: string | null;
-                created: string;
-                updatedAt: string;
-            };
-        };
-        UserResponse: {
-            id: string;
-            email: string;
-            name: string | null;
-            image: string | null;
-            domain: string;
-            provider: string;
-            isAdmin: boolean;
-            isActive: boolean;
-            termsAcceptedAt: string | null;
-            lastLogin: string | null;
-            created: string;
-        };
-        SvgSelector: {
-            /** @enum {string} */
-            type: "SvgSelector";
-            /** @description SVG markup defining the region (must include xmlns attribute) */
-            value: string;
-        };
-        /** @description W3C Web Annotation FragmentSelector for media fragment identifiers (RFC 3778 for PDFs) */
-        FragmentSelector: {
-            /** @enum {string} */
-            type: "FragmentSelector";
-            /**
-             * @description Media fragment identifier (e.g., 'page=1&viewrect=100,200,50,30' for PDF)
-             * @example page=1&viewrect=100,200,50,30
-             * @example page=5&viewrect=250,400,100,75
-             */
-            value: string;
-            /**
-             * @description URI identifying the fragment syntax specification
-             * @example http://tools.ietf.org/rfc/rfc3778
-             */
-            conformsTo?: string;
-        };
-        /** @description Context information used for AI generation. Includes source document excerpts and metadata. */
-        GenerationContext: {
-            /** @description Text context from the source document */
-            sourceContext: {
-                /** @description Text appearing before the selected passage */
-                before?: string;
-                /** @description The selected text passage (the annotation target) */
-                selected: string;
-                /** @description Text appearing after the selected passage */
-                after?: string;
-            };
-            /** @description Additional context metadata (reserved for future use) */
-            metadata?: {
-                /** @description Type of source resource (e.g., 'document', 'image', 'video') */
-                resourceType?: string;
-                /** @description BCP 47 language tag of source content */
-                language?: string;
-                /** @description Entity types associated with the annotation */
-                entityTypes?: string[];
-            };
-        };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-type $defs = Record<string, never>;
-type operations = Record<string, never>;
-
-/**
- * Branded string types for compile-time type safety
- *
- * These types are zero-cost at runtime but prevent mixing
- * different string types at compile time.
- */
-
-type Motivation = components['schemas']['Motivation'];
-type ContentFormat = components['schemas']['ContentFormat'];
-type Email = string & {
-    readonly __brand: 'Email';
-};
-type AuthCode = string & {
-    readonly __brand: 'AuthCode';
-};
-type GoogleCredential = string & {
-    readonly __brand: 'GoogleCredential';
-};
-type AccessToken = string & {
-    readonly __brand: 'AccessToken';
-};
-type RefreshToken = string & {
-    readonly __brand: 'RefreshToken';
-};
-type MCPToken = string & {
-    readonly __brand: 'MCPToken';
-};
-type CloneToken = string & {
-    readonly __brand: 'CloneToken';
-};
-type JobId = string & {
-    readonly __brand: 'JobId';
-};
-type UserDID = string & {
-    readonly __brand: 'UserDID';
-};
-type EntityType = string & {
-    readonly __brand: 'EntityType';
-};
-type SearchQuery = string & {
-    readonly __brand: 'SearchQuery';
-};
-type BaseUrl = string & {
-    readonly __brand: 'BaseUrl';
-};
-declare function email(value: string): Email;
-declare function authCode(value: string): AuthCode;
-declare function googleCredential(value: string): GoogleCredential;
-declare function accessToken(value: string): AccessToken;
-declare function refreshToken(value: string): RefreshToken;
-declare function mcpToken(value: string): MCPToken;
-declare function cloneToken(value: string): CloneToken;
-declare function jobId(value: string): JobId;
-declare function userDID(value: string): UserDID;
-declare function entityType(value: string): EntityType;
-declare function searchQuery(value: string): SearchQuery;
-declare function baseUrl(value: string): BaseUrl;
-type ResourceUri = string & {
-    readonly __brand: 'ResourceUri';
-};
-type AnnotationUri = string & {
-    readonly __brand: 'AnnotationUri';
-};
-type ResourceAnnotationUri = string & {
-    readonly __brand: 'ResourceAnnotationUri';
-};
-declare function resourceUri(uri: string): ResourceUri;
-declare function annotationUri(uri: string): AnnotationUri;
-declare function resourceAnnotationUri(uri: string): ResourceAnnotationUri;
-
-/**
- * Annotation and Selector Utilities
- *
- * Pure TypeScript utilities for working with W3C Web Annotations.
- * No React dependencies - safe to use in any JavaScript environment.
- *
- * Body is either empty array (stub) or single SpecificResource (resolved)
- * Body can be array of TextualBody (tagging) + SpecificResource (linking)
- * Target can be simple string IRI or object with source and optional selector
- */
-
-type Annotation = components['schemas']['Annotation'];
-type HighlightAnnotation = Annotation;
-type ReferenceAnnotation = Annotation;
-type TextPositionSelector = components['schemas']['TextPositionSelector'];
-type TextQuoteSelector = components['schemas']['TextQuoteSelector'];
-type SvgSelector = components['schemas']['SvgSelector'];
-type FragmentSelector = components['schemas']['FragmentSelector'];
-type Selector = TextPositionSelector | TextQuoteSelector | SvgSelector | FragmentSelector;
-
-/**
- * Get the source from an annotation body (null if stub)
- * Search for SpecificResource in body array
- */
-declare function getBodySource(body: Annotation['body']): ResourceUri | null;
-/**
- * Get the type from an annotation body (returns first body type in array)
- */
-declare function getBodyType(body: Annotation['body']): 'TextualBody' | 'SpecificResource' | null;
-/**
- * Check if body is resolved (has a source)
- * Check for SpecificResource in body array
- */
-declare function isBodyResolved(body: Annotation['body']): boolean;
-/**
- * Get the source IRI from target (handles both string and object forms)
- */
-declare function getTargetSource(target: Annotation['target']): ResourceUri;
-/**
- * Get the selector from target (undefined if string or no selector)
- */
-declare function getTargetSelector(target: Annotation['target']): {
-    type: "TextPositionSelector";
-    start: number;
-    end: number;
-} | {
-    type: "TextQuoteSelector";
-    exact: string;
-    prefix?: string;
-    suffix?: string;
-} | {
-    type: "SvgSelector";
-    value: string;
-} | {
-    type: "FragmentSelector";
-    value: string;
-    conformsTo?: string;
-} | ({
-    type: "TextPositionSelector";
-    start: number;
-    end: number;
-} | {
-    type: "TextQuoteSelector";
-    exact: string;
-    prefix?: string;
-    suffix?: string;
-} | {
-    type: "SvgSelector";
-    value: string;
-} | {
-    type: "FragmentSelector";
-    value: string;
-    conformsTo?: string;
-})[] | undefined;
-/**
- * Check if target has a selector
- */
-declare function hasTargetSelector(target: Annotation['target']): boolean;
-/**
- * Type guard to check if an annotation is a highlight
- */
-declare function isHighlight(annotation: Annotation): annotation is HighlightAnnotation;
-/**
- * Type guard to check if an annotation is a reference (linking)
- */
-declare function isReference(annotation: Annotation): annotation is ReferenceAnnotation;
-/**
- * Type guard to check if an annotation is an assessment
- */
-declare function isAssessment(annotation: Annotation): annotation is Annotation;
-/**
- * Type guard to check if an annotation is a comment
- */
-declare function isComment(annotation: Annotation): annotation is Annotation;
-/**
- * Type guard to check if an annotation is a tag
- */
-declare function isTag(annotation: Annotation): annotation is Annotation;
-/**
- * Extract comment text from a comment annotation's body
- * @param annotation - The annotation to extract comment text from
- * @returns The comment text, or undefined if not a comment or no text found
- */
-declare function getCommentText(annotation: Annotation): string | undefined;
-/**
- * Type guard to check if a reference annotation is a stub (unresolved)
- * Stub if no SpecificResource in body array
- */
-declare function isStubReference(annotation: Annotation): boolean;
-/**
- * Type guard to check if a reference annotation is resolved
- * Resolved if SpecificResource exists in body array
- */
-declare function isResolvedReference(annotation: Annotation): annotation is ReferenceAnnotation;
-/**
- * Get the exact text from a selector (single or array)
- *
- * When selector is an array, tries to find a TextQuoteSelector (which has exact text).
- * TextPositionSelector does not have exact text, only character offsets.
- * Handles undefined selector (when target is a string IRI with no selector)
- */
-declare function getExactText(selector: Selector | Selector[] | undefined): string;
-/**
- * Get the exact text from an annotation's target selector
- * Uses getTargetSelector helper to safely get selector
- */
-declare function getAnnotationExactText(annotation: Annotation): string;
-/**
- * Get the primary selector from a selector (single or array)
- *
- * When selector is an array, returns the first selector.
- * When selector is a single object, returns it as-is.
- */
-declare function getPrimarySelector(selector: Selector | Selector[]): Selector;
-/**
- * Get TextPositionSelector from a selector (single or array)
- *
- * Returns the first TextPositionSelector found, or null if none exists.
- * Handles undefined selector (when target is a string IRI with no selector)
- */
-declare function getTextPositionSelector(selector: Selector | Selector[] | undefined): TextPositionSelector | null;
-/**
- * Get TextQuoteSelector from a selector (single or array)
- *
- * Returns the first TextQuoteSelector found, or null if none exists.
- */
-declare function getTextQuoteSelector(selector: Selector | Selector[]): TextQuoteSelector | null;
-/**
- * Get SvgSelector from a selector (single or array)
- *
- * Returns the first SvgSelector found, or null if none exists.
- */
-declare function getSvgSelector(selector: Selector | Selector[] | undefined): SvgSelector | null;
-/**
- * Get FragmentSelector from a selector (single or array)
- *
- * Returns the first FragmentSelector found, or null if none exists.
- */
-declare function getFragmentSelector(selector: Selector | Selector[] | undefined): FragmentSelector | null;
-/**
- * Validate SVG markup for W3C compliance
- *
- * Checks that:
- * - SVG contains xmlns attribute
- * - SVG is well-formed XML
- * - SVG contains at least one shape element
- *
- * @returns null if valid, error message if invalid
- */
-declare function validateSvgMarkup(svg: string): string | null;
-/**
- * Extract bounding box from SVG markup
- *
- * Attempts to extract x, y, width, height from the SVG viewBox or root element.
- * Returns null if bounding box cannot be determined.
- */
-declare function extractBoundingBox(svg: string): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-} | null;
-
-/**
- * Fuzzy Anchoring for W3C Web Annotation TextQuoteSelector
- *
- * Uses prefix/suffix context to disambiguate when the same text appears multiple times.
- * Implements fuzzy matching as specified in the W3C Web Annotation Data Model.
- *
- * @see https://www.w3.org/TR/annotation-model/#text-quote-selector
- */
-interface TextPosition {
-    start: number;
-    end: number;
-}
-type MatchQuality = 'exact' | 'normalized' | 'case-insensitive' | 'fuzzy';
-/**
- * Normalize text for comparison - handles common document editing changes
- *
- * Collapses whitespace, converts curly quotes to straight quotes,
- * and normalizes common punctuation variations.
- */
-declare function normalizeText(text: string): string;
-/**
- * Find best match for text in content using multi-strategy search
- *
- * Shared core logic used by both findTextWithContext and validateAndCorrectOffsets.
- *
- * @param content - Full text content to search within
- * @param searchText - The text to find
- * @param positionHint - Optional hint for where to search (TextPositionSelector.start)
- * @returns Match with position and quality, or null if not found
- */
-declare function findBestTextMatch(content: string, searchText: string, positionHint?: number): {
-    start: number;
-    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, suffix?: string, positionHint?: number): 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;
-
-/**
- * Locale information
- * Copied from SDK for frontend use
- */
-interface LocaleInfo {
-    code: string;
-    nativeName: string;
-    englishName: string;
-}
-declare const LOCALES: readonly LocaleInfo[];
-/**
- * Get locale information by code
- */
-declare function getLocaleInfo(code: string | undefined): LocaleInfo | undefined;
-/**
- * Get the native name of a language by its locale code
- */
-declare function getLocaleNativeName(code: string | undefined): string | undefined;
-/**
- * Get the English name of a language by its locale code
- */
-declare function getLocaleEnglishName(code: string | undefined): string | undefined;
-/**
- * Format locale code for display as "Native Name (code)"
- */
-declare function formatLocaleDisplay(code: string | undefined): string | undefined;
-/**
- * Get all supported locale codes
- */
-declare function getAllLocaleCodes(): readonly string[];
-
-/**
- * Helper functions for working with W3C ResourceDescriptor
- */
-
-type ResourceDescriptor = components['schemas']['ResourceDescriptor'];
-type Representation = components['schemas']['Representation'];
-/**
- * Get the resource ID from @id property
- *
- * For internal resources: extracts UUID from "http://localhost:4000/resources/{uuid}"
- * For external resources: returns undefined
- *
- * This is used for routing - the frontend URL should contain only the resource ID,
- * not the full HTTP URI.
- */
-declare function getResourceId(resource: ResourceDescriptor | undefined): string | undefined;
-/**
- * Get the primary representation (first or only representation)
- */
-declare function getPrimaryRepresentation(resource: ResourceDescriptor | undefined): Representation | undefined;
-/**
- * Get the media type from the primary representation
- */
-declare function getPrimaryMediaType(resource: ResourceDescriptor | undefined): string | undefined;
-/**
- * Get the checksum from the primary representation
- */
-declare function getChecksum(resource: ResourceDescriptor | undefined): string | undefined;
-/**
- * Get the language from the primary representation
- */
-declare function getLanguage(resource: ResourceDescriptor | undefined): string | undefined;
-/**
- * Get storage URI from primary representation
- *
- * @param resource - ResourceDescriptor
- * @returns Storage URI or undefined
- */
-declare function getStorageUri(resource: ResourceDescriptor | undefined): string | undefined;
-/**
- * Get creator agent from wasAttributedTo
- * Handles both single agent and array of agents
- *
- * @param resource - ResourceDescriptor
- * @returns First agent or undefined
- */
-declare function getCreator(resource: ResourceDescriptor | undefined): components['schemas']['Agent'] | undefined;
-/**
- * Get derived-from URI
- * Handles both single URI and array of URIs
- *
- * @param resource - ResourceDescriptor
- * @returns First derivation URI or undefined
- */
-declare function getDerivedFrom(resource: ResourceDescriptor | undefined): string | undefined;
-/**
- * Check if resource is archived (application-specific field)
- *
- * @param resource - ResourceDescriptor
- * @returns True if archived, false otherwise
- */
-declare function isArchived(resource: ResourceDescriptor | undefined): boolean;
-/**
- * Get entity types from resource (application-specific field)
- *
- * @param resource - ResourceDescriptor
- * @returns Array of entity types, empty if not set
- */
-declare function getResourceEntityTypes(resource: ResourceDescriptor | undefined): string[];
-/**
- * Check if resource is a draft (application-specific field)
- *
- * @param resource - ResourceDescriptor
- * @returns True if draft, false otherwise
- */
-declare function isDraft(resource: ResourceDescriptor | undefined): boolean;
-/**
- * Map charset names to Node.js Buffer encoding names
- * Node.js Buffer.toString() supports: 'utf8', 'utf16le', 'latin1', 'base64', 'hex', 'ascii', 'binary', 'ucs2'
- *
- * @param charset - Charset name (e.g., "UTF-8", "ISO-8859-1", "Windows-1252")
- * @returns Node.js BufferEncoding
- */
-declare function getNodeEncoding(charset: string): BufferEncoding;
-/**
- * Decode a representation buffer to string using the correct charset
- * Extracts charset from media type and uses appropriate encoding
- *
- * @param buffer - The raw representation data
- * @param mediaType - Media type with optional charset (e.g., "text/plain; charset=iso-8859-1")
- * @returns Decoded string
- *
- * @example
- * ```typescript
- * const content = decodeRepresentation(buffer, "text/plain; charset=utf-8");
- * const legacy = decodeRepresentation(buffer, "text/plain; charset=windows-1252");
- * ```
- */
-declare function decodeRepresentation(buffer: Buffer, mediaType: string): string;
-
-/**
- * SVG Utility Functions
- *
- * Utilities for creating, parsing, and manipulating W3C-compliant SVG selectors
- * for image annotation.
- */
-interface Point {
-    x: number;
-    y: number;
-}
-interface BoundingBox {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/**
- * Create W3C-compliant SVG rectangle selector
- */
-declare function createRectangleSvg(start: Point, end: Point): string;
-/**
- * Create W3C-compliant SVG polygon selector
- */
-declare function createPolygonSvg(points: Point[]): string;
-/**
- * Create W3C-compliant SVG circle selector
- */
-declare function createCircleSvg(center: Point, radius: number): string;
-/**
- * Parse SVG selector to extract shape type and data
- */
-declare function parseSvgSelector(svg: string): {
-    type: 'rect' | 'polygon' | 'circle' | 'path';
-    data: any;
-} | null;
-/**
- * Normalize coordinates from display space to image native resolution
- */
-declare function normalizeCoordinates(point: Point, displayWidth: number, displayHeight: number, imageWidth: number, imageHeight: number): Point;
-/**
- * Scale entire SVG selector from display space to image native resolution
- */
-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.
- *
- * 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
- */
-
-/**
- * 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..." }
- * ```
- */
-declare function extractContext(content: string, start: number, end: number): {
-    prefix?: string;
-    suffix?: string;
-};
-/**
- * Result of validating and correcting AI-provided annotation offsets
- */
-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', ... }
- * ```
- */
-declare function validateAndCorrectOffsets(content: string, aiStart: number, aiEnd: number, exact: string): ValidatedAnnotation;
-
-/**
- * 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"
- */
-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");
- */
-declare function decodeWithCharset(buffer: ArrayBuffer, mediaType: string): string;
-
-/**
- * Generic validation utilities for @semiont/api-client
- *
- * Pure TypeScript validation with no external dependencies.
- * Safe to use in any JavaScript environment (Node.js, browser, Deno, etc.)
- */
-/**
- * Validation result types
- */
-type ValidationSuccess<T> = {
-    success: true;
-    data: T;
-};
-type ValidationFailure = {
-    success: false;
-    error: string;
-    details?: string[];
-};
-type ValidationResult<T> = ValidationSuccess<T> | ValidationFailure;
-/**
- * JWT Token validation
- *
- * Validates JWT token format (header.payload.signature).
- * Does not verify signature - use for format validation only.
- */
-declare const JWTTokenSchema: {
-    parse(token: unknown): string;
-    safeParse(token: unknown): ValidationResult<string>;
-};
-/**
- * Generic validation helper with error formatting
- *
- * Wraps any schema's parse method with try/catch and returns ValidationResult.
- *
- * @example
- * ```typescript
- * const result = validateData(JWTTokenSchema, 'eyJ...');
- * if (result.success) {
- *   console.log('Valid token:', result.data);
- * } else {
- *   console.error('Invalid:', result.error);
- * }
- * ```
- */
-declare function validateData<T>(schema: {
-    parse(data: unknown): T;
-}, data: unknown): ValidationResult<T>;
-/**
- * Email validation helper
- *
- * Validates email format using RFC 5322 simplified regex.
- *
- * @param email - Email address to validate
- * @returns true if valid email format
- */
-declare function isValidEmail(email: string): boolean;
-
-export { type $defs as $, type AccessToken as A, type BaseUrl as B, type ContentFormat as C, getExactText as D, type EntityType as E, type FragmentSelector as F, type GoogleCredential as G, getAnnotationExactText as H, getPrimarySelector as I, type JobId as J, getTextPositionSelector as K, getTextQuoteSelector as L, type Motivation as M, getSvgSelector as N, getFragmentSelector as O, validateSvgMarkup as P, extractBoundingBox as Q, type ResourceUri as R, type SearchQuery as S, type TextPositionSelector as T, type UserDID as U, type TextPosition as V, type MatchQuality as W, normalizeText as X, findBestTextMatch as Y, findTextWithContext as Z, verifyPosition as _, type AnnotationUri as a, type LocaleInfo as a0, LOCALES as a1, getLocaleInfo as a2, getLocaleNativeName as a3, getLocaleEnglishName as a4, formatLocaleDisplay as a5, getAllLocaleCodes as a6, getResourceId as a7, getPrimaryRepresentation as a8, getPrimaryMediaType as a9, JWTTokenSchema as aA, validateData as aB, isValidEmail as aC, type AuthCode as aD, type MCPToken as aE, email as aF, authCode as aG, googleCredential as aH, accessToken as aI, refreshToken as aJ, mcpToken as aK, cloneToken as aL, jobId as aM, userDID as aN, entityType as aO, searchQuery as aP, baseUrl as aQ, resourceUri as aR, annotationUri as aS, resourceAnnotationUri as aT, getChecksum as aa, getLanguage as ab, getStorageUri as ac, getCreator as ad, getDerivedFrom as ae, isArchived as af, getResourceEntityTypes as ag, isDraft as ah, getNodeEncoding as ai, decodeRepresentation as aj, type Point as ak, type BoundingBox as al, createRectangleSvg as am, createPolygonSvg as an, createCircleSvg as ao, parseSvgSelector as ap, normalizeCoordinates as aq, scaleSvgToNative as ar, extractContext as as, type ValidatedAnnotation as at, validateAndCorrectOffsets as au, extractCharset as av, decodeWithCharset as aw, type ValidationSuccess as ax, type ValidationFailure as ay, type ValidationResult as az, type Email as b, type components as c, type RefreshToken as d, type CloneToken as e, type ResourceAnnotationUri as f, type TextQuoteSelector as g, type SvgSelector as h, type Selector as i, getBodySource as j, getBodyType as k, isBodyResolved as l, getTargetSource as m, getTargetSelector as n, type operations as o, type paths as p, hasTargetSelector as q, isHighlight as r, isReference as s, isAssessment as t, isComment as u, isTag as v, type webhooks as w, getCommentText as x, isStubReference as y, isResolvedReference as z };