@mcoda/mswarm 0.1.56 → 0.1.60

package/dist/vendor/codali/docdex/DocdexClient.d.ts

@@ -0,0 +1,113 @@
+import type { DocdexCapabilitySnapshot } from "../cognitive/Types.js";
+export interface DocdexClientOptions {
+    baseUrl: string;
+    repoRoot?: string;
+    repoId?: string;
+    authToken?: string;
+    dagSessionId?: string;
+}
+export interface DocdexSearchOptions {
+    limit?: number;
+    dagSessionId?: string;
+}
+export interface DocdexSnippetOptions {
+    window?: number;
+    textOnly?: boolean;
+}
+export interface DocdexImpactOptions {
+    maxDepth?: number;
+    maxEdges?: number;
+    edgeTypes?: string[];
+}
+export interface DocdexDagOptions {
+    format?: "json" | "text" | "dot";
+    maxNodes?: number;
+}
+export interface DocdexImpactDiagnosticsOptions {
+    limit?: number;
+    offset?: number;
+    file?: string;
+}
+export interface DocdexTreeOptions {
+    path?: string;
+    maxDepth?: number;
+    dirsOnly?: boolean;
+    includeHidden?: boolean;
+    extraExcludes?: string[];
+}
+export interface DocdexOpenFileOptions {
+    startLine?: number;
+    endLine?: number;
+    head?: number;
+    clamp?: boolean;
+}
+export interface DocdexWebResearchOptions {
+    forceWeb?: boolean;
+    skipLocalSearch?: boolean;
+    webLimit?: number;
+    noCache?: boolean;
+}
+export interface DocdexWriteMetadata {
+    [key: string]: unknown;
+}
+export declare class DocdexClient {
+    private options;
+    private repoId?;
+    private dagSessionId?;
+    private healthChecked;
+    private repoInitializeAttempted;
+    private capabilitySnapshot?;
+    constructor(options: DocdexClientOptions);
+    setRepoId(repoId: string): void;
+    getRepoId(): string | undefined;
+    getRepoRoot(): string | undefined;
+    setDagSessionId(sessionId: string): void;
+    getDagSessionId(): string | undefined;
+    clearCapabilityCache(): void;
+    private resolveBaseUrl;
+    private buildHeaders;
+    private ensureHealth;
+    healthCheck(): Promise<boolean>;
+    initialize(rootUri: string): Promise<{
+        repoId?: string;
+        repoRoot?: string;
+    }>;
+    private ensureRepoInitialized;
+    private withRepoId;
+    search(query: string, options?: DocdexSearchOptions): Promise<unknown>;
+    openSnippet(docId: string, options?: DocdexSnippetOptions): Promise<unknown>;
+    impactGraph(file: string, options?: DocdexImpactOptions): Promise<unknown>;
+    impactDiagnostics(options?: DocdexImpactDiagnosticsOptions): Promise<unknown>;
+    indexRebuild(libsSources?: string): Promise<unknown>;
+    indexIngest(file: string): Promise<unknown>;
+    hooksValidate(files: string[]): Promise<unknown>;
+    delegate(payload: Record<string, unknown>): Promise<unknown>;
+    dagExport(sessionId: string, options?: DocdexDagOptions): Promise<unknown>;
+    callMcp<T>(method: string, params: Record<string, unknown>): Promise<T>;
+    private normalizeMcpResult;
+    private tryParseJson;
+    private buildProjectParams;
+    private defaultCapabilityMap;
+    private toCapabilityStatus;
+    private normalizeCapabilityPayload;
+    symbols(pathValue: string): Promise<unknown>;
+    ast(pathValue: string, maxNodes?: number): Promise<unknown>;
+    stats(): Promise<unknown>;
+    files(limit?: number, offset?: number): Promise<unknown>;
+    repoInspect(): Promise<unknown>;
+    memorySave(text: string, metadata?: DocdexWriteMetadata): Promise<unknown>;
+    memoryRecall(query: string, topK?: number): Promise<unknown>;
+    tree(options?: DocdexTreeOptions): Promise<unknown>;
+    openFile(pathValue: string, options?: DocdexOpenFileOptions): Promise<unknown>;
+    getProfile(agentId?: string): Promise<unknown>;
+    savePreference(agentId: string, category: string, content: string, metadata?: DocdexWriteMetadata): Promise<unknown>;
+    webResearch(query: string, options?: DocdexWebResearchOptions): Promise<unknown>;
+    private webResearchHttp;
+    rerank(query: string, candidates: unknown[], limit?: number): Promise<unknown>;
+    batchSearch(queries: string[], options?: {
+        limit?: number;
+        includeLibs?: boolean;
+    }): Promise<unknown>;
+    getCapabilities(forceRefresh?: boolean): Promise<DocdexCapabilitySnapshot>;
+}
+//# sourceMappingURL=DocdexClient.d.ts.map

package/dist/vendor/codali/docdex/DocdexClient.d.ts.map

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

package/dist/vendor/codali/docdex/DocdexClient.js

@@ -0,0 +1,524 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+const CAPABILITY_KEYS = [
+    "score_breakdown",
+    "rerank",
+    "snippet_provenance",
+    "retrieval_explanation",
+    "batch_search",
+];
+export class DocdexClient {
+    constructor(options) {
+        this.options = options;
+        this.healthChecked = false;
+        this.repoInitializeAttempted = false;
+        this.repoId = options.repoId;
+        this.dagSessionId = options.dagSessionId;
+    }
+    setRepoId(repoId) {
+        this.repoId = repoId;
+    }
+    getRepoId() {
+        return this.repoId;
+    }
+    getRepoRoot() {
+        return this.options.repoRoot;
+    }
+    setDagSessionId(sessionId) {
+        this.dagSessionId = sessionId;
+    }
+    getDagSessionId() {
+        return this.dagSessionId;
+    }
+    clearCapabilityCache() {
+        this.capabilitySnapshot = undefined;
+    }
+    resolveBaseUrl() {
+        const base = this.options.baseUrl.trim();
+        return base.endsWith("/") ? base.slice(0, -1) : base;
+    }
+    buildHeaders(dagSessionId) {
+        const headers = { "content-type": "application/json" };
+        if (this.options.authToken)
+            headers.authorization = `Bearer ${this.options.authToken}`;
+        if (this.repoId)
+            headers["x-docdex-repo-id"] = this.repoId;
+        if (this.options.repoRoot)
+            headers["x-docdex-repo-root"] = path.resolve(this.options.repoRoot);
+        const resolvedDagSessionId = dagSessionId ?? this.dagSessionId;
+        if (resolvedDagSessionId)
+            headers["x-docdex-dag-session"] = resolvedDagSessionId;
+        return headers;
+    }
+    async ensureHealth() {
+        if (this.healthChecked)
+            return;
+        const ok = await this.healthCheck();
+        if (!ok) {
+            throw new Error("Docdex health check failed");
+        }
+    }
+    async healthCheck() {
+        const response = await fetch(`${this.resolveBaseUrl()}/healthz`);
+        this.healthChecked = response.ok;
+        return response.ok;
+    }
+    async initialize(rootUri) {
+        await this.ensureHealth();
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/initialize`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify({ rootUri }),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex initialize failed (${response.status}): ${body}`);
+        }
+        const payload = (await response.json());
+        const repoId = (payload.repo_id ?? payload.repoId ?? payload.repo);
+        const repoRoot = (payload.repo_root ?? payload.repoRoot);
+        if (repoId)
+            this.repoId = repoId;
+        return { repoId, repoRoot };
+    }
+    async ensureRepoInitialized() {
+        if (this.repoId || this.repoInitializeAttempted || !this.options.repoRoot)
+            return;
+        this.repoInitializeAttempted = true;
+        try {
+            await this.initialize(pathToFileURL(path.resolve(this.options.repoRoot)).toString());
+        }
+        catch {
+            // Keep endpoint-specific calls responsible for reporting the final failure.
+            // Single-repo daemons can still accept repo_root without a prior initialize.
+        }
+    }
+    withRepoId(params) {
+        if (this.repoId)
+            params.set("repo_id", this.repoId);
+        if (this.options.repoRoot)
+            params.set("repo_root", path.resolve(this.options.repoRoot));
+    }
+    async search(query, options = {}) {
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const params = new URLSearchParams({ q: query });
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        const dagSessionId = options.dagSessionId ?? this.dagSessionId;
+        if (dagSessionId)
+            params.set("dag_session_id", dagSessionId);
+        this.withRepoId(params);
+        const response = await fetch(`${this.resolveBaseUrl()}/search?${params.toString()}`, {
+            headers: this.buildHeaders(dagSessionId),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex search failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async openSnippet(docId, options = {}) {
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const params = new URLSearchParams();
+        if (options.window !== undefined)
+            params.set("window", String(options.window));
+        if (options.textOnly)
+            params.set("text_only", "true");
+        this.withRepoId(params);
+        const response = await fetch(`${this.resolveBaseUrl()}/snippet/${encodeURIComponent(docId)}?${params.toString()}`, {
+            headers: this.buildHeaders(),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex snippet failed (${response.status}): ${body}`);
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("application/json")) {
+            return response.json();
+        }
+        return response.text();
+    }
+    async impactGraph(file, options = {}) {
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const params = new URLSearchParams({ file });
+        if (options.maxDepth !== undefined)
+            params.set("max_depth", String(options.maxDepth));
+        if (options.maxEdges !== undefined)
+            params.set("max_edges", String(options.maxEdges));
+        if (options.edgeTypes?.length)
+            params.set("edge_types", options.edgeTypes.join(","));
+        this.withRepoId(params);
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/graph/impact?${params.toString()}`, {
+            headers: this.buildHeaders(),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex impact graph failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async impactDiagnostics(options = {}) {
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const params = new URLSearchParams();
+        if (options.file)
+            params.set("file", options.file);
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        if (options.offset !== undefined)
+            params.set("offset", String(options.offset));
+        this.withRepoId(params);
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/graph/impact/diagnostics?${params.toString()}`, {
+            headers: this.buildHeaders(),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex impact diagnostics failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async indexRebuild(libsSources) {
+        await this.ensureHealth();
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/index/rebuild`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(libsSources ? { libs_sources: libsSources } : {}),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex index rebuild failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async indexIngest(file) {
+        await this.ensureHealth();
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/index/ingest`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify({ file }),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex index ingest failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async hooksValidate(files) {
+        await this.ensureHealth();
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/hooks/validate`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify({ files }),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex hooks validate failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async delegate(payload) {
+        await this.ensureHealth();
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/delegate`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex delegate failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    async dagExport(sessionId, options = {}) {
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const params = new URLSearchParams({ session_id: sessionId });
+        if (options.format)
+            params.set("format", options.format);
+        if (options.maxNodes !== undefined)
+            params.set("max_nodes", String(options.maxNodes));
+        this.withRepoId(params);
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/dag/export?${params.toString()}`, {
+            headers: this.buildHeaders(),
+        });
+        const body = await response.text();
+        if (!response.ok) {
+            throw new Error(`Docdex dag export failed (${response.status}): ${body}`);
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("application/json")) {
+            try {
+                return JSON.parse(body);
+            }
+            catch {
+                return body;
+            }
+        }
+        return body;
+    }
+    async callMcp(method, params) {
+        await this.ensureHealth();
+        const payload = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method,
+            params,
+        };
+        const response = await fetch(`${this.resolveBaseUrl()}/v1/mcp`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex MCP failed (${response.status}): ${body}`);
+        }
+        const raw = (await response.json());
+        if (raw.error) {
+            throw new Error(raw.error.message ?? "Docdex MCP error");
+        }
+        return this.normalizeMcpResult(raw.result);
+    }
+    normalizeMcpResult(payload) {
+        if (!payload || typeof payload !== "object")
+            return payload;
+        const record = payload;
+        if (record.structuredContent !== undefined) {
+            return record.structuredContent;
+        }
+        if (!Array.isArray(record.content) || record.content.length === 0) {
+            return payload;
+        }
+        const textChunks = record.content
+            .map((entry) => {
+            if (!entry || typeof entry !== "object")
+                return undefined;
+            const text = entry.text;
+            return typeof text === "string" ? text : undefined;
+        })
+            .filter((text) => typeof text === "string");
+        if (textChunks.length === 0) {
+            return payload;
+        }
+        const joined = textChunks.join("\n").trim();
+        if (joined.length === 0) {
+            return payload;
+        }
+        const parsed = this.tryParseJson(joined);
+        return parsed ?? joined;
+    }
+    tryParseJson(text) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return undefined;
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    buildProjectParams(extra) {
+        return {
+            project_root: this.options.repoRoot,
+            ...extra,
+        };
+    }
+    defaultCapabilityMap(status) {
+        return {
+            score_breakdown: status,
+            rerank: status,
+            snippet_provenance: status,
+            retrieval_explanation: status,
+            batch_search: status,
+        };
+    }
+    toCapabilityStatus(value) {
+        if (value === true)
+            return "available";
+        if (value === false)
+            return "unavailable";
+        if (typeof value === "number")
+            return value > 0 ? "available" : "unavailable";
+        if (typeof value !== "string")
+            return "unknown";
+        const normalized = value.trim().toLowerCase();
+        if (["available", "enabled", "supported", "ok", "true", "yes"].includes(normalized)) {
+            return "available";
+        }
+        if (["unavailable", "disabled", "unsupported", "none", "false", "no"].includes(normalized)) {
+            return "unavailable";
+        }
+        return "unknown";
+    }
+    normalizeCapabilityPayload(payload) {
+        if (!payload || typeof payload !== "object")
+            return undefined;
+        const record = payload;
+        const source = ((record.capabilities && typeof record.capabilities === "object"
+            ? record.capabilities
+            : undefined) ??
+            (record.retrieval && typeof record.retrieval === "object"
+                ? record.retrieval
+                : undefined) ??
+            record);
+        const scopedSource = (source.retrieval && typeof source.retrieval === "object"
+            ? source.retrieval
+            : source);
+        const aliases = {
+            score_breakdown: ["score_breakdown", "structured_scoring", "scoring"],
+            rerank: ["rerank", "re_rank"],
+            snippet_provenance: ["snippet_provenance", "stable_provenance", "provenance"],
+            retrieval_explanation: ["retrieval_explanation", "hit_explanations", "explanations", "retrieval_explanations"],
+            batch_search: ["batch_search", "batch_retrieval", "batch", "multi_fetch"],
+        };
+        const result = this.defaultCapabilityMap("unknown");
+        let found = false;
+        for (const key of CAPABILITY_KEYS) {
+            const aliasKeys = aliases[key];
+            const raw = aliasKeys.map((alias) => scopedSource[alias]).find((entry) => entry !== undefined);
+            if (raw === undefined)
+                continue;
+            found = true;
+            result[key] = this.toCapabilityStatus(raw);
+        }
+        return found ? result : undefined;
+    }
+    symbols(pathValue) {
+        return this.callMcp("docdex_symbols", this.buildProjectParams({ path: pathValue }));
+    }
+    ast(pathValue, maxNodes) {
+        return this.callMcp("docdex_ast", this.buildProjectParams({ path: pathValue, max_nodes: maxNodes }));
+    }
+    stats() {
+        return this.callMcp("docdex_stats", this.buildProjectParams({}));
+    }
+    files(limit, offset) {
+        return this.callMcp("docdex_files", this.buildProjectParams({ limit, offset }));
+    }
+    repoInspect() {
+        return this.callMcp("docdex_repo_inspect", this.buildProjectParams({}));
+    }
+    memorySave(text, metadata) {
+        return this.callMcp("docdex_memory_save", this.buildProjectParams({ text, metadata }));
+    }
+    memoryRecall(query, topK) {
+        return this.callMcp("docdex_memory_recall", this.buildProjectParams({ query, top_k: topK }));
+    }
+    tree(options = {}) {
+        return this.callMcp("docdex_tree", this.buildProjectParams({
+            path: options.path,
+            max_depth: options.maxDepth,
+            dirs_only: options.dirsOnly,
+            include_hidden: options.includeHidden,
+            extra_excludes: options.extraExcludes,
+        }));
+    }
+    openFile(pathValue, options = {}) {
+        return this.callMcp("docdex_open", this.buildProjectParams({
+            path: pathValue,
+            start_line: options.startLine,
+            end_line: options.endLine,
+            head: options.head,
+            clamp: options.clamp,
+        }));
+    }
+    getProfile(agentId) {
+        const params = {};
+        if (agentId)
+            params.agent_id = agentId;
+        return this.callMcp("docdex_get_profile", params);
+    }
+    savePreference(agentId, category, content, metadata) {
+        return this.callMcp("docdex_save_preference", {
+            agent_id: agentId,
+            category,
+            content,
+            metadata,
+        });
+    }
+    webResearch(query, options = {}) {
+        return this.callMcp("docdex_web_research", this.buildProjectParams({
+            query,
+            force_web: options.forceWeb ?? true,
+            skip_local_search: options.skipLocalSearch,
+            web_limit: options.webLimit,
+            no_cache: options.noCache,
+        })).catch(() => this.webResearchHttp(query, options));
+    }
+    async webResearchHttp(query, options = {}) {
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        const params = new URLSearchParams({ q: query });
+        params.set("force_web", String(options.forceWeb ?? true));
+        if (options.skipLocalSearch !== undefined) {
+            params.set("skip_local_search", String(options.skipLocalSearch));
+        }
+        if (options.webLimit !== undefined) {
+            params.set("max_web_results", String(options.webLimit));
+        }
+        if (options.noCache !== undefined) {
+            params.set("no_cache", String(options.noCache));
+        }
+        this.withRepoId(params);
+        const response = await fetch(`${this.resolveBaseUrl()}/search?${params.toString()}`, {
+            headers: this.buildHeaders(this.dagSessionId),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Docdex web research failed (${response.status}): ${body}`);
+        }
+        return response.json();
+    }
+    rerank(query, candidates, limit) {
+        return this.callMcp("docdex_rerank", this.buildProjectParams({
+            query,
+            candidates,
+            limit,
+        }));
+    }
+    batchSearch(queries, options = {}) {
+        return this.callMcp("docdex_batch_search", this.buildProjectParams({
+            queries,
+            limit: options.limit,
+            include_libs: options.includeLibs,
+        }));
+    }
+    async getCapabilities(forceRefresh = false) {
+        if (this.capabilitySnapshot && !forceRefresh) {
+            return { ...this.capabilitySnapshot, cached: true };
+        }
+        try {
+            const payload = await this.callMcp("docdex_capabilities", this.buildProjectParams({}));
+            const normalizedCapabilities = this.normalizeCapabilityPayload(payload);
+            const capabilities = normalizedCapabilities ?? this.defaultCapabilityMap("unknown");
+            const warnings = normalizedCapabilities ? undefined : ["probe_missing_capability_fields"];
+            const snapshot = {
+                cached: false,
+                source: "mcp_probe",
+                probed_at_ms: Date.now(),
+                capabilities,
+                warnings,
+            };
+            this.capabilitySnapshot = snapshot;
+            return snapshot;
+        }
+        catch (error) {
+            const snapshot = {
+                cached: false,
+                source: "fallback",
+                probed_at_ms: Date.now(),
+                capabilities: this.defaultCapabilityMap("unavailable"),
+                warnings: [
+                    `probe_failed:${error instanceof Error ? error.message : String(error)}`,
+                ],
+            };
+            this.capabilitySnapshot = snapshot;
+            return snapshot;
+        }
+    }
+}

package/dist/vendor/codali/eval/EvalRunner.d.ts

@@ -0,0 +1,35 @@
+import type { EvalTaskExecution } from "./EvalTaskExecutor.js";
+import type { EvalTaskDefinition } from "./SuiteSchema.js";
+export interface EvalTaskExecutorLike {
+    executeTask(task: EvalTaskDefinition): Promise<EvalTaskExecution>;
+}
+export interface EvalRunSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    execution_errors: number;
+}
+export interface EvalRunResult {
+    schema_version: 1;
+    suite_id: string;
+    suite_fingerprint: string;
+    started_at: string;
+    ended_at: string;
+    duration_ms: number;
+    task_results: EvalTaskExecution[];
+    summary: EvalRunSummary;
+}
+export declare class EvalRunner {
+    private readonly suiteId;
+    private readonly suiteFingerprint;
+    private readonly tasks;
+    private readonly executor;
+    constructor(params: {
+        suite_id: string;
+        suite_fingerprint: string;
+        tasks: EvalTaskDefinition[];
+        executor: EvalTaskExecutorLike;
+    });
+    run(): Promise<EvalRunResult>;
+}
+//# sourceMappingURL=EvalRunner.d.ts.map

package/dist/vendor/codali/eval/EvalRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvalRunner.d.ts","sourceRoot":"","sources":["../../src/eval/EvalRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;gBAEpC,MAAM,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAC5B,QAAQ,EAAE,oBAAoB,CAAC;KAChC;IAOK,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC;CA8BpC"}