@stratabook/mcp 0.1.4 → 0.1.5

package/dist/src/generated-harness.d.ts

@@ -3,11 +3,13 @@ export declare const STRATA_AGENT_HARNESS: {
     readonly harness_version: "1.0";
     readonly contract_version: "1.1";
     readonly name: "Strata Agent Harness";
-    readonly summary: "A capability-gated workflow and executable action graph for agents that discover, quote, prepare, externally sign, and submit Strata operations.";
+    readonly summary: "A capability-gated workflow and executable action graph for agents that discover, read market and account state, quote, prepare, externally sign, and submit Strata operations.";
     readonly entrypoints: {
         readonly documentation: "https://stratabook.org/docs/agent-harness/";
         readonly capabilities: "https://api.stratabook.app/sonar/capabilities";
         readonly markets: "https://api.stratabook.app/sonar/markets";
+        readonly platform_capabilities: "https://api.stratabook.app/v2/capabilities";
+        readonly platform_markets: "https://api.stratabook.app/v2/markets";
         readonly action_graph: "https://api.stratabook.app/sonar/action-graph";
         readonly mcp: "https://api.stratabook.app/mcp";
         readonly manifest: "https://api.stratabook.app/.well-known/strata-agent.json";
@@ -28,6 +30,12 @@ export declare const STRATA_AGENT_HARNESS: {
     }, {
         readonly id: "discover_market";
         readonly instruction: "List markets, select one marked ready, and use its discovered base and quote decimals. Do not guess market identifiers or token decimals.";
+    }, {
+        readonly id: "read_market_data";
+        readonly instruction: "When books.read is live, use the opaque market ID to read the Strata book, status, fees, and recent trades. Subscribe to the market stream for changes and recover from any sequence gap with a fresh snapshot.";
+    }, {
+        readonly id: "read_account";
+        readonly instruction: "When account.read is live, use the owner-configured signer to authorize the exact wallet, market, request time, and fill limit. Read or stream only the sanitized orders and fills returned by the official SDK, and recover stream gaps from a fresh signed snapshot.";
     }, {
         readonly id: "preserve_atoms";
         readonly instruction: "Represent token amounts as unsigned base-10 atomic strings. Never pass settlement amounts through floating-point arithmetic.";
@@ -39,7 +47,7 @@ export declare const STRATA_AGENT_HARNESS: {
         readonly instruction: "Verify the quote binds to the selected market, side, and input. Check labelled fees, minimum output, price impact, server time, and expiry.";
     }, {
         readonly id: "report_result";
-        readonly instruction: "Report consumed input, expected output, minimum output, fees by asset side, price impact, and remaining validity without inventing private route composition.";
+        readonly instruction: "Report consumed input, expected output, minimum output, fees by asset side, price impact, and remaining validity.";
     }, {
         readonly id: "authorize_writes";
         readonly instruction: "When prepare and submit are exposed, keep signing external to Strata: request canonical authorization bytes, sign them with the owner-configured signer, verify the prepared transaction preserves the quote, then submit the externally signed transaction with idempotency.";
@@ -94,6 +102,112 @@ export declare const STRATA_ACTION_GRAPH: {
             readonly path: "/sonar/action-graph";
             readonly mcp_tool: "strata_action_graph";
         };
+    }, {
+        readonly id: "discover_platform_capabilities";
+        readonly kind: "discovery";
+        readonly summary: "Read the versioned capabilities available through the official SDK.";
+        readonly required_capabilities: readonly [];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/capabilities";
+        };
+    }, {
+        readonly id: "discover_platform_markets";
+        readonly kind: "discovery";
+        readonly summary: "Discover opaque market IDs and current market status.";
+        readonly required_capabilities: readonly ["markets.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets";
+        };
+    }, {
+        readonly id: "read_book";
+        readonly kind: "read";
+        readonly summary: "Read a sequenced Strata book snapshot.";
+        readonly required_capabilities: readonly ["books.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets/{market_id}/book";
+        };
+    }, {
+        readonly id: "read_market_status";
+        readonly kind: "read";
+        readonly summary: "Read tick size, minimum order size, and current market status.";
+        readonly required_capabilities: readonly ["books.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets/{market_id}/status";
+        };
+    }, {
+        readonly id: "read_best_bid_ask";
+        readonly kind: "read";
+        readonly summary: "Read the current best bid and ask.";
+        readonly required_capabilities: readonly ["books.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets/{market_id}/bbo";
+        };
+    }, {
+        readonly id: "read_fees";
+        readonly kind: "read";
+        readonly summary: "Read the market fee schedule.";
+        readonly required_capabilities: readonly ["books.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets/{market_id}/fees";
+        };
+    }, {
+        readonly id: "read_trades";
+        readonly kind: "read";
+        readonly summary: "Read recent anonymized trades.";
+        readonly required_capabilities: readonly ["books.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets/{market_id}/trades";
+        };
+    }, {
+        readonly id: "stream_market";
+        readonly kind: "read";
+        readonly summary: "Subscribe to book changes, trades, and heartbeats with automatic recovery.";
+        readonly required_capabilities: readonly ["books.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "WEBSOCKET";
+            readonly path: "/v2/markets/{market_id}/stream";
+        };
+    }, {
+        readonly id: "authorize_account_read";
+        readonly kind: "external_signature";
+        readonly summary: "The agent owner's configured signer authorizes the exact account request or stream challenge.";
+        readonly required_capabilities: readonly [];
+        readonly available: true;
+    }, {
+        readonly id: "read_account";
+        readonly kind: "read";
+        readonly summary: "Read the owner's sanitized open orders and fills for a Strata market.";
+        readonly required_capabilities: readonly ["account.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "GET";
+            readonly path: "/v2/markets/{market_id}/account/{wallet_address}";
+        };
+    }, {
+        readonly id: "stream_account";
+        readonly kind: "read";
+        readonly summary: "Subscribe to signed, sequenced order and fill state for the owner.";
+        readonly required_capabilities: readonly ["account.read"];
+        readonly available: true;
+        readonly operation: {
+            readonly method: "WEBSOCKET";
+            readonly path: "/v2/markets/{market_id}/account/{wallet_address}/stream";
+        };
     }, {
         readonly id: "request_quote";
         readonly kind: "read";
@@ -165,6 +279,50 @@ export declare const STRATA_ACTION_GRAPH: {
         readonly from: "discover_action_graph";
         readonly to: "discover_markets";
         readonly condition: "markets.read is enabled";
+    }, {
+        readonly from: "discover_action_graph";
+        readonly to: "discover_platform_capabilities";
+        readonly condition: "the versioned SDK contract is supported";
+    }, {
+        readonly from: "discover_platform_capabilities";
+        readonly to: "discover_platform_markets";
+        readonly condition: "markets.read is enabled";
+    }, {
+        readonly from: "discover_platform_markets";
+        readonly to: "read_book";
+        readonly condition: "books.read is enabled and the market is active";
+    }, {
+        readonly from: "discover_platform_markets";
+        readonly to: "read_market_status";
+        readonly condition: "books.read is enabled";
+    }, {
+        readonly from: "discover_platform_markets";
+        readonly to: "read_best_bid_ask";
+        readonly condition: "books.read is enabled";
+    }, {
+        readonly from: "discover_platform_markets";
+        readonly to: "read_fees";
+        readonly condition: "books.read is enabled";
+    }, {
+        readonly from: "discover_platform_markets";
+        readonly to: "read_trades";
+        readonly condition: "books.read is enabled";
+    }, {
+        readonly from: "read_book";
+        readonly to: "stream_market";
+        readonly condition: "books.read is enabled and the snapshot sequence is accepted";
+    }, {
+        readonly from: "discover_platform_markets";
+        readonly to: "authorize_account_read";
+        readonly condition: "account.read is enabled and the owner-configured signer is available";
+    }, {
+        readonly from: "authorize_account_read";
+        readonly to: "read_account";
+        readonly condition: "the signature binds the wallet, market, request time, and fill limit";
+    }, {
+        readonly from: "read_account";
+        readonly to: "stream_account";
+        readonly condition: "the stream challenge is signed by the same owner-configured signer";
     }, {
         readonly from: "discover_markets";
         readonly to: "request_quote";

package/dist/src/generated-harness.js

@@ -4,11 +4,13 @@ export const STRATA_AGENT_HARNESS = {
     "harness_version": "1.0",
     "contract_version": "1.1",
     "name": "Strata Agent Harness",
-    "summary": "A capability-gated workflow and executable action graph for agents that discover, quote, prepare, externally sign, and submit Strata operations.",
+    "summary": "A capability-gated workflow and executable action graph for agents that discover, read market and account state, quote, prepare, externally sign, and submit Strata operations.",
     "entrypoints": {
         "documentation": "https://stratabook.org/docs/agent-harness/",
         "capabilities": "https://api.stratabook.app/sonar/capabilities",
         "markets": "https://api.stratabook.app/sonar/markets",
+        "platform_capabilities": "https://api.stratabook.app/v2/capabilities",
+        "platform_markets": "https://api.stratabook.app/v2/markets",
         "action_graph": "https://api.stratabook.app/sonar/action-graph",
         "mcp": "https://api.stratabook.app/mcp",
         "manifest": "https://api.stratabook.app/.well-known/strata-agent.json"
@@ -47,6 +49,14 @@ export const STRATA_AGENT_HARNESS = {
             "id": "discover_market",
             "instruction": "List markets, select one marked ready, and use its discovered base and quote decimals. Do not guess market identifiers or token decimals."
         },
+        {
+            "id": "read_market_data",
+            "instruction": "When books.read is live, use the opaque market ID to read the Strata book, status, fees, and recent trades. Subscribe to the market stream for changes and recover from any sequence gap with a fresh snapshot."
+        },
+        {
+            "id": "read_account",
+            "instruction": "When account.read is live, use the owner-configured signer to authorize the exact wallet, market, request time, and fill limit. Read or stream only the sanitized orders and fills returned by the official SDK, and recover stream gaps from a fresh signed snapshot."
+        },
         {
             "id": "preserve_atoms",
             "instruction": "Represent token amounts as unsigned base-10 atomic strings. Never pass settlement amounts through floating-point arithmetic."
@@ -61,7 +71,7 @@ export const STRATA_AGENT_HARNESS = {
         },
         {
             "id": "report_result",
-            "instruction": "Report consumed input, expected output, minimum output, fees by asset side, price impact, and remaining validity without inventing private route composition."
+            "instruction": "Report consumed input, expected output, minimum output, fees by asset side, price impact, and remaining validity."
         },
         {
             "id": "authorize_writes",
@@ -139,6 +149,141 @@ export const STRATA_ACTION_GRAPH = {
                 "mcp_tool": "strata_action_graph"
             }
         },
+        {
+            "id": "discover_platform_capabilities",
+            "kind": "discovery",
+            "summary": "Read the versioned capabilities available through the official SDK.",
+            "required_capabilities": [],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/capabilities"
+            }
+        },
+        {
+            "id": "discover_platform_markets",
+            "kind": "discovery",
+            "summary": "Discover opaque market IDs and current market status.",
+            "required_capabilities": [
+                "markets.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets"
+            }
+        },
+        {
+            "id": "read_book",
+            "kind": "read",
+            "summary": "Read a sequenced Strata book snapshot.",
+            "required_capabilities": [
+                "books.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets/{market_id}/book"
+            }
+        },
+        {
+            "id": "read_market_status",
+            "kind": "read",
+            "summary": "Read tick size, minimum order size, and current market status.",
+            "required_capabilities": [
+                "books.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets/{market_id}/status"
+            }
+        },
+        {
+            "id": "read_best_bid_ask",
+            "kind": "read",
+            "summary": "Read the current best bid and ask.",
+            "required_capabilities": [
+                "books.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets/{market_id}/bbo"
+            }
+        },
+        {
+            "id": "read_fees",
+            "kind": "read",
+            "summary": "Read the market fee schedule.",
+            "required_capabilities": [
+                "books.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets/{market_id}/fees"
+            }
+        },
+        {
+            "id": "read_trades",
+            "kind": "read",
+            "summary": "Read recent anonymized trades.",
+            "required_capabilities": [
+                "books.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets/{market_id}/trades"
+            }
+        },
+        {
+            "id": "stream_market",
+            "kind": "read",
+            "summary": "Subscribe to book changes, trades, and heartbeats with automatic recovery.",
+            "required_capabilities": [
+                "books.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "WEBSOCKET",
+                "path": "/v2/markets/{market_id}/stream"
+            }
+        },
+        {
+            "id": "authorize_account_read",
+            "kind": "external_signature",
+            "summary": "The agent owner's configured signer authorizes the exact account request or stream challenge.",
+            "required_capabilities": [],
+            "available": true
+        },
+        {
+            "id": "read_account",
+            "kind": "read",
+            "summary": "Read the owner's sanitized open orders and fills for a Strata market.",
+            "required_capabilities": [
+                "account.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "GET",
+                "path": "/v2/markets/{market_id}/account/{wallet_address}"
+            }
+        },
+        {
+            "id": "stream_account",
+            "kind": "read",
+            "summary": "Subscribe to signed, sequenced order and fill state for the owner.",
+            "required_capabilities": [
+                "account.read"
+            ],
+            "available": true,
+            "operation": {
+                "method": "WEBSOCKET",
+                "path": "/v2/markets/{market_id}/account/{wallet_address}/stream"
+            }
+        },
         {
             "id": "request_quote",
             "kind": "read",
@@ -228,6 +373,61 @@ export const STRATA_ACTION_GRAPH = {
             "to": "discover_markets",
             "condition": "markets.read is enabled"
         },
+        {
+            "from": "discover_action_graph",
+            "to": "discover_platform_capabilities",
+            "condition": "the versioned SDK contract is supported"
+        },
+        {
+            "from": "discover_platform_capabilities",
+            "to": "discover_platform_markets",
+            "condition": "markets.read is enabled"
+        },
+        {
+            "from": "discover_platform_markets",
+            "to": "read_book",
+            "condition": "books.read is enabled and the market is active"
+        },
+        {
+            "from": "discover_platform_markets",
+            "to": "read_market_status",
+            "condition": "books.read is enabled"
+        },
+        {
+            "from": "discover_platform_markets",
+            "to": "read_best_bid_ask",
+            "condition": "books.read is enabled"
+        },
+        {
+            "from": "discover_platform_markets",
+            "to": "read_fees",
+            "condition": "books.read is enabled"
+        },
+        {
+            "from": "discover_platform_markets",
+            "to": "read_trades",
+            "condition": "books.read is enabled"
+        },
+        {
+            "from": "read_book",
+            "to": "stream_market",
+            "condition": "books.read is enabled and the snapshot sequence is accepted"
+        },
+        {
+            "from": "discover_platform_markets",
+            "to": "authorize_account_read",
+            "condition": "account.read is enabled and the owner-configured signer is available"
+        },
+        {
+            "from": "authorize_account_read",
+            "to": "read_account",
+            "condition": "the signature binds the wallet, market, request time, and fill limit"
+        },
+        {
+            "from": "read_account",
+            "to": "stream_account",
+            "condition": "the stream challenge is signed by the same owner-configured signer"
+        },
         {
             "from": "discover_markets",
             "to": "request_quote",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratabook/mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Connect AI agents to Strata markets and Sonar quotes with MCP.",
   "type": "module",
   "license": "MIT OR Apache-2.0",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@stratabook/sdk": "0.1.3",
+    "@stratabook/sdk": "0.1.4",
     "zod": "^3.25.76"
   },
   "devDependencies": {