@withpica/mcp-server 2.7.0 → 2.8.0

package/dist/tools/import.js

@@ -0,0 +1,455 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, formatAsText, mapGapsToHints, } from "@withpica/mcp-utils";
+const VALID_DOMAINS = [
+    "works",
+    "people",
+    "recordings",
+    "documents",
+    "enquiries",
+    "royalties",
+];
+export class ImportTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_import_analyze",
+                    description: "Analyze a CSV file and get AI-suggested column mappings. Pass the raw CSV content as a string. " +
+                        "Returns parsed headers, sample rows, and AI-suggested mappings from CSV columns to PICA fields. " +
+                        "Use this as the first step before validate and execute. " +
+                        "→ then: pica_import_validate (check for errors), pica_import_execute (run the import)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            file_content: {
+                                type: "string",
+                                description: "Raw CSV content as a string (read the CSV file and pass its contents here)",
+                            },
+                            domain: {
+                                type: "string",
+                                description: "Import domain — what type of records to create",
+                                enum: VALID_DOMAINS,
+                            },
+                        },
+                        required: ["file_content", "domain"],
+                    },
+                },
+                executor: this.analyzeImport.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_import_validate",
+                    description: "Validate all CSV rows against a field mapping before executing import. " +
+                        "Returns per-row validation errors and a summary of valid/invalid rows. " +
+                        "Run this after pica_import_analyze to check for issues before importing.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            file_content: {
+                                type: "string",
+                                description: "Raw CSV content (same as passed to pica_import_analyze)",
+                            },
+                            domain: {
+                                type: "string",
+                                description: "Import domain",
+                                enum: VALID_DOMAINS,
+                            },
+                            mapping: {
+                                type: "array",
+                                description: "Column mappings from pica_import_analyze (or manually adjusted). " +
+                                    "Each entry maps a CSV column to a PICA target field.",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        csvColumn: {
+                                            type: "string",
+                                            description: "CSV column header name",
+                                        },
+                                        targetField: {
+                                            type: "string",
+                                            description: "PICA database field name",
+                                        },
+                                        transformType: {
+                                            type: "string",
+                                            description: "Transform to apply (default: 'text'). Options: text, date, number, boolean, enum",
+                                        },
+                                    },
+                                    required: ["csvColumn", "targetField"],
+                                },
+                            },
+                        },
+                        required: ["file_content", "domain", "mapping"],
+                    },
+                },
+                executor: this.validateImport.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_import_execute",
+                    description: "Execute a bulk import from CSV. Creates records in PICA based on the CSV data and field mapping. " +
+                        "Always run pica_import_validate first to check for errors. " +
+                        "Use dry_run: true to preview what would be imported without actually creating records. " +
+                        "Max 10,000 rows per import.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            file_content: {
+                                type: "string",
+                                description: "Raw CSV content",
+                            },
+                            domain: {
+                                type: "string",
+                                description: "Import domain",
+                                enum: VALID_DOMAINS,
+                            },
+                            mapping: {
+                                type: "array",
+                                description: "Column mappings (same format as pica_import_validate)",
+                                items: {
+                                    type: "object",
+                                    properties: {
+                                        csvColumn: { type: "string" },
+                                        targetField: { type: "string" },
+                                        transformType: { type: "string" },
+                                    },
+                                    required: ["csvColumn", "targetField"],
+                                },
+                            },
+                            dry_run: {
+                                type: "boolean",
+                                description: "If true, simulates the import without creating records. Recommended before first real import.",
+                            },
+                            skip_invalid_rows: {
+                                type: "boolean",
+                                description: "If true, skips rows with validation errors instead of failing the entire import.",
+                            },
+                            batch_size: {
+                                type: "number",
+                                description: "Number of rows to process per batch (default: 50, max: 1000)",
+                            },
+                        },
+                        required: ["file_content", "domain", "mapping"],
+                    },
+                },
+                executor: this.executeImport.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_import_fields",
+                    description: "Get the available target fields for an import domain. Returns field names, labels, types, " +
+                        "and whether they are required. Useful for understanding what columns a CSV should have.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            domain: {
+                                type: "string",
+                                description: "Import domain to get fields for",
+                                enum: VALID_DOMAINS,
+                            },
+                        },
+                        required: ["domain"],
+                    },
+                },
+                executor: this.getImportFields.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_import_template",
+                    description: "Get an example CSV template for an import domain. Returns a CSV string with headers " +
+                        "and example rows that can be used as a starting point.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            domain: {
+                                type: "string",
+                                description: "Import domain to get template for",
+                                enum: VALID_DOMAINS,
+                            },
+                        },
+                        required: ["domain"],
+                    },
+                },
+                executor: this.getImportTemplate.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_import_from_spotify",
+                    description: "Import works from a Spotify URL (track, album, or playlist). " +
+                        "Matches tracks against existing catalog works, enriches matches, creates new works for unmatched. " +
+                        "Two-step: omit confirm to preview, set confirm: true to execute. " +
+                        "→ then: pica_works_query (check imported works)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            spotify_url: {
+                                type: "string",
+                                description: "Any Spotify URL or URI — track, album, or playlist.",
+                            },
+                            confirm: {
+                                type: "boolean",
+                                description: "Set true to execute import. Omit or false to preview first.",
+                            },
+                        },
+                        required: ["spotify_url"],
+                    },
+                },
+                executor: this.importFromSpotify.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_import_streaming_link",
+                    description: "Import works from a Spotify or Deezer URL. Paste a track, album, or playlist link " +
+                        "and PICA will fetch all tracks and create works, recordings, people, and performer credits automatically. " +
+                        "Two-step flow: first call without confirm to preview tracks, then call with confirm: true to execute.\n\n" +
+                        "Supported platforms: Spotify (track/album/playlist), Deezer (track/album/playlist).\n" +
+                        "Apple Music and artist profile URLs are not yet supported.\n\n" +
+                        "Each imported track creates: a work (with title, ISRC, UPC, label, artwork), " +
+                        "a recording (with ISRC, linked to work), people records for artists, " +
+                        "performer credits, and multimedia links. Enrichment cascades fire automatically. " +
+                        "→ then: pica_credits_update (add songwriting credits), pica_works_inspect (check gaps)",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            url: {
+                                type: "string",
+                                description: "Spotify or Deezer URL (track, album, or playlist). " +
+                                    "Examples: https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy, " +
+                                    "https://deezer.com/playlist/1234567",
+                            },
+                            confirm: {
+                                type: "boolean",
+                                description: "Set to true to execute the import. Omit or set false to preview tracks first.",
+                            },
+                            selected_track_ids: {
+                                type: "array",
+                                items: { type: "string" },
+                                description: "Optional: external IDs of specific tracks to import (from the preview). " +
+                                    "If omitted, all non-duplicate tracks are imported.",
+                            },
+                        },
+                        required: ["url"],
+                    },
+                },
+                executor: this.importStreamingLink.bind(this),
+            },
+        ];
+    }
+    async analyzeImport(args) {
+        const result = await this.pica.imports.analyze({
+            fileContent: args.file_content,
+            domain: args.domain,
+        });
+        const parsed = result.parsed;
+        const mappingCount = Object.keys(result.analysis?.mappings || {}).length;
+        return formatSuccess(`CSV analyzed: ${parsed.totalRows} rows, ${parsed.headers.length} columns. ` +
+            `${mappingCount} columns auto-mapped. ` +
+            `Review the mappings and run pica_import_validate to check for errors.`, {
+            headers: parsed.headers,
+            totalRows: parsed.totalRows,
+            sampleRows: parsed.rows.slice(0, 3),
+            mappings: result.analysis?.mappings,
+            suggestions: result.analysis?.suggestions,
+        });
+    }
+    async validateImport(args) {
+        const result = await this.pica.imports.validate({
+            domain: args.domain,
+            fileContent: args.file_content,
+            mapping: args.mapping,
+        });
+        if (result.valid) {
+            return formatSuccess(`All ${result.totalRowCount} rows are valid. Ready to import with pica_import_execute.`, {
+                validRowCount: result.validRowCount,
+                totalRowCount: result.totalRowCount,
+            });
+        }
+        return formatSuccess(`Validation: ${result.validRowCount}/${result.totalRowCount} rows valid, ` +
+            `${result.invalidRowCount} invalid. ` +
+            `Fix the errors or use skip_invalid_rows: true when importing.`, {
+            valid: result.valid,
+            validRowCount: result.validRowCount,
+            invalidRowCount: result.invalidRowCount,
+            totalRowCount: result.totalRowCount,
+            errorsByType: result.errorsByType,
+            errors: result.errors.slice(0, 20),
+        });
+    }
+    async executeImport(args) {
+        const result = await this.pica.imports.execute({
+            domain: args.domain,
+            fileContent: args.file_content,
+            mapping: args.mapping,
+            options: {
+                dryRun: args.dry_run ?? false,
+                skipInvalidRows: args.skip_invalid_rows ?? false,
+                batchSize: args.batch_size,
+            },
+        });
+        const prefix = result.dryRun ? "[DRY RUN] " : "";
+        return formatSuccess(`${prefix}Import complete: ${result.importedCount} created, ` +
+            `${result.updatedCount} updated, ${result.skippedCount} skipped. ` +
+            `${result.errors.length} errors.`, {
+            importedCount: result.importedCount,
+            updatedCount: result.updatedCount,
+            skippedCount: result.skippedCount,
+            dryRun: result.dryRun,
+            errors: result.errors.length > 0 ? result.errors.slice(0, 10) : undefined,
+            createdRecords: result.createdRecords.length <= 20
+                ? result.createdRecords
+                : `${result.createdRecords.length} records (showing first 20)`,
+            summary: result.summary,
+        });
+    }
+    async getImportFields(args) {
+        const fields = await this.pica.imports.getFields(args.domain);
+        return formatAsText({
+            domain: args.domain,
+            fields,
+        });
+    }
+    async getImportTemplate(args) {
+        const csvContent = await this.pica.imports.getTemplate(args.domain);
+        return formatSuccess(`Template CSV for "${args.domain}" import. Use this as a starting point.`, { csvContent });
+    }
+    async importFromSpotify(args) {
+        const spotifyUrl = args.spotify_url;
+        if (!spotifyUrl) {
+            return {
+                content: [{ type: "text", text: "Error: spotify_url is required" }],
+                isError: true,
+            };
+        }
+        try {
+            if (args.confirm) {
+                const result = await this.pica.enrichment.spotifyUrlExecute(spotifyUrl);
+                const data = result.data ?? result;
+                return formatSuccess(`Spotify import complete: ${data.worksCreated ?? 0} works created, ` +
+                    `${data.worksEnriched ?? data.enrichResults?.length ?? 0} works enriched, ` +
+                    `${data.duplicatesSkipped ?? 0} duplicates skipped`, data);
+            }
+            const result = await this.pica.enrichment.spotifyUrlPreview(spotifyUrl);
+            const data = result.data ?? result;
+            const trackCount = data.tracks?.length ?? 0;
+            const newCount = data.newTracks?.length ?? 0;
+            const dupCount = data.duplicates?.length ?? 0;
+            return formatSuccess(`Spotify preview: ${trackCount} tracks found. ` +
+                `${newCount} new (will be created), ${dupCount} already in catalog (will be enriched). ` +
+                `Call again with confirm: true to execute.`, data);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Spotify import failed: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async importStreamingLink(args) {
+        const url = args.url;
+        if (!url) {
+            return {
+                content: [{ type: "text", text: "Error: url is required" }],
+                isError: true,
+            };
+        }
+        try {
+            if (args.confirm) {
+                // Execute import
+                const result = await this.pica.imports.streamingLinkImport(url, args.selected_track_ids);
+                // Generate completion hints by sampling the first created work
+                const hints = [];
+                if (result.workIds?.length > 0) {
+                    try {
+                        const sample = await this.pica.health.getWorkCompleteness(result.workIds[0]);
+                        hints.push(...mapGapsToHints(sample?.gaps || sample?.missing || []));
+                    }
+                    catch {
+                        // Completeness check is best-effort — don't fail the import
+                    }
+                    // Hint about songwriting credits for streaming imports
+                    // (streaming platforms only provide performer credits, not writers)
+                    if (!hints.some((h) => h.gap.includes("credit"))) {
+                        hints.push({
+                            gap: "no_songwriting_credits",
+                            suggestion: "Add songwriting credits — streaming imports only include performer credits",
+                            count: result.worksCreated,
+                            severity: "critical",
+                        });
+                    }
+                }
+                return formatSuccess(`Streaming import complete: ${result.worksCreated} works, ` +
+                    `${result.recordingsCreated} recordings, ${result.peopleCreated} people, ` +
+                    `${result.creditsCreated} credits created. ` +
+                    `${result.duplicatesSkipped} duplicates skipped.`, {
+                    worksCreated: result.worksCreated,
+                    recordingsCreated: result.recordingsCreated,
+                    peopleCreated: result.peopleCreated,
+                    creditsCreated: result.creditsCreated,
+                    multimediaLinked: result.multimediaLinked,
+                    duplicatesSkipped: result.duplicatesSkipped,
+                    workIds: result.workIds,
+                }, hints);
+            }
+            // Preview mode
+            const preview = await this.pica.imports.streamingLinkPreview(url);
+            const trackSummary = preview.newTracks
+                .slice(0, 10)
+                .map((t) => `  - ${t.title} — ${t.artists.map((a) => a.name).join(", ")}${t.isrc ? ` [${t.isrc}]` : ""}`)
+                .join("\n");
+            const dupSummary = preview.duplicates.length > 0
+                ? `\n\n${preview.duplicates.length} duplicates found (will be skipped):\n` +
+                    preview.duplicates
+                        .slice(0, 5)
+                        .map((d) => `  - "${d.track.title}" matches "${d.existingTitle}" (${d.matchType})`)
+                        .join("\n")
+                : "";
+            return formatSuccess(`Found ${preview.tracks.length} tracks from ${preview.source.platform} ${preview.source.type}. ` +
+                `${preview.newTracks.length} new, ${preview.duplicates.length} duplicates.\n\n` +
+                `New tracks:\n${trackSummary}` +
+                (preview.newTracks.length > 10
+                    ? `\n  ... and ${preview.newTracks.length - 10} more`
+                    : "") +
+                dupSummary +
+                `\n\nTo import, call again with confirm: true.`, {
+                source: preview.source,
+                totalTracks: preview.tracks.length,
+                newTrackCount: preview.newTracks.length,
+                duplicateCount: preview.duplicates.length,
+                newTracks: preview.newTracks.map((t) => ({
+                    title: t.title,
+                    artists: t.artists.map((a) => a.name),
+                    isrc: t.isrc,
+                    externalId: t.externalId,
+                })),
+                duplicates: preview.duplicates.map((d) => ({
+                    title: d.track.title,
+                    existingTitle: d.existingTitle,
+                    existingWorkId: d.existingWorkId,
+                    matchType: d.matchType,
+                })),
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Streaming import failed: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/tools/import.js.map

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

package/dist/tools/index.d.ts

@@ -2,47 +2,93 @@
  * Tool Registry for MCP Server
  * Manages all available tools that AI assistants can call
  */
-import { PicaClient } from "../pica-sdk.js";
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ServerConfig } from "../config.js";
+import { McpAuditLogger, type CallerContext } from "@withpica/mcp-utils";
 export interface ToolDefinition {
-  name: string;
-  description: string;
-  inputSchema: {
-    type: string;
-    properties: Record<string, any>;
-    required?: string[];
-    additionalProperties?: boolean;
-  };
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, any>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+    _meta?: {
+        ui?: {
+            resourceUri: string;
+        };
+        "ui/resourceUri"?: string;
+        [key: string]: unknown;
+    };
 }
+export type ToolCategory = "catalog" | "enrichment" | "business" | "discovery" | "media" | "comms" | "settings";
+export interface ToolMetadata {
+    category: ToolCategory;
+    risk: "safe" | "mutating" | "destructive";
+    retry_safe: boolean;
+    display_name: string;
+    credits_required?: number;
+}
+/**
+ * Build a tool description with metadata injected.
+ * Format: "[category] original description"
+ */
+export declare function injectMetadataIntoDescription(description: string, metadata: ToolMetadata): string;
+export declare const CATEGORY_DISPLAY: Record<ToolCategory, string>;
 export interface ToolResult {
-  content: Array<{
-    type: string;
-    text: string;
-  }>;
-  structuredContent?: Record<string, unknown>;
-  isError?: boolean;
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
 }
 export type ToolExecutor = (args: Record<string, any>) => Promise<any>;
 export declare class ToolRegistry {
-  private tools;
-  private pica;
-  constructor(pica: PicaClient);
-  /**
-   * Register all available tools
-   */
-  private registerAllTools;
-  private static readonly DESTRUCTIVE_PATTERNS;
-  private static readonly MUTATING_PATTERNS;
-  private static readonly SAFE_OVERRIDES;
-  private static readonly DESTRUCTIVE_PREFIX;
-  private static readonly MUTATING_PREFIX;
-  private classifyTool;
-  /**
-   * List all available tools with write-safety prefixes injected
-   */
-  listTools(): ToolDefinition[];
-  /**
-   * Execute a tool by name
-   */
-  executeTool(name: string, args: Record<string, any>): Promise<any>;
+    private tools;
+    private pica;
+    private config?;
+    private reinitializeCallback?;
+    private signOutCallback?;
+    private auditLogger?;
+    private callerContext;
+    constructor(pica: PicaClient | null, config?: ServerConfig, reinitializeCallback?: (apiKey: string) => void, callerContext?: CallerContext, signOutCallback?: () => void);
+    setAuditLogger(logger: McpAuditLogger): void;
+    setCallerContext(context: CallerContext): void;
+    /**
+     * Register all available tools
+     */
+    private registerAllTools;
+    private static readonly DESTRUCTIVE_PATTERNS;
+    private static readonly MUTATING_PATTERNS;
+    private static readonly SAFE_OVERRIDES;
+    private classifyTool;
+    /**
+     * List all available tools with write-safety prefixes injected.
+     * When discoveryMode is enabled, only the 5 handshake-visible tools are returned.
+     * All other tools remain registered and callable via pica_execute.
+     */
+    listTools(): ToolDefinition[];
+    /**
+     * Build a human-readable preview of what a destructive operation will affect.
+     */
+    private buildDestructivePreview;
+    /**
+     * Sanitize tool parameters for audit logging.
+     * Strips confirmation tokens and truncates large string values.
+     */
+    private sanitizeParams;
+    /**
+     * Execute a tool by name
+     */
+    executeTool(name: string, args: Record<string, any>): Promise<any>;
 }
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA+C5C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvE,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAGX;IACF,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAM5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+QxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAM1C;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CA4BvC;IAGF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAkBnC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CACoK;IAE9M,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAC8G;IAErJ,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,SAAS,IAAI,cAAc,EAAE;IAoB7B;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CAgBzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA+C/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAU5C,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE;YACH,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,WAAW,GACX,OAAO,GACP,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,GACrB,MAAM,CAKR;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAQzD,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvE,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAOX;IACF,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,oBAAoB,CAAC,CAA2B;IACxD,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,WAAW,CAAC,CAAiB;IACrC,OAAO,CAAC,aAAa,CAAgB;gBAGnC,IAAI,EAAE,UAAU,GAAG,IAAI,EACvB,MAAM,CAAC,EAAE,YAAY,EACrB,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAC/C,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,MAAM,IAAI;IAc9B,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI5C,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAI9C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8SxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAM1C;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CA4BvC;IAGF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAanC;IAEH,OAAO,CAAC,YAAY;IAapB;;;;OAIG;IACH,SAAS,IAAI,cAAc,EAAE;IAyF7B;;OAEG;YACW,uBAAuB;IAgHrC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;CA+KzE"}