@oobe-protocol-labs/sap-mcp-server 0.9.1 → 0.9.3

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.001, // $0.001/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.01, // $0.01/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.002, // $0.002/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"}

package/dist/premium/trading-capabilities.js

@@ -0,0 +1,205 @@
+/**
+ * @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
+ */
+/* -------------------------------------------------------------------------- */
+/* Shared schemas                                                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * @description Input schema for trading stream capabilities. Requires a
+ * `subscriptionKey` for de-duplication and supports narrow filters for
+ * mints, DEXes, size thresholds, and signal types.
+ */
+const tradingStreamInputSchema = {
+    type: 'object',
+    required: ['subscriptionKey'],
+    properties: {
+        subscriptionKey: {
+            type: 'string',
+            minLength: 3,
+            description: 'Stable subscription key for de-duplication. Use a hash of mint pair + strategy id.',
+        },
+        mints: {
+            type: 'array',
+            items: { type: 'string', minLength: 32, maxLength: 44 },
+            description: 'Token mint addresses to watch. Empty = all tokens.',
+        },
+        dexes: {
+            type: 'array',
+            items: { type: 'string', enum: ['jupiter', 'raydium', 'orca', 'drift', 'phoenix', 'meteora'] },
+            description: 'DEX protocols to scan. Empty = all DEXes.',
+        },
+        minSizeUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum trade size in USD to emit an event. Filters noise.',
+        },
+        maxLatencyMs: {
+            type: 'number',
+            minimum: 100,
+            maximum: 10_000,
+            description: 'Maximum acceptable data staleness in milliseconds.',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Output schema for trading stream events. Each event carries
+ * a signal type, actionable data (entry/exit/SL/TP), and metadata for
+ * execution by the agent.
+ */
+const tradingStreamOutputSchema = {
+    type: 'object',
+    required: ['eventId', 'signalType', 'observedAt', 'payload'],
+    properties: {
+        eventId: {
+            type: 'string',
+            description: 'Stable event id for idempotent execution and replay.',
+        },
+        signalType: {
+            type: 'string',
+            enum: [
+                'arbitrage.opportunity',
+                'volatility.breakout',
+                'route.optimized',
+            ],
+            description: 'Trading signal type determining the payload structure.',
+        },
+        observedAt: {
+            type: 'string',
+            format: 'date-time',
+            description: 'ISO timestamp when the provider observed the market condition.',
+        },
+        payload: {
+            type: 'object',
+            required: ['action', 'confidence'],
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['buy', 'sell', 'swap', 'close', 'monitor', 'alert'],
+                    description: 'Recommended agent action.',
+                },
+                confidence: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                    description: 'Signal confidence score (0-1). Above 0.7 = high conviction.',
+                },
+                inputMint: { type: 'string', description: 'Input token mint for swap execution.' },
+                outputMint: { type: 'string', description: 'Output token mint for swap execution.' },
+                amount: { type: 'string', description: 'Suggested amount in smallest unit.' },
+                entryPrice: { type: 'number', description: 'Suggested entry price in USD.' },
+                exitPrice: { type: 'number', description: 'Suggested take-profit price in USD.' },
+                stopLoss: { type: 'number', description: 'Suggested stop-loss price in USD.' },
+                sizeUsd: { type: 'number', description: 'Opportunity size in USD.' },
+                expectedPnlUsd: { type: 'number', description: 'Expected profit in USD.' },
+                route: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Ordered DEX route for optimal execution.',
+                },
+                priceImpactBps: { type: 'number', description: 'Expected price impact in basis points.' },
+                mevProtected: { type: 'boolean', description: 'Whether the route is MEV-protected.' },
+                expiresAt: { type: 'string', format: 'date-time', description: 'Signal expiry timestamp.' },
+            },
+            additionalProperties: true,
+        },
+    },
+    additionalProperties: false,
+};
+/* -------------------------------------------------------------------------- */
+/* Capability factory                                                         */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name tradingStreamCapability
+ * @description Factory for building a trading stream capability definition.
+ *
+ * @param id           - Capability id (e.g. `jupiter.arbitrage.scan`).
+ * @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 tradingStreamCapability(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: tradingStreamInputSchema,
+        outputSchema: tradingStreamOutputSchema,
+        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: 250, // low latency for trading
+            replayWindowSeconds: 120, // short replay for trading
+        },
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Plugin manifests                                                           */
+/* -------------------------------------------------------------------------- */
+/**
+ * @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 const TRADING_PREMIUM_PLUGINS = [
+    {
+        id: 'sap-premium-trading-streams',
+        version: '0.1.0',
+        title: 'SAP Premium Trading Streams',
+        description: 'Paid real-time SSE trading streams for Solana agents: cross-DEX arbitrage scanning, volatility breakout detection, whale movement monitoring, and MEV-protected route optimization. Low-latency delivery with x402 per-minute metering.',
+        publisher: 'OOBE Protocol',
+        visibility: 'public',
+        capabilities: [
+            tradingStreamCapability('jupiter.arbitrage.scan', 'Jupiter cross-DEX arbitrage scanner', 'Continuously scans Jupiter routes across connected DEXes for arbitrage opportunities. Emits events when profitable cross-DEX paths are found with expected PnL above the minimum threshold. Agents receive entry mints, output mints, route, expected PnL, and price impact for instant execution.', ['arbitrage.opportunity'], 0.025, // $0.025/minute — premium for real-time arb scanning
+            ['SAP_MCP_PREMIUM_JUPITER_STREAM_URL']),
+            tradingStreamCapability('pyth.volatility.watch', 'Pyth volatility breakout detector', 'Monitors Pyth price feeds for volatility breakouts using Bollinger Band width expansion and ATR spikes. Emits events when a token breaks out of its volatility envelope with confidence scoring. Agents receive entry price, stop-loss, take-profit, and confidence level for breakout trading.', ['volatility.breakout'], 0.015, // $0.015/minute
+            ['SAP_MCP_PREMIUM_PYTH_STREAM_URL']),
+            tradingStreamCapability('jupiter.route.optimized', 'MEV-protected optimized route stream', 'Continuously computes optimal Jupiter swap routes with MEV protection for specified mint pairs. Emits route updates when a better path is found (lower price impact, fewer hops, or better overall rate). Agents receive the full route, expected output, price impact in bps, and MEV protection status.', ['route.optimized'], 0.0125, // $0.0125/minute
+            ['SAP_MCP_PREMIUM_JUPITER_STREAM_URL']),
+        ],
+    },
+];
+//# sourceMappingURL=trading-capabilities.js.map

package/dist/premium/trading-capabilities.js.map

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