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

package/.env.example

@@ -181,12 +181,13 @@ SAP_MCP_FACILITATOR_NETWORKS=devnet
 
 # Initial pricing:
 # Free: tools/list, prompts/list, resources/list, sap_profile_current, base overview.
-# Read premium: enriched discovery/indexes/network stats.
-# Builder: SNS batch checks, analytics, transaction builders.
-# Value action: fixed fee plus basis-points fee when public USD notional is present.
-SAP_MCP_PRICE_READ_PREMIUM_USD=0.008
-SAP_MCP_PRICE_BUILDER_USD=0.05
-SAP_MCP_PRICE_VALUE_FIXED_USD=0.20
-SAP_MCP_PRICE_VALUE_BPS=50
+# Read premium: broad discovery, market/oracle/DAS reads, enriched pages.
+# Builder: SNS batch checks, analytics, unsigned transaction builders.
+# Value action: fixed fee for value-linked operations; heavy paths can use a higher fixed fee.
+SAP_MCP_PRICE_READ_PREMIUM_USD=0.001
+SAP_MCP_PRICE_BUILDER_USD=0.008
+SAP_MCP_PRICE_VALUE_FIXED_USD=0.09
+SAP_MCP_PRICE_HEAVY_VALUE_USD=0.15
+SAP_MCP_PRICE_VALUE_BPS=0
 SAP_MCP_PRICE_MIN_USD=0.001
 SAP_MCP_PRICE_MAX_USD=100

package/CHANGELOG.md

@@ -2,6 +2,233 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.9.20 - 2026-07-25
+
+### Added
+
+- Added 10 new MCP tools for perpetual futures trading and chart analysis:
+  - `sap_perp_markets` — List Adrena perp markets with mark price, funding, OI.
+  - `sap_perp_position_info` — Read on-chain Adrena perp positions for a wallet.
+  - `sap_perp_funding_history` — Historical funding rates from Adrena API.
+  - `sap_chart_ohlc` — OHLC candlestick data for any Solana token (DexScreener).
+  - `sap_chart_long_term` — Long-term price history + protocol TVL (DexScreener + DeFiLlama).
+  - `sap_chart_volume_profile` — Volume profile analysis with POC, VAH, VAL.
+  - `sap_perp_liquidation_zones` — Compute liquidation zones for open positions.
+  - `sap_perp_build_open` — Build unsigned tx to open leveraged perp position (Adrena).
+  - `sap_perp_build_close` — Build unsigned tx to close a perp position.
+  - `sap_perp_build_modify` — Build unsigned tx to add/remove collateral.
+- All 10 tools use only free APIs (DexScreener, DeFiLlama, Adrena REST, Solana RPC).
+- Inscribed tools (`sap_perp_build_*`) return unsigned transactions for local agent signing.
+
+### Removed
+
+- Removed `sap-premium-agent-events` plugin (depended on REGISTRY_STREAM_URL — internal).
+- Removed `sap-premium-x402-ledger` plugin (depended on X402_STREAM_URL — internal).
+- Removed `sap-premium-trading-signals` plugin (depended on SIGNAL_PROVIDER_URL — not built).
+- Removed `sap-premium-lowcap-discovery` plugin (depended on BIRDEYE_API_URL — paid).
+- Removed `meme.social.sentiment` capability (depended on BIRDEYE_API_URL — paid).
+- Removed `tech.github.activity` and `tech.tokenomics.analysis` capabilities (GITHUB_API_URL — rate limited).
+- Removed `mempool.whale.alert` capability and provider.
+- Removed all env vars for paid/internal services: REGISTRY_STREAM_URL, X402_STREAM_URL,
+  SIGNAL_PROVIDER_URL, BIRDEYE_API_URL, GITHUB_API_URL, MEMPOOL_STREAM_URL.
+- Deleted 4 manifest JSON files, 11 provider TS files, 2 provider directories.
+
+### Improved
+
+- Hardened `webhook-engine.ts`: `signDelivery()` now throws if
+  `SAP_MCP_PREMIUM_WEBHOOK_SIGNER` is not set (was using 'fallback-dev-key').
+- Zero signing keys exposed in premium provider code — all providers are read-only
+  data streams + webhook delivery. No sendTransaction, Keypair.from, or secretKey.
+- Premium capabilities reduced from 23 to 10 — all now use only free APIs.
+- Updated `server-metadata.ts` tool count from 302 to 312.
+- Updated `builtin-plugins.test.ts` plugin count from 8 to 4.
+- Updated `trading-capabilities.ts` from 6 to 3 capabilities.
+- Updated pnpm overrides for Dependabot vulnerability fixes (postcss, langsmith,
+  @hono/node-server, uuid).
+- Bumped package, server metadata, and runtime version to `0.9.20`.
+
+## 0.9.19 - 2026-07-25
+
+### Added
+
+- Added 5 new premium plugin definitions with 15 additional capabilities:
+  - `sap-premium-trading-streams` — 4 WebSocket stream capabilities (arbitrage,
+    volatility, whale, route optimization) powered by Jupiter, Pyth, and Helius.
+  - `sap-premium-trading-signals` — 3 webhook signal capabilities (breakout,
+    liquidation cascade, funding rate) via the signal provider rail.
+  - `sap-premium-meme-radar` — 4 capabilities (new listing alert, social
+    sentiment, rugpull detector, volume spike) using Birdeye + DexScreener.
+  - `sap-premium-lowcap-discovery` — 3 capabilities (gem scan, early entry,
+    holder analysis) using Birdeye API for low-cap token discovery.
+  - `sap-premium-tech-fundamentals` — 3 capabilities (GitHub activity, TVL
+    change, tokenomics analysis) using GitHub + DeFiLlama APIs.
+- Added real provider implementations for all 3 core premium plugins
+  (market-data, agent-events, x402-ledger) with WebSocket connections,
+  exponential backoff reconnection, queue-based async generators, and graceful
+  disconnect. Replaced all stub/skeletal placeholders.
+- Added 17 provider adapter files in the private subrepo
+  (`sap-mcp-premium-private/providers/`) covering trading streams, trading
+  signals, meme radar, lowcap discovery, and tech fundamentals with real
+  WebSocket and HTTP polling implementations against free API endpoints.
+- Added OHLC candlestick and on-chain Solana data providers using
+  `@solana/web3.js` Connection and Birdeye OHLC endpoint.
+- Added 5 pure-function technical indicators (Bollinger Bands, ATR, RSI,
+  Volume Profile, Holder Concentration) and 5 stateless strategy engines
+  (Scalping, Arbitrage, Momentum, Mean-Reversion, Meme-Sniper).
+- Added 5 manifest JSON files for the new premium plugins in the private
+  subrepo, bringing the total to 8 manifests with 24 capabilities.
+- Added `src/remote/premium-routes.ts` and `src/remote/premium-memory.ts` for
+  HTTP premium delivery rails.
+- Added full TSDoc documentation (`@name`, `@description`, `@flow`, `@env`,
+  `@module`) across all premium source files and private subrepo providers.
+
+### Improved
+
+- Updated `builtin-plugins.ts` to merge `TRADING_PREMIUM_PLUGINS`,
+  `MEME_RADAR_PREMIUM_PLUGINS`, `LOWCAP_DISCOVERY_PREMIUM_PLUGINS`, and
+  `TECH_FUNDAMENTALS_PREMIUM_PLUGINS` into `listPremiumPlugins()`.
+- Updated premium env templates (production, staging, trading) with 6 new
+  provider env vars for Birdeye, DexScreener, GitHub, DeFiLlama, mempool, and
+  signal provider endpoints.
+- Rewrote private subrepo README with complete structure documentation and
+  zero references to stubs or placeholders.
+- Bumped package, server metadata, and runtime version to `0.9.19`.
+
+## Unreleased
+
+### Added
+
+- Added a typed SAP MCP premium plugin runtime foundation with free discovery
+  and planning tools for stream, webhook, and premium plugin contracts.
+- Added `sap_premium_plugin_catalog`, `sap_stream_catalog`,
+  `sap_webhook_catalog`, `sap_premium_validate_plugin_manifest`,
+  `sap_premium_plugin_template`, `sap_premium_session_start`, and
+  `sap_premium_session_status`.
+- Added premium manifest validation for ids, semver, descriptions, JSON
+  Schemas, pricing policies, and delivery contracts.
+- Added built-in contract manifests for premium market data, SAP agent events,
+  and x402 ledger telemetry without returning fake live data when providers are
+  not configured.
+- Added public machine-readable premium discovery endpoints at
+  `/premium/catalog.json`, `/premium/streams.json`, and
+  `/premium/webhooks.json`.
+- Added a manifest-only private plugin loader for controlled deployments using
+  `SAP_MCP_ENABLE_PREMIUM_PLUGINS`, `SAP_MCP_PLUGIN_DIR`, and
+  `SAP_MCP_PREMIUM_EXPOSE_PRIVATE_DISCOVERY`.
+
+### Improved
+
+- Kept premium discovery/session planning free in both default and strict
+  monetization modes so agents can validate provider readiness before paid
+  stream/webhook activation.
+- Documented the private enterprise plugin loader contract and the rule that
+  live premium data must only be promised when provider readiness is true.
+- Added capability-level `providerReady` signals to premium catalog responses,
+  strict root schema validation for premium plugin manifests, and bounded
+  in-memory premium session pruning.
+- Hardened premium manifests against unknown fields and unsafe provider env
+  values so private provider secrets or executable code cannot leak through
+  public discovery.
+
+## 0.9.18 - 2026-07-23
+
+### Improved
+
+- Strengthened MCP tool metadata so every registered tool carries fluent
+  intent-level guidance covering pricing, routing, and signer boundaries.
+- Extended JSON Schema enrichment to nested object, array, `oneOf`, `anyOf`,
+  and `allOf` branches so agents receive contextual descriptions for complex
+  parameters instead of guessing field names.
+- Added release-blocking regression coverage that fails if any tool has a thin
+  description, lacks exact-field guidance, or exposes an undescribed nested
+  input parameter.
+- Bumped package, public server metadata, desktop wizard, docs, and runtime
+  snippets to `0.9.18` for a coherent release surface across hosted MCP,
+  npm, registries, and client setup flows.
+
+## 0.9.17 - 2026-07-23
+
+### Added
+
+- Added the `sap-agent-intent-router` prompt, a compact MCP prompt that maps
+  user goals and common SAP/x402/MCP errors to the correct hosted read,
+  paid-call, local-signing, unsigned-builder, escrow, registry-write, or repair
+  flow.
+
+### Improved
+
+- Updated MCP initialize instructions so runtimes that support prompts can use
+  `sap-agent-intent-router` before paid calls, registry writes, escrow flows,
+  identity updates, and troubleshooting.
+- Bumped public metadata, npm/package manifests, desktop wizard references, and
+  client config snippets to `0.9.17` so users, registries, and agent runtimes
+  receive a single coherent release identity.
+- Moved supply-chain overrides to `pnpm-workspace.yaml` for pnpm 11 and pinned
+  patched `fast-uri`, `hono`, and `@hono/node-server` versions so desktop
+  release jobs pass the moderate-level audit gate.
+- Removed the duplicate npm `package-lock.json` from the pnpm-managed source
+  tree and disabled package-lock generation, preventing stale npm lock alerts
+  from diverging from the verified `pnpm-lock.yaml` dependency graph.
+- Hardened MCP client config validation and resource-template matching against
+  CodeQL-reported URL substring bypasses and regex-based template matching.
+- Hardened MCP tool-call normalization so explicit output schemas no longer
+  receive synthetic `structuredContent` for text/error responses, preventing
+  strict runtimes from rejecting otherwise-readable SAP tool errors.
+- Taught `sap_agent_next_action`, initialize instructions, prompts, skills, and
+  identity docs to classify Anchor 3012 / `AccountNotInitialized` /
+  `pricing_menu` as SAP on-chain registry lifecycle issues rather than missing
+  `sap_payments` runtime configuration.
+- Kept the `0.9.16` hardening set intact: intent-level tool schemas, payment
+  funnel telemetry, cost estimation, local MCP session reuse, hosted submit
+  relay guidance, and no-key-material safety tests.
+
+## 0.9.16 - 2026-07-21
+
+### Added
+
+- Added free `sap_agent_context`, a compact hosted orientation tool for exact
+  wallet/agent lookups and first-page agent discovery. It gives agents a
+  low-friction way to understand SAP state before running paid/broad calls.
+- Added free `sap_agent_next_action`, a routing resolver for common SAP MCP
+  errors and partial results. It tells agents whether to use hosted reads,
+  `sap_payments_*`, `sap_runtime_repair_plan`, unsigned transaction
+  finalization, or signature verification before retrying.
+- Added free `sap_estimate_tool_cost`, a pre-call estimator that gives agents
+  the pricing tier, expected USD cost, and recommended `maxPriceUsd` before
+  using `sap_payments_call_paid_tool`.
+- Added hosted payment-funnel telemetry for returned challenges, verification
+  failures, and hosted-local-signer blocks so dashboard/operator metrics
+  separate demand from successful settlements.
+- Added a short-lived MCP session cache for local paid-call retries. It reuses
+  initialized MCP sessions without caching live chain data, x402 challenges, or
+  signed payment payloads.
+
+### Improved
+
+- Made exact base SAP registry reads free by default:
+  `sap_get_agent`, `sap_get_agent_profile`, `sap_get_agent_stats`,
+  `sap_get_global_state`, and `sap_is_agent_active`.
+- Made `sap_list_agents` free for compact orientation calls while keeping
+  broad, hydrated, full, and protocol-indexed directory scans paid.
+- Added cache and singleflight protection around compact directory reads so
+  hosted discovery remains faster under repeated agent/runtime probes.
+- Updated agent bootstrap guidance, SAP skills, payment docs, and tool
+  reference files so agents start with context, resolve routing before retrying,
+  avoid temporary signing scripts, and use local `sap_payments_*` tools for
+  user-signed writes.
+- Expanded pricing tests and server metadata tests to cover the new free
+  context/resolver tools and conditional-free discovery behavior.
+- Enriched every registered tool description and root input schema with
+  intent-level routing, pricing, signer-boundary, and exact-field guidance so
+  agents stop guessing aliases, avoid hosted writes that require local signing,
+  and route user-signed transactions through supported `sap_payments_*` flows.
+- Hardened already-signed transaction submission through the hosted
+  `/tx/submit` relay with explicit retry-safety, confirmation-state, and
+  no-key-material audit fields.
+- Added release safety coverage for root input parameter descriptions,
+  hosted-local-signer ledger events, private-key guard behavior, unsafe-action
+  guard behavior, and updated public metadata version examples.
+
 ## 0.9.15 - 2026-07-20
 
 ### Added

package/README.md

@@ -15,7 +15,7 @@ User-facing setup docs live in [`USER_DOCS/`](USER_DOCS/00_START_HERE.md). Opera
 
 | Area | Current behavior |
 | --- | --- |
-| Package version | `0.2.1` |
+| Package version | `0.9.20` |
 | MCP transport | stdio locally, Streamable HTTP remotely |
 | Remote access | Bearerless public mode for hosted agents; API key or JWT for private modes |
 | Config directory | `~/.config/mcp-sap` only |
@@ -134,7 +134,7 @@ For paid/write hosted tools, add the local non-custodial payment bridge as well:
 ```toml
 [mcp_servers.sap_payments]
 command = "npx"
-args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"]
+args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"]
 startup_timeout_sec = 300
 tool_timeout_sec = 300
 
@@ -152,7 +152,7 @@ Codex supports Streamable HTTP MCP servers with URL-based entries in `config.tom
 ```toml
 [mcp_servers.sap]
 command = "npx"
-args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"]
+args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"]
 
 [mcp_servers.sap.env]
 SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE = "false"

package/USER_DOCS/01_HOSTED_REMOTE_MCP.md

@@ -29,7 +29,7 @@ Public `server.json` shape:
   "name": "sap-mcp-server",
   "title": "SAP MCP Server | OOBE Protocol",
   "description": "Hosted Solana-native MCP gateway for Synapse Agent Protocol tools, x402/pay.sh monetization, SNS identity, and agent operations.",
-  "version": "0.2.1",
+  "version": "0.9.20",
   "status": "online",
   "protocol": {
     "primary": "mcp",

package/USER_DOCS/04_CLIENT_CONFIGS.md

@@ -45,7 +45,7 @@ url = "https://mcp.sap.oobeprotocol.ai/mcp"
 
 [mcp_servers.sap_payments]
 command = "npx.cmd"
-args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"]
+args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"]
 startup_timeout_sec = 300
 tool_timeout_sec = 300
 
@@ -65,7 +65,7 @@ the complete local stdio SAP MCP process instead of using the hosted endpoint, u
 ```toml
 [mcp_servers.sap]
 command = "npx.cmd"
-args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"]
+args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"]
 
 [mcp_servers.sap.env]
 SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE = "false"
@@ -201,7 +201,7 @@ For Claude Code, use the official MCP CLI pattern:
 
 ```bash
 claude mcp add --transport http sap https://mcp.sap.oobeprotocol.ai/mcp
-claude mcp add --transport stdio sap_payments -- npx --yes --package @oobe-protocol-labs/sap-mcp-server@0.9.15 sap-mcp-server
+claude mcp add --transport stdio sap_payments -- npx --yes --package @oobe-protocol-labs/sap-mcp-server@0.9.20 sap-mcp-server
 ```
 
 Set `SAP_MCP_PAYMENTS_BRIDGE_ONLY=true` and `SAP_ALLOWED_TOOLS=all` in the

package/USER_DOCS/05_SKILLS_AND_TOOLS.md

@@ -13,14 +13,15 @@ The agent should then:
 
 1. call `sap_agent_start`;
 2. call `sap_skills_bundle` with `includeContents: true`;
-3. call `sap_skills_upgrade_plan` if skills are missing or stale;
-4. use exact tool names from `tools/list`;
-5. call `sap_payments_readiness` if the local `sap_payments` bridge is visible;
-6. use `sap_payments_call_paid_tool` for paid hosted SAP MCP tools that return x402 payment requirements;
-7. use `sap_payments_call_external_x402` for external HTTP x402 agent endpoints discovered through SAP registry metadata;
-8. use `sap_payments_register_agent` for local non-custodial SAP agent registration when hosted `sap_register_agent` is blocked;
-9. use `sap_payments_update_agent` for local non-custodial SAP agent profile/image/metadata updates when hosted `sap_update_agent` is blocked;
-10. if a paid hosted builder returns `transactionBase64`, call `sap_payments_finalize_transaction` for local preview/sign/submit.
+3. use the `sap-agent-intent-router` prompt when prompts are available and the user wants a paid call, registry write, escrow flow, identity update, or error recovery;
+4. call `sap_skills_upgrade_plan` if skills are missing or stale;
+5. use exact tool names from `tools/list`;
+6. call `sap_payments_readiness` if the local `sap_payments` bridge is visible;
+7. use `sap_payments_call_paid_tool` for paid hosted SAP MCP tools that return x402 payment requirements;
+8. use `sap_payments_call_external_x402` for external HTTP x402 agent endpoints discovered through SAP registry metadata;
+9. use `sap_payments_register_agent` for local non-custodial SAP agent registration when hosted `sap_register_agent` is blocked;
+10. use `sap_payments_update_agent` for local non-custodial SAP agent profile/image/metadata updates when hosted `sap_update_agent` is blocked;
+11. if a paid hosted builder returns `transactionBase64`, call `sap_payments_finalize_transaction` for local preview/sign/submit.
 
 If `sap_payments` is missing, run the wizard repair flow and restart the agent
 runtime:
@@ -139,6 +140,13 @@ Use transactions:
 - `sap_payments_register_agent` for SAP agent registration through the local signer bridge
 - `sap_payments_update_agent` for SAP agent profile, image metadata, capabilities, protocols, pricing, and x402 endpoint updates through the local signer bridge
 
+If a local registry update returns Anchor 3012, `AccountNotInitialized`, or a
+`pricing_menu` message, the local payment/signing bridge is not the problem.
+That error is an on-chain SAP registry lifecycle issue for a required PDA. Do
+not retry paid hosted writes or run repair loops; call `sap_agent_next_action`
+and `sap_protocol_invariants`, then use the current SDK/server initializer path
+before retrying.
+
 ## 4. Agent Safety
 
 Agents must not:

package/USER_DOCS/06_DESKTOP_GUI_WIZARD.md

@@ -106,7 +106,7 @@ url = "https://mcp.sap.oobeprotocol.ai/mcp"
 
 [mcp_servers.sap_payments]
 command = "npx"
-args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"]
+args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"]
 startup_timeout_sec = 300
 tool_timeout_sec = 300
 
@@ -138,7 +138,7 @@ Claude Desktop uses a root `mcpServers` JSON object:
     },
     "sap_payments": {
       "command": "npx",
-      "args": ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"],
+      "args": ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"],
       "env": {
         "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "false",
         "SAP_MCP_PAYMENTS_BRIDGE_ONLY": "true",
@@ -170,7 +170,7 @@ Hermes global `mcp.json` uses flat server entries:
   },
   "sap_payments": {
     "command": "npx",
-    "args": ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"],
+    "args": ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"],
     "env": {
       "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "false",
       "SAP_MCP_PAYMENTS_BRIDGE_ONLY": "true",
@@ -193,7 +193,7 @@ mcp_servers:
     args:
       - "--yes"
       - "--package"
-      - "@oobe-protocol-labs/sap-mcp-server@0.9.15"
+      - "@oobe-protocol-labs/sap-mcp-server@0.9.20"
       - "sap-mcp-server"
     env:
       SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE: "false"
@@ -215,7 +215,7 @@ OpenClaw MCP JSON uses the same root `mcpServers` structure as generic MCP clien
     },
     "sap_payments": {
       "command": "npx",
-      "args": ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.15", "sap-mcp-server"],
+      "args": ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.20", "sap-mcp-server"],
       "env": {
         "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "false",
         "SAP_MCP_PAYMENTS_BRIDGE_ONLY": "true",

package/config.example.json

@@ -53,10 +53,11 @@
     "maxTimeoutSeconds": 120,
     "payShCheckoutUrl": "https://pay.sh/checkout/YOUR_CHECKOUT_ID",
     "prices": {
-      "readPremiumUsd": 0.008,
-      "builderUsd": 0.05,
-      "valueFixedUsd": 0.2,
-      "valueBps": 50,
+      "readPremiumUsd": 0.001,
+      "builderUsd": 0.008,
+      "valueFixedUsd": 0.09,
+      "heavyValueUsd": 0.15,
+      "valueBps": 0,
       "minUsd": 0.001,
       "maxUsd": 100
     }

package/config.schema.json

@@ -329,12 +329,17 @@
             "valueFixedUsd": {
               "type": "number",
               "minimum": 0,
-              "default": 0.2
+              "default": 0.09
+            },
+            "heavyValueUsd": {
+              "type": "number",
+              "minimum": 0,
+              "default": 0.15
             },
             "valueBps": {
               "type": "number",
               "minimum": 0,
-              "default": 50
+              "default": 0
             },
             "minUsd": {
               "type": "number",

package/config.secure-example.json

@@ -56,10 +56,11 @@
     "maxTimeoutSeconds": 120,
     "payShCheckoutUrl": "https://pay.sh/checkout/YOUR_CHECKOUT_ID",
     "prices": {
-      "readPremiumUsd": 0.008,
-      "builderUsd": 0.05,
-      "valueFixedUsd": 0.2,
-      "valueBps": 50,
+      "readPremiumUsd": 0.001,
+      "builderUsd": 0.008,
+      "valueFixedUsd": 0.09,
+      "heavyValueUsd": 0.15,
+      "valueBps": 0,
       "minUsd": 0.001,
       "maxUsd": 100
     }

package/dist/adapters/index.d.ts

@@ -1,5 +1,11 @@
 /**
- * Adapters - Export all adapter modules
+ * @name adapters/index
+ * @description Barrel export for all SAP MCP adapter modules (MCP and Solana).
+ *
+ * Re-exports the MCP response helpers and Solana connection utilities so that
+ * the rest of the server can import them from a single entry point.
+ *
+ * @module adapters/index
  */
 export * from './mcp/index.js';
 export * from './solana/index.js';

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/adapters/index.js

@@ -1,5 +1,11 @@
 /**
- * Adapters - Export all adapter modules
+ * @name adapters/index
+ * @description Barrel export for all SAP MCP adapter modules (MCP and Solana).
+ *
+ * Re-exports the MCP response helpers and Solana connection utilities so that
+ * the rest of the server can import them from a single entry point.
+ *
+ * @module adapters/index
  */
 export * from './mcp/index.js';
 export * from './solana/index.js';

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/adapters/mcp/errors.d.ts

@@ -1,5 +1,17 @@
 /**
- * MCP error helper
+ * @name adapters/mcp/errors
+ * @description Custom error class for MCP protocol-level failures.
+ *
+ * @module adapters/mcp/errors
+ */
+/**
+ * @name McpError
+ * @description Error thrown when an MCP protocol operation fails.
+ *
+ * Extends the native `Error` class with a fixed `name` property so that
+ * consumers can distinguish MCP errors from other runtime errors.
+ *
+ * @usedBy `adapters/mcp/index.ts`, MCP tool handlers
  */
 export declare class McpError extends Error {
     constructor(message: string);

package/dist/adapters/mcp/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/adapters/mcp/errors.js

@@ -1,5 +1,17 @@
 /**
- * MCP error helper
+ * @name adapters/mcp/errors
+ * @description Custom error class for MCP protocol-level failures.
+ *
+ * @module adapters/mcp/errors
+ */
+/**
+ * @name McpError
+ * @description Error thrown when an MCP protocol operation fails.
+ *
+ * Extends the native `Error` class with a fixed `name` property so that
+ * consumers can distinguish MCP errors from other runtime errors.
+ *
+ * @usedBy `adapters/mcp/index.ts`, MCP tool handlers
  */
 export class McpError extends Error {
     constructor(message) {

package/dist/adapters/mcp/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adapters/mcp/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/adapters/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/adapters/mcp/index.d.ts

@@ -1,5 +1,11 @@
 /**
- * MCP adapter barrel export
+ * @name adapters/mcp/index
+ * @description Barrel export for the MCP adapter subsystem.
+ *
+ * Re-exports tool response helpers, resource response helpers,
+ * prompt response helpers, and the MCP error class.
+ *
+ * @module adapters/mcp/index
  */
 export { createTextResponse, createJsonResponse, createErrorResponse } from './tool-response.js';
 export { createResourceResponse } from './resource-response.js';

package/dist/adapters/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/mcp/index.js

@@ -1,5 +1,11 @@
 /**
- * MCP adapter barrel export
+ * @name adapters/mcp/index
+ * @description Barrel export for the MCP adapter subsystem.
+ *
+ * Re-exports tool response helpers, resource response helpers,
+ * prompt response helpers, and the MCP error class.
+ *
+ * @module adapters/mcp/index
  */
 export { createTextResponse, createJsonResponse, createErrorResponse } from './tool-response.js';
 export { createResourceResponse } from './resource-response.js';

package/dist/adapters/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/adapters/mcp/prompt-response.d.ts

@@ -1,5 +1,17 @@
 /**
- * MCP prompt response helper.
+ * @name adapters/mcp/prompt-response
+ * @description Helper for constructing MCP prompt responses.
+ *
+ * @module adapters/mcp/prompt-response
+ */
+/**
+ * @name createPromptResponse
+ * @description Wraps an array of role/content message objects into an MCP prompt response.
+ *
+ * @param messages — Array of message objects with `role` and `content` string fields.
+ * @returns An MCP prompt response containing the provided messages.
+ *
+ * @usedBy MCP prompt handlers
  */
 export declare function createPromptResponse(messages: Array<{
     role: string;

package/dist/adapters/mcp/prompt-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-response.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/prompt-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE/I"}
+{"version":3,"file":"prompt-response.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/prompt-response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAE/I"}

package/dist/adapters/mcp/prompt-response.js

@@ -1,5 +1,17 @@
 /**
- * MCP prompt response helper.
+ * @name adapters/mcp/prompt-response
+ * @description Helper for constructing MCP prompt responses.
+ *
+ * @module adapters/mcp/prompt-response
+ */
+/**
+ * @name createPromptResponse
+ * @description Wraps an array of role/content message objects into an MCP prompt response.
+ *
+ * @param messages — Array of message objects with `role` and `content` string fields.
+ * @returns An MCP prompt response containing the provided messages.
+ *
+ * @usedBy MCP prompt handlers
  */
 export function createPromptResponse(messages) {
     return { messages };

package/dist/adapters/mcp/prompt-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-response.js","sourceRoot":"","sources":["../../../src/adapters/mcp/prompt-response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,oBAAoB,CAAC,QAAkD;IACrF,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"prompt-response.js","sourceRoot":"","sources":["../../../src/adapters/mcp/prompt-response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkD;IACrF,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}