@4da/mcp-server 4.0.0 → 4.1.0

package/dist/schema-registry.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
 /**
  * Schema Registry for Dynamic Context Discovery
  *
@@ -5,144 +6,248 @@
  * - Returning only one-liner summaries in list_tools
  * - Storing full schemas as MCP Resources (lazy-loaded)
  *
+ * Also provides category/tag metadata for tool discovery and filtering.
+ *
  * Full schemas available at: 4da://schema/{tool_name}
+ * Category manifest at: 4da://categories
  */
 /**
- * Slim tool registry - one-liner descriptions only
- * Full schemas are stored in schemas/*.json and exposed as MCP Resources
+ * Slim tool registry — one-liner descriptions + category/tag metadata.
+ * Full schemas are stored in schemas/*.json and exposed as MCP Resources.
  */
 export const TOOL_REGISTRY = {
     // Core Tools
     get_relevant_content: {
         summary: "Query filtered content by relevance, source, time",
         schemaFile: "get-relevant-content.json",
+        category: "core",
+        tags: ["content", "feed", "relevance", "filter", "query"],
     },
     get_context: {
         summary: "Get user's interests, tech stack, learned affinities",
         schemaFile: "get-context.json",
+        category: "core",
+        tags: ["context", "interests", "tech-stack", "profile"],
     },
     explain_relevance: {
         summary: "Understand why an item scored the way it did",
         schemaFile: "explain-relevance.json",
+        category: "core",
+        tags: ["relevance", "scoring", "explanation", "debug"],
     },
     record_feedback: {
         summary: "Teach 4DA what you like/dislike (click, save, dismiss)",
         schemaFile: "record-feedback.json",
+        category: "core",
+        tags: ["feedback", "preference", "learning", "interaction"],
     },
-    // Superpower Tools
+    // Intelligence Tools
     score_autopsy: {
         summary: "Deep forensic analysis of relevance scores (AI-powered)",
         schemaFile: "score-autopsy.json",
+        category: "intelligence",
+        tags: ["scoring", "forensic", "analysis", "ai", "debug"],
     },
     trend_analysis: {
         summary: "Statistical patterns, anomalies, and predictions (AI-powered)",
         schemaFile: "trend-analysis.json",
+        category: "intelligence",
+        tags: ["trends", "patterns", "predictions", "ai", "statistics"],
     },
     daily_briefing: {
         summary: "Executive summary of discoveries (AI-powered)",
         schemaFile: "daily-briefing.json",
+        category: "intelligence",
+        tags: ["briefing", "summary", "daily", "ai", "digest"],
     },
     context_analysis: {
         summary: "Optimize your context for better relevance (AI-powered)",
         schemaFile: "context-analysis.json",
-    },
-    source_health: {
-        summary: "Diagnose source fetching and data quality issues",
-        schemaFile: "source-health.json",
+        category: "intelligence",
+        tags: ["context", "optimization", "relevance", "ai"],
     },
     topic_connections: {
         summary: "Build knowledge graphs from content (AI-powered)",
         schemaFile: "topic-connections.json",
+        category: "intelligence",
+        tags: ["topics", "knowledge-graph", "connections", "ai"],
+    },
+    get_actionable_signals: {
+        summary: "Classify content into actionable signals with priority levels",
+        schemaFile: "get-actionable-signals.json",
+        category: "intelligence",
+        tags: ["signals", "priority", "actionable", "classification"],
+    },
+    signal_chains: {
+        summary: "Get causal signal chains connecting related events over time",
+        schemaFile: "signal-chains.json",
+        category: "intelligence",
+        tags: ["signals", "causal", "chains", "temporal"],
+    },
+    semantic_shifts: {
+        summary: "Detect narrative shifts in topics you follow",
+        schemaFile: "semantic-shifts.json",
+        category: "intelligence",
+        tags: ["narrative", "shifts", "topics", "detection"],
+    },
+    attention_report: {
+        summary: "Analyze attention allocation vs codebase needs",
+        schemaFile: "attention-report.json",
+        category: "intelligence",
+        tags: ["attention", "allocation", "codebase", "analysis"],
+    },
+    // Diagnostic Tools
+    source_health: {
+        summary: "Diagnose source fetching and data quality issues",
+        schemaFile: "source-health.json",
+        category: "diagnostic",
+        tags: ["sources", "health", "fetching", "quality"],
     },
     config_validator: {
         summary: "Validate configuration and detect issues",
         schemaFile: "config-validator.json",
+        category: "diagnostic",
+        tags: ["config", "validation", "settings", "health"],
     },
     llm_status: {
         summary: "Check LLM/Ollama configuration and availability",
         schemaFile: "llm-status.json",
+        category: "diagnostic",
+        tags: ["llm", "ollama", "status", "availability"],
     },
-    get_actionable_signals: {
-        summary: "Classify content into actionable signals with priority levels",
-        schemaFile: "get-actionable-signals.json",
-    },
-    // Innovation Feature Tools
+    // Knowledge & Health Tools
     export_context_packet: {
         summary: "Generate portable context packet for session handoff",
         schemaFile: "export-context.json",
+        category: "knowledge",
+        tags: ["export", "context", "handoff", "portable"],
     },
     knowledge_gaps: {
         summary: "Detect knowledge gaps in your project dependencies",
         schemaFile: "knowledge-gaps.json",
-    },
-    signal_chains: {
-        summary: "Get causal signal chains connecting related events over time",
-        schemaFile: "signal-chains.json",
-    },
-    semantic_shifts: {
-        summary: "Detect narrative shifts in topics you follow",
-        schemaFile: "semantic-shifts.json",
+        category: "knowledge",
+        tags: ["gaps", "dependencies", "knowledge", "detection"],
     },
     reverse_mentions: {
         summary: "Find where your projects are mentioned in sources",
         schemaFile: "reverse-mentions.json",
-    },
-    attention_report: {
-        summary: "Analyze attention allocation vs codebase needs",
-        schemaFile: "attention-report.json",
+        category: "knowledge",
+        tags: ["mentions", "projects", "sources", "discovery"],
     },
     project_health: {
         summary: "Project health radar for dependency freshness and security",
         schemaFile: "project-health.json",
+        category: "knowledge",
+        tags: ["project", "health", "dependencies", "security"],
     },
     // Decision Intelligence Tools
     decision_memory: {
         summary: "Manage developer decisions (record, list, check, update, supersede)",
         schemaFile: "decision-memory.json",
+        category: "decisions",
+        tags: ["decisions", "memory", "record", "manage"],
     },
     tech_radar: {
         summary: "Generate tech radar from decisions and content signals",
         schemaFile: "tech-radar.json",
+        category: "decisions",
+        tags: ["tech-radar", "decisions", "signals", "adopt"],
     },
     check_decision_alignment: {
         summary: "Check if a technology or pattern aligns with active decisions before suggesting changes",
         schemaFile: "decision-enforcement.json",
+        category: "decisions",
+        tags: ["alignment", "decisions", "enforcement", "check"],
     },
     // Agent Autonomy Tools
     agent_memory: {
         summary: "Cross-agent persistent memory — store and recall across sessions and tools",
         schemaFile: "agent-memory.json",
+        category: "agent",
+        tags: ["agent", "memory", "persistent", "cross-session"],
     },
     agent_session_brief: {
         summary: "Tailored session startup context for AI agents — decisions, changes, memories",
         schemaFile: "agent-session-brief.json",
+        category: "agent",
+        tags: ["agent", "session", "brief", "startup"],
     },
     delegation_score: {
         summary: "AI-delegatability assessment — should the agent proceed or ask the human?",
         schemaFile: "delegation-score.json",
+        category: "agent",
+        tags: ["agent", "delegation", "autonomy", "assessment"],
     },
     // Developer DNA
     developer_dna: {
         summary: "Export your Developer DNA — tech identity, dependencies, engagement, blind spots",
         schemaFile: "developer-dna.json",
+        category: "identity",
+        tags: ["identity", "dna", "profile", "tech-stack", "export"],
     },
     // Intelligence Metabolism Tools
     autophagy_status: {
         summary: "Get intelligence metabolism status — autophagy cycles, calibration accuracy, anti-patterns",
         schemaFile: "autophagy-status.json",
+        category: "metabolism",
+        tags: ["autophagy", "metabolism", "calibration", "health"],
     },
     decision_windows: {
         summary: "View and manage decision windows — time-bounded opportunities requiring attention",
         schemaFile: "decision-windows.json",
+        category: "metabolism",
+        tags: ["decisions", "windows", "time-bounded", "opportunities"],
     },
     compound_advantage: {
         summary: "Get compound advantage score — measures intelligence leverage for decisions",
         schemaFile: "compound-advantage.json",
+        category: "metabolism",
+        tags: ["compound", "advantage", "leverage", "score"],
+    },
+    // Agent Feedback Tools
+    record_agent_feedback: {
+        summary: "Record whether agent-recommended content was used, rejected, or partially used",
+        schemaFile: "record-agent-feedback.json",
+        category: "agent",
+        tags: ["agent", "feedback", "learning", "pasifa", "scoring"],
+    },
+    get_agent_feedback_stats: {
+        summary: "Get statistics on agent recommendation usage — source usefulness, top items, trends",
+        schemaFile: "agent-feedback-stats.json",
+        category: "agent",
+        tags: ["agent", "feedback", "statistics", "analytics", "pasifa"],
+    },
+    // Synthesis Tools
+    what_should_i_know: {
+        summary: "Pre-task intelligence briefing — advisories, decisions, signals, delegation assessment",
+        schemaFile: "what-should-i-know.json",
+        category: "agent",
+        tags: ["agent", "briefing", "synthesis", "pre-task", "delegation", "advisories"],
+    },
+    // Trust & Preemption Tools
+    trust_summary: {
+        summary: "Intelligence quality metrics — precision, action rate, false positives, preemption wins",
+        schemaFile: "trust-summary.json",
+        category: "intelligence",
+        tags: ["trust", "precision", "quality", "metrics", "reliability"],
+    },
+    preemption_feed: {
+        summary: "Forward-looking alerts — signal chains, dependency risks, knowledge gaps",
+        schemaFile: "preemption-feed.json",
+        category: "intelligence",
+        tags: ["preemption", "alerts", "risks", "dependencies", "forward-looking"],
+    },
+    // Live Intelligence Tools
+    vulnerability_scan: {
+        summary: "Scan dependencies for known CVEs via OSV.dev — zero config, multi-ecosystem",
+        schemaFile: "vulnerability-scan.json",
+        category: "knowledge",
+        tags: ["security", "vulnerabilities", "cve", "dependencies", "osv", "scanning"],
     },
 };
 /**
  * Get slim tool list for list_tools response
- * Returns minimal schema (just type: object) - full schema via resources
+ * Returns minimal schema (just type: object) — full schema via resources
  */
 export function getSlimToolList() {
     return Object.entries(TOOL_REGISTRY).map(([name, info]) => ({
@@ -155,23 +260,50 @@ export function getSlimToolList() {
  * Get list of schema resources for ListResources
  */
 export function getSchemaResources() {
-    return Object.entries(TOOL_REGISTRY).map(([name, info]) => ({
+    return Object.entries(TOOL_REGISTRY).map(([name]) => ({
         uri: `4da://schema/${name}`,
         name: `${name} schema`,
         description: `Full JSON Schema for the ${name} tool`,
         mimeType: "application/json",
     }));
 }
-/**
- * Check if a tool exists
- */
+/** Check if a tool exists */
 export function hasToolSchema(toolName) {
     return toolName in TOOL_REGISTRY;
 }
-/**
- * Get schema filename for a tool
- */
+/** Get schema filename for a tool */
 export function getSchemaFilename(toolName) {
     return TOOL_REGISTRY[toolName]?.schemaFile || null;
 }
+/** Get tool names grouped by category */
+export function getToolsByCategory() {
+    const result = {};
+    for (const [name, entry] of Object.entries(TOOL_REGISTRY)) {
+        if (!result[entry.category]) {
+            result[entry.category] = [];
+        }
+        result[entry.category].push(name);
+    }
+    return result;
+}
+/** Structured category manifest for the 4da://categories resource */
+export function getCategoryManifest() {
+    const grouped = getToolsByCategory();
+    const categories = {};
+    for (const [cat, tools] of Object.entries(grouped)) {
+        categories[cat] = { tools, count: tools.length };
+    }
+    return {
+        version: "1.0.0",
+        total_tools: Object.keys(TOOL_REGISTRY).length,
+        categories,
+    };
+}
+/** Find tools matching any of the given tags */
+export function getToolsByTags(tags) {
+    const tagSet = new Set(tags.map((t) => t.toLowerCase()));
+    return Object.entries(TOOL_REGISTRY)
+        .filter(([, entry]) => entry.tags.some((t) => tagSet.has(t.toLowerCase())))
+        .map(([name]) => name);
+}
 //# sourceMappingURL=schema-registry.js.map

package/dist/schema-registry.js.map

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

package/dist/schemas/agent-feedback-stats.json

@@ -0,0 +1,14 @@
+{
+  "name": "get_agent_feedback_stats",
+  "description": "Get statistics on how agents have used 4DA recommendations.\n\nShows which sources and topics are most valuable for AI-assisted development:\n- Total recommendations: used / rejected / partially_used counts\n- By source type: which sources produce the most agent-useful content\n- Top used item IDs (most frequently recommended and accepted)\n- Recent feedback entries\n\nUse this to understand what content is actually being used by AI agents and where PASIFA scoring can be improved.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "days": {
+        "type": "number",
+        "description": "Number of days to look back (default: 30, max: 365)",
+        "default": 30
+      }
+    }
+  }
+}

package/dist/schemas/preemption-feed.json

@@ -0,0 +1,18 @@
+{
+  "name": "preemption_feed",
+  "description": "Get forward-looking intelligence alerts about upcoming risks, breaking changes, and ecosystem shifts affecting your stack.\n\nSynthesizes signal chains, dependency health alerts, and knowledge gaps into actionable preemption intelligence. Use before dependency updates or when planning work.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "urgency_filter": {
+        "type": "string",
+        "description": "Filter by minimum urgency: critical, high, medium, watch. Default: all",
+        "enum": ["critical", "high", "medium", "watch"]
+      },
+      "limit": {
+        "type": "number",
+        "description": "Maximum alerts to return. Default: 10"
+      }
+    }
+  }
+}

package/dist/schemas/record-agent-feedback.json

@@ -0,0 +1,28 @@
+{
+  "name": "record_agent_feedback",
+  "description": "Record whether content recommended by 4DA was useful in the agent's task.\n\nCall this after using get_relevant_content results to help 4DA learn what's actually valuable for AI-assisted development.\n\nOutcomes:\n- \"used\": Agent/developer used the recommended content (strong positive signal)\n- \"rejected\": Content was not useful — outdated, irrelevant, or wrong context (negative signal)\n- \"partially_used\": Some value extracted but not directly applicable (weak positive signal)\n\nThis feedback helps 4DA's PASIFA scoring system learn which content sources and topics are genuinely useful when agents recommend them.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "item_ids": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Source item IDs that were recommended (from get_relevant_content results)"
+      },
+      "outcome": {
+        "type": "string",
+        "enum": ["used", "rejected", "partially_used"],
+        "description": "Whether the agent/developer used the recommended content"
+      },
+      "context": {
+        "type": "string",
+        "description": "Brief context about why (e.g., 'recommended to developer, they found it relevant' or 'content was outdated')"
+      },
+      "session_task": {
+        "type": "string",
+        "description": "What task the agent was working on when it used this content"
+      }
+    },
+    "required": ["item_ids", "outcome"]
+  }
+}

package/dist/schemas/trust-summary.json

@@ -0,0 +1,13 @@
+{
+  "name": "trust_summary",
+  "description": "Get intelligence quality metrics — precision, action conversion rate, false positive rate, and preemption wins.\n\nReturns trust ledger data for a configurable time window. Use this to assess how reliable 4DA's signals are before acting on them.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "days": {
+        "type": "number",
+        "description": "Number of days to analyze. Default: 30"
+      }
+    }
+  }
+}

package/dist/schemas/vulnerability-scan.json

@@ -0,0 +1,26 @@
+{
+  "name": "vulnerability_scan",
+  "description": "Scan project dependencies for known vulnerabilities (CVEs) using OSV.dev.\n\nReturns severity levels, fix versions, and upgrade recommendations for npm, Rust, Python, and Go dependencies. Zero configuration — automatically detects your stack from manifest and lock files.\n\nPrivacy: only sends package names and versions (public manifest data). No code, paths, or personal data transmitted.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "project_path": {
+        "type": "string",
+        "description": "Project directory to scan. Default: current working directory."
+      },
+      "severity_filter": {
+        "type": "string",
+        "enum": ["critical", "high", "medium", "low"],
+        "description": "Only show vulnerabilities at or above this severity level."
+      },
+      "include_dev": {
+        "type": "boolean",
+        "description": "Include devDependencies in scan. Default: false."
+      },
+      "force_refresh": {
+        "type": "boolean",
+        "description": "Ignore cache and fetch fresh data from OSV.dev. Default: false."
+      }
+    }
+  }
+}

package/dist/schemas/what-should-i-know.json

@@ -0,0 +1,19 @@
+{
+  "name": "what_should_i_know",
+  "description": "Pre-task intelligence briefing. Given a task description and optional file paths, returns filtered advisories (security alerts, breaking changes), active decision windows, signal chains, relevant past decisions/memories, and a delegation assessment. Call this before starting any non-trivial task to get caught up on what matters.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "task": {
+        "type": "string",
+        "description": "Description of what you are about to work on"
+      },
+      "files": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "File paths involved in the task (optional). Improves relevance filtering."
+      }
+    },
+    "required": ["task"]
+  }
+}

package/dist/setup.d.ts

@@ -12,6 +12,7 @@
  */
 /**
  * Run the setup wizard: detect editors and write MCP configurations.
+ * @param dryRun If true, only report what would be written without modifying files.
  */
-export declare function runSetup(): void;
+export declare function runSetup(dryRun?: boolean): void;
 //# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AA6GH;;GAEG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAuB/B"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AA+HH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,UAAQ,GAAG,IAAI,CAkC7C"}

package/dist/setup.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
 /**
  * 4DA MCP Setup — Zero-friction editor configuration
  *
@@ -105,19 +106,45 @@ const editors = [
             console.log(`  Written: ${configPath}`);
         },
     },
+    {
+        name: "Windsurf",
+        detect: () => {
+            const windsurfDir = join(homedir(), ".windsurf");
+            if (existsSync(windsurfDir)) {
+                return join(windsurfDir, "mcp.json");
+            }
+            return null;
+        },
+        write: (configPath) => {
+            const config = readJsonSafe(configPath);
+            const mcpServers = (config.mcpServers || {});
+            mcpServers["4da"] = MCP_CONFIG["4da"];
+            config.mcpServers = mcpServers;
+            writeJsonFile(configPath, config);
+            console.log(`  Written: ${configPath}`);
+        },
+    },
 ];
 /**
  * Run the setup wizard: detect editors and write MCP configurations.
+ * @param dryRun If true, only report what would be written without modifying files.
  */
-export function runSetup() {
+export function runSetup(dryRun = false) {
     console.log("\n  4DA MCP Server — Setup\n");
+    if (dryRun)
+        console.log("  [DRY RUN] No files will be modified.\n");
     console.log("  Detecting editors...\n");
     let configured = 0;
     for (const editor of editors) {
         const configPath = editor.detect();
         if (configPath) {
             console.log(`  Found: ${editor.name}`);
-            editor.write(configPath);
+            if (dryRun) {
+                console.log(`  Would write: ${configPath}`);
+            }
+            else {
+                editor.write(configPath);
+            }
             configured++;
             console.log("");
         }
@@ -127,11 +154,18 @@ export function runSetup() {
         console.log("  Manual setup — add to your editor's MCP config:\n");
         console.log(`  ${JSON.stringify(MCP_CONFIG, null, 2)}\n`);
     }
-    console.log("  Done. Restart your editor to activate 4DA.\n");
+    console.log("  Done. Restart your editor to activate 4DA.");
+    console.log("");
+    console.log("  Note: This server reads data from the 4DA desktop app.");
+    console.log("  If you haven't installed it yet:");
+    console.log("    https://github.com/runyourempire/4DA/releases/latest");
+    console.log("");
+    console.log("  Run: npx @4da/mcp-server --doctor  to verify everything works.\n");
 }
 // Run directly if invoked as a script (bin entry or pnpm run setup)
 const isDirectRun = process.argv[1]?.endsWith("setup.js") || process.argv[1]?.endsWith("setup.ts");
 if (isDirectRun) {
-    runSetup();
+    const dryRun = process.argv.includes("--dry-run");
+    runSetup(dryRun);
 }
 //# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/tool-dispatch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool Dispatch Registry
+ *
+ * Map-based dispatch replacing the monolithic switch statement in index.ts.
+ * All 33 execute functions are imported once and mapped by tool name.
+ *
+ * Adding a new tool = add to this map + schema-registry + barrel export.
+ */
+import type { FourDADatabase } from "./db.js";
+/**
+ * Executor signature — all tool execute functions follow this shape.
+ * Awaiting a sync return resolves immediately, so we can await uniformly.
+ *
+ * Uses `any` for params because each tool defines its own strict param type —
+ * type safety is enforced inside each tool file, not at the dispatch boundary.
+ * (The original switch statement used `as unknown as XParams` on every call.)
+ */
+export type ToolExecutor = (db: FourDADatabase, params: any) => unknown | Promise<unknown>;
+/**
+ * Dispatch a tool call by name. Awaits uniformly (no-op for sync executors).
+ * Returns MCP-formatted response with JSON-serialized result.
+ */
+export declare function dispatchTool(name: string, db: FourDADatabase, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/** Check if a tool exists in the dispatch map */
+export declare function hasDispatchTool(name: string): boolean;
+/** Get count of registered tool executors */
+export declare function getDispatchToolCount(): number;
+//# sourceMappingURL=tool-dispatch.d.ts.map

package/dist/tool-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatch.d.ts","sourceRoot":"","sources":["../src/tool-dispatch.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2C9C;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAoE3F;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAU7D;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}