abb-opencode-local-rag 0.1.0

package/dist/server/tool-input.js

@@ -0,0 +1,216 @@
+// Runtime validation for MCP tool arguments.
+//
+// MCP tool arguments arrive as `unknown` from the SDK: TypeScript types are
+// erased at runtime, so the previous `as unknown as XxxInput` casts let
+// malformed input flow into the handlers (non-string query, negative limit,
+// missing metadata, enum-violating format). These validators reject malformed
+// input at the entry boundary with `McpError(InvalidParams)` — the same
+// structured failure shape `read_chunk_neighbors` already uses — without
+// leaking internal diagnostics to the client.
+import { isAbsolute } from 'node:path';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { QUALITY_PROFILES } from '../pdf-visual/types.js';
+import { MAX_NEIGHBOR_COUNT, MAX_QUERY_LIMIT, MIN_QUERY_LIMIT } from '../utils/limits.js';
+import { CONTENT_FORMATS } from '../utils/raw-data-utils.js';
+const SCOPE_ERROR = 'scope must be a non-empty string or a non-empty array of non-empty strings';
+/**
+ * Normalize the optional `scope` to a trimmed `string[]`, rejecting any other
+ * shape with `McpError(InvalidParams)`. Mirrors the `limit` boundary check.
+ */
+function normalizeScope(scope) {
+    const isNonEmptyString = (value) => typeof value === 'string' && value.trim().length > 0;
+    // Trim so whitespace-padded prefixes don't silently match nothing.
+    if (isNonEmptyString(scope)) {
+        return [scope.trim()];
+    }
+    if (Array.isArray(scope) && scope.length > 0 && scope.every(isNonEmptyString)) {
+        return scope.map((value) => value.trim());
+    }
+    throw new McpError(ErrorCode.InvalidParams, SCOPE_ERROR);
+}
+function asRecord(raw, label) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new McpError(ErrorCode.InvalidParams, `${label} arguments must be an object`);
+    }
+    return raw;
+}
+/**
+ * Validate `query_documents` arguments. `query` must be a non-empty string;
+ * `limit`, when provided, must be a positive integer (the handler defaults it
+ * to 10 when absent).
+ */
+export function parseQueryDocumentsInput(raw) {
+    const obj = asRecord(raw, 'query_documents');
+    const { query, limit, scope } = obj;
+    if (typeof query !== 'string' || query.trim().length === 0) {
+        throw new McpError(ErrorCode.InvalidParams, 'query must be a non-empty string');
+    }
+    const input = { query };
+    if (limit !== undefined) {
+        // Bound to 1-20 at the entry boundary — the same range VectorStore.search
+        // enforces and the CLI `--limit` accepts. Rejecting here returns a clean
+        // McpError(InvalidParams) instead of letting an out-of-range value reach
+        // search() and surface as a DatabaseError.
+        if (typeof limit !== 'number' ||
+            !Number.isInteger(limit) ||
+            limit < MIN_QUERY_LIMIT ||
+            limit > MAX_QUERY_LIMIT) {
+            throw new McpError(ErrorCode.InvalidParams, 'limit must be an integer between 1 and 20');
+        }
+        input.limit = limit;
+    }
+    if (scope !== undefined) {
+        input.scope = normalizeScope(scope);
+    }
+    return input;
+}
+/**
+ * Validate `list_files` arguments. The tool historically takes no arguments, so
+ * an omitted `arguments` (`undefined`) or `{}` is accepted as "no scope". When
+ * `scope` is present, it is normalized the same way as `query_documents`.
+ */
+export function parseListFilesInput(raw) {
+    // Preserve the no-argument contract: `asRecord` rejects `undefined`, so
+    // short-circuit before it to avoid a spurious McpError on no-arg calls.
+    if (raw === undefined) {
+        return {};
+    }
+    const { scope } = asRecord(raw, 'list_files');
+    if (scope === undefined) {
+        return {};
+    }
+    return { scope: normalizeScope(scope) };
+}
+/**
+ * Validate `ingest_data` arguments. `content` must be a non-empty string;
+ * `metadata` must be an object with a non-empty `source` string and a `format`
+ * in the supported set.
+ */
+export function parseIngestDataInput(raw) {
+    const obj = asRecord(raw, 'ingest_data');
+    const { content, metadata } = obj;
+    if (typeof content !== 'string' || content.length === 0) {
+        throw new McpError(ErrorCode.InvalidParams, 'content must be a non-empty string');
+    }
+    const meta = asRecord(metadata, 'ingest_data metadata');
+    const { source, format } = meta;
+    if (typeof source !== 'string' || source.trim().length === 0) {
+        throw new McpError(ErrorCode.InvalidParams, 'metadata.source must be a non-empty string');
+    }
+    if (typeof format !== 'string' || !CONTENT_FORMATS.includes(format)) {
+        throw new McpError(ErrorCode.InvalidParams, `metadata.format must be one of: ${CONTENT_FORMATS.join(', ')}`);
+    }
+    return { content, metadata: { source, format: format } };
+}
+export function parseIngestFileInput(raw) {
+    const { filePath, visual, visualQuality } = asRecord(raw, 'ingest_file');
+    if (typeof filePath !== 'string' || filePath.trim().length === 0) {
+        throw new McpError(ErrorCode.InvalidParams, 'filePath must be a non-empty string');
+    }
+    if (visual !== undefined && typeof visual !== 'boolean') {
+        throw new McpError(ErrorCode.InvalidParams, "'visual' must be a boolean if provided");
+    }
+    if (visualQuality !== undefined &&
+        visualQuality !== '' &&
+        !QUALITY_PROFILES.includes(visualQuality)) {
+        throw new McpError(ErrorCode.InvalidParams, "'visualQuality' must be 'fast' or 'quality' if provided");
+    }
+    return {
+        filePath,
+        ...(visual !== undefined ? { visual } : {}),
+        ...(QUALITY_PROFILES.includes(visualQuality)
+            ? { visualQuality: visualQuality }
+            : {}),
+    };
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+export function parseDeleteFileInput(raw) {
+    const { filePath, source } = asRecord(raw, 'delete_file');
+    const hasFilePath = nonEmptyString(filePath);
+    const hasSource = nonEmptyString(source);
+    if (hasFilePath === hasSource) {
+        throw new McpError(ErrorCode.InvalidParams, hasFilePath
+            ? 'Provide either filePath or source, not both'
+            : 'Either filePath or source must be provided');
+    }
+    return hasFilePath ? { filePath } : { source: source };
+}
+export function parseReadChunkNeighborsInput(raw) {
+    const { filePath, source, chunkIndex, before, after } = asRecord(raw, 'read_chunk_neighbors');
+    if (!Number.isInteger(chunkIndex) || chunkIndex < 0) {
+        throw new McpError(ErrorCode.InvalidParams, 'chunkIndex must be a non-negative integer');
+    }
+    for (const [label, value] of [
+        ['before', before],
+        ['after', after],
+    ]) {
+        if (value !== undefined && (!Number.isInteger(value) || value < 0)) {
+            throw new McpError(ErrorCode.InvalidParams, `${label} must be a non-negative integer`);
+        }
+        if (typeof value === 'number' && value > MAX_NEIGHBOR_COUNT) {
+            throw new McpError(ErrorCode.InvalidParams, `${label} must be between 0 and 50 (got ${value})`);
+        }
+    }
+    const ref = parseDeleteFileInput({ filePath, source });
+    return {
+        ...ref,
+        chunkIndex: chunkIndex,
+        ...(before !== undefined ? { before: before } : {}),
+        ...(after !== undefined ? { after: after } : {}),
+    };
+}
+/**
+ * Validate `sync_start` arguments. The tool is legitimately callable with no
+ * arguments — an omitted `path` means "every configured base directory" — so
+ * both `undefined` and `{}` are accepted, the same contract `list_files` has.
+ *
+ * Root containment is deliberately not checked here: the sync core owns that
+ * rule so the CLI and MCP surfaces cannot drift apart.
+ */
+export function parseSyncStartInput(raw) {
+    if (raw === undefined) {
+        return {};
+    }
+    const { path } = asRecord(raw, 'sync_start');
+    if (path === undefined) {
+        return {};
+    }
+    if (!nonEmptyString(path)) {
+        throw new McpError(ErrorCode.InvalidParams, 'path must be a non-empty string');
+    }
+    // Trimmed for the same reason as `scope`: a whitespace-padded path would
+    // otherwise be resolved verbatim and silently match nothing on disk.
+    const trimmed = path.trim();
+    // A relative path would be resolved against the server process's working
+    // directory, which the caller cannot see. `ingest_file` and `delete_file`
+    // already require absolute paths, and the tool description promises one.
+    if (!isAbsolute(trimmed)) {
+        throw new McpError(ErrorCode.InvalidParams, 'path must be an absolute path');
+    }
+    return { path: trimmed };
+}
+/**
+ * A job id is a `randomUUID()` this server handed out: 36 characters of
+ * hexadecimal and dashes. The cap and the alphabet are enforced because the value
+ * is echoed into the "unknown sync job" message and into a stderr log line — an
+ * unbounded id with a newline in it would forge a log line for the operator.
+ */
+const JOB_ID_PATTERN = /^[0-9a-fA-F-]{1,128}$/;
+/**
+ * Validate `sync_status` arguments. `jobId` is required; an unknown but
+ * well-formed id is the handler's concern, not this boundary's.
+ */
+export function parseSyncStatusInput(raw) {
+    const { jobId } = asRecord(raw, 'sync_status');
+    if (!nonEmptyString(jobId)) {
+        throw new McpError(ErrorCode.InvalidParams, 'jobId must be a non-empty string');
+    }
+    const trimmed = jobId.trim();
+    if (!JOB_ID_PATTERN.test(trimmed)) {
+        throw new McpError(ErrorCode.InvalidParams, 'jobId must be at most 128 characters of hexadecimal digits and dashes');
+    }
+    return { jobId: trimmed };
+}
+//# sourceMappingURL=tool-input.js.map

package/dist/server/tool-input.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,331 @@
+import type { QualityProfile } from '../pdf-visual/types.js';
+import type { BaseDirsConfigError } from '../utils/base-dirs.js';
+import type { ContentFormat } from '../utils/raw-data-utils.js';
+import type { GroupingMode } from '../vectordb/index.js';
+/**
+ * Fields shared by both `RAGServerConfig` shapes (legacy single-root and
+ * multi-root). Extracted so the union below only needs to describe the
+ * `baseDir` / `baseDirs` axis.
+ */
+interface RAGServerConfigBase {
+    /** LanceDB database path */
+    dbPath: string;
+    /** Transformers.js model path */
+    modelName: string;
+    /** Model cache directory */
+    cacheDir: string;
+    /** Maximum file size (100MB) */
+    maxFileSize: number;
+    /** Compute device (cpu, webgpu, dml, etc) */
+    device?: string;
+    /** Embedding quantization dtype (fp32, fp16, q8, int8, ...). Unset → fp32. */
+    dtype?: string;
+    /** Maximum distance threshold for quality filtering (optional) */
+    maxDistance?: number;
+    /** Grouping mode for quality filtering (optional) */
+    grouping?: GroupingMode;
+    /** Hybrid search weight for BM25 (0.0 = vector only, 1.0 = BM25 only, default 0.6) */
+    hybridWeight?: number;
+    /** Maximum number of files to keep in search results (optional) */
+    maxFiles?: number;
+    /** Minimum chunk length in characters (optional, default: 50) */
+    chunkMinLength?: number;
+    /** Store bounded PDF regions and Mammoth-produced DOCX images. */
+    storeImages?: boolean;
+    /**
+     * Normal-path (resolve()) roots, index-aligned with the realpath'd `baseDirs`
+     * security boundary; used for user-facing `list_files` scan/display so paths
+     * match the resolve()-stored DB keys. From `BaseDirsConfig.rawBaseDirs` (see
+     * it for the path policy). Optional: legacy `{ baseDir }` callers fall back to
+     * `baseDirs`.
+     */
+    rawBaseDirs?: readonly string[];
+    /** Configuration validation warnings to surface to users via MCP annotations */
+    configWarnings?: string[];
+    /**
+     * Structured base-dirs resolution error. When present, the server is in
+     * degraded mode: `status` remains callable so the user can diagnose the
+     * problem via MCP, while root-dependent tools surface the error before
+     * doing DB or filesystem work. See `resolveBaseDirs` for the error
+     * semantics.
+     */
+    configError?: BaseDirsConfigError;
+}
+/**
+ * RAGServer configuration.
+ *
+ * Accepts either a single `baseDir` (legacy shape — preserved so existing
+ * direct callers and tests that pass `{ baseDir }` continue to work) or
+ * `baseDirs` (multi-root shape produced by `resolveBaseDirs`). Exactly one
+ * of the two MUST be supplied. The constructor normalizes both into a single
+ * `baseDirs: string[]` internally and derives the legacy `baseDir` accessor
+ * as `baseDirs[0]`.
+ */
+export type RAGServerConfig = (RAGServerConfigBase & {
+    /** Document base directory (legacy single-root shape). */
+    baseDir: string;
+    baseDirs?: undefined;
+}) | (RAGServerConfigBase & {
+    /** One or more allowed document base directories (multi-root shape). */
+    baseDirs: string[];
+    baseDir?: undefined;
+});
+/**
+ * query_documents tool input
+ */
+export interface QueryDocumentsInput {
+    /** Natural language query */
+    query: string;
+    /** Number of results to retrieve (default 10) */
+    limit?: number;
+    /** Path prefix scope (one or a list); the parser normalizes to `string[]`. */
+    scope?: string | string[];
+}
+/**
+ * list_files tool input
+ */
+export interface ListFilesInput {
+    /** Path prefix scope (one or a list); the parser normalizes to `string[]`. */
+    scope?: string | string[];
+}
+/**
+ * ingest_file tool input
+ */
+export interface IngestFileInput {
+    /** File path */
+    filePath: string;
+    /**
+     * When true and `filePath` is a PDF, the visual enrichment path runs
+     * (VLM captioning of figure-heavy pages). For non-PDF files this flag is
+     * silently coerced to the default text-only path. The runtime check at the
+     * handler boundary stays in place because MCP arguments arrive as `unknown`
+     * from the SDK.
+     */
+    visual?: boolean;
+    /**
+     * Visual-quality profile when `visual` is true. Some MCP clients send the
+     * empty string for unspecified optional parameters; the transport decoder
+     * normalizes it before this type reaches the handler.
+     */
+    visualQuality?: QualityProfile;
+}
+/**
+ * ingest_data tool input metadata
+ */
+interface IngestDataMetadata {
+    /** Source identifier: URL ("https://...") or custom ID ("clipboard://2024-12-30") */
+    source: string;
+    /** Content format */
+    format: ContentFormat;
+}
+/**
+ * ingest_data tool input
+ */
+export interface IngestDataInput {
+    /** Content to ingest (text, HTML, or Markdown) */
+    content: string;
+    /** Content metadata */
+    metadata: IngestDataMetadata;
+}
+/**
+ * delete_file tool input
+ * Either filePath or source must be provided
+ */
+export type DeleteFileInput = {
+    filePath: string;
+    source?: never;
+} | {
+    source: string;
+    filePath?: never;
+};
+/**
+ * delete_file tool output
+ */
+export interface DeleteFileResult {
+    /** Resolved file path used for the delete operation */
+    filePath: string;
+    /** True when the delete operation completed (idempotent; not "something was removed") */
+    deleted: true;
+    /** Number of vector chunks removed from the database */
+    removedChunks: number;
+    /** True when ingested chunks and/or raw-data artifacts existed before delete */
+    existed: boolean;
+    /** Timestamp */
+    timestamp: string;
+}
+/**
+ * ingest_file tool output
+ */
+export interface IngestResult {
+    /** File path */
+    filePath: string;
+    /** Chunk count */
+    chunkCount: number;
+    /** Timestamp */
+    timestamp: string;
+    /** Document title extracted from file content (display-only, not used for scoring) */
+    fileTitle: string | null;
+}
+/**
+ * list_files tool output — entry for a file found under one of the effective
+ * base directories.
+ *
+ * `baseDir` identifies the producing root (one of `ListFilesResult.baseDirs`).
+ * Always present, including in single-root configurations — the field is
+ * additive over the legacy shape, so existing clients that ignore it continue
+ * to work.
+ */
+export type FileEntry = {
+    filePath: string;
+    baseDir: string;
+    ingested: true;
+    chunkCount: number;
+    timestamp: string;
+} | {
+    filePath: string;
+    baseDir: string;
+    ingested: false;
+};
+/**
+ * list_files tool output — entry for content ingested via ingest_data,
+ * or an orphaned DB entry whose file no longer exists on disk
+ */
+export type SourceEntry = {
+    source: string;
+    chunkCount: number;
+    timestamp: string;
+} | {
+    filePath: string;
+    chunkCount: number;
+    timestamp: string;
+};
+/**
+ * list_files tool output.
+ *
+ * Multi-root contract:
+ * - `baseDirs`: all effective roots (normal resolve() form, nested-root pruned).
+ * - `baseDir`: the first effective root (`baseDirs[0]`). Preserved as a
+ *   legacy field so clients written against the single-root shape continue to
+ *   work.
+ * - `files`: union across roots, each annotated with its producing `baseDir`.
+ *   Exact duplicate paths across roots are de-duplicated (first occurrence
+ *   wins, preserving root iteration order).
+ * - `sources`: raw-data entries (from `ingest_data`) and orphaned DB entries
+ *   whose files no longer exist on disk. Sources are not produced by any
+ *   root, so they carry no `baseDir` annotation.
+ */
+export interface ListFilesResult {
+    baseDir: string;
+    baseDirs: string[];
+    files: FileEntry[];
+    sources: SourceEntry[];
+}
+/**
+ * query_documents tool output
+ */
+export interface QueryResult {
+    /** File path */
+    filePath: string;
+    /** Chunk index */
+    chunkIndex: number;
+    /** Text */
+    text: string;
+    /** Similarity score */
+    score: number;
+    /** Original source (only for raw-data files, e.g., URLs ingested via ingest_data) */
+    source?: string;
+    /** Document title extracted from file content (display-only, not used for scoring) */
+    fileTitle: string | null;
+}
+/**
+ * read_chunk_neighbors tool input.
+ * Exactly one of filePath / source must be provided (XOR).
+ */
+export type ReadChunkNeighborsInput = DeleteFileInput & {
+    /** Target chunk index (zero-based, required, non-negative integer). */
+    chunkIndex: number;
+    /** Number of chunks before the target to include (default 2, non-negative integer). */
+    before?: number;
+    /** Number of chunks after the target to include (default 2, non-negative integer). */
+    after?: number;
+};
+/**
+ * read_chunk_neighbors tool output item.
+ * Core fields are {filePath, chunkIndex, text}. `isTarget` is true only for
+ * the requested target when it exists, and `source` is present only on
+ * raw-data rows.
+ * fileTitle mirrors QueryResult for drop-in consistency with query_documents results.
+ */
+export interface ReadChunkNeighborsResultItem {
+    /** File path */
+    filePath: string;
+    /** Chunk index */
+    chunkIndex: number;
+    /** Text */
+    text: string;
+    /** True iff this chunk's chunkIndex matches the requested target. */
+    isTarget: boolean;
+    /** Original source (only for raw-data files, e.g., URLs ingested via ingest_data). */
+    source?: string;
+    /** Document title extracted from file content (display-only, not used for scoring) */
+    fileTitle: string | null;
+}
+/**
+ * sync_start tool input
+ */
+export interface SyncStartInput {
+    /** Absolute path inside a configured root. Omitted means every configured root. */
+    path?: string;
+}
+/**
+ * sync_status tool input
+ */
+export interface SyncStatusInput {
+    /** Identifier returned by sync_start. */
+    jobId: string;
+}
+/**
+ * Lifecycle of the one process-local sync job the server retains. There is no
+ * cancelled, queued, or recovered state: the record lives only for the server
+ * process and a new job replaces a terminal one.
+ */
+export type SyncJobState = 'running' | 'succeeded' | 'failed';
+/**
+ * Per-file outcome counters of a sync job. Structurally identical to the sync
+ * core's counters, restated here because `server/` does not depend on
+ * `features/`.
+ */
+export interface SyncSummary {
+    /** Files re-ingested because they were new, changed, or stored inconsistently. */
+    upserted: number;
+    /** Files whose stored content identity already matched the disk bytes. */
+    skipped: number;
+    /** Present files that produced zero chunks; their prior rows and hash are kept. */
+    empty: number;
+    /** Indexed files removed from the index. Counts files, not rows, and is outside `completed`. */
+    pruned: number;
+}
+/**
+ * sync_status tool output — the whole pollable record for one job.
+ *
+ * `total` stays `null` until scanning has counted the supported files on disk,
+ * and `completed` (`upserted + skipped + empty`) never exceeds a non-null
+ * `total`. `error` is `null` unless the job failed; a failed job carries one
+ * controlled message that names the file for a per-file failure. A job succeeds
+ * only when `error` is `null`.
+ */
+export interface SyncStatusResult {
+    jobId: string;
+    state: SyncJobState;
+    total: number | null;
+    completed: number;
+    summary: SyncSummary;
+    /**
+     * Scanner coverage warnings, carried as JSON rather than as the content
+     * blocks `list_files` uses, because status is a single pollable record.
+     */
+    warnings: string[];
+    error: string | null;
+}
+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":"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"}

package/dist/server/types.js

@@ -0,0 +1,3 @@
+// Type definitions for RAGServer
+export {};
+//# 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,iCAAiC"}

package/dist/server-main.d.ts

@@ -0,0 +1,46 @@
+import { RAGServer } from './server/index.js';
+import type { GroupingMode } from './vectordb/index.js';
+/** Result of parsing an environment variable */
+export interface ParseResult<T> {
+    value: T | undefined;
+    warning?: string;
+}
+/**
+ * Parse grouping mode from environment variable
+ */
+export declare function parseGroupingMode(value: string | undefined): ParseResult<GroupingMode>;
+/**
+ * Parse max distance from environment variable
+ */
+export declare function parseMaxDistance(value: string | undefined): ParseResult<number>;
+/**
+ * Parse max files from environment variable
+ */
+export declare function parseMaxFiles(value: string | undefined): ParseResult<number>;
+/**
+ * Parse hybrid weight from environment variable
+ */
+export declare function parseHybridWeight(value: string | undefined): ParseResult<number>;
+/**
+ * Parse chunk minimum length from environment variable
+ */
+export declare function parseChunkMinLength(value: string | undefined): ParseResult<number>;
+/** Parse the independent PDF image-storage toggle. */
+export declare function parseStoreImages(value: string | undefined): ParseResult<boolean>;
+/**
+ * Resolve the full RAGServer configuration from environment variables.
+ *
+ * Pure (no process.exit, no transport): `env` and `cwd` are passed in so the
+ * entry-point wiring can be exercised directly in tests instead of via a copy.
+ * Single source of truth for BASE_DIRS / BASE_DIR / cwd precedence, the
+ * sensitive-path policy on both raw and realpath-normalized roots, and the
+ * never-fall-back-to-cwd-on-error rule.
+ */
+export declare function resolveServerConfig(env: NodeJS.ProcessEnv, cwd: string): Promise<ConstructorParameters<typeof RAGServer>[0]>;
+/**
+ * Start the RAG MCP Server
+ * Configuration is read from environment variables only (no CLI flags).
+ * This ensures the bare `mcp-local-rag` launch is suitable for MCP clients.
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server-main.d.ts.map

package/dist/server-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-main.d.ts","sourceRoot":"","sources":["../src/server-main.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAI7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAMvD,gDAAgD;AAChD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,CAQtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAQ/E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAQ5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAQhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAQlF;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAShF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,qBAAqB,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CA2GrD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBjD"}