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

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.05, // $0.05/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.03, // $0.03/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.025, // $0.025/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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"}