ocr-provenance-mcp 1.0.0

package/dist/server/transports/http-transport.js.map

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

package/dist/server/transports/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Transport Layer Index
+ * Re-exports transport implementations
+ *
+ * @module server/transports
+ */
+export { HttpTransport, type HttpTransportConfig } from './http-transport.js';
+export { SessionManager, sessionManager, type SessionState } from './session-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/transports/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/server/transports/index.js

@@ -0,0 +1,9 @@
+/**
+ * Transport Layer Index
+ * Re-exports transport implementations
+ *
+ * @module server/transports
+ */
+export { HttpTransport } from './http-transport.js';
+export { SessionManager, sessionManager } from './session-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/server/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/transports/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC"}

package/dist/server/transports/session-manager.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Session Manager - Scoped state per MCP session
+ *
+ * Each session tracks its own currentDatabase, userId, and active operations.
+ * Stdio transport uses a default "local" session.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module server/transports/session-manager
+ */
+export interface SessionState {
+    sessionId: string;
+    currentDatabase: string | null;
+    userId: string | null;
+    activeOperations: number;
+    createdAt: number;
+    lastActivity: number;
+    metadata: Record<string, unknown>;
+}
+export declare class SessionManager {
+    private sessions;
+    private static readonly LOCAL_SESSION_ID;
+    /** Get or create session state */
+    getSession(sessionId: string): SessionState;
+    /** Get the local (stdio) session */
+    getLocalSession(): SessionState;
+    /** Remove a session */
+    removeSession(sessionId: string): void;
+    /** Set user for a session */
+    setSessionUser(sessionId: string, userId: string): void;
+    /** Get all active sessions */
+    listSessions(): SessionState[];
+    /** Get session count */
+    getSessionCount(): number;
+    /** Clean up expired sessions */
+    cleanupExpired(ttlMs: number): number;
+}
+/** Singleton session manager */
+export declare const sessionManager: SessionManager;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/server/transports/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/server/transports/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAW;IAEnD,kCAAkC;IAClC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAkB3C,oCAAoC;IACpC,eAAe,IAAI,YAAY;IAI/B,uBAAuB;IACvB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,6BAA6B;IAC7B,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKvD,8BAA8B;IAC9B,YAAY,IAAI,YAAY,EAAE;IAI9B,wBAAwB;IACxB,eAAe,IAAI,MAAM;IAIzB,gCAAgC;IAChC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAWtC;AAMD,gCAAgC;AAChC,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/server/transports/session-manager.js

@@ -0,0 +1,74 @@
+/**
+ * Session Manager - Scoped state per MCP session
+ *
+ * Each session tracks its own currentDatabase, userId, and active operations.
+ * Stdio transport uses a default "local" session.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module server/transports/session-manager
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// SESSION MANAGER
+// ═══════════════════════════════════════════════════════════════════════════════
+export class SessionManager {
+    sessions = new Map();
+    static LOCAL_SESSION_ID = 'local';
+    /** Get or create session state */
+    getSession(sessionId) {
+        let session = this.sessions.get(sessionId);
+        if (!session) {
+            session = {
+                sessionId,
+                currentDatabase: null,
+                userId: null,
+                activeOperations: 0,
+                createdAt: Date.now(),
+                lastActivity: Date.now(),
+                metadata: {},
+            };
+            this.sessions.set(sessionId, session);
+        }
+        session.lastActivity = Date.now();
+        return session;
+    }
+    /** Get the local (stdio) session */
+    getLocalSession() {
+        return this.getSession(SessionManager.LOCAL_SESSION_ID);
+    }
+    /** Remove a session */
+    removeSession(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    /** Set user for a session */
+    setSessionUser(sessionId, userId) {
+        const session = this.getSession(sessionId);
+        session.userId = userId;
+    }
+    /** Get all active sessions */
+    listSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /** Get session count */
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    /** Clean up expired sessions */
+    cleanupExpired(ttlMs) {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [id, session] of this.sessions) {
+            if (id !== SessionManager.LOCAL_SESSION_ID && now - session.lastActivity > ttlMs) {
+                this.sessions.delete(id);
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// SINGLETON INSTANCE
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Singleton session manager */
+export const sessionManager = new SessionManager();
+//# sourceMappingURL=session-manager.js.map

package/dist/server/transports/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/server/transports/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,kFAAkF;AAClF,kBAAkB;AAClB,kFAAkF;AAElF,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC3C,MAAM,CAAU,gBAAgB,GAAG,OAAO,CAAC;IAEnD,kCAAkC;IAClC,UAAU,CAAC,SAAiB;QAC1B,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG;gBACR,SAAS;gBACT,eAAe,EAAE,IAAI;gBACrB,MAAM,EAAE,IAAI;gBACZ,gBAAgB,EAAE,CAAC;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;gBACxB,QAAQ,EAAE,EAAE;aACb,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,oCAAoC;IACpC,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAED,uBAAuB;IACvB,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,6BAA6B;IAC7B,cAAc,CAAC,SAAiB,EAAE,MAAc;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,8BAA8B;IAC9B,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,wBAAwB;IACxB,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,gCAAgC;IAChC,cAAc,CAAC,KAAa;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,EAAE,KAAK,cAAc,CAAC,gBAAgB,IAAI,GAAG,GAAG,OAAO,CAAC,YAAY,GAAG,KAAK,EAAE,CAAC;gBACjF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;;AAGH,kFAAkF;AAClF,qBAAqB;AACrB,kFAAkF;AAElF,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC"}

package/dist/server/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * MCP Server Type Definitions
+ *
+ * Defines interfaces for tool results, server configuration, and state.
+ *
+ * @module server/types
+ */
+import type { DatabaseService } from '../services/storage/database/index.js';
+/**
+ * Successful tool result
+ */
+interface ToolResultSuccess<T = unknown> {
+    success: true;
+    data: T;
+}
+/**
+ * Helper to create success result
+ */
+export declare function successResult<T>(data: T): ToolResultSuccess<T>;
+/**
+ * OCR processing mode
+ */
+export type OCRMode = 'fast' | 'balanced' | 'accurate';
+/**
+ * Image optimization configuration
+ */
+export interface ImageOptimizationConfig {
+    /** Enable image optimization (default: true) */
+    enabled: boolean;
+    /** Maximum width for OCR resize - Datalab API limit (default: 4800) */
+    ocrMaxWidth: number;
+    /** Maximum dimension for VLM resize - optimize tokens (default: 2048) */
+    vlmMaxDimension: number;
+    /** Skip images smaller than this for VLM (default: 50) */
+    vlmSkipBelowSize: number;
+    /** Minimum relevance score for VLM processing (default: 0.3) */
+    vlmMinRelevance: number;
+    /** Skip images predicted as logos/icons (default: true) */
+    vlmSkipLogosIcons: boolean;
+}
+/**
+ * Server configuration options
+ */
+export interface ServerConfig {
+    /** Default path for database storage */
+    defaultStoragePath: string;
+    /** Default OCR processing mode */
+    defaultOCRMode: OCRMode;
+    /** Maximum concurrent OCR operations */
+    maxConcurrent: number;
+    /** Batch size for embedding generation */
+    embeddingBatchSize: number;
+    /** GPU device for embedding generation */
+    embeddingDevice: string;
+    /** Chunk size in characters */
+    chunkSize: number;
+    /** Chunk overlap percentage (0-50) */
+    chunkOverlapPercent: number;
+    /** Maximum chunk size for oversized sections (default: 8000) */
+    maxChunkSize: number;
+    /** Image optimization settings */
+    imageOptimization: ImageOptimizationConfig;
+    /** Enable auto-clustering after processing */
+    autoClusterEnabled?: boolean;
+    /** Minimum documents before auto-clustering triggers */
+    autoClusterThreshold?: number;
+    /** Algorithm for auto-clustering */
+    autoClusterAlgorithm?: 'hdbscan' | 'agglomerative' | 'kmeans';
+}
+/**
+ * Server state tracking
+ */
+export interface ServerState {
+    /** Currently selected database instance */
+    currentDatabase: DatabaseService | null;
+    /** Name of the currently selected database */
+    currentDatabaseName: string | null;
+    /** Server configuration */
+    config: ServerConfig;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAM7E;;GAEG;AACH,UAAU,iBAAiB,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAE9D;AAMD;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IAEjB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IAEpB,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IAExB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IAExB,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAE3B,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;IAExB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAE3B,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IAExB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,iBAAiB,EAAE,uBAAuB,CAAC;IAE3C,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,oCAAoC;IACpC,oBAAoB,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,QAAQ,CAAC;CAC/D;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IAExC,8CAA8C;IAC9C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;CACtB"}

package/dist/server/types.js

@@ -0,0 +1,14 @@
+/**
+ * MCP Server Type Definitions
+ *
+ * Defines interfaces for tool results, server configuration, and state.
+ *
+ * @module server/types
+ */
+/**
+ * Helper to create success result
+ */
+export function successResult(data) {
+    return { success: true, data };
+}
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,IAAO;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/services/audit.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Audit Logger - Records user actions in audit_log table
+ *
+ * Call this from tool handlers to track mutations.
+ * Audit logging is best-effort: failures are logged but never break the main operation.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module services/audit
+ */
+/**
+ * Log an action to the audit_log table.
+ *
+ * Best-effort: if no database is selected or the insert fails,
+ * the error is logged to stderr and the function returns silently.
+ * Audit logging should NEVER break the main operation.
+ */
+export declare function logAudit(params: {
+    userId?: string | null;
+    sessionId?: string | null;
+    action: string;
+    entityType?: string;
+    entityId?: string;
+    details?: Record<string, unknown>;
+}): void;
+//# sourceMappingURL=audit.d.ts.map

package/dist/services/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/services/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,IAAI,CAoBP"}

package/dist/services/audit.js

@@ -0,0 +1,43 @@
+/**
+ * Audit Logger - Records user actions in audit_log table
+ *
+ * Call this from tool handlers to track mutations.
+ * Audit logging is best-effort: failures are logged but never break the main operation.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module services/audit
+ */
+import { hasDatabase, requireDatabase } from '../server/state.js';
+import { insertAuditLog } from './storage/database/user-operations.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// AUDIT LOGGING
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Log an action to the audit_log table.
+ *
+ * Best-effort: if no database is selected or the insert fails,
+ * the error is logged to stderr and the function returns silently.
+ * Audit logging should NEVER break the main operation.
+ */
+export function logAudit(params) {
+    if (!hasDatabase())
+        return;
+    try {
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        insertAuditLog(conn, {
+            user_id: params.userId ?? null,
+            session_id: params.sessionId ?? null,
+            action: params.action,
+            entity_type: params.entityType ?? null,
+            entity_id: params.entityId ?? null,
+            details_json: JSON.stringify(params.details ?? {}),
+        });
+    }
+    catch (error) {
+        // Audit logging should never break the main operation
+        console.error('[Audit] Failed to log:', error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/services/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/services/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,kFAAkF;AAClF,gBAAgB;AAChB,kFAAkF;AAElF;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAOxB;IACC,IAAI,CAAC,WAAW,EAAE;QAAE,OAAO;IAC3B,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,EAAE,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;QAChC,cAAc,CAAC,IAAI,EAAE;YACnB,OAAO,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;YAC9B,UAAU,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;YACpC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;YACtC,SAAS,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;YAClC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sDAAsD;QACtD,OAAO,CAAC,KAAK,CACX,wBAAwB,EACxB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/services/chunking/chunk-deduplicator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Chunk Deduplication Service (HE-4 / Task 7.3)
+ *
+ * Identifies exact duplicate chunks by text_hash for deduplication
+ * in search results and storage analysis.
+ *
+ * @module services/chunking/chunk-deduplicator
+ */
+import type { DatabaseService } from '../storage/database/index.js';
+/** Result of a chunk deduplication analysis */
+export interface DeduplicationResult {
+    totalChunks: number;
+    uniqueChunks: number;
+    duplicateGroups: Array<{
+        hash: string;
+        count: number;
+        chunkIds: string[];
+        representativeChunkId: string;
+    }>;
+}
+/**
+ * Find exact duplicate chunks by text_hash.
+ *
+ * Groups chunks that share the same text_hash and identifies
+ * duplicate groups (2+ chunks with the same hash). Optionally
+ * scoped to a single document.
+ *
+ * @param db - Database service instance
+ * @param documentId - Optional document ID to scope analysis
+ * @returns DeduplicationResult with total, unique counts, and duplicate groups
+ */
+export declare function findExactDuplicateChunks(db: DatabaseService, documentId?: string): DeduplicationResult;
+//# sourceMappingURL=chunk-deduplicator.d.ts.map

package/dist/services/chunking/chunk-deduplicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-deduplicator.d.ts","sourceRoot":"","sources":["../../../src/services/chunking/chunk-deduplicator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC,CAAC;CACJ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,eAAe,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,mBAAmB,CAoCrB"}

package/dist/services/chunking/chunk-deduplicator.js

@@ -0,0 +1,46 @@
+/**
+ * Chunk Deduplication Service (HE-4 / Task 7.3)
+ *
+ * Identifies exact duplicate chunks by text_hash for deduplication
+ * in search results and storage analysis.
+ *
+ * @module services/chunking/chunk-deduplicator
+ */
+/**
+ * Find exact duplicate chunks by text_hash.
+ *
+ * Groups chunks that share the same text_hash and identifies
+ * duplicate groups (2+ chunks with the same hash). Optionally
+ * scoped to a single document.
+ *
+ * @param db - Database service instance
+ * @param documentId - Optional document ID to scope analysis
+ * @returns DeduplicationResult with total, unique counts, and duplicate groups
+ */
+export function findExactDuplicateChunks(db, documentId) {
+    const conn = db.getConnection();
+    const filter = documentId ? 'WHERE document_id = ?' : '';
+    const params = documentId ? [documentId] : [];
+    const groups = conn.prepare(`SELECT text_hash, COUNT(*) as count, GROUP_CONCAT(id) as chunk_ids
+     FROM chunks ${filter}
+     GROUP BY text_hash
+     HAVING COUNT(*) > 1
+     ORDER BY count DESC`).all(...params);
+    const duplicateGroups = groups.map(g => {
+        const chunkIds = g.chunk_ids.split(',');
+        return {
+            hash: g.text_hash,
+            count: g.count,
+            chunkIds,
+            representativeChunkId: chunkIds[0],
+        };
+    });
+    const totalRow = conn.prepare(`SELECT COUNT(*) as c FROM chunks ${filter}`).get(...params);
+    const uniqueRow = conn.prepare(`SELECT COUNT(DISTINCT text_hash) as c FROM chunks ${filter}`).get(...params);
+    return {
+        totalChunks: totalRow.c,
+        uniqueChunks: uniqueRow.c,
+        duplicateGroups,
+    };
+}
+//# sourceMappingURL=chunk-deduplicator.js.map

package/dist/services/chunking/chunk-deduplicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-deduplicator.js","sourceRoot":"","sources":["../../../src/services/chunking/chunk-deduplicator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAmB,EACnB,UAAmB;IAEnB,MAAM,IAAI,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CACzB;mBACe,MAAM;;;yBAGA,CACtB,CAAC,GAAG,CAAC,GAAG,MAAM,CAAmE,CAAC;IAEnF,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,SAAS;YACjB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ;YACR,qBAAqB,EAAE,QAAQ,CAAC,CAAC,CAAC;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAC3B,oCAAoC,MAAM,EAAE,CAC7C,CAAC,GAAG,CAAC,GAAG,MAAM,CAAkB,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAC5B,qDAAqD,MAAM,EAAE,CAC9D,CAAC,GAAG,CAAC,GAAG,MAAM,CAAkB,CAAC;IAElC,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,CAAC;QACvB,YAAY,EAAE,SAAS,CAAC,CAAC;QACzB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/services/chunking/chunk-merger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Heading-Only Chunk Merger for Section-Aware Chunking
+ *
+ * Post-processing pass that merges tiny heading-only chunks with their
+ * nearest neighbor to improve embedding quality. Heading-only chunks
+ * (e.g., "## ARTICLE 5") produce poor embeddings because they lack
+ * semantic content.
+ *
+ * @module services/chunking/chunk-merger
+ */
+import { ChunkResult } from '../../models/chunk.js';
+/**
+ * Merge heading-only chunks that are below the minimum size threshold.
+ *
+ * Strategy:
+ * - If a next chunk exists, merge heading into next (prepend)
+ * - If no next chunk (last in array), merge into previous (append)
+ * - Consecutive heading-only chunks cascade-merge via while loop
+ * - Re-indexes all chunks after merging
+ *
+ * @param chunks - Array of ChunkResult (not mutated; returns new array)
+ * @param minChunkSize - Minimum character threshold (default: 100)
+ * @returns New array with heading-only chunks merged
+ */
+export declare function mergeHeadingOnlyChunks(chunks: ChunkResult[], minChunkSize?: number): ChunkResult[];
+//# sourceMappingURL=chunk-merger.d.ts.map

package/dist/services/chunking/chunk-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-merger.d.ts","sourceRoot":"","sources":["../../../src/services/chunking/chunk-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA2CpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,EAAE,EACrB,YAAY,GAAE,MAAY,GACzB,WAAW,EAAE,CAsCf"}

package/dist/services/chunking/chunk-merger.js

@@ -0,0 +1,94 @@
+/**
+ * Heading-Only Chunk Merger for Section-Aware Chunking
+ *
+ * Post-processing pass that merges tiny heading-only chunks with their
+ * nearest neighbor to improve embedding quality. Heading-only chunks
+ * (e.g., "## ARTICLE 5") produce poor embeddings because they lack
+ * semantic content.
+ *
+ * @module services/chunking/chunk-merger
+ */
+/**
+ * Check if a chunk is heading-only and below the size threshold.
+ */
+function isHeadingOnlyTiny(chunk, minChunkSize) {
+    return (chunk.contentTypes.length === 1 &&
+        chunk.contentTypes[0] === 'heading' &&
+        chunk.text.trim().length < minChunkSize);
+}
+/**
+ * Merge two chunks: prepend `source` text before `target`.
+ * Updates offsets, contentTypes, and heading context.
+ */
+function mergeIntoNext(source, target) {
+    target.text = source.text + '\n\n' + target.text;
+    target.startOffset = Math.min(source.startOffset, target.startOffset);
+    target.endOffset = Math.max(source.endOffset, target.endOffset);
+    target.headingContext = source.headingContext ?? target.headingContext;
+    target.headingLevel = source.headingLevel ?? target.headingLevel;
+    target.sectionPath = source.sectionPath ?? target.sectionPath;
+    target.pageNumber = source.pageNumber ?? target.pageNumber;
+    // Merge content types (deduplicated)
+    const types = new Set([...source.contentTypes, ...target.contentTypes]);
+    target.contentTypes = Array.from(types);
+}
+/**
+ * Merge two chunks: append `source` text after `target`.
+ */
+function mergeIntoPrevious(target, source) {
+    target.text = target.text + '\n\n' + source.text;
+    target.endOffset = Math.max(target.endOffset, source.endOffset);
+    // Merge content types (deduplicated)
+    const types = new Set([...target.contentTypes, ...source.contentTypes]);
+    target.contentTypes = Array.from(types);
+}
+/**
+ * Merge heading-only chunks that are below the minimum size threshold.
+ *
+ * Strategy:
+ * - If a next chunk exists, merge heading into next (prepend)
+ * - If no next chunk (last in array), merge into previous (append)
+ * - Consecutive heading-only chunks cascade-merge via while loop
+ * - Re-indexes all chunks after merging
+ *
+ * @param chunks - Array of ChunkResult (not mutated; returns new array)
+ * @param minChunkSize - Minimum character threshold (default: 100)
+ * @returns New array with heading-only chunks merged
+ */
+export function mergeHeadingOnlyChunks(chunks, minChunkSize = 100) {
+    if (chunks.length <= 1) {
+        return chunks.map(c => ({ ...c, contentTypes: [...c.contentTypes] }));
+    }
+    // Work on a shallow copy so we can splice without affecting the original
+    const result = chunks.map(c => ({ ...c, contentTypes: [...c.contentTypes] }));
+    let i = 0;
+    while (i < result.length) {
+        if (!isHeadingOnlyTiny(result[i], minChunkSize)) {
+            i++;
+            continue;
+        }
+        if (i < result.length - 1) {
+            // Merge into next chunk
+            mergeIntoNext(result[i], result[i + 1]);
+            result.splice(i, 1);
+            // Don't increment i - check the merged result again (cascade)
+        }
+        else if (i > 0) {
+            // Last chunk - merge into previous
+            mergeIntoPrevious(result[i - 1], result[i]);
+            result.splice(i, 1);
+            // Move back to check if previous is now also heading-only-tiny
+            i = Math.max(0, i - 1);
+        }
+        else {
+            // Single chunk remaining - nothing to merge with
+            i++;
+        }
+    }
+    // Re-index all chunks
+    for (let idx = 0; idx < result.length; idx++) {
+        result[idx].index = idx;
+    }
+    return result;
+}
+//# sourceMappingURL=chunk-merger.js.map

package/dist/services/chunking/chunk-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-merger.js","sourceRoot":"","sources":["../../../src/services/chunking/chunk-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAkB,EAAE,YAAoB;IACjE,OAAO,CACL,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAC/B,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,SAAS;QACnC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,YAAY,CACxC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,MAAmB,EAAE,MAAmB;IAC7D,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IACjD,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACtE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,CAAC;IACvE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC;IACjE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;IAC9D,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAE3D,qCAAqC;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACxE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAmB,EAAE,MAAmB;IACjE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IACjD,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAEhE,qCAAqC;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACxE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAqB,EACrB,eAAuB,GAAG;IAE1B,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,yEAAyE;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC;YAChD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,wBAAwB;YACxB,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,8DAA8D;QAChE,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,mCAAmC;YACnC,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,+DAA+D;YAC/D,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,iDAAiD;YACjD,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/services/chunking/chunker.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Hybrid Section-Aware Chunking Service for OCR Provenance MCP System
+ *
+ * Uses markdown structure (headings, paragraphs, tables), JSON block data
+ * (for atomic region detection), and page offsets (for page tracking) to
+ * produce semantically coherent chunks with provenance records (chain_depth=2).
+ *
+ * @module services/chunking/chunker
+ */
+import { ChunkResult, ChunkingConfig } from '../../models/chunk.js';
+import { PageOffset } from '../../models/document.js';
+import { CreateProvenanceParams } from '../../models/provenance.js';
+/**
+ * Parameters for creating chunk provenance record
+ */
+export interface ChunkProvenanceParams {
+    /** The chunk result containing text and position info */
+    chunk: ChunkResult;
+    /** Pre-computed hash of chunk.text (sha256:...) */
+    chunkTextHash: string;
+    /** Parent provenance ID (OCR result, chain_depth=1) */
+    ocrProvenanceId: string;
+    /** Root document provenance ID (chain_depth=0) */
+    documentProvenanceId: string;
+    /** Hash of full OCR text (input_hash) */
+    ocrContentHash: string;
+    /** Hash of original file */
+    fileHash: string;
+    /** Total number of chunks produced */
+    totalChunks: number;
+    /** Processing duration in milliseconds */
+    processingDurationMs?: number;
+    /** Chunking config used (defaults to DEFAULT_CHUNKING_CONFIG) */
+    config?: ChunkingConfig;
+}
+/**
+ * Hybrid section-aware chunking.
+ *
+ * Uses markdown structure (headings, paragraphs, tables), JSON block data
+ * (for atomic region detection), and page offsets (for page tracking) to
+ * produce semantically coherent chunks.
+ *
+ * @param text - Full markdown text from OCR output
+ * @param pageOffsets - Page offset information for page number assignment
+ * @param jsonBlocks - JSON block hierarchy from Datalab OCR (may be null)
+ * @param config - Chunking configuration (default: 2000 chars, 10% overlap)
+ * @returns Array of ChunkResult with section context, content types, and page info
+ */
+export declare function chunkHybridSectionAware(text: string, pageOffsets: PageOffset[], jsonBlocks: Record<string, unknown> | null, config?: ChunkingConfig): ChunkResult[];
+/**
+ * Create provenance parameters for a chunk.
+ *
+ * Generates a CreateProvenanceParams object suitable for creating
+ * a CHUNK provenance record (chain_depth=2).
+ *
+ * @param params - Chunk provenance parameters
+ * @returns CreateProvenanceParams ready for insertProvenance
+ */
+export declare function createChunkProvenance(params: ChunkProvenanceParams): CreateProvenanceParams;
+export type { ChunkResult, ChunkingConfig } from '../../models/chunk.js';
+export { DEFAULT_CHUNKING_CONFIG } from '../../models/chunk.js';
+//# sourceMappingURL=chunker.d.ts.map

package/dist/services/chunking/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../src/services/chunking/chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAIL,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AAqDpC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,KAAK,EAAE,WAAW,CAAC;IACnB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AA4ID;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,UAAU,EAAE,EACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1C,MAAM,GAAE,cAAwC,GAC/C,WAAW,EAAE,CA4Zf;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,CAuD3F;AAGD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}