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

package/dist/premium/index.js

@@ -0,0 +1,54 @@
+/**
+ * @name premium/index
+ * @description Barrel export for the SAP MCP Premium plugin subsystem.
+ *
+ * Re-exports every public module in the premium layer so external consumers
+ * (MCP tools, remote server, tests) can import from a single entry point:
+ *
+ * ```ts
+ * import {
+ *   listPremiumPlugins,
+ *   createPremiumSessionPlan,
+ *   activatePremiumSession,
+ *   startStream,
+ *   streamEvents,
+ *   registerWebhook,
+ *   getPremiumMetrics,
+ *   validatePremiumPluginManifest,
+ *   type PremiumPluginManifest,
+ * } from '../premium/index.js';
+ * ```
+ *
+ * @flow
+ *   Import order matters only for readability, not for runtime:
+ *   1. `builtin-plugins`       — Built-in plugin definitions and discovery helpers.
+ *   2. `manifest-builder`      — Template generation for custom plugin authors.
+ *   3. `private-manifest-loader` — Filesystem loader for enterprise manifests.
+ *   4. `plugin-validator`      — Manifest validation against strict schema rules.
+ *   5. `session-manager`       — In-memory session plan lifecycle.
+ *   6. `activation-manager`    — x402/pay.sh receipt binding and session activation.
+ *   7. `event-store`           — Replay and idempotency store for delivered events.
+ *   8. `provider-bridge`       — Dynamic loader for private provider adapters.
+ *   9. `stream-broker`         — SSE stream delivery for premium real-time events.
+ *  10. `webhook-engine`        — Signed webhook delivery for premium event callbacks.
+ *  11. `metrics`               — Premium subsystem metrics snapshot.
+ *  12. `types`                 — All TypeScript type declarations.
+ *
+ * @module premium/index
+ */
+export * from './builtin-plugins.js';
+export * from './trading-capabilities.js';
+export * from './meme-radar-capabilities.js';
+export * from './tech-fundamentals-capabilities.js';
+export * from './manifest-builder.js';
+export * from './private-manifest-loader.js';
+export * from './plugin-validator.js';
+export * from './session-manager.js';
+export * from './activation-manager.js';
+export * from './event-store.js';
+export * from './provider-bridge.js';
+export * from './stream-broker.js';
+export * from './webhook-engine.js';
+export * from './metrics.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/premium/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/premium/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/premium/manifest-builder.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @name premium/manifest-builder
+ * @description Template generator for custom premium plugin manifests.
+ *
+ * Produces a data-only `PremiumPluginManifest` from a simplified request,
+ * filling in sensible defaults for pricing, delivery, and JSON schemas.
+ * The generated template is meant to be customized by plugin authors before
+ * production use — it never writes files, loads code, or embeds secrets.
+ *
+ * @flow
+ *   1. MCP tool `sap_premium_build_manifest_template` receives a request
+ *      with plugin id, capability id, type, and optional overrides.
+ *   2. → `buildPremiumPluginManifestTemplate(request)` generates a full manifest
+ *      with default pricing/delivery/schema based on capability type.
+ *   3. The agent returns the manifest JSON to the caller for review/customization.
+ *   4. The caller can then validate it with `validatePremiumPluginManifest`.
+ *
+ * @module premium/manifest-builder
+ */
+import type { PremiumCapabilityType, PremiumPluginManifest } from './types.js';
+/**
+ * @name PremiumManifestTemplateRequest
+ * @description Simplified request for generating a premium plugin manifest template.
+ *
+ * Only `pluginId`, `capabilityId`, and `capabilityType` are required. All other
+ * fields have sensible defaults and can be overridden by the caller.
+ *
+ * @property pluginId        - Unique plugin id (lowercase, dots/dashes allowed).
+ * @property capabilityId    - Unique capability id within the plugin.
+ * @property capabilityType  - `stream`, `webhook`, or `tool`.
+ * @property title           - Optional human-readable label (defaults applied).
+ * @property description     - Optional agent-facing description (defaults applied).
+ * @property publisher       - Optional publisher name (defaults to 'Custom Publisher').
+ * @property visibility       - Optional visibility (defaults to 'private').
+ * @property unitPriceUsd    - Optional price per unit in USD (defaults to 0.01).
+ * @property providerEnv     - Optional env var names for provider readiness.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_build_manifest_template`.
+ */
+export interface PremiumManifestTemplateRequest {
+    pluginId: string;
+    capabilityId: string;
+    capabilityType: PremiumCapabilityType;
+    title?: string;
+    description?: string;
+    publisher?: string;
+    visibility?: 'public' | 'private' | 'enterprise';
+    unitPriceUsd?: number;
+    providerEnv?: string[];
+}
+/**
+ * @name buildPremiumPluginManifestTemplate
+ * @description Build a data-only premium plugin manifest template from a simplified request.
+ *
+ * It never writes files, loads code, or embeds provider secrets. The generated
+ * manifest uses default schemas, pricing, and delivery contracts that are
+ * sensible starting points but should be customized before production use.
+ *
+ * @param request - Template request with required plugin/capability ids and type.
+ * @returns A complete `PremiumPluginManifest` with one capability.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_build_manifest_template`.
+ */
+export declare function buildPremiumPluginManifestTemplate(request: PremiumManifestTemplateRequest): PremiumPluginManifest;
+//# sourceMappingURL=manifest-builder.d.ts.map

package/dist/premium/manifest-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-builder.d.ts","sourceRoot":"","sources":["../../src/premium/manifest-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EAErB,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,qBAAqB,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAkID;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,8BAA8B,GAAG,qBAAqB,CA4BjH"}

package/dist/premium/manifest-builder.js

@@ -0,0 +1,182 @@
+/**
+ * @name premium/manifest-builder
+ * @description Template generator for custom premium plugin manifests.
+ *
+ * Produces a data-only `PremiumPluginManifest` from a simplified request,
+ * filling in sensible defaults for pricing, delivery, and JSON schemas.
+ * The generated template is meant to be customized by plugin authors before
+ * production use — it never writes files, loads code, or embeds secrets.
+ *
+ * @flow
+ *   1. MCP tool `sap_premium_build_manifest_template` receives a request
+ *      with plugin id, capability id, type, and optional overrides.
+ *   2. → `buildPremiumPluginManifestTemplate(request)` generates a full manifest
+ *      with default pricing/delivery/schema based on capability type.
+ *   3. The agent returns the manifest JSON to the caller for review/customization.
+ *   4. The caller can then validate it with `validatePremiumPluginManifest`.
+ *
+ * @module premium/manifest-builder
+ */
+/* -------------------------------------------------------------------------- */
+/* Default JSON schemas                                                       */
+/* -------------------------------------------------------------------------- */
+/**
+ * @description Default input schema for template-generated capabilities.
+ * Requires a `requestId` for idempotency and allows free-form `filters`.
+ */
+const defaultInputSchema = {
+    type: 'object',
+    required: ['requestId'],
+    properties: {
+        requestId: {
+            type: 'string',
+            description: 'Caller-provided idempotency key binding planning, payment, delivery, and audit output.',
+        },
+        filters: {
+            type: 'object',
+            additionalProperties: true,
+            description: 'Narrow capability-specific filters. Keep broad scans out of premium delivery paths.',
+        },
+    },
+    additionalProperties: false,
+};
+/**
+ * @description Default output schema for template-generated capabilities.
+ * Returns a stable event id, ISO timestamp, and a versioned provider payload.
+ * The `payload` field uses `additionalProperties: true` as a placeholder —
+ * plugin authors should replace it with a strict object schema before production.
+ */
+const defaultOutputSchema = {
+    type: 'object',
+    required: ['eventId', 'observedAt', 'payload'],
+    properties: {
+        eventId: {
+            type: 'string',
+            description: 'Stable provider event id suitable for audit binding, replay protection, and de-duplication.',
+        },
+        observedAt: {
+            type: 'string',
+            format: 'date-time',
+            description: 'ISO timestamp when the provider observed or delivered this premium result.',
+        },
+        payload: {
+            type: 'object',
+            additionalProperties: true,
+            description: 'Provider-specific payload. Replace this with a strict object schema before production.',
+        },
+    },
+    additionalProperties: false,
+};
+/* -------------------------------------------------------------------------- */
+/* Default pricing & delivery factories                                       */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name defaultPricing
+ * @description Generate a default `PremiumPricingPolicy` based on capability type.
+ *
+ * Maps each type to its canonical pricing model, unit, and tier:
+ *   - `stream`  → `x402-per-minute`, `minute`, `premium-stream`, 1–120 units.
+ *   - `webhook` → `x402-per-event`, `event`, `premium-webhook`, 10–100 000 units.
+ *   - `tool`    → `x402-session`, `session`, `premium-tool`, 1–120 units.
+ *
+ * @param type          - The capability type to generate pricing for.
+ * @param unitPriceUsd  - Price per unit in USD.
+ * @returns A complete `PremiumPricingPolicy` with `x402` settlement.
+ *
+ * @internal
+ */
+function defaultPricing(type, unitPriceUsd) {
+    const modelByType = {
+        stream: 'x402-per-minute',
+        webhook: 'x402-per-event',
+        tool: 'x402-session',
+    };
+    const unitByType = {
+        stream: 'minute',
+        webhook: 'event',
+        tool: 'session',
+    };
+    const tierByType = {
+        stream: 'premium-stream',
+        webhook: 'premium-webhook',
+        tool: 'premium-tool',
+    };
+    return {
+        tier: tierByType[type],
+        model: modelByType[type],
+        unit: unitByType[type],
+        unitPriceUsd,
+        minUnits: type === 'webhook' ? 10 : 1,
+        maxUnits: type === 'webhook' ? 100_000 : 120,
+        settlement: 'x402',
+    };
+}
+/**
+ * @name defaultDelivery
+ * @description Generate a default `PremiumDeliveryContract` based on capability type.
+ *
+ * Maps each type to its canonical transport, event id pattern, latency, and
+ * replay window:
+ *   - `stream`  → `mcp-streamable-http`, 750ms latency, 300s replay.
+ *   - `webhook` → `webhook-http`, 1500ms latency, 900s replay.
+ *   - `tool`    → `mcp-streamable-http`, 1500ms latency, 300s replay.
+ *
+ * @param type - The capability type to generate delivery for.
+ * @returns A complete `PremiumDeliveryContract`.
+ *
+ * @internal
+ */
+function defaultDelivery(type) {
+    return {
+        transport: type === 'webhook' ? 'webhook-http' : 'mcp-streamable-http',
+        events: type === 'tool' ? ['tool.completed'] : [`${type}.event`],
+        latencyTargetMs: type === 'stream' ? 750 : 1_500,
+        replayWindowSeconds: type === 'webhook' ? 900 : 300,
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* Public API                                                                 */
+/* -------------------------------------------------------------------------- */
+/**
+ * @name buildPremiumPluginManifestTemplate
+ * @description Build a data-only premium plugin manifest template from a simplified request.
+ *
+ * It never writes files, loads code, or embeds provider secrets. The generated
+ * manifest uses default schemas, pricing, and delivery contracts that are
+ * sensible starting points but should be customized before production use.
+ *
+ * @param request - Template request with required plugin/capability ids and type.
+ * @returns A complete `PremiumPluginManifest` with one capability.
+ *
+ * @usedBy `premium-tools.ts` → MCP tool `sap_premium_build_manifest_template`.
+ */
+export function buildPremiumPluginManifestTemplate(request) {
+    // Filter out empty/falsy env var names from the request.
+    const providerEnv = request.providerEnv?.filter(Boolean) ?? [];
+    return {
+        id: request.pluginId,
+        version: '0.1.0',
+        title: request.title ?? 'Custom SAP MCP Premium Plugin',
+        description: request.description
+            ?? 'Custom premium SAP MCP capability contract for paid agent runtime delivery with strict schemas and x402/pay.sh settlement.',
+        publisher: request.publisher ?? 'Custom Publisher',
+        visibility: request.visibility ?? 'private',
+        capabilities: [
+            {
+                id: request.capabilityId,
+                type: request.capabilityType,
+                title: request.title ?? 'Custom premium capability',
+                description: request.description
+                    ?? 'Custom premium capability. Replace this description with a concrete agent use case, delivery boundary, provider dependency, and payment model before production.',
+                status: providerEnv.length > 0 ? 'requires-provider' : 'planned',
+                requiresProvider: providerEnv.length > 0,
+                providerEnv,
+                inputSchema: defaultInputSchema,
+                outputSchema: defaultOutputSchema,
+                pricing: defaultPricing(request.capabilityType, request.unitPriceUsd ?? 0.01),
+                delivery: defaultDelivery(request.capabilityType),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=manifest-builder.js.map

package/dist/premium/manifest-builder.js.map

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

package/dist/premium/meme-radar-capabilities.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @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
+ */
+import type { PremiumPluginManifest } from './types.js';
+/**
+ * @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 declare const MEME_RADAR_PREMIUM_PLUGINS: PremiumPluginManifest[];
+//# sourceMappingURL=meme-radar-capabilities.d.ts.map

package/dist/premium/meme-radar-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meme-radar-capabilities.d.ts","sourceRoot":"","sources":["../../src/premium/meme-radar-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAA+B,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAmRrF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,qBAAqB,EA4C7D,CAAC"}

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