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

package/dist/premium/meme-radar-capabilities.js

@@ -0,0 +1,306 @@
+/**
+ * @name premium/meme-radar-capabilities
+ * @description Built-in premium meme radar capabilities for Solana meme token analysis.
+ *
+ * Defines 4 premium meme radar capabilities across 1 plugin:
+ *
+ *   1. `sap-premium-meme-radar` — Meme token intelligence:
+ *      - `meme.newlisting.alert`  — New token listing alerts (webhook)
+ *      - `meme.social.sentiment`  — Social sentiment stream (stream)
+ *      - `meme.rugpull.detector`  — Rugpull risk monitoring (stream)
+ *      - `meme.volume.spike`      — DEX volume anomaly detection (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 meme radar capabilities via `sap_premium_plugin_catalog`.
+ *   2. Agent creates a session plan for a meme 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 listing alerts via `POST /premium/webhook/register`.
+ *   6. Provider adapter in the private subrepo feeds real meme token data.
+ *
+ * @module premium/meme-radar-capabilities
+ */
+/* -------------------------------------------------------------------------- */
+/* Shared schemas                                                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * @description Input schema for meme stream capabilities. Requires a
+ * `subscriptionKey` for de-duplication and supports narrow filters for
+ * mints, minimum liquidity, and minimum volume thresholds.
+ */
+const memeStreamInputSchema = {
+    type: 'object',
+    required: ['subscriptionKey'],
+    properties: {
+        subscriptionKey: {
+            type: 'string',
+            minLength: 3,
+            description: 'Stable subscription key for de-duplication. Use a hash of mint + strategy id.',
+        },
+        mints: {
+            type: 'array',
+            items: { type: 'string', minLength: 32, maxLength: 44 },
+            description: 'Token mint addresses to watch. Empty = all tokens.',
+        },
+        minLiquidityUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum pool liquidity in USD to emit an event. Filters low-liquidity noise.',
+        },
+        minVolumeUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum 24h volume in USD to emit an event. Filters low-volume tokens.',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Output schema for meme stream events. Each event carries
+ * a signal type, actionable data (sentiment, risk, volume), and metadata
+ * for decision-making by the agent.
+ */
+const memeStreamOutputSchema = {
+    type: 'object',
+    required: ['eventId', 'eventType', 'observedAt', 'payload'],
+    properties: {
+        eventId: {
+            type: 'string',
+            description: 'Stable event id for idempotent execution and replay.',
+        },
+        eventType: {
+            type: 'string',
+            enum: [
+                'social.sentiment',
+                'rugpull.risk',
+                'volume.spike',
+            ],
+            description: 'Meme radar event type determining the payload structure.',
+        },
+        observedAt: {
+            type: 'string',
+            format: 'date-time',
+            description: 'ISO timestamp when the provider observed the meme token condition.',
+        },
+        payload: {
+            type: 'object',
+            required: ['mint', 'action', 'confidence'],
+            properties: {
+                mint: { type: 'string', description: 'Token mint address.' },
+                action: {
+                    type: 'string',
+                    enum: ['buy', 'sell', 'monitor', 'alert', 'avoid'],
+                    description: 'Recommended agent action.',
+                },
+                confidence: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 1,
+                    description: 'Signal confidence score (0-1).',
+                },
+                bullScore: { type: 'number', description: 'Bullish sentiment score (0-100).' },
+                bearScore: { type: 'number', description: 'Bearish sentiment score (0-100).' },
+                liquidityUsd: { type: 'number', description: 'Current pool liquidity in USD.' },
+                volume24hUsd: { type: 'number', description: '24-hour trading volume in USD.' },
+                volumeChangePct: { type: 'number', description: 'Volume change percentage vs baseline.' },
+                devWalletHoldingPct: { type: 'number', description: 'Dev wallet holding percentage.' },
+                mintAuthority: { type: 'boolean', description: 'Whether mint authority is still active.' },
+                freezeAuthority: { type: 'boolean', description: 'Whether freeze authority is still active.' },
+                honeypotRisk: { type: 'boolean', description: 'Whether honeypot risk was detected.' },
+                riskLevel: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'critical'],
+                    description: 'Rugpull risk level.',
+                },
+                expiresAt: { type: 'string', format: 'date-time', description: 'Signal expiry timestamp.' },
+            },
+            additionalProperties: true,
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Input schema for meme webhook capabilities. The buyer
+ * provides an HTTPS endpoint and selects which event types to receive.
+ */
+const memeWebhookInputSchema = {
+    type: 'object',
+    required: ['targetUrl', 'events'],
+    properties: {
+        targetUrl: {
+            type: 'string',
+            format: 'uri',
+            description: 'HTTPS webhook endpoint owned by the trading agent.',
+        },
+        events: {
+            type: 'array',
+            minItems: 1,
+            items: {
+                type: 'string',
+                enum: ['meme.newlisting.alert'],
+            },
+            description: 'Event types to deliver to this webhook.',
+        },
+        minLiquidityUsd: {
+            type: 'number',
+            minimum: 0,
+            description: 'Minimum liquidity in USD for listing alerts. Filters low-liquidity tokens.',
+        },
+        honeypotCheck: {
+            type: 'boolean',
+            description: 'Whether to run honeypot scan on new listings. Default: true.',
+        },
+        devWalletCheck: {
+            type: 'boolean',
+            description: 'Whether to analyze dev wallet holdings and movements. Default: true.',
+        },
+        signingPublicKey: {
+            type: 'string',
+            description: 'Optional public key for webhook signature verification.',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Output schema for meme webhook deliveries.
+ */
+const memeWebhookOutputSchema = {
+    type: 'object',
+    required: ['deliveryId', 'eventType', 'deliveredAt', 'signature', 'payload'],
+    properties: {
+        deliveryId: { type: 'string', description: 'Idempotent delivery id.' },
+        eventType: { type: 'string', description: 'Meme radar 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: 'Meme radar payload with listing details, honeypot scan, and dev wallet analysis.',
+        },
+    },
+    additionalProperties: false,
+};
+/* -------------------------------------------------------------------------- */
+/* Capability factory                                                         */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name memeStreamCapability
+ * @description Factory for building a meme radar stream capability definition.
+ *
+ * @param id           - Capability id (e.g. `meme.social.sentiment`).
+ * @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 memeStreamCapability(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: memeStreamInputSchema,
+        outputSchema: memeStreamOutputSchema,
+        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: 500,
+            replayWindowSeconds: 180,
+        },
+    };
+}
+/**
+ * @name memeWebhookCapability
+ * @description Factory for building a meme radar webhook capability definition.
+ *
+ * @param id           - Capability id (e.g. `meme.newlisting.alert`).
+ * @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 memeWebhookCapability(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: memeWebhookInputSchema,
+        outputSchema: memeWebhookOutputSchema,
+        pricing: {
+            tier: 'premium-webhook',
+            model: 'x402-per-event',
+            unit: 'event',
+            unitPriceUsd,
+            minUnits: 5,
+            maxUnits: 50_000,
+            settlement: 'x402',
+        },
+        delivery: {
+            transport: 'webhook-http',
+            events,
+            latencyTargetMs: 750,
+            replayWindowSeconds: 300,
+        },
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Plugin manifests                                                           */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name MEME_RADAR_PREMIUM_PLUGINS
+ * @description Built-in premium meme radar plugin manifests.
+ *
+ * One plugin covering 4 meme radar capabilities:
+ *   - `sap-premium-meme-radar` — 1 webhook + 3 stream capabilities
+ *
+ * @usedBy `listPremiumPlugins()` — merged with the existing built-in plugins.
+ */
+export const MEME_RADAR_PREMIUM_PLUGINS = [
+    {
+        id: 'sap-premium-meme-radar',
+        version: '0.1.0',
+        title: 'SAP Premium Meme Radar',
+        description: 'Paid meme token intelligence for Solana agents: new listing alerts with honeypot and dev wallet analysis, social sentiment streams, rugpull risk monitoring, and DEX volume anomaly detection. Real-time delivery with x402 metering.',
+        publisher: 'OOBE Protocol',
+        visibility: 'public',
+        capabilities: [
+            memeWebhookCapability('meme.newlisting.alert', 'New token listing alerts', 'Delivers signed webhook callbacks when new tokens are listed on Raydium, Orca, or Meteora. Each alert includes liquidity check results, honeypot scan status, and dev wallet holding analysis. Agents receive mint address, pool details, risk flags, and recommended action for instant decision-making on new meme token opportunities.', ['meme.newlisting.alert'], 0.003, // $0.003/event
+            ['SAP_MCP_PREMIUM_BIRDEYE_API_URL', 'SAP_MCP_PREMIUM_WEBHOOK_SIGNER']),
+            memeStreamCapability('meme.social.sentiment', 'Social sentiment stream', 'Streams real-time social sentiment scores for specified meme tokens. Continuously aggregates social signals from Twitter, Telegram, and Discord to produce bull/bear scores. Agents receive mint, bull score, bear score, confidence, and sentiment trend direction for social-driven trading decisions.', ['social.sentiment'], 0.02, // $0.02/min
+            ['SAP_MCP_PREMIUM_BIRDEYE_API_URL']),
+            memeStreamCapability('meme.rugpull.detector', 'Rugpull risk detector', 'Continuously monitors pool liquidity changes, dev wallet movements, mint authority status, and freeze authority status for specified meme tokens. Emits risk alerts when rugpull indicators are detected — liquidity drain, dev wallet dump, mint authority activation, or freeze authority usage. Agents receive risk level, affected mint, and recommended action (avoid/exit).', ['rugpull.risk'], 0.04, // $0.04/min
+            ['SAP_MCP_PREMIUM_DEXSCREENER_API_URL', 'SAP_MCP_PREMIUM_BIRDEYE_API_URL']),
+            memeStreamCapability('meme.volume.spike', 'DEX volume anomaly detector', 'Monitors DEX trading volume for specified meme tokens and detects anomalous volume spikes that may indicate pump/dump activity. Uses statistical baselines to flag unusual volume patterns. Agents receive mint, volume change percentage, current vs baseline volume, and confidence score for volume-driven trading signals.', ['volume.spike'], 0.025, // $0.025/min
+            ['SAP_MCP_PREMIUM_DEXSCREENER_API_URL']),
+        ],
+    },
+];
+//# sourceMappingURL=meme-radar-capabilities.js.map

package/dist/premium/meme-radar-capabilities.js.map

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

package/dist/premium/metrics.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @name premium/metrics
+ * @description Metrics collector for the premium subsystem.
+ *
+ * Aggregates counts from the session manager, event store, stream broker,
+ * webhook engine, and provider bridge into a single `PremiumMetricsSnapshot`.
+ * Used by the health endpoint (`GET /premium/health.json`) and MCP monitoring
+ * tools.
+ *
+ * @flow
+ *   1. `remote/server.ts` → `GET /premium/health.json` → `getPremiumMetrics()`.
+ *   2. `premium-tools.ts` → `sap_premium_metrics` → `getPremiumMetrics()`.
+ *
+ * @module premium/metrics
+ */
+import type { PremiumMetricsSnapshot } from './types.js';
+/**
+ * @name getPremiumMetrics
+ * @description Collect a point-in-time metrics snapshot of the premium subsystem.
+ *
+ * @returns `PremiumMetricsSnapshot` with current counts and provider health.
+ *
+ * @usedBy `remote/server.ts` → `GET /premium/health.json`,
+ *   `premium-tools.ts` → `sap_premium_metrics`
+ */
+export declare function getPremiumMetrics(): Promise<PremiumMetricsSnapshot>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/premium/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/premium/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAsCzE"}

package/dist/premium/metrics.js

@@ -0,0 +1,65 @@
+/**
+ * @name premium/metrics
+ * @description Metrics collector for the premium subsystem.
+ *
+ * Aggregates counts from the session manager, event store, stream broker,
+ * webhook engine, and provider bridge into a single `PremiumMetricsSnapshot`.
+ * Used by the health endpoint (`GET /premium/health.json`) and MCP monitoring
+ * tools.
+ *
+ * @flow
+ *   1. `remote/server.ts` → `GET /premium/health.json` → `getPremiumMetrics()`.
+ *   2. `premium-tools.ts` → `sap_premium_metrics` → `getPremiumMetrics()`.
+ *
+ * @module premium/metrics
+ */
+import { listPremiumSessions } from './session-manager.js';
+import { getEventCount } from './event-store.js';
+import { getActiveStreamCount } from './stream-broker.js';
+import { getActiveWebhookCount } from './webhook-engine.js';
+import { getAllProviderHealth } from './provider-bridge.js';
+/**
+ * @name getPremiumMetrics
+ * @description Collect a point-in-time metrics snapshot of the premium subsystem.
+ *
+ * @returns `PremiumMetricsSnapshot` with current counts and provider health.
+ *
+ * @usedBy `remote/server.ts` → `GET /premium/health.json`,
+ *   `premium-tools.ts` → `sap_premium_metrics`
+ */
+export async function getPremiumMetrics() {
+    const sessions = listPremiumSessions();
+    let activeSessions = 0;
+    let pendingSessions = 0;
+    let blockedSessions = 0;
+    let totalRevenueUsd = 0;
+    for (const session of sessions) {
+        switch (session.status) {
+            case 'active':
+                activeSessions++;
+                totalRevenueUsd += session.estimatedPriceUsd;
+                break;
+            case 'pending_payment':
+                pendingSessions++;
+                break;
+            case 'blocked_requires_provider':
+                blockedSessions++;
+                break;
+            default:
+                break;
+        }
+    }
+    const providerHealth = await getAllProviderHealth();
+    return {
+        activeSessions,
+        pendingSessions,
+        blockedSessions,
+        totalSessionsCreated: sessions.length,
+        totalEventsDelivered: getEventCount(),
+        totalRevenueUsd: Number(totalRevenueUsd.toFixed(6)),
+        activeStreams: getActiveStreamCount(),
+        activeWebhooks: getActiveWebhookCount(),
+        providerHealth,
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/premium/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/premium/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,KAAK,QAAQ;gBACX,cAAc,EAAE,CAAC;gBACjB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC;gBAC7C,MAAM;YACR,KAAK,iBAAiB;gBACpB,eAAe,EAAE,CAAC;gBAClB,MAAM;YACR,KAAK,2BAA2B;gBAC9B,eAAe,EAAE,CAAC;gBAClB,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAEpD,OAAO;QACL,cAAc;QACd,eAAe;QACf,eAAe;QACf,oBAAoB,EAAE,QAAQ,CAAC,MAAM;QACrC,oBAAoB,EAAE,aAAa,EAAE;QACrC,eAAe,EAAE,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnD,aAAa,EAAE,oBAAoB,EAAE;QACrC,cAAc,EAAE,qBAAqB,EAAE;QACvC,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/premium/plugin-validator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @name premium/plugin-validator
+ * @description Strict structural validator for premium plugin manifests.
+ *
+ * Validates unknown JSON objects against the `PremiumPluginManifest` shape,
+ * rejecting unknown fields (so private provider secrets or executable code
+ * cannot leak through manifests), enforcing semver versions, JSON Schema
+ * correctness, pricing bounds, and delivery contract constraints.
+ *
+ * Used by:
+ *   - `private-manifest-loader.ts` → validates every `.json` file loaded from disk.
+ *   - `premium-tools.ts` → MCP tool `sap_premium_validate_plugin_manifest`.
+ *
+ * @flow
+ *   1. External manifest JSON arrives (filesystem or MCP tool argument).
+ *   2. → `validatePremiumPluginManifest(manifest)` runs structural checks.
+ *   3. Returns `PremiumValidationReport` with errors[] and warnings[].
+ *   4. Caller decides: accept (valid=true) or reject with error details.
+ *
+ * @module premium/plugin-validator
+ */
+import type { PremiumValidationReport } from './types.js';
+/**
+ * @name validatePremiumPluginManifest
+ * @description Validate an unknown value as a `PremiumPluginManifest`.
+ *
+ * Top-level checks: object shape, id format, semver version, title, description
+ * length, publisher, visibility enum, and at least one capability. Each
+ * capability is then validated by `validateCapability`.
+ *
+ * @param manifest - Unknown JSON value (from filesystem or MCP tool argument).
+ * @returns `PremiumValidationReport` with `valid`, `errors[]`, and `warnings[]`.
+ *
+ * @usedBy
+ *   - `private-manifest-loader.ts` → validates each `.json` file from disk.
+ *   - `premium-tools.ts` → MCP tool `sap_premium_validate_plugin_manifest`.
+ */
+export declare function validatePremiumPluginManifest(manifest: unknown): PremiumValidationReport;
+//# sourceMappingURL=plugin-validator.d.ts.map

package/dist/premium/plugin-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-validator.d.ts","sourceRoot":"","sources":["../../src/premium/plugin-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAA8E,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA8QtI;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,GAAG,uBAAuB,CAgDxF"}