@oobe-protocol-labs/synapse-client-sdk 1.2.2 → 2.0.0

package/dist/esm/ai/sap/registry.js

@@ -0,0 +1,515 @@
+/**
+ * @module ai/sap/registry
+ * @description SAP — Canonical capability registry for the agent sub-network.
+ *
+ * Defines the **standard capability catalog** — every protocol/method pair
+ * that SAP-registered agents can advertise. This gives the network a shared
+ * vocabulary so discovery queries are reliable and unambiguous.
+ *
+ * Capabilities follow the `protocol:method` convention (e.g. `jupiter:swap`).
+ * Each entry carries metadata: human description, category, expected I/O
+ * schema hints, and minimum version.
+ *
+ * @example
+ * ```ts
+ * import { SAPCapabilityRegistry } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const reg = SAPCapabilityRegistry.default();
+ *
+ * // List everything Jupiter supports
+ * const jupiterCaps = reg.byProtocol('jupiter');
+ *
+ * // Check if a capability ID is known
+ * const valid = reg.has('jupiter:swap');          // true
+ * const unknown = reg.has('made_up:blah');        // false
+ *
+ * // All capabilities in the 'defi' category
+ * const defi = reg.byCategory('defi');
+ *
+ * // Full catalog
+ * const all = reg.list();
+ * ```
+ *
+ * @since 1.4.0
+ */
+/* ═══════════════════════════════════════════════════════════════
+ *  Default Catalog
+ * ═══════════════════════════════════════════════════════════════ */
+const DEFAULT_CAPABILITIES = [
+    // ── Jupiter ──
+    {
+        id: 'jupiter:swap',
+        protocol: 'jupiter',
+        description: 'Execute a token swap via Jupiter aggregator',
+        category: 'defi',
+        isCritical: true,
+        input: { fields: { inputMint: 'string', outputMint: 'string', amount: 'bigint', slippageBps: 'number' } },
+        output: { fields: { txSignature: 'string', outputAmount: 'bigint' } },
+        relatedCapabilities: ['jupiter:getQuote', 'jupiter:getRoutes'],
+    },
+    {
+        id: 'jupiter:getQuote',
+        protocol: 'jupiter',
+        description: 'Get a price quote for a token swap',
+        category: 'defi',
+        input: { fields: { inputMint: 'string', outputMint: 'string', amount: 'bigint' } },
+        output: { fields: { outputAmount: 'bigint', priceImpact: 'number', routes: 'object' } },
+        relatedCapabilities: ['jupiter:swap'],
+    },
+    {
+        id: 'jupiter:getRoutes',
+        protocol: 'jupiter',
+        description: 'Get available swap routes between two tokens',
+        category: 'defi',
+        input: { fields: { inputMint: 'string', outputMint: 'string' } },
+        output: { fields: { routes: 'object' } },
+    },
+    {
+        id: 'jupiter:limitOrder',
+        protocol: 'jupiter',
+        description: 'Place a limit order via Jupiter',
+        category: 'defi',
+        input: { fields: { inputMint: 'string', outputMint: 'string', amount: 'bigint', price: 'bigint' } },
+        output: { fields: { orderId: 'string', txSignature: 'string' } },
+    },
+    {
+        id: 'jupiter:dcaCreate',
+        protocol: 'jupiter',
+        description: 'Create a DCA (dollar cost average) order',
+        category: 'defi',
+        input: { fields: { inputMint: 'string', outputMint: 'string', totalAmount: 'bigint', intervalSeconds: 'number', numOrders: 'number' } },
+        output: { fields: { dcaId: 'string', txSignature: 'string' } },
+    },
+    // ── Raydium ──
+    {
+        id: 'raydium:swap',
+        protocol: 'raydium',
+        description: 'Execute a swap via Raydium AMM',
+        category: 'defi',
+        input: { fields: { inputMint: 'string', outputMint: 'string', amount: 'bigint', slippageBps: 'number' } },
+        output: { fields: { txSignature: 'string', outputAmount: 'bigint' } },
+    },
+    {
+        id: 'raydium:getPoolInfo',
+        protocol: 'raydium',
+        description: 'Get pool info (TVL, volume, APR) from Raydium',
+        category: 'data',
+        input: { fields: { poolAddress: 'string' } },
+        output: { fields: { tvl: 'bigint', volume24h: 'bigint', apr: 'number' } },
+    },
+    {
+        id: 'raydium:addLiquidity',
+        protocol: 'raydium',
+        description: 'Add liquidity to a Raydium pool',
+        category: 'defi',
+        input: { fields: { poolAddress: 'string', amountA: 'bigint', amountB: 'bigint' } },
+        output: { fields: { txSignature: 'string', lpTokenAmount: 'bigint' } },
+    },
+    // ── Marinade ──
+    {
+        id: 'marinade:stake',
+        protocol: 'marinade',
+        description: 'Stake SOL via Marinade liquid staking',
+        category: 'defi',
+        isCritical: true,
+        input: { fields: { amount: 'bigint' } },
+        output: { fields: { txSignature: 'string', mSOLReceived: 'bigint' } },
+    },
+    {
+        id: 'marinade:unstake',
+        protocol: 'marinade',
+        description: 'Unstake mSOL to SOL',
+        category: 'defi',
+        input: { fields: { amount: 'bigint' } },
+        output: { fields: { txSignature: 'string', solReceived: 'bigint' } },
+    },
+    // ── Drift ──
+    {
+        id: 'drift:perp',
+        protocol: 'drift',
+        description: 'Open a perpetual futures position on Drift',
+        category: 'defi',
+        input: { fields: { market: 'string', direction: 'string', size: 'bigint', leverage: 'number' } },
+        output: { fields: { positionId: 'string', txSignature: 'string' } },
+    },
+    {
+        id: 'drift:getPosition',
+        protocol: 'drift',
+        description: 'Get current perpetual positions for a wallet',
+        category: 'data',
+        input: { fields: { wallet: 'string' } },
+        output: { fields: { positions: 'object' } },
+    },
+    // ── Solend / Lending ──
+    {
+        id: 'solend:lend',
+        protocol: 'solend',
+        description: 'Supply tokens to Solend lending pool',
+        category: 'defi',
+        input: { fields: { mint: 'string', amount: 'bigint' } },
+        output: { fields: { txSignature: 'string', cTokenReceived: 'bigint' } },
+    },
+    {
+        id: 'solend:borrow',
+        protocol: 'solend',
+        description: 'Borrow tokens from Solend',
+        category: 'defi',
+        input: { fields: { mint: 'string', amount: 'bigint' } },
+        output: { fields: { txSignature: 'string' } },
+    },
+    // ── Metaplex / NFT ──
+    {
+        id: 'metaplex:mint',
+        protocol: 'metaplex',
+        description: 'Mint a new NFT via Metaplex',
+        category: 'nft',
+        input: { fields: { name: 'string', uri: 'string', sellerFeeBasisPoints: 'number' } },
+        output: { fields: { mint: 'string', txSignature: 'string' } },
+    },
+    {
+        id: 'metaplex:getNFTMetadata',
+        protocol: 'metaplex',
+        description: 'Fetch NFT metadata from on-chain',
+        category: 'data',
+        input: { fields: { mint: 'string' } },
+        output: { fields: { name: 'string', uri: 'string', creators: 'object' } },
+    },
+    // ── AI / Analytics ──
+    {
+        id: 'ai:sentimentAnalysis',
+        protocol: 'ai',
+        description: 'Analyze market sentiment from social/on-chain signals',
+        category: 'ai',
+        input: { fields: { token: 'string', sources: 'object' } },
+        output: { fields: { score: 'number', confidence: 'number', signals: 'object' } },
+    },
+    {
+        id: 'ai:riskScore',
+        protocol: 'ai',
+        description: 'Compute a risk score for a wallet or protocol',
+        category: 'ai',
+        input: { fields: { target: 'string', targetType: 'string' } },
+        output: { fields: { score: 'number', factors: 'object' } },
+    },
+    {
+        id: 'ai:pricePredictor',
+        protocol: 'ai',
+        description: 'Generate short-term price predictions for a token',
+        category: 'ai',
+        input: { fields: { mint: 'string', horizonMinutes: 'number' } },
+        output: { fields: { predictions: 'object', confidence: 'number' } },
+    },
+    {
+        id: 'ai:summarize',
+        protocol: 'ai',
+        description: 'Summarize on-chain activity for a wallet or protocol',
+        category: 'ai',
+        input: { fields: { target: 'string', period: 'string' } },
+        output: { fields: { summary: 'string', metrics: 'object' } },
+    },
+    // ── Oracle ──
+    {
+        id: 'pyth:getPrice',
+        protocol: 'pyth',
+        description: 'Get real-time price feed from Pyth Network',
+        category: 'oracle',
+        isCritical: true,
+        input: { fields: { feedId: 'string' } },
+        output: { fields: { price: 'bigint', confidence: 'bigint', timestamp: 'number' } },
+    },
+    {
+        id: 'switchboard:readFeed',
+        protocol: 'switchboard',
+        description: 'Read a data feed from Switchboard oracle',
+        category: 'oracle',
+        input: { fields: { feedAddress: 'string' } },
+        output: { fields: { value: 'bigint', timestamp: 'number' } },
+    },
+    // ── Payments ──
+    {
+        id: 'payments:transfer',
+        protocol: 'payments',
+        description: 'Transfer SOL or SPL tokens to a recipient',
+        category: 'payments',
+        input: { fields: { to: 'string', amount: 'bigint', mint: 'string' } },
+        output: { fields: { txSignature: 'string' } },
+    },
+    {
+        id: 'payments:streamCreate',
+        protocol: 'payments',
+        description: 'Create a token streaming payment (e.g. via Streamflow)',
+        category: 'payments',
+        input: { fields: { recipient: 'string', amount: 'bigint', durationSeconds: 'number', mint: 'string' } },
+        output: { fields: { streamId: 'string', txSignature: 'string' } },
+    },
+    // ── Governance ──
+    {
+        id: 'realms:vote',
+        protocol: 'realms',
+        description: 'Cast a vote in a Realms DAO proposal',
+        category: 'governance',
+        input: { fields: { proposalAddress: 'string', vote: 'boolean' } },
+        output: { fields: { txSignature: 'string' } },
+    },
+    {
+        id: 'realms:createProposal',
+        protocol: 'realms',
+        description: 'Create a new governance proposal',
+        category: 'governance',
+        input: { fields: { realm: 'string', title: 'string', description: 'string', instructions: 'object' } },
+        output: { fields: { proposalAddress: 'string', txSignature: 'string' } },
+    },
+    // ── Identity ──
+    {
+        id: 'sns:resolveDomain',
+        protocol: 'sns',
+        description: 'Resolve a .sol domain to a wallet address',
+        category: 'identity',
+        input: { fields: { domain: 'string' } },
+        output: { fields: { wallet: 'string' } },
+    },
+    // ── Infrastructure ──
+    {
+        id: 'infra:rpcProxy',
+        protocol: 'infra',
+        description: 'Proxy an RPC call with load balancing and caching',
+        category: 'infrastructure',
+        input: { fields: { method: 'string', params: 'object' } },
+        output: { fields: { result: 'object' } },
+    },
+    {
+        id: 'infra:webhookRelay',
+        protocol: 'infra',
+        description: 'Relay webhook notifications for on-chain events',
+        category: 'infrastructure',
+        input: { fields: { eventType: 'string', targetUrl: 'string', filter: 'object' } },
+        output: { fields: { subscriptionId: 'string' } },
+    },
+];
+/* ═══════════════════════════════════════════════════════════════
+ *  SAPCapabilityRegistry
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Canonical catalog of capabilities for the SAP agent network.
+ *
+ * Provides lookup / filtering by ID, protocol, category, and supports
+ * custom registrations so third-party protocols can extend the catalog
+ * at runtime.
+ *
+ * @since 1.4.0
+ */
+export class SAPCapabilityRegistry {
+    capabilities = new Map();
+    /**
+     * @param {CapabilityDefinition[]} [initial] - Seed capabilities
+     */
+    constructor(initial) {
+        if (initial) {
+            for (const cap of initial)
+                this.capabilities.set(cap.id, cap);
+        }
+    }
+    /* ── Factory ── */
+    /**
+     * @description Create a registry pre-loaded with all default (known) capabilities.
+     * @returns {SAPCapabilityRegistry}
+     * @since 1.4.0
+     */
+    static default() {
+        return new SAPCapabilityRegistry(DEFAULT_CAPABILITIES);
+    }
+    /**
+     * @description Create an empty registry (for testing or fully custom setups).
+     * @returns {SAPCapabilityRegistry}
+     * @since 1.4.0
+     */
+    static empty() {
+        return new SAPCapabilityRegistry();
+    }
+    /* ── Mutation ── */
+    /**
+     * @description Register a new capability (or overwrite an existing one).
+     * @param {CapabilityDefinition} def - Capability definition
+     * @since 1.4.0
+     */
+    register(def) {
+        if (!def.id.includes(':')) {
+            throw new Error(`Capability ID must follow "protocol:method" format, got "${def.id}"`);
+        }
+        this.capabilities.set(def.id, def);
+    }
+    /**
+     * @description Register multiple capabilities at once.
+     * @param {CapabilityDefinition[]} defs - Capability definitions
+     * @since 1.4.0
+     */
+    registerMany(defs) {
+        for (const def of defs)
+            this.register(def);
+    }
+    /**
+     * @description Remove a capability from the registry.
+     * @param {string} id - Capability ID
+     * @returns {boolean} `true` if the capability was found and removed
+     * @since 1.4.0
+     */
+    remove(id) {
+        return this.capabilities.delete(id);
+    }
+    /* ── Lookup ── */
+    /**
+     * @description Check if a capability ID is registered.
+     * @param {string} id - Capability ID (e.g. `"jupiter:swap"`)
+     * @returns {boolean}
+     * @since 1.4.0
+     */
+    has(id) {
+        return this.capabilities.has(id);
+    }
+    /**
+     * @description Get a single capability by ID.
+     * @param {string} id - Capability ID
+     * @returns {CapabilityDefinition | undefined}
+     * @since 1.4.0
+     */
+    get(id) {
+        return this.capabilities.get(id);
+    }
+    /**
+     * @description List all registered capabilities.
+     * @returns {CapabilityDefinition[]}
+     * @since 1.4.0
+     */
+    list() {
+        return [...this.capabilities.values()];
+    }
+    /**
+     * @description Get all registered capability IDs.
+     * @returns {string[]}
+     * @since 1.4.0
+     */
+    ids() {
+        return [...this.capabilities.keys()];
+    }
+    /**
+     * @description Total number of registered capabilities.
+     * @returns {number}
+     * @since 1.4.0
+     */
+    get size() {
+        return this.capabilities.size;
+    }
+    /* ── Filtering ── */
+    /**
+     * @description Get all capabilities for a given protocol.
+     * @param {string} protocol - Protocol name (e.g. `"jupiter"`)
+     * @returns {CapabilityDefinition[]}
+     * @since 1.4.0
+     */
+    byProtocol(protocol) {
+        return this.list().filter(c => c.protocol === protocol);
+    }
+    /**
+     * @description Get all capabilities in a given category.
+     * @param {CapabilityCategory} category
+     * @returns {CapabilityDefinition[]}
+     * @since 1.4.0
+     */
+    byCategory(category) {
+        return this.list().filter(c => c.category === category);
+    }
+    /**
+     * @description Get all unique protocol names.
+     * @returns {string[]}
+     * @since 1.4.0
+     */
+    protocols() {
+        return [...new Set(this.list().map(c => c.protocol))];
+    }
+    /**
+     * @description Get all unique categories in use.
+     * @returns {CapabilityCategory[]}
+     * @since 1.4.0
+     */
+    categories() {
+        return [...new Set(this.list().map(c => c.category))];
+    }
+    /**
+     * @description Search capabilities by free-text query (matches id, description, protocol).
+     * @param {string} query - Search text (case-insensitive)
+     * @returns {CapabilityDefinition[]}
+     * @since 1.4.0
+     */
+    search(query) {
+        const q = query.toLowerCase();
+        return this.list().filter(c => c.id.toLowerCase().includes(q) ||
+            c.description.toLowerCase().includes(q) ||
+            c.protocol.toLowerCase().includes(q));
+    }
+    /**
+     * @description Get all critical (core) capabilities.
+     * @returns {CapabilityDefinition[]}
+     * @since 1.4.0
+     */
+    critical() {
+        return this.list().filter(c => c.isCritical);
+    }
+    /**
+     * @description Get deprecated capabilities.
+     * @returns {CapabilityDefinition[]}
+     * @since 1.4.0
+     */
+    deprecated() {
+        return this.list().filter(c => c.deprecated);
+    }
+    /**
+     * @description Validate a list of capability IDs against the registry.
+     * Returns unknown IDs (not registered) — useful during agent registration.
+     * @param {string[]} ids - Capability IDs to check
+     * @returns {{ known: string[]; unknown: string[]; deprecated: string[] }}
+     * @since 1.4.0
+     */
+    validate(ids) {
+        const known = [];
+        const unknown = [];
+        const deprecated = [];
+        for (const id of ids) {
+            const def = this.capabilities.get(id);
+            if (!def) {
+                unknown.push(id);
+            }
+            else {
+                known.push(id);
+                if (def.deprecated)
+                    deprecated.push(id);
+            }
+        }
+        return { known, unknown, deprecated };
+    }
+    /**
+     * @description Get the dependency graph: which capabilities are frequently used together.
+     * @param {string} id - Root capability ID
+     * @returns {string[]} Related capability IDs (transitive, max 2 levels)
+     * @since 1.4.0
+     */
+    relatedGraph(id) {
+        const seen = new Set();
+        const queue = [id];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            const def = this.capabilities.get(current);
+            if (def?.relatedCapabilities) {
+                for (const rel of def.relatedCapabilities) {
+                    if (!seen.has(rel))
+                        queue.push(rel);
+                }
+            }
+        }
+        seen.delete(id); // remove the root
+        return [...seen];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/esm/ai/sap/registry.js.map

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

package/dist/esm/ai/sap/scoring.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @module ai/sap/scoring
+ * @description SAP — Agent health scoring and network analytics.
+ *
+ * Computes composite health scores for individual agents and entire
+ * sub-networks, factoring in reputation, uptime, latency, call volume,
+ * capability coverage, and pricing competitiveness.
+ *
+ * Also provides **network-level analytics**: protocol concentration,
+ * Gini coefficient for call distribution, and trend detection.
+ *
+ * @example
+ * ```ts
+ * import { computeAgentHealthScore, computeNetworkAnalytics } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
+ *
+ * const health = computeAgentHealthScore(agentPDA);
+ * console.log(health.composite);   // 0..100
+ * console.log(health.breakdown);   // { reputation, uptime, latency, activity, pricing }
+ *
+ * const analytics = computeNetworkAnalytics(allAgents);
+ * console.log(analytics.giniCoefficient);     // 0..1 (0 = perfectly even)
+ * console.log(analytics.protocolConcentration);
+ * ```
+ *
+ * @since 1.4.0
+ */
+import type { AgentPDAAccount } from './types';
+/**
+ * @description Breakdown of an agent's health score.
+ * Each component is 0–100.
+ * @since 1.4.0
+ */
+export interface HealthScoreBreakdown {
+    /** Reputation component (from on-chain score 0–1000 mapped to 0–100). */
+    reputation: number;
+    /** Uptime component (0–100). */
+    uptime: number;
+    /** Latency component (lower latency → higher score). */
+    latency: number;
+    /** Activity component (based on call volume relative to network average). */
+    activity: number;
+    /** Pricing competitiveness (lower relative price → higher score). */
+    pricing: number;
+}
+/**
+ * @description Full health score result for a single agent.
+ * @since 1.4.0
+ */
+export interface AgentHealthScore {
+    /** Wallet pubkey. */
+    walletPubkey: string;
+    /** Agent name. */
+    name: string;
+    /** Composite score (0–100, weighted average of breakdown). */
+    composite: number;
+    /** Component-level breakdown. */
+    breakdown: HealthScoreBreakdown;
+    /** Qualitative tier: 'excellent' | 'good' | 'fair' | 'poor' | 'critical'. */
+    tier: 'excellent' | 'good' | 'fair' | 'poor' | 'critical';
+    /** Human-readable summary. */
+    summary: string;
+    /** Actionable recommendations (if any). */
+    recommendations: string[];
+}
+/**
+ * @description Network-level analytics across all agents.
+ * @since 1.4.0
+ */
+export interface NetworkAnalytics {
+    /** Total agents analysed. */
+    totalAgents: number;
+    /** Active agents count. */
+    activeAgents: number;
+    /** Average composite health score. */
+    avgHealthScore: number;
+    /** Distribution of agents by tier. */
+    tierDistribution: Record<AgentHealthScore['tier'], number>;
+    /** Gini coefficient for call distribution (0 = equal, 1 = one agent has all calls). */
+    giniCoefficient: number;
+    /** Protocol concentration: which protocols have the most agents. */
+    protocolConcentration: Array<{
+        protocol: string;
+        agentCount: number;
+        pct: number;
+    }>;
+    /** Capability coverage: how many agents cover each capability. */
+    capabilityCoverage: Array<{
+        capability: string;
+        agentCount: number;
+    }>;
+    /** Top agents by composite score. */
+    topAgents: Array<{
+        walletPubkey: string;
+        name: string;
+        score: number;
+    }>;
+    /** Agents needing attention (score < 40). */
+    needsAttention: Array<{
+        walletPubkey: string;
+        name: string;
+        score: number;
+        reasons: string[];
+    }>;
+}
+declare const DEFAULT_WEIGHTS: {
+    readonly reputation: 0.3;
+    readonly uptime: 0.25;
+    readonly latency: 0.2;
+    readonly activity: 0.15;
+    readonly pricing: 0.1;
+};
+/**
+ * @description Compute a composite health score for a single agent.
+ *
+ * @param {AgentPDAAccount} agent - The agent to score
+ * @param {Object} [context] - Optional context for relative scoring
+ * @param {number} [context.networkAvgCalls] - Network average calls (for activity scoring)
+ * @param {bigint} [context.networkAvgPrice] - Network average price per call
+ * @param {Partial<typeof DEFAULT_WEIGHTS>} [weights] - Override default weights
+ * @returns {AgentHealthScore}
+ *
+ * @since 1.4.0
+ */
+export declare function computeAgentHealthScore(agent: AgentPDAAccount, context?: {
+    networkAvgCalls?: number;
+    networkAvgPrice?: bigint;
+}, weights?: Partial<typeof DEFAULT_WEIGHTS>): AgentHealthScore;
+/**
+ * @description Compute network-level analytics across all discovered agents.
+ *
+ * @param {AgentPDAAccount[]} agents - All agents in the network
+ * @returns {NetworkAnalytics}
+ *
+ * @since 1.4.0
+ */
+export declare function computeNetworkAnalytics(agents: AgentPDAAccount[]): NetworkAnalytics;
+export {};
+//# sourceMappingURL=scoring.d.ts.map

package/dist/esm/ai/sap/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM/C;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,oBAAoB,CAAC;IAChC,6EAA6E;IAC7E,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1D,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3D,uFAAuF;IACvF,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,qBAAqB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,kEAAkE;IAClE,kBAAkB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,qCAAqC;IACrC,SAAS,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,6CAA6C;IAC7C,cAAc,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACjG;AAMD,QAAA,MAAM,eAAe;;;;;;CAMX,CAAC;AAMX;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,eAAe,CAAC,GACxC,gBAAgB,CAoDlB;AAMD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CA4FnF"}