@oobe-protocol-labs/sap-mcp-server 0.9.16 → 0.9.21

package/dist/premium/stream-broker.js

@@ -0,0 +1,199 @@
+/**
+ * @name premium/stream-broker
+ * @description SSE stream broker for premium real-time event delivery.
+ *
+ * After a session is activated (`status=active`), the stream broker opens a
+ * provider subscription, enriches each event with session metadata, stores it
+ * in the event store for replay, and delivers it to the buyer via SSE
+ * (Server-Sent Events) over the `/premium/stream/:sessionId` HTTP endpoint.
+ *
+ * The broker enforces:
+ *   - Unit quota: stops delivery when `requestedUnits` reaches zero.
+ *   - Session status: only delivers for `status=active` sessions.
+ *   - Event idempotency: deduplicates via `eventId` in the event store.
+ *   - Graceful shutdown: closes all active streams on disconnect.
+ *
+ * @flow
+ *   1. Buyer calls `GET /premium/stream/:sessionId` with `Accept: text/event-stream`.
+ *   2. → `startStream()` validates session is active, loads provider adapter.
+ *   3. → Provider `subscribe()` returns async iterable of `ProviderEvent`.
+ *   4. → For each event: enrich with session metadata, `appendEvent()`, write SSE.
+ *   5. → `decrementSessionQuota()` after each event; auto-close at zero.
+ *   6. Client disconnects or quota exhausted → `stopStream()`.
+ *
+ * @module premium/stream-broker
+ */
+import { getPremiumSession, decrementSessionQuota } from './session-manager.js';
+import { subscribeToProvider } from './provider-bridge.js';
+import { appendEvent, getEvents } from './event-store.js';
+/**
+ * @description Registry of active stream subscriptions keyed by session id.
+ */
+const activeStreams = new Map();
+/**
+ * @description Abort controllers for active streams, keyed by session id.
+ * Used to cancel the provider async iterable when the client disconnects.
+ */
+const streamControllers = new Map();
+/**
+ * @name startStream
+ * @description Start a premium stream subscription for an active session.
+ *
+ * @param sessionId      - The activated premium session id.
+ * @param subscriptionKey - De-duplication key from the stream input schema.
+ * @param filters        - Narrow filters for the provider subscription.
+ * @returns The `PremiumStreamSubscription` if successful, or `null` if the
+ *   session is not active or the provider is not available.
+ *
+ * @usedBy `remote/server.ts` → `GET /premium/stream/:sessionId`
+ */
+export async function startStream(sessionId, subscriptionKey, filters) {
+    const session = getPremiumSession(sessionId);
+    if (!session || session.status !== 'active')
+        return null;
+    // Don't start a duplicate stream for the same session.
+    if (activeStreams.has(sessionId))
+        return activeStreams.get(sessionId);
+    const subscription = {
+        sessionId,
+        pluginId: session.pluginId,
+        capabilityId: session.capabilityId,
+        subscriptionKey,
+        filters,
+        startedAt: new Date().toISOString(),
+        unitsDelivered: 0,
+        unitsQuota: session.requestedUnits,
+        active: true,
+    };
+    activeStreams.set(sessionId, subscription);
+    return subscription;
+}
+/**
+ * @name streamEvents
+ * @description Async generator that yields enriched premium events for a session.
+ *
+ * This is the core delivery loop. It:
+ *   1. Loads the provider adapter for the session's plugin/capability.
+ *   2. Subscribes with the session's filters.
+ *   3. For each provider event: enriches with session metadata, appends to the
+ *      event store, decrements the unit quota, and yields the enriched event.
+ *   4. Stops when the quota reaches zero, the provider iterable ends, or the
+ *      stream is cancelled via `stopStream()`.
+ *
+ * @param sessionId - The active session id.
+ * @returns Async generator yielding `ProviderEvent` enriched with session metadata.
+ *
+ * @usedBy `remote/server.ts` → SSE response writer
+ */
+export async function* streamEvents(sessionId) {
+    const subscription = activeStreams.get(sessionId);
+    if (!subscription)
+        return;
+    const session = getPremiumSession(sessionId);
+    if (!session || session.status !== 'active')
+        return;
+    const iterable = await subscribeToProvider(subscription.pluginId, subscription.capabilityId, subscription.filters);
+    if (!iterable)
+        return;
+    const controller = new AbortController();
+    streamControllers.set(sessionId, controller);
+    try {
+        for await (const event of iterable) {
+            if (controller.signal.aborted)
+                break;
+            if (!subscription.active)
+                break;
+            // Enrich and store the event.
+            appendEvent({
+                eventId: event.eventId,
+                sessionId,
+                pluginId: subscription.pluginId,
+                capabilityId: subscription.capabilityId,
+                eventType: event.eventType,
+                observedAt: event.observedAt,
+                payload: event.payload,
+                deliveredAt: new Date().toISOString(),
+            });
+            subscription.unitsDelivered++;
+            const remaining = decrementSessionQuota(sessionId);
+            if (remaining <= 0) {
+                subscription.active = false;
+                yield event;
+                break;
+            }
+            yield event;
+        }
+    }
+    finally {
+        streamControllers.delete(sessionId);
+        if (subscription.active) {
+            subscription.active = false;
+        }
+        activeStreams.delete(sessionId);
+    }
+}
+/**
+ * @name stopStream
+ * @description Stop an active stream subscription.
+ *
+ * Aborts the provider async iterable and marks the subscription as inactive.
+ * The session is not closed — the buyer can resume with a replay query.
+ *
+ * @param sessionId - The session id to stop streaming for.
+ *
+ * @usedBy `remote/server.ts` → client disconnect handler
+ */
+export function stopStream(sessionId) {
+    const controller = streamControllers.get(sessionId);
+    if (controller) {
+        controller.abort();
+        streamControllers.delete(sessionId);
+    }
+    const subscription = activeStreams.get(sessionId);
+    if (subscription) {
+        subscription.active = false;
+        activeStreams.delete(sessionId);
+    }
+}
+/**
+ * @name replayEvents
+ * @description Replay past events for a session within the replay window.
+ *
+ * Used when a client reconnects and needs to catch up on events missed
+ * during the disconnection period.
+ *
+ * @param sessionId - The session id to replay events for.
+ * @param since     - Optional ISO timestamp; only events after this are returned.
+ * @returns Array of `ProviderEvent` records from the event store.
+ *
+ * @usedBy `remote/server.ts` → SSE replay before live stream
+ */
+export function replayEvents(sessionId, since) {
+    return getEvents({ sessionId, since }).map(record => ({
+        eventId: record.eventId,
+        eventType: record.eventType,
+        observedAt: record.observedAt,
+        payload: record.payload,
+    }));
+}
+/**
+ * @name getActiveStreamCount
+ * @description Return the number of currently active stream subscriptions.
+ *
+ * @usedBy `metrics.ts`
+ */
+export function getActiveStreamCount() {
+    return activeStreams.size;
+}
+/**
+ * @name stopAllStreams
+ * @description Stop all active streams. Called during graceful shutdown.
+ *
+ * @usedBy `remote/server.ts` shutdown handler
+ */
+export function stopAllStreams() {
+    for (const sessionId of activeStreams.keys()) {
+        stopStream(sessionId);
+    }
+}
+//# sourceMappingURL=stream-broker.js.map

package/dist/premium/stream-broker.js.map

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

package/dist/premium/tech-fundamentals-capabilities.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @name premium/tech-fundamentals-capabilities
+ * @description Built-in premium tech fundamentals capabilities for Solana project analysis.
+ *
+ * Defines 3 premium tech fundamentals capabilities across 1 plugin:
+ *
+ *   1. `sap-premium-tech-fundamentals` — Technical & fundamental analysis:
+ *      - `tech.github.activity`     — GitHub activity spike alerts (webhook)
+ *      - `tech.tvl.change`          — Real-time TVL changes for Solana DeFi (stream)
+ *      - `tech.tokenomics.analysis` — On-demand tokenomics analysis (webhook)
+ *
+ * These capabilities are contracts only — they become live when the corresponding
+ * provider env vars are configured and a provider adapter is loaded from the
+ * private subrepo.
+ *
+ * @flow
+ *   1. Agent discovers tech fundamentals capabilities via `sap_premium_plugin_catalog`.
+ *   2. Agent creates a session plan for a tech stream or webhook.
+ *   3. Agent activates the session with x402/pay.sh receipt.
+ *   4. Agent connects to `GET /premium/stream/:sessionId` for SSE streams.
+ *   5. Agent registers webhooks for GitHub activity and tokenomics alerts via `POST /premium/webhook/register`.
+ *   6. Provider adapter in the private subrepo feeds real tech fundamentals data.
+ *
+ * @module premium/tech-fundamentals-capabilities
+ */
+import type { PremiumPluginManifest } from './types.js';
+/**
+ * @name TECH_FUNDAMENTALS_PREMIUM_PLUGINS
+ * @description Built-in premium tech fundamentals plugin manifests.
+ *
+ * One plugin covering 3 tech fundamentals capabilities:
+ *   - `sap-premium-tech-fundamentals` — 2 webhook + 1 stream capability
+ *
+ * @usedBy `listPremiumPlugins()` — merged with the existing built-in plugins.
+ */
+export declare const TECH_FUNDAMENTALS_PREMIUM_PLUGINS: PremiumPluginManifest[];
+//# sourceMappingURL=tech-fundamentals-capabilities.d.ts.map

package/dist/premium/tech-fundamentals-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-fundamentals-capabilities.d.ts","sourceRoot":"","sources":["../../src/premium/tech-fundamentals-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAA+B,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+PrF;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,EAAE,qBAAqB,EAoCpE,CAAC"}

package/dist/premium/tech-fundamentals-capabilities.js

@@ -0,0 +1,283 @@
+/**
+ * @name premium/tech-fundamentals-capabilities
+ * @description Built-in premium tech fundamentals capabilities for Solana project analysis.
+ *
+ * Defines 3 premium tech fundamentals capabilities across 1 plugin:
+ *
+ *   1. `sap-premium-tech-fundamentals` — Technical & fundamental analysis:
+ *      - `tech.github.activity`     — GitHub activity spike alerts (webhook)
+ *      - `tech.tvl.change`          — Real-time TVL changes for Solana DeFi (stream)
+ *      - `tech.tokenomics.analysis` — On-demand tokenomics analysis (webhook)
+ *
+ * These capabilities are contracts only — they become live when the corresponding
+ * provider env vars are configured and a provider adapter is loaded from the
+ * private subrepo.
+ *
+ * @flow
+ *   1. Agent discovers tech fundamentals capabilities via `sap_premium_plugin_catalog`.
+ *   2. Agent creates a session plan for a tech stream or webhook.
+ *   3. Agent activates the session with x402/pay.sh receipt.
+ *   4. Agent connects to `GET /premium/stream/:sessionId` for SSE streams.
+ *   5. Agent registers webhooks for GitHub activity and tokenomics alerts via `POST /premium/webhook/register`.
+ *   6. Provider adapter in the private subrepo feeds real tech fundamentals data.
+ *
+ * @module premium/tech-fundamentals-capabilities
+ */
+/* -------------------------------------------------------------------------- */
+/* Shared schemas                                                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * @description Input schema for tech fundamentals stream capabilities.
+ * Requires a `subscriptionKey` for de-duplication and supports narrow
+ * filters for mints and minimum liquidity/volume thresholds.
+ */
+const techStreamInputSchema = {
+    type: 'object',
+    required: ['subscriptionKey'],
+    properties: {
+        subscriptionKey: {
+            type: 'string',
+            minLength: 3,
+            description: 'Stable subscription key for de-duplication. Use a hash of protocol + metric id.',
+        },
+        mints: {
+            type: 'array',
+            items: { type: 'string', minLength: 32, maxLength: 44 },
+            description: 'Token mint addresses to watch. Empty = all Solana DeFi protocols.',
+        },
+        minLiquidityUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum TVL/liquidity in USD to emit an event. Filters small protocols.',
+        },
+        minVolumeUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum 24h volume in USD to emit an event.',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Output schema for tech fundamentals stream events. Each event
+ * carries a signal type, protocol metadata, and TVL/change data.
+ */
+const techStreamOutputSchema = {
+    type: 'object',
+    required: ['eventId', 'eventType', 'observedAt', 'payload'],
+    properties: {
+        eventId: {
+            type: 'string',
+            description: 'Stable event id for idempotent execution and replay.',
+        },
+        eventType: {
+            type: 'string',
+            enum: [
+                'tvl.change',
+            ],
+            description: 'Tech fundamentals event type determining the payload structure.',
+        },
+        observedAt: {
+            type: 'string',
+            format: 'date-time',
+            description: 'ISO timestamp when the provider observed the protocol condition.',
+        },
+        payload: {
+            type: 'object',
+            required: ['protocol', 'action', 'confidence'],
+            properties: {
+                protocol: { type: 'string', description: 'Protocol name (e.g. "Jupiter", "Raydium").' },
+                mint: { type: 'string', description: 'Associated token mint address.' },
+                action: {
+                    type: 'string',
+                    enum: ['buy', 'sell', 'monitor', 'alert'],
+                    description: 'Recommended agent action.',
+                },
+                confidence: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                    description: 'Signal confidence score (0-1).',
+                },
+                tvlUsd: { type: 'number', description: 'Current TVL in USD.' },
+                tvlChangePct: { type: 'number', description: 'TVL change percentage (24h).' },
+                tvlChangeUsd: { type: 'number', description: 'TVL change in USD (24h).' },
+                rank: { type: 'number', description: 'Protocol TVL rank on Solana.' },
+                expiresAt: { type: 'string', format: 'date-time', description: 'Signal expiry timestamp.' },
+            },
+            additionalProperties: true,
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Input schema for tech fundamentals webhook capabilities. The
+ * buyer provides an HTTPS endpoint and selects which event types to receive.
+ */
+const techWebhookInputSchema = {
+    type: 'object',
+    required: ['targetUrl', 'events'],
+    properties: {
+        targetUrl: {
+            type: 'string',
+            format: 'uri',
+            description: 'HTTPS webhook endpoint owned by the agent.',
+        },
+        events: {
+            type: 'array',
+            minItems: 1,
+            items: {
+                type: 'string',
+                enum: ['tech.github.activity', 'tech.tokenomics.analysis'],
+            },
+            description: 'Event types to deliver to this webhook.',
+        },
+        minLiquidityUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum liquidity/TVL in USD for alerts. Filters small protocols.',
+        },
+        signingPublicKey: {
+            type: 'string',
+            description: 'Optional public key for webhook signature verification.',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Output schema for tech fundamentals webhook deliveries.
+ */
+const techWebhookOutputSchema = {
+    type: 'object',
+    required: ['deliveryId', 'eventType', 'deliveredAt', 'signature', 'payload'],
+    properties: {
+        deliveryId: { type: 'string', description: 'Idempotent delivery id.' },
+        eventType: { type: 'string', description: 'Tech fundamentals event type.' },
+        deliveredAt: { type: 'string', format: 'date-time', description: 'ISO delivery timestamp.' },
+        signature: { type: 'string', description: 'HMAC-SHA256 signature.' },
+        payload: {
+            type: 'object',
+            additionalProperties: true,
+            description: 'Tech fundamentals payload with GitHub activity, TVL, or tokenomics analysis data.',
+        },
+    },
+    additionalProperties: false,
+};
+/* -------------------------------------------------------------------------- */
+/* Capability factory                                                         */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name techStreamCapability
+ * @description Factory for building a tech fundamentals stream capability definition.
+ *
+ * @param id           - Capability id (e.g. `tech.tvl.change`).
+ * @param title        - Human-readable title.
+ * @param description  - Agent-facing description.
+ * @param events       - Event types this stream emits.
+ * @param unitPriceUsd - Price per minute in USD.
+ * @param providerEnv  - Required provider env vars.
+ * @returns A `PremiumCapabilityDefinition` with type `stream`.
+ *
+ * @internal
+ */
+function techStreamCapability(id, title, description, events, unitPriceUsd, providerEnv) {
+    return {
+        id,
+        type: 'stream',
+        title,
+        description,
+        status: providerEnv.length > 0 ? 'requires-provider' : 'planned',
+        requiresProvider: providerEnv.length > 0,
+        providerEnv,
+        inputSchema: techStreamInputSchema,
+        outputSchema: techStreamOutputSchema,
+        pricing: {
+            tier: 'premium-stream',
+            model: 'x402-per-minute',
+            unit: 'minute',
+            unitPriceUsd,
+            minUnits: 1,
+            maxUnits: 480, // up to 8 hours of streaming
+            settlement: 'x402',
+        },
+        delivery: {
+            transport: 'mcp-streamable-http',
+            events,
+            latencyTargetMs: 1000,
+            replayWindowSeconds: 600,
+        },
+    };
+}
+/**
+ * @name techWebhookCapability
+ * @description Factory for building a tech fundamentals webhook capability definition.
+ *
+ * @param id           - Capability id (e.g. `tech.github.activity`).
+ * @param title        - Human-readable title.
+ * @param description  - Agent-facing description.
+ * @param events       - Event types this webhook delivers.
+ * @param unitPriceUsd - Price per delivered event in USD.
+ * @param providerEnv  - Required provider env vars.
+ * @returns A `PremiumCapabilityDefinition` with type `webhook`.
+ *
+ * @internal
+ */
+function techWebhookCapability(id, title, description, events, unitPriceUsd, providerEnv) {
+    return {
+        id,
+        type: 'webhook',
+        title,
+        description,
+        status: providerEnv.length > 0 ? 'requires-provider' : 'planned',
+        requiresProvider: providerEnv.length > 0,
+        providerEnv,
+        inputSchema: techWebhookInputSchema,
+        outputSchema: techWebhookOutputSchema,
+        pricing: {
+            tier: 'premium-webhook',
+            model: 'x402-per-event',
+            unit: 'event',
+            unitPriceUsd,
+            minUnits: 5,
+            maxUnits: 50_000,
+            settlement: 'x402',
+        },
+        delivery: {
+            transport: 'webhook-http',
+            events,
+            latencyTargetMs: 1_500,
+            replayWindowSeconds: 900,
+        },
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Plugin manifests                                                           */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name TECH_FUNDAMENTALS_PREMIUM_PLUGINS
+ * @description Built-in premium tech fundamentals plugin manifests.
+ *
+ * One plugin covering 3 tech fundamentals capabilities:
+ *   - `sap-premium-tech-fundamentals` — 2 webhook + 1 stream capability
+ *
+ * @usedBy `listPremiumPlugins()` — merged with the existing built-in plugins.
+ */
+export const TECH_FUNDAMENTALS_PREMIUM_PLUGINS = [
+    {
+        id: 'sap-premium-tech-fundamentals',
+        version: '0.1.0',
+        title: 'SAP Premium Tech Fundamentals',
+        description: 'Paid technical and fundamental analysis for Solana agents: GitHub activity spike alerts for Solana projects, real-time TVL change monitoring for DeFi protocols, and on-demand tokenomics analysis with supply distribution, vesting schedules, and unlock calendars. x402 metered delivery.',
+        publisher: 'OOBE Protocol',
+        visibility: 'public',
+        capabilities: [
+            techWebhookCapability('tech.github.activity', 'GitHub activity spike alerts', 'Delivers signed webhook callbacks when GitHub activity spikes are detected for Solana projects. Monitors commit frequency, PR count, issue activity, and contributor changes. Agents receive project name, repo URL, activity spike type (commits, PRs, issues), spike magnitude, and historical comparison for development-driven investment signals.', ['tech.github.activity'], 0.002, // $0.002/event
+            ['SAP_MCP_PREMIUM_GITHUB_API_URL', 'SAP_MCP_PREMIUM_WEBHOOK_SIGNER']),
+            techStreamCapability('tech.tvl.change', 'Real-time TVL change stream', 'Streams real-time TVL changes for Solana DeFi protocols. Monitors total value locked across lending, DEX, staking, and yield protocols. Emits events when TVL changes by a configurable threshold. Agents receive protocol name, current TVL, change percentage, change in USD, and protocol rank for TVL-driven investment decisions.', ['tvl.change'], 0.02, // $0.02/min
+            ['SAP_MCP_PREMIUM_DEFILAMA_API_URL']),
+            techWebhookCapability('tech.tokenomics.analysis', 'On-demand tokenomics analysis', 'Delivers signed webhook callbacks with on-demand tokenomics analysis for Solana projects. Analyzes supply distribution, vesting schedules, token unlock calendars, and team/advisor allocations. Agents receive mint, circulating supply, total supply, unlock dates, vesting breakdown, concentration risk, and recommended action for tokenomics-aware investment decisions.', ['tech.tokenomics.analysis'], 0.004, // $0.004/event
+            ['SAP_MCP_PREMIUM_GITHUB_API_URL', 'SAP_MCP_PREMIUM_WEBHOOK_SIGNER']),
+        ],
+    },
+];
+//# sourceMappingURL=tech-fundamentals-capabilities.js.map

package/dist/premium/tech-fundamentals-capabilities.js.map

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

package/dist/premium/trading-capabilities.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @name premium/trading-capabilities
+ * @description Built-in premium trading capabilities for Solana real-time trading agents.
+ *
+ * Defines 3 premium trading capabilities across 1 plugin:
+ *
+ *   1. `sap-premium-trading-streams` — Real-time SSE streams for trading signals:
+ *      - `jupiter.arbitrage.scan`   — Cross-DEX arbitrage opportunity scanner (stream)
+ *      - `pyth.volatility.watch`    — Price volatility breakout detector (stream)
+ *      - `jupiter.route.optimized`  — Optimized swap route with MEV protection (stream)
+ *
+ * These capabilities are contracts only — they become live when the corresponding
+ * provider env vars are configured and a provider adapter is loaded from the
+ * private subrepo.
+ *
+ * @flow
+ *   1. Agent discovers trading capabilities via `sap_premium_plugin_catalog`.
+ *   2. Agent creates a session plan for a trading stream.
+ *   3. Agent activates the session with x402/pay.sh receipt.
+ *   4. Agent connects to `GET /premium/stream/:sessionId` for SSE streams.
+ *   5. Provider adapter in the private subrepo feeds real market data.
+ *
+ * @module premium/trading-capabilities
+ */
+import type { PremiumPluginManifest } from './types.js';
+/**
+ * @name TRADING_PREMIUM_PLUGINS
+ * @description Built-in premium trading plugin manifests.
+ *
+ * One plugin covering 3 trading stream capabilities:
+ *   - `sap-premium-trading-streams` — 3 SSE stream capabilities
+ *
+ * @usedBy `listPremiumPlugins()` — merged with the other built-in plugins.
+ */
+export declare const TRADING_PREMIUM_PLUGINS: PremiumPluginManifest[];
+//# sourceMappingURL=trading-capabilities.d.ts.map

package/dist/premium/trading-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-capabilities.d.ts","sourceRoot":"","sources":["../../src/premium/trading-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAA+B,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAwKrF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,qBAAqB,EAoC1D,CAAC"}