@stratabook/mcp 0.1.6 → 0.1.7

package/README.md

@@ -35,6 +35,7 @@ The tools currently available are:
 - `strata_order_challenge`, when `orders.prepare` is enabled for MCP
 - `strata_order_prepare`, when `orders.prepare` is enabled for MCP
 - `strata_order_submit`, when `orders.submit` is enabled for MCP
+- `strata_order_status`, when `orders.submit` is enabled for MCP
 
 Every initialization response carries the compact Strata Agent Harness. The
 server also publishes the complete harness as the

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

@@ -15,7 +15,7 @@ export declare const STRATA_AGENT_HARNESS: {
         readonly manifest: "https://api.stratabook.app/.well-known/strata-agent.json";
     };
     readonly interfaces: {
-        readonly mcp_tool_order: readonly ["strata_capabilities", "strata_action_graph", "strata_markets", "strata_quote", "strata_execution_challenge", "strata_execution_prepare", "strata_execution_submit", "strata_order_challenge", "strata_order_prepare", "strata_order_submit"];
+        readonly mcp_tool_order: readonly ["strata_capabilities", "strata_action_graph", "strata_markets", "strata_quote", "strata_execution_challenge", "strata_execution_prepare", "strata_execution_submit", "strata_order_challenge", "strata_order_prepare", "strata_order_submit", "strata_order_status"];
         readonly terminal: readonly ["npx -y @stratabook/sdk capabilities --json", "npx -y @stratabook/sdk action-graph --json", "npx -y @stratabook/sdk markets --json", "npx -y @stratabook/sdk quote --market SOL/USDC --side sell --amount-atoms 10000000 --json"];
     };
     readonly workflow: readonly [{
@@ -53,7 +53,7 @@ export declare const STRATA_AGENT_HARNESS: {
         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 or exact opaque order set, then submit the externally signed transaction with idempotency. Resting-order control uses place, cancel, or cancel-all and cancel-all is atomically bounded to six orders per call.";
     }, {
         readonly id: "monitor_outcome";
-        readonly instruction: "After an authorized submission, report the durable receipt or explicit failure. Never claim completion from preparation, signing, or an unconfirmed request.";
+        readonly instruction: "After an authorized submission, report the durable receipt or explicit failure. If the request times out or either process restarts, recover it with the same control ID and idempotency key. Never claim completion from preparation, signing, or an unconfirmed request.";
     }];
     readonly stop_conditions: readonly ["The required live capability is disabled or absent.", "The market is paused, unavailable, or has no reviewed operation path.", "Market, side, amount, decimals, tolerance, or signer authority is unavailable or ambiguous.", "The contract version is unsupported or a response contains unknown fields.", "A quote is expired or its market, side, amount, fee, minimum-output, or time binding is inconsistent.", "A requested operation exceeds the exposed tool, account, or policy scope.", "A user asks the agent to receive or expose wallet secrets, private keys, seed phrases, session keys, or production credentials."];
     readonly safety_rules: readonly ["Never request or accept wallet secrets, private keys, seed phrases, session keys, or production credentials in a prompt.", "Never call undocumented endpoints or reconstruct private Sonar behavior.", "Never silently widen slippage, refresh changed economics, substitute a market, or retry a non-retryable failure.", "Treat capability removal, revocation, expiry, and emergency disable as immediate stop signals.", "Capability and action-graph availability are authoritative for Strata operations; permission and signer policy remain controlled by the external agent owner."];
@@ -321,6 +321,17 @@ export declare const STRATA_ACTION_GRAPH: {
         readonly summary: "Receive the opaque order IDs, transaction signature, and submitted status.";
         readonly required_capabilities: readonly [];
         readonly available: true;
+    }, {
+        readonly id: "recover_order_status";
+        readonly kind: "read";
+        readonly summary: "Recover durable submitting, submitted, or failed status after a timeout or restart.";
+        readonly required_capabilities: readonly ["orders.submit"];
+        readonly available: false;
+        readonly operation: {
+            readonly method: "POST";
+            readonly path: "/v2/markets/{market_id}/orders/status";
+            readonly mcp_tool: "strata_order_status";
+        };
     }];
     readonly edges: readonly [{
         readonly from: "discover_capabilities";
@@ -426,7 +437,15 @@ export declare const STRATA_ACTION_GRAPH: {
         readonly from: "submit_order_control";
         readonly to: "receive_order_receipt";
         readonly condition: "the control ID and idempotency key match";
+    }, {
+        readonly from: "submit_order_control";
+        readonly to: "recover_order_status";
+        readonly condition: "the submission result is ambiguous or either process restarted";
+    }, {
+        readonly from: "recover_order_status";
+        readonly to: "receive_order_receipt";
+        readonly condition: "durable status is submitted";
     }];
 };
 export declare const STRATA_ACTION_GRAPH_URI = "strata://action-graph/v1";
-export declare const STRATA_AGENT_HARNESS_INSTRUCTIONS = "Strata Agent Harness 1.0. Start every objective with strata_capabilities, then strata_action_graph, then strata_markets. Read strata://agent-harness/v1 and strata://action-graph/v1. The external agent owner controls permission and signer authority. Strata accepts public keys, detached signatures, and signed transactions, never private keys or seed phrases. Resolve the market, side, exact input atoms, and tolerance before strata_quote. Treat amounts as unsigned base-10 token atoms; check quote bindings, labelled fees, minimum output, and expiry. To execute or control a resting order: request a challenge, verify its quote or exact opaque order bindings, sign canonical authorization bytes externally, prepare, verify and sign the returned transaction externally, then submit with idempotency. Cancel-all is atomically bounded to six orders per call. Stop on ambiguity, unavailable capabilities, paused markets, unsupported contracts, inconsistent bindings, expiry, or missing signer authority.";
+export declare const STRATA_AGENT_HARNESS_INSTRUCTIONS = "Strata Agent Harness 1.0. Start every objective with strata_capabilities, then strata_action_graph, then strata_markets. Read strata://agent-harness/v1 and strata://action-graph/v1. The external agent owner controls permission and signer authority. Strata accepts public keys, detached signatures, and signed transactions, never private keys or seed phrases. Resolve the market, side, exact input atoms, and tolerance before strata_quote. Treat amounts as unsigned base-10 token atoms; check quote bindings, labelled fees, minimum output, and expiry. To execute or control a resting order: request a challenge, verify its quote or exact opaque order bindings, sign canonical authorization bytes externally, prepare, verify and sign the returned transaction externally, then submit with idempotency. If order submission is ambiguous, recover durable status with the same control ID and idempotency key. Cancel-all is atomically bounded to six orders per call. Stop on ambiguity, unavailable capabilities, paused markets, unsupported contracts, inconsistent bindings, expiry, or missing signer authority.";

package/dist/src/generated-harness.js

@@ -26,7 +26,8 @@ export const STRATA_AGENT_HARNESS = {
             "strata_execution_submit",
             "strata_order_challenge",
             "strata_order_prepare",
-            "strata_order_submit"
+            "strata_order_submit",
+            "strata_order_status"
         ],
         "terminal": [
             "npx -y @stratabook/sdk capabilities --json",
@@ -82,7 +83,7 @@ export const STRATA_AGENT_HARNESS = {
         },
         {
             "id": "monitor_outcome",
-            "instruction": "After an authorized submission, report the durable receipt or explicit failure. Never claim completion from preparation, signing, or an unconfirmed request."
+            "instruction": "After an authorized submission, report the durable receipt or explicit failure. If the request times out or either process restarts, recover it with the same control ID and idempotency key. Never claim completion from preparation, signing, or an unconfirmed request."
         }
     ],
     "stop_conditions": [
@@ -426,6 +427,20 @@ export const STRATA_ACTION_GRAPH = {
             "summary": "Receive the opaque order IDs, transaction signature, and submitted status.",
             "required_capabilities": [],
             "available": true
+        },
+        {
+            "id": "recover_order_status",
+            "kind": "read",
+            "summary": "Recover durable submitting, submitted, or failed status after a timeout or restart.",
+            "required_capabilities": [
+                "orders.submit"
+            ],
+            "available": false,
+            "operation": {
+                "method": "POST",
+                "path": "/v2/markets/{market_id}/orders/status",
+                "mcp_tool": "strata_order_status"
+            }
         }
     ],
     "edges": [
@@ -558,8 +573,18 @@ export const STRATA_ACTION_GRAPH = {
             "from": "submit_order_control",
             "to": "receive_order_receipt",
             "condition": "the control ID and idempotency key match"
+        },
+        {
+            "from": "submit_order_control",
+            "to": "recover_order_status",
+            "condition": "the submission result is ambiguous or either process restarted"
+        },
+        {
+            "from": "recover_order_status",
+            "to": "receive_order_receipt",
+            "condition": "durable status is submitted"
         }
     ]
 };
 export const STRATA_ACTION_GRAPH_URI = "strata://action-graph/v1";
-export const STRATA_AGENT_HARNESS_INSTRUCTIONS = "Strata Agent Harness 1.0. Start every objective with strata_capabilities, then strata_action_graph, then strata_markets. Read strata://agent-harness/v1 and strata://action-graph/v1. The external agent owner controls permission and signer authority. Strata accepts public keys, detached signatures, and signed transactions, never private keys or seed phrases. Resolve the market, side, exact input atoms, and tolerance before strata_quote. Treat amounts as unsigned base-10 token atoms; check quote bindings, labelled fees, minimum output, and expiry. To execute or control a resting order: request a challenge, verify its quote or exact opaque order bindings, sign canonical authorization bytes externally, prepare, verify and sign the returned transaction externally, then submit with idempotency. Cancel-all is atomically bounded to six orders per call. Stop on ambiguity, unavailable capabilities, paused markets, unsupported contracts, inconsistent bindings, expiry, or missing signer authority.";
+export const STRATA_AGENT_HARNESS_INSTRUCTIONS = "Strata Agent Harness 1.0. Start every objective with strata_capabilities, then strata_action_graph, then strata_markets. Read strata://agent-harness/v1 and strata://action-graph/v1. The external agent owner controls permission and signer authority. Strata accepts public keys, detached signatures, and signed transactions, never private keys or seed phrases. Resolve the market, side, exact input atoms, and tolerance before strata_quote. Treat amounts as unsigned base-10 token atoms; check quote bindings, labelled fees, minimum output, and expiry. To execute or control a resting order: request a challenge, verify its quote or exact opaque order bindings, sign canonical authorization bytes externally, prepare, verify and sign the returned transaction externally, then submit with idempotency. If order submission is ambiguous, recover durable status with the same control ID and idempotency key. Cancel-all is atomically bounded to six orders per call. Stop on ambiguity, unavailable capabilities, paused markets, unsupported contracts, inconsistent bindings, expiry, or missing signer authority.";

package/dist/src/server.js

@@ -407,6 +407,24 @@ export async function createStrataMcpServer(options = {}) {
         });
         return toolResult(response, `Submitted ${response.action} control ${response.order_control_id} as ${response.signature}.`);
     }));
+    const orderStatus = server.registerTool("strata_order_status", {
+        title: "Read Strata order-control status",
+        description: "Recover the durable result for an externally signed order submission after a timeout or restart.",
+        inputSchema: {
+            marketId: z.string().regex(/^market_[0-9a-f]{32}$/),
+            orderControlId: z.string().regex(/^or_[0-9a-f]{32}$/),
+            idempotencyKey: z.string().min(1).max(64).regex(/^[A-Za-z0-9._-]+$/),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ marketId, orderControlId, idempotencyKey }) => guardedTool(client, "orders.submit", async () => {
+        const response = await platformClient.orders.status(marketId, { orderControlId, idempotencyKey });
+        return toolResult(response, `Order control ${response.order_control_id} is ${response.status}.`);
+    }));
     const handles = {
         markets,
         quote,
@@ -416,6 +434,7 @@ export async function createStrataMcpServer(options = {}) {
         orderChallenge,
         orderPrepare,
         orderSubmit,
+        orderStatus,
     };
     applyCapabilityCatalog(handles, initialCatalog);
     let closed = false;
@@ -449,6 +468,7 @@ function applyCapabilityCatalog(handles, catalog) {
     setToolEnabled(handles.orderChallenge, capabilityAvailable(catalog, "orders.prepare"));
     setToolEnabled(handles.orderPrepare, capabilityAvailable(catalog, "orders.prepare"));
     setToolEnabled(handles.orderSubmit, capabilityAvailable(catalog, "orders.submit"));
+    setToolEnabled(handles.orderStatus, capabilityAvailable(catalog, "orders.submit"));
 }
 function setToolEnabled(tool, enabled) {
     if (enabled)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratabook/mcp",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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.5",
+    "@stratabook/sdk": "0.1.6",
     "zod": "^3.25.76"
   },
   "devDependencies": {