@slashfi/agents-sdk 0.24.2 → 0.24.3

package/dist/cjs/build.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Build Agents
+ *
+ * Scans a directory for agent definitions and generates a registry file.
+ *
+ * Convention:
+ * - Agent directories start with `@` (e.g., `@my-agent`)
+ * - Each agent has:
+ *   - `entrypoint.md` - System prompt
+ *   - `agent.config.ts` - Configuration (exports default AgentConfig)
+ *   - `*.tool.ts` - Tool definitions (exports `{toolName}Tool`)
+ *
+ * @example
+ * ```typescript
+ * // scripts/build-agents.ts
+ * import { buildAgents } from '@slashfi/agents-sdk';
+ *
+ * await buildAgents({
+ *   agentsDir: './src/agents',
+ *   outFile: './src/agents/_generated-registry.ts',
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgents = buildAgents;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Convert kebab-case to camelCase.
+ */
+function toCamelCase(str) {
+    return str
+        .split("-")
+        .map((part, i) => i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+/**
+ * Escape a string for use in a JavaScript string literal.
+ */
+function escapeString(str, quote) {
+    return str
+        .replace(/\\/g, "\\\\")
+        .replace(new RegExp(quote, "g"), `\\${quote}`)
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+}
+/**
+ * Build agents from a directory.
+ *
+ * Scans the given directory for agent folders (starting with `@`) and generates
+ * a TypeScript file that creates and populates an agent registry.
+ */
+async function buildAgents(options) {
+    const { agentsDir, outFile, sdkImport = "@slashfi/agents-sdk", defaultVisibility = "internal", doubleQuotes = false, } = options;
+    const q = doubleQuotes ? '"' : "'";
+    const agents = [];
+    const skipped = [];
+    // Find all agent directories (start with @)
+    const agentDirs = (0, node_fs_1.readdirSync)(agentsDir).filter((name) => {
+        if (!name.startsWith("@"))
+            return false;
+        try {
+            const stat = (0, node_fs_1.statSync)((0, node_path_1.join)(agentsDir, name));
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    const imports = [];
+    const registrations = [];
+    const exportItems = [];
+    for (const agentDir of agentDirs) {
+        const agentPath = (0, node_path_1.join)(agentsDir, agentDir);
+        const entrypointPath = (0, node_path_1.join)(agentPath, "entrypoint.md");
+        const configPath = (0, node_path_1.join)(agentPath, "agent.config.ts");
+        // Check if required files exist
+        try {
+            (0, node_fs_1.statSync)(entrypointPath);
+            (0, node_fs_1.statSync)(configPath);
+        }
+        catch {
+            skipped.push(agentDir);
+            continue;
+        }
+        // Read entrypoint content
+        const entrypoint = (0, node_fs_1.readFileSync)(entrypointPath, "utf-8");
+        // Find tool files
+        const toolFiles = (0, node_fs_1.readdirSync)(agentPath).filter((f) => f.endsWith(".tool.ts"));
+        // Generate variable name from directory (e.g., @product-applications -> productApplications)
+        const varName = toCamelCase(agentDir.slice(1));
+        // Add config import
+        imports.push(`import ${varName}Config from ${q}./${agentDir}/agent.config.js${q};`);
+        // Add tool imports and collect tool info
+        const toolEntries = [];
+        for (const toolFile of toolFiles) {
+            const baseName = toolFile.replace(".tool.ts", "");
+            // Convert kebab-case to camelCase for JS variable: get-status -> getStatusTool
+            const toolVarName = `${toCamelCase(baseName)}Tool`;
+            // Tool name is just the filename (kebab-case): get-status
+            const toolName = baseName;
+            imports.push(`import { ${toolVarName} } from ${q}./${agentDir}/${toolFile.replace(".ts", ".js")}${q};`);
+            toolEntries.push({ varName: toolVarName, name: toolName });
+        }
+        // Read config to get the path override if specified
+        const configContent = (0, node_fs_1.readFileSync)(configPath, "utf-8");
+        const pathMatch = configContent.match(/path:\s*['"]([^'"]+)['"]/);
+        const registeredPath = pathMatch ? pathMatch[1] : agentDir;
+        // Generate tools array with name override
+        const toolsArray = toolEntries
+            .map((t) => `{ ...${t.varName}, name: ${q}${t.name}${q} }`)
+            .join(", ");
+        // Generate agent definition
+        const entrypointEscaped = escapeString(entrypoint, q);
+        registrations.push(`
+const ${varName}Agent = defineAgent({
+  path: ${q}${registeredPath}${q},
+  entrypoint: ${q}${entrypointEscaped}${q},
+  config: ${varName}Config,
+  tools: [${toolsArray}],
+  visibility: ${q}${defaultVisibility}${q},
+});
+agentRegistry.register(${varName}Agent);`);
+        exportItems.push(`  ${varName}: ${varName}Agent,`);
+        agents.push(registeredPath);
+    }
+    const output = `/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ * Generated by buildAgents from ${sdkImport}
+ *
+ * This file bundles agent entrypoints at build time.
+ * Tool names are derived from filenames (kebab-case).
+ */
+
+import { createAgentRegistry, defineAgent } from ${q}${sdkImport}${q};
+
+${imports.join("\n")}
+
+// Create registry
+export const agentRegistry = createAgentRegistry({
+  defaultVisibility: ${q}${defaultVisibility}${q},
+});
+
+// Register agents
+${registrations.join("\n")}
+
+// Export agents
+export const agents = {
+${exportItems.join("\n")}
+};
+`;
+    (0, node_fs_1.writeFileSync)(outFile, output);
+    return {
+        agentCount: agents.length,
+        agents,
+        skipped,
+        outFile,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/cjs/build.js.map

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

package/dist/cjs/callback/index.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Agent Callback — Deferred call_agent execution with triggers.
+ *
+ * An agent_callback is a call_agent command with an optional trigger.
+ * When the trigger fires (e.g., user submits a form), template references
+ * like {{trigger.variable_name}} are resolved with the trigger's values
+ * and the call_agent command is executed.
+ *
+ * This module provides the unopinionated contract:
+ * - Trigger schema (extensible discriminated union)
+ * - Template resolution
+ * - Store interface
+ * - Validation utilities
+ *
+ * No platform-specific code (no Slack, no CockroachDB, no Atlas).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCallbackTemplates = resolveCallbackTemplates;
+exports.validateCallbackTemplates = validateCallbackTemplates;
+// ---------------------------------------------------------------------------
+// Template Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve {{trigger.variable}} references in an object tree.
+ * Scans all string values and replaces {{trigger.x}} with the
+ * corresponding value from triggerValues.
+ *
+ * Unresolved references are left as-is.
+ */
+function resolveCallbackTemplates(obj, triggerValues) {
+    if (typeof obj === 'string') {
+        return obj.replace(/\{\{trigger\.(\w+)\}\}/g, (_match, varName) => {
+            return triggerValues[varName] ?? `{{trigger.${varName}}}`;
+        });
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => resolveCallbackTemplates(item, triggerValues));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, val] of Object.entries(obj)) {
+            result[key] = resolveCallbackTemplates(val, triggerValues);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Validate that all {{trigger.x}} references in a callback have
+ * corresponding variables in the provided set.
+ * Returns array of unresolved variable names, or empty if valid.
+ */
+function validateCallbackTemplates(callback, knownVariables) {
+    const definedVars = new Set(knownVariables);
+    const referencedVars = [];
+    const scanForRefs = (obj) => {
+        if (typeof obj === 'string') {
+            const matches = obj.matchAll(/\{\{trigger\.(\w+)\}\}/g);
+            for (const match of matches) {
+                referencedVars.push(match[1]);
+            }
+        }
+        else if (Array.isArray(obj)) {
+            obj.forEach(scanForRefs);
+        }
+        else if (obj !== null && typeof obj === 'object') {
+            Object.values(obj).forEach(scanForRefs);
+        }
+    };
+    scanForRefs(callback);
+    return referencedVars.filter((v) => !definedVars.has(v));
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/callback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/callback/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AA+FH,4DAoBC;AAOD,8DAuBC;AA7DD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,GAAM,EACN,aAAqC;IAErC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE;YACxE,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,OAAO,IAAI,CAAC;QAC5D,CAAC,CAAM,CAAC;IACV,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAM,CAAC;IAC/E,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CACvC,QAAiC,EACjC,cAAwB;IAExB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,MAAM,WAAW,GAAG,CAAC,GAAY,EAAQ,EAAE;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,GAA8B,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC;IAEF,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEtB,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/cjs/client.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Agent Client
+ *
+ * Creates a typed client from a SerializedAgentDefinition.
+ * The client spawns (or connects to) the MCP server and proxies
+ * tool calls via JSON-RPC.
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from '@slashfi/agents-sdk';
+ * import definition from './agents/notion/definition.json';
+ *
+ * const client = createClient(definition, {
+ *   env: { NOTION_TOKEN: process.env.NOTION_TOKEN },
+ * });
+ *
+ * const result = await client.call('API-post-search', { query: 'meeting notes' });
+ * await client.close();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+const node_child_process_1 = require("node:child_process");
+class McpStdioClient {
+    definition;
+    proc = null;
+    messageId = 0;
+    buffer = "";
+    pending = new Map();
+    initialized = false;
+    initPromise = null;
+    serverCommand;
+    env;
+    timeout;
+    constructor(definition, options = {}) {
+        this.definition = definition;
+        this.serverCommand = options.serverCommand ?? definition.serverSource ?? "";
+        this.env = options.env ?? {};
+        this.timeout = options.timeout ?? 30000;
+        if (!this.serverCommand) {
+            throw new Error(`No server command for agent "${definition.path}". Set serverSource in the definition or pass serverCommand in options.`);
+        }
+    }
+    tools() {
+        return this.definition.tools;
+    }
+    isConnected() {
+        return this.proc !== null && !this.proc.killed;
+    }
+    async call(toolName, input = {}) {
+        // Validate tool exists
+        const tool = this.definition.tools.find((t) => t.name === toolName);
+        if (!tool) {
+            const available = this.definition.tools.map((t) => t.name).join(", ");
+            throw new Error(`Tool "${toolName}" not found. Available: ${available}`);
+        }
+        // Ensure connected + initialized
+        await this.ensureInitialized();
+        // Send tools/call
+        const result = await this.sendRequest("tools/call", {
+            name: toolName,
+            arguments: input,
+        });
+        // MCP tools/call returns { content: [{ type, text }] }
+        const resultObj = result;
+        if (resultObj && typeof resultObj === "object" && "content" in resultObj) {
+            const content = resultObj.content;
+            if (Array.isArray(content) && content.length > 0) {
+                const first = content[0];
+                if (first.type === "text") {
+                    try {
+                        return JSON.parse(first.text);
+                    }
+                    catch {
+                        return first.text;
+                    }
+                }
+                return first;
+            }
+        }
+        return result;
+    }
+    close() {
+        if (this.proc) {
+            this.proc.kill();
+            this.proc = null;
+        }
+        this.initialized = false;
+        this.initPromise = null;
+        // Reject all pending
+        for (const req of Array.from(this.pending.values())) {
+            clearTimeout(req.timer);
+            req.reject(new Error("Client closed"));
+        }
+        this.pending.clear();
+    }
+    // ── Private ──
+    async ensureInitialized() {
+        if (this.initialized)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.connect();
+        await this.initPromise;
+        this.initialized = true;
+    }
+    async connect() {
+        const parts = this.serverCommand.split(/\s+/);
+        this.proc = (0, node_child_process_1.spawn)(parts[0], parts.slice(1), {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, ...this.env },
+        });
+        this.proc.stdout?.on("data", (chunk) => this.onData(chunk));
+        this.proc.on("error", (err) => {
+            for (const req of Array.from(this.pending.values())) {
+                clearTimeout(req.timer);
+                req.reject(err);
+            }
+            this.pending.clear();
+        });
+        // Initialize handshake
+        await this.sendRequest("initialize", {
+            protocolVersion: "2024-11-05",
+            capabilities: {},
+            clientInfo: { name: "agents-sdk-client", version: "1.0.0" },
+        });
+        // Send initialized notification
+        this.sendNotification("notifications/initialized");
+    }
+    sendRequest(method, params = {}) {
+        return new Promise((resolve, reject) => {
+            const id = ++this.messageId;
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Timeout after ${this.timeout}ms calling ${method}`));
+            }, this.timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            const msg = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+            this.proc?.stdin?.write(`${msg}\n`);
+        });
+    }
+    sendNotification(method, params) {
+        const msg = JSON.stringify({
+            jsonrpc: "2.0",
+            method,
+            ...(params ? { params } : {}),
+        });
+        this.proc?.stdin?.write(`${msg}\n`);
+    }
+    onData(chunk) {
+        this.buffer += chunk.toString();
+        const lines = this.buffer.split("\n");
+        this.buffer = lines.pop() || "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed.id != null && this.pending.has(parsed.id)) {
+                    const req = this.pending.get(parsed.id);
+                    if (!req)
+                        continue;
+                    this.pending.delete(parsed.id);
+                    clearTimeout(req.timer);
+                    if (parsed.error) {
+                        req.reject(new Error(JSON.stringify(parsed.error)));
+                    }
+                    else {
+                        req.resolve(parsed.result);
+                    }
+                }
+            }
+            catch {
+                // ignore non-JSON lines (stderr leakage, etc.)
+            }
+        }
+    }
+}
+// ============================================
+// Factory
+// ============================================
+/**
+ * Create an agent client from a serialized definition.
+ *
+ * The client lazily spawns the MCP server on first call and
+ * proxies tool invocations via JSON-RPC over stdio.
+ */
+function createClient(definition, options) {
+    return new McpStdioClient(definition, options);
+}
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AAwPH,oCAKC;AA3PD,2DAA8D;AAkD9D,MAAM,cAAc;IACT,UAAU,CAA4B;IACvC,IAAI,GAAwB,IAAI,CAAC;IACjC,SAAS,GAAG,CAAC,CAAC;IACd,MAAM,GAAG,EAAE,CAAC;IACZ,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,WAAW,GAAG,KAAK,CAAC;IACpB,WAAW,GAAyB,IAAI,CAAC;IACzC,aAAa,CAAS;IACtB,GAAG,CAAqC;IACxC,OAAO,CAAS;IAExB,YACE,UAAqC,EACrC,UAA+B,EAAE;QAEjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5E,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QAExC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,CAAC,IAAI,yEAAyE,CACzH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,QAAiC,EAAE;QAEnC,uBAAuB;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,2BAA2B,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,iCAAiC;QACjC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE/B,kBAAkB;QAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAClD,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,uDAAuD;QACvD,MAAM,SAAS,GAAG,MAAwC,CAAC;QAC3D,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YACzE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;YAClC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACzB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAChC,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,KAAK,CAAC,IAAI,CAAC;oBACpB,CAAC;gBACH,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,qBAAqB;QACrB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACpD,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACxB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,gBAAgB;IAER,KAAK,CAAC,iBAAiB;QAC7B,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAE9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,WAAW,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAA,0BAAK,EAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC1C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC5B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;gBACpD,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACxB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YACnC,eAAe,EAAE,YAAY;YAC7B,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE;SAC5D,CAAC,CAAC;QAEH,gCAAgC;QAChC,IAAI,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,CAAC;IACrD,CAAC;IAEO,WAAW,CACjB,MAAc,EACd,SAAkC,EAAE;QAEpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;YAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,OAAO,cAAc,MAAM,EAAE,CAAC,CAAC,CAAC;YACzE,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAEjD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,CACtB,MAAc,EACd,MAAgC;QAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YACzB,OAAO,EAAE,KAAK;YACd,MAAM;YACN,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAEO,MAAM,CAAC,KAAa;QAC1B,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACnC,IAAI,MAAM,CAAC,EAAE,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;oBACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACxC,IAAI,CAAC,GAAG;wBAAE,SAAS;oBACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC/B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACxB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACtD,CAAC;yBAAM,CAAC;wBACN,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,+CAA+C;AAC/C,UAAU;AACV,+CAA+C;AAE/C;;;;;GAKG;AACH,SAAgB,YAAY,CAC1B,UAAqC,EACrC,OAA6B;IAE7B,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}