@framers/agentos 0.1.94 → 0.1.95

package/dist/emergent/EmergentToolRegistry.js

@@ -0,0 +1,546 @@
+/**
+ * @fileoverview EmergentToolRegistry — tiered lifecycle manager for emergent tools.
+ * @module @framers/agentos/emergent/EmergentToolRegistry
+ *
+ * Manages the lifecycle of emergent tools across three trust tiers:
+ *
+ * - **Session tier**: In-memory `Map`, auto-cleaned when the session ends.
+ *   Tools at this tier live only for the duration of the agent session and are
+ *   never persisted.
+ *
+ * - **Agent tier**: Persisted in SQLite via the `agentos_emergent_tools` table.
+ *   Tools at this tier are scoped to the agent that created them and survive
+ *   across sessions.
+ *
+ * - **Shared tier**: Same SQLite table, discoverable by all agents. Promotion
+ *   to shared tier requires explicit human or system approval.
+ *
+ * All state changes are logged to an in-memory audit trail (and to the
+ * `agentos_emergent_audit_log` table when a storage adapter is provided).
+ *
+ * The registry operates fully in-memory when no storage adapter is supplied,
+ * making it suitable for testing and ephemeral agents.
+ */
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_EMERGENT_CONFIG } from './types.js';
+// ============================================================================
+// TIER ORDER
+// ============================================================================
+/**
+ * Tier ordering used for promotion validation.
+ * Higher index = broader scope = higher trust.
+ */
+const TIER_ORDER = ['session', 'agent', 'shared'];
+// ============================================================================
+// EMERGENT TOOL REGISTRY
+// ============================================================================
+/**
+ * Manages the lifecycle of emergent tools across three trust tiers.
+ *
+ * The registry stores session-tier tools in an in-memory Map (keyed by tool ID)
+ * and agent/shared-tier tools in SQLite (when a storage adapter is provided) or
+ * in a separate in-memory Map as fallback.
+ *
+ * Key responsibilities:
+ * - **Registration**: Accept new tools at a given tier, enforcing config limits.
+ * - **Lookup**: Retrieve tools by ID or filter by tier with optional scope.
+ * - **Usage tracking**: Record invocations and update rolling statistics.
+ * - **Promotion / demotion**: Move tools between tiers with audit logging.
+ * - **Session cleanup**: Bulk-remove all session-scoped tools for a given session.
+ * - **Audit trail**: Log every state change for observability and debugging.
+ *
+ * @example
+ * ```ts
+ * const registry = new EmergentToolRegistry({ ...DEFAULT_EMERGENT_CONFIG, enabled: true });
+ * registry.register(tool, 'session');
+ * registry.recordUse(tool.id, { x: 1 }, { y: 2 }, true, 42);
+ * const stats = registry.getUsageStats(tool.id);
+ * ```
+ */
+export class EmergentToolRegistry {
+    /**
+     * Create a new EmergentToolRegistry.
+     *
+     * @param config - Emergent capability configuration. Missing fields are
+     *   filled from {@link DEFAULT_EMERGENT_CONFIG}.
+     * @param db - Optional SQLite storage adapter. When provided, agent and
+     *   shared tier tools are persisted to the `agentos_emergent_tools` table.
+     *   When omitted, all tiers use in-memory storage only.
+     */
+    constructor(config = {}, db) {
+        /** In-memory store for session-tier tools, keyed by tool ID. */
+        this.sessionTools = new Map();
+        /** In-memory store for agent/shared-tier tools when no DB is available. */
+        this.persistedTools = new Map();
+        /** In-memory audit log. Always populated regardless of DB availability. */
+        this.auditLog = [];
+        /** Whether `ensureSchema()` has been called and completed. */
+        this.schemaReady = false;
+        this.config = { ...DEFAULT_EMERGENT_CONFIG, ...config };
+        this.db = db;
+    }
+    // --------------------------------------------------------------------------
+    // SCHEMA
+    // --------------------------------------------------------------------------
+    /**
+     * Initialize the database schema for emergent tool persistence.
+     *
+     * Creates the `agentos_emergent_tools` and `agentos_emergent_audit_log`
+     * tables along with their indexes. Safe to call multiple times — all
+     * statements use `CREATE TABLE IF NOT EXISTS` / `CREATE INDEX IF NOT EXISTS`.
+     *
+     * This method is a no-op when no storage adapter was provided.
+     *
+     * @throws If the storage adapter's `exec` or `run` method rejects.
+     */
+    async ensureSchema() {
+        if (!this.db || this.schemaReady) {
+            return;
+        }
+        const toolsTable = `
+CREATE TABLE IF NOT EXISTS agentos_emergent_tools (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT NOT NULL,
+  input_schema TEXT NOT NULL,
+  output_schema TEXT,
+  implementation_mode TEXT NOT NULL,
+  implementation_source TEXT NOT NULL,
+  tier TEXT NOT NULL DEFAULT 'session',
+  created_by_agent TEXT NOT NULL,
+  created_by_session TEXT NOT NULL,
+  created_at BIGINT NOT NULL,
+  promoted_at BIGINT,
+  promoted_by TEXT,
+  judge_verdicts TEXT,
+  confidence_score REAL DEFAULT 0,
+  total_uses INTEGER DEFAULT 0,
+  success_count INTEGER DEFAULT 0,
+  failure_count INTEGER DEFAULT 0,
+  avg_execution_ms REAL DEFAULT 0,
+  last_used_at BIGINT,
+  is_active INTEGER DEFAULT 1
+);`;
+        const toolsTierIndex = `CREATE INDEX IF NOT EXISTS idx_emergent_tools_tier ON agentos_emergent_tools(tier, is_active);`;
+        const toolsAgentIndex = `CREATE INDEX IF NOT EXISTS idx_emergent_tools_agent ON agentos_emergent_tools(created_by_agent, tier);`;
+        const auditTable = `
+CREATE TABLE IF NOT EXISTS agentos_emergent_audit_log (
+  id TEXT PRIMARY KEY,
+  tool_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  event_data TEXT,
+  timestamp BIGINT NOT NULL
+);`;
+        const auditIndex = `CREATE INDEX IF NOT EXISTS idx_emergent_audit_tool ON agentos_emergent_audit_log(tool_id, timestamp);`;
+        // Prefer `exec` for multi-statement DDL; fall back to individual `run` calls.
+        if (this.db.exec) {
+            await this.db.exec([toolsTable, toolsTierIndex, toolsAgentIndex, auditTable, auditIndex].join('\n'));
+        }
+        else {
+            await this.db.run(toolsTable);
+            await this.db.run(toolsTierIndex);
+            await this.db.run(toolsAgentIndex);
+            await this.db.run(auditTable);
+            await this.db.run(auditIndex);
+        }
+        this.schemaReady = true;
+    }
+    // --------------------------------------------------------------------------
+    // REGISTER
+    // --------------------------------------------------------------------------
+    /**
+     * Register a new emergent tool at the given tier.
+     *
+     * Session-tier tools are stored in the in-memory session map. Agent and shared
+     * tier tools are stored in the persisted map (and will be written to SQLite on
+     * the next DB sync if a storage adapter is available).
+     *
+     * @param tool - The emergent tool to register. Must have a unique `id`.
+     * @param tier - The tier to register the tool at. The tool's `tier` property
+     *   is updated to match.
+     *
+     * @throws {Error} If the maximum tool count for the target tier is exceeded
+     *   (checked against `maxSessionTools` or `maxAgentTools` from config).
+     * @throws {Error} If a tool with the same ID is already registered.
+     */
+    register(tool, tier) {
+        // Check for duplicates across all stores.
+        if (this.sessionTools.has(tool.id) || this.persistedTools.has(tool.id)) {
+            throw new Error(`Tool "${tool.id}" is already registered.`);
+        }
+        // Enforce tier-specific limits.
+        if (tier === 'session') {
+            const sessionCount = this.sessionTools.size;
+            if (sessionCount >= this.config.maxSessionTools) {
+                throw new Error(`Session tool limit reached (${this.config.maxSessionTools}). ` +
+                    `Remove or promote existing tools before registering new ones.`);
+            }
+        }
+        else if (tier === 'agent') {
+            const agentCount = this.getByTier('agent').length;
+            if (agentCount >= this.config.maxAgentTools) {
+                throw new Error(`Agent tool limit reached (${this.config.maxAgentTools}). ` +
+                    `Remove or promote existing tools before registering new ones.`);
+            }
+        }
+        // Stamp the tier on the tool object.
+        const registered = { ...tool, tier };
+        if (tier === 'session') {
+            this.sessionTools.set(registered.id, registered);
+        }
+        else {
+            this.persistedTools.set(registered.id, registered);
+        }
+        if (this.db && this.schemaReady) {
+            this.persistToolToDb(registered).catch(() => {
+                // Best-effort persistence mirror. In-memory state remains authoritative.
+            });
+        }
+        this.logAudit(registered.id, 'register', { tier });
+    }
+    // --------------------------------------------------------------------------
+    // GET
+    // --------------------------------------------------------------------------
+    /**
+     * Retrieve a tool by its unique identifier.
+     *
+     * Searches all tiers (session first, then persisted agent/shared).
+     *
+     * @param toolId - The tool ID to look up.
+     * @returns The tool if found, or `undefined` if no tool with that ID exists.
+     */
+    get(toolId) {
+        return this.sessionTools.get(toolId) ?? this.persistedTools.get(toolId);
+    }
+    /**
+     * Remove a tool from the registry entirely.
+     *
+     * Used to roll back newly forged tools when downstream activation fails.
+     */
+    remove(toolId) {
+        const removed = this.sessionTools.delete(toolId) || this.persistedTools.delete(toolId);
+        if (removed) {
+            if (this.db && this.schemaReady) {
+                this.db
+                    .run(`DELETE FROM agentos_emergent_tools WHERE id = ?`, [toolId])
+                    .catch(() => {
+                    // Best-effort cleanup only.
+                });
+            }
+            this.logAudit(toolId, 'remove');
+        }
+        return removed;
+    }
+    // --------------------------------------------------------------------------
+    // GET BY TIER
+    // --------------------------------------------------------------------------
+    /**
+     * Get all tools registered at a specific tier, optionally filtered by scope.
+     *
+     * @param tier - The tier to query (`'session'`, `'agent'`, or `'shared'`).
+     * @param scope - Optional scope filter. When provided, results are narrowed:
+     *   - `sessionId`: Match tools whose `source` string contains the session ID.
+     *   - `agentId`: Match tools whose `createdBy` equals the agent ID.
+     * @returns An array of matching tools (may be empty).
+     */
+    getByTier(tier, scope) {
+        let tools;
+        if (tier === 'session') {
+            tools = Array.from(this.sessionTools.values());
+        }
+        else {
+            tools = Array.from(this.persistedTools.values()).filter((t) => t.tier === tier);
+        }
+        // Apply optional scope filters.
+        if (scope?.sessionId) {
+            const sid = scope.sessionId;
+            tools = tools.filter((t) => t.source.includes(sid));
+        }
+        if (scope?.agentId) {
+            const aid = scope.agentId;
+            tools = tools.filter((t) => t.createdBy === aid);
+        }
+        return tools;
+    }
+    // --------------------------------------------------------------------------
+    // RECORD USE
+    // --------------------------------------------------------------------------
+    /**
+     * Record a tool invocation, updating rolling usage statistics.
+     *
+     * Updates the tool's {@link ToolUsageStats} in place:
+     * - Increments `totalUses`.
+     * - Increments `successCount` or `failureCount` based on the `success` flag.
+     * - Recalculates `avgExecutionTimeMs` as a running average.
+     * - Recalculates `confidenceScore` as `successCount / totalUses`.
+     * - Sets `lastUsedAt` to the current ISO-8601 timestamp.
+     *
+     * @param toolId - The ID of the tool that was invoked.
+     * @param _input - The input arguments passed to the tool (logged for audit).
+     * @param _output - The output returned by the tool (logged for audit).
+     * @param success - Whether the invocation completed successfully.
+     * @param executionTimeMs - Wall-clock execution time in milliseconds.
+     *
+     * @throws {Error} If no tool with the given ID is registered.
+     */
+    recordUse(toolId, _input, _output, success, executionTimeMs) {
+        const tool = this.get(toolId);
+        if (!tool) {
+            throw new Error(`Cannot record use: tool "${toolId}" not found.`);
+        }
+        const stats = tool.usageStats;
+        const prevTotal = stats.totalUses;
+        stats.totalUses += 1;
+        if (success) {
+            stats.successCount += 1;
+        }
+        else {
+            stats.failureCount += 1;
+        }
+        // Running average: newAvg = (oldAvg * prevTotal + newValue) / newTotal
+        stats.avgExecutionTimeMs =
+            (stats.avgExecutionTimeMs * prevTotal + executionTimeMs) / stats.totalUses;
+        // Confidence is success rate.
+        stats.confidenceScore = stats.successCount / stats.totalUses;
+        stats.lastUsedAt = new Date().toISOString();
+        if (this.db && this.schemaReady) {
+            this.persistToolToDb(tool).catch(() => {
+                // Best-effort persistence mirror. Usage stats still live in memory.
+            });
+        }
+        this.logAudit(toolId, 'use', { success, executionTimeMs });
+    }
+    // --------------------------------------------------------------------------
+    // GET USAGE STATS
+    // --------------------------------------------------------------------------
+    /**
+     * Retrieve usage statistics for a registered tool.
+     *
+     * @param toolId - The tool ID to look up.
+     * @returns The tool's {@link ToolUsageStats}, or `undefined` if the tool
+     *   is not registered.
+     */
+    getUsageStats(toolId) {
+        return this.get(toolId)?.usageStats;
+    }
+    // --------------------------------------------------------------------------
+    // PROMOTE
+    // --------------------------------------------------------------------------
+    /**
+     * Promote a tool to a higher lifecycle tier.
+     *
+     * Moves the tool from its current tier to `targetTier`. If the tool was at
+     * session tier, it is removed from the session map and added to the persisted
+     * map. If a storage adapter is available and the target tier is agent or
+     * shared, the tool is persisted to the database.
+     *
+     * @param toolId - The ID of the tool to promote.
+     * @param targetTier - The target tier to promote to. Must be strictly higher
+     *   than the tool's current tier.
+     * @param approvedBy - Optional identifier of the human or system entity that
+     *   approved the promotion.
+     *
+     * @throws {Error} If the tool is not found.
+     * @throws {Error} If `targetTier` is not higher than the tool's current tier.
+     */
+    async promote(toolId, targetTier, approvedBy) {
+        const tool = this.get(toolId);
+        if (!tool) {
+            throw new Error(`Cannot promote: tool "${toolId}" not found.`);
+        }
+        const currentIndex = TIER_ORDER.indexOf(tool.tier);
+        const targetIndex = TIER_ORDER.indexOf(targetTier);
+        if (targetIndex <= currentIndex) {
+            throw new Error(`Cannot promote tool from "${tool.tier}" to "${targetTier}": ` +
+                `target tier must be strictly higher than current tier.`);
+        }
+        const previousTier = tool.tier;
+        // If moving from session to a persisted tier, migrate between maps.
+        if (previousTier === 'session') {
+            this.sessionTools.delete(toolId);
+            tool.tier = targetTier;
+            this.persistedTools.set(toolId, tool);
+        }
+        else {
+            tool.tier = targetTier;
+        }
+        // Persist to DB if adapter is available and target is a persisted tier.
+        if (this.db && this.schemaReady) {
+            await this.persistToolToDb(tool, approvedBy);
+        }
+        this.logAudit(toolId, 'promote', {
+            from: previousTier,
+            to: targetTier,
+            approvedBy: approvedBy ?? null,
+        });
+    }
+    // --------------------------------------------------------------------------
+    // DEMOTE
+    // --------------------------------------------------------------------------
+    /**
+     * Demote or deactivate a tool.
+     *
+     * Marks the tool as inactive by setting a sentinel on its usage stats
+     * (`confidenceScore` set to 0) and logs the demotion event with a reason.
+     *
+     * Inactive tools are still retrievable via `get()` but should be filtered
+     * out by callers when building tool lists for the LLM.
+     *
+     * @param toolId - The ID of the tool to demote.
+     * @param reason - Human-readable explanation for why the tool is being demoted.
+     *
+     * @throws {Error} If the tool is not found.
+     */
+    demote(toolId, reason) {
+        const tool = this.get(toolId);
+        if (!tool) {
+            throw new Error(`Cannot demote: tool "${toolId}" not found.`);
+        }
+        tool.usageStats.confidenceScore = 0;
+        // Mark as inactive via a convention property.
+        tool.isActive = false;
+        if (this.db && this.schemaReady) {
+            this.db
+                .run(`UPDATE agentos_emergent_tools SET is_active = 0 WHERE id = ?`, [toolId])
+                .catch(() => {
+                // Best-effort persistence only.
+            });
+        }
+        this.logAudit(toolId, 'demote', { reason });
+    }
+    // --------------------------------------------------------------------------
+    // CLEANUP SESSION
+    // --------------------------------------------------------------------------
+    /**
+     * Remove all session-tier tools associated with a specific session.
+     *
+     * Iterates the session map and deletes every tool whose `source` string
+     * contains the given session ID. Logs a cleanup audit event for each
+     * removed tool.
+     *
+     * @param sessionId - The session identifier to match against tool `source`
+     *   strings.
+     * @returns The number of tools removed.
+     */
+    cleanupSession(sessionId) {
+        let removedCount = 0;
+        for (const [id, tool] of this.sessionTools) {
+            if (tool.source.includes(sessionId)) {
+                this.sessionTools.delete(id);
+                if (this.db && this.schemaReady) {
+                    this.db
+                        .run(`DELETE FROM agentos_emergent_tools WHERE id = ?`, [id])
+                        .catch(() => {
+                        // Best-effort cleanup only.
+                    });
+                }
+                this.logAudit(id, 'cleanup', { sessionId });
+                removedCount += 1;
+            }
+        }
+        return removedCount;
+    }
+    // --------------------------------------------------------------------------
+    // AUDIT LOG ACCESSORS
+    // --------------------------------------------------------------------------
+    /**
+     * Retrieve audit log entries, optionally filtered by tool ID.
+     *
+     * @param toolId - When provided, only entries for this tool are returned.
+     * @returns An array of {@link AuditEntry} objects in chronological order.
+     */
+    getAuditLog(toolId) {
+        if (toolId) {
+            return this.auditLog.filter((e) => e.toolId === toolId);
+        }
+        return [...this.auditLog];
+    }
+    // --------------------------------------------------------------------------
+    // PRIVATE: logAudit
+    // --------------------------------------------------------------------------
+    /**
+     * Log an audit event to both the in-memory trail and (optionally) the database.
+     *
+     * @param toolId - The tool this event pertains to.
+     * @param eventType - Machine-readable event type string.
+     * @param data - Optional structured data to attach to the event.
+     */
+    logAudit(toolId, eventType, data) {
+        const entry = {
+            id: randomUUID(),
+            toolId,
+            eventType,
+            data,
+            timestamp: Date.now(),
+        };
+        this.auditLog.push(entry);
+        // Best-effort DB write — do not await or throw if it fails.
+        if (this.db && this.schemaReady) {
+            this.db
+                .run(`INSERT INTO agentos_emergent_audit_log (id, tool_id, event_type, event_data, timestamp)
+           VALUES (?, ?, ?, ?, ?)`, [
+                entry.id,
+                entry.toolId,
+                entry.eventType,
+                data != null ? JSON.stringify(data) : null,
+                entry.timestamp,
+            ])
+                .catch(() => {
+                // Swallow DB write errors for audit logs — the in-memory log is
+                // the authoritative source and we should not disrupt the caller.
+            });
+        }
+    }
+    // --------------------------------------------------------------------------
+    // PRIVATE: persistToolToDb
+    // --------------------------------------------------------------------------
+    /**
+     * Upsert a tool record into the `agentos_emergent_tools` SQLite table.
+     *
+     * Uses INSERT OR REPLACE to handle both initial persistence and updates
+     * after promotion.
+     *
+     * @param tool - The emergent tool to persist.
+     * @param approvedBy - Optional identifier of the promotion approver.
+     */
+    async persistToolToDb(tool, approvedBy) {
+        if (!this.db) {
+            return;
+        }
+        // Extract the session ID from the source string if present.
+        const sessionMatch = tool.source.match(/session\s+([\w-]+)/);
+        const sessionId = sessionMatch?.[1] ?? 'unknown';
+        await this.db.run(`INSERT OR REPLACE INTO agentos_emergent_tools
+       (id, name, description, input_schema, output_schema, implementation_mode,
+        implementation_source, tier, created_by_agent, created_by_session,
+        created_at, promoted_at, promoted_by, judge_verdicts, confidence_score,
+        total_uses, success_count, failure_count, avg_execution_ms, last_used_at,
+        is_active)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            tool.id,
+            tool.name,
+            tool.description,
+            JSON.stringify(tool.inputSchema),
+            JSON.stringify(tool.outputSchema),
+            tool.implementation.mode,
+            JSON.stringify(tool.implementation),
+            tool.tier,
+            tool.createdBy,
+            sessionId,
+            new Date(tool.createdAt).getTime(),
+            tool.tier === 'session' ? null : Date.now(),
+            approvedBy ?? null,
+            JSON.stringify(tool.judgeVerdicts),
+            tool.usageStats.confidenceScore,
+            tool.usageStats.totalUses,
+            tool.usageStats.successCount,
+            tool.usageStats.failureCount,
+            tool.usageStats.avgExecutionTimeMs,
+            tool.usageStats.lastUsedAt
+                ? new Date(tool.usageStats.lastUsedAt).getTime()
+                : null,
+            1,
+        ]);
+    }
+}
+//# sourceMappingURL=EmergentToolRegistry.js.map

package/dist/emergent/EmergentToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmergentToolRegistry.js","sourceRoot":"","sources":["../../src/emergent/EmergentToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA4ErD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,GAAwB,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAEvE,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,oBAAoB;IAmB/B;;;;;;;;OAQG;IACH,YAAY,SAAkC,EAAE,EAAE,EAAoB;QA3BtE,gEAAgE;QAC/C,iBAAY,GAAG,IAAI,GAAG,EAAwB,CAAC;QAEhE,2EAA2E;QAC1D,mBAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;QAElE,2EAA2E;QAC1D,aAAQ,GAAiB,EAAE,CAAC;QAQ7C,8DAA8D;QACtD,gBAAW,GAAG,KAAK,CAAC;QAY1B,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,MAAM,EAAE,CAAC;QACxD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,6EAA6E;IAC7E,SAAS;IACT,6EAA6E;IAE7E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;GAuBpB,CAAC;QAEA,MAAM,cAAc,GAAG,gGAAgG,CAAC;QACxH,MAAM,eAAe,GAAG,wGAAwG,CAAC;QAEjI,MAAM,UAAU,GAAG;;;;;;;GAOpB,CAAC;QAEA,MAAM,UAAU,GAAG,uGAAuG,CAAC;QAE3H,8EAA8E;QAC9E,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAChB,CAAC,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACjF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAClC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAC7E,WAAW;IACX,6EAA6E;IAE7E;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAkB,EAAE,IAAc;QACzC,0CAA0C;QAC1C,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;QAC9D,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAC5C,IAAI,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,MAAM,CAAC,eAAe,KAAK;oBAC/D,+DAA+D,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAClD,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK;oBAC3D,+DAA+D,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,MAAM,UAAU,GAAiB,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;QAEnD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC1C,yEAAyE;YAC3E,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,6EAA6E;IAC7E,MAAM;IACN,6EAA6E;IAE7E;;;;;;;OAOG;IACH,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,MAAM,OAAO,GACX,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzE,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC,EAAE;qBACJ,GAAG,CAAC,iDAAiD,EAAE,CAAC,MAAM,CAAC,CAAC;qBAChE,KAAK,CAAC,GAAG,EAAE;oBACV,4BAA4B;gBAC9B,CAAC,CAAC,CAAC;YACP,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6EAA6E;IAC7E,cAAc;IACd,6EAA6E;IAE7E;;;;;;;;OAQG;IACH,SAAS,CACP,IAAc,EACd,KAAgD;QAEhD,IAAI,KAAqB,CAAC;QAE1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACrD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CACvB,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,IAAI,KAAK,EAAE,SAAS,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;YAC5B,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,KAAK,EAAE,OAAO,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1B,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6EAA6E;IAC7E,aAAa;IACb,6EAA6E;IAE7E;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CACP,MAAc,EACd,MAAe,EACf,OAAgB,EAChB,OAAgB,EAChB,eAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,cAAc,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAElC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QAErB,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,uEAAuE;QACvE,KAAK,CAAC,kBAAkB;YACtB,CAAC,KAAK,CAAC,kBAAkB,GAAG,SAAS,GAAG,eAAe,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAE7E,8BAA8B;QAC9B,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC;QAE7D,KAAK,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE5C,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACpC,oEAAoE;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;IAClB,6EAA6E;IAE7E;;;;;;OAMG;IACH,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IACtC,CAAC;IAED,6EAA6E;IAC7E,UAAU;IACV,6EAA6E;IAE7E;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,OAAO,CACX,MAAc,EACd,UAAoB,EACpB,UAAmB;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,cAAc,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEnD,IAAI,WAAW,IAAI,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,CAAC,IAAI,SAAS,UAAU,KAAK;gBAC9D,wDAAwD,CACzD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;QAE/B,oEAAoE;QACpE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;YACvB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACzB,CAAC;QAED,wEAAwE;QACxE,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE;YAC/B,IAAI,EAAE,YAAY;YAClB,EAAE,EAAE,UAAU;YACd,UAAU,EAAE,UAAU,IAAI,IAAI;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,SAAS;IACT,6EAA6E;IAE7E;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAc,EAAE,MAAc;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,cAAc,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,eAAe,GAAG,CAAC,CAAC;QACpC,8CAA8C;QAC7C,IAA8C,CAAC,QAAQ,GAAG,KAAK,CAAC;QAEjE,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE;iBACJ,GAAG,CAAC,8DAA8D,EAAE,CAAC,MAAM,CAAC,CAAC;iBAC7E,KAAK,CAAC,GAAG,EAAE;gBACV,gCAAgC;YAClC,CAAC,CAAC,CAAC;QACP,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,6EAA6E;IAC7E,kBAAkB;IAClB,6EAA6E;IAE7E;;;;;;;;;;OAUG;IACH,cAAc,CAAC,SAAiB;QAC9B,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC7B,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBAChC,IAAI,CAAC,EAAE;yBACJ,GAAG,CAAC,iDAAiD,EAAE,CAAC,EAAE,CAAC,CAAC;yBAC5D,KAAK,CAAC,GAAG,EAAE;wBACV,4BAA4B;oBAC9B,CAAC,CAAC,CAAC;gBACP,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC5C,YAAY,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,6EAA6E;IAC7E,sBAAsB;IACtB,6EAA6E;IAE7E;;;;;OAKG;IACH,WAAW,CAAC,MAAe;QACzB,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,6EAA6E;IAC7E,oBAAoB;IACpB,6EAA6E;IAE7E;;;;;;OAMG;IACK,QAAQ,CAAC,MAAc,EAAE,SAAiB,EAAE,IAAc;QAChE,MAAM,KAAK,GAAe;YACxB,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM;YACN,SAAS;YACT,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B,4DAA4D;QAC5D,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE;iBACJ,GAAG,CACF;kCACwB,EACxB;gBACE,KAAK,CAAC,EAAE;gBACR,KAAK,CAAC,MAAM;gBACZ,KAAK,CAAC,SAAS;gBACf,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC1C,KAAK,CAAC,SAAS;aAChB,CACF;iBACA,KAAK,CAAC,GAAG,EAAE;gBACV,gEAAgE;gBAChE,iEAAiE;YACnE,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,2BAA2B;IAC3B,6EAA6E;IAE7E;;;;;;;;OAQG;IACK,KAAK,CAAC,eAAe,CAC3B,IAAkB,EAClB,UAAmB;QAEnB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,4DAA4D;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAEjD,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CACf;;;;;;8EAMwE,EACxE;YACE,IAAI,CAAC,EAAE;YACP,IAAI,CAAC,IAAI;YACT,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;YACjC,IAAI,CAAC,cAAc,CAAC,IAAI;YACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC;YACnC,IAAI,CAAC,IAAI;YACT,IAAI,CAAC,SAAS;YACd,SAAS;YACT,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;YAClC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC3C,UAAU,IAAI,IAAI;YAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,eAAe;YAC/B,IAAI,CAAC,UAAU,CAAC,SAAS;YACzB,IAAI,CAAC,UAAU,CAAC,YAAY;YAC5B,IAAI,CAAC,UAAU,CAAC,YAAY;YAC5B,IAAI,CAAC,UAAU,CAAC,kBAAkB;YAClC,IAAI,CAAC,UAAU,CAAC,UAAU;gBACxB,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;gBAChD,CAAC,CAAC,IAAI;YACR,CAAC;SACF,CACF,CAAC;IACJ,CAAC;CACF"}