@stratabook/mcp 0.1.6 → 0.1.8

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
@@ -75,7 +76,8 @@ manifest at `/.well-known/strata-agent.json` and the graph at
 
 The external agent owner decides what its agent may do and configures its
 signer. MCP can request authorization bytes, prepare quote-bound trades or
-resting-order controls, and submit the externally signed result. It accepts
+atomic place, cancel, cancel-all, replace, or bounded batch order controls, and
+submit the externally signed result. It accepts
 public keys, detached signatures, and signed transactions, never private keys,
 seed phrases, or wallet secrets. Amounts are token atoms encoded as base-10
 strings.

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 [{
@@ -50,10 +50,10 @@ export declare const STRATA_AGENT_HARNESS: {
         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 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 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 supports place, cancel, bounded cancel-all, atomic replace, and atomic heterogeneous batches of up to six operations.";
     }, {
         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."];
@@ -273,7 +273,7 @@ export declare const STRATA_ACTION_GRAPH: {
     }, {
         readonly id: "request_order_challenge";
         readonly kind: "prepare";
-        readonly summary: "Bind a product-level place, cancel, or cancel-all operation to canonical authorization bytes.";
+        readonly summary: "Bind a product-level place, cancel, bounded cancel-all, atomic replace, or atomic batch operation to canonical authorization bytes.";
         readonly required_capabilities: readonly ["orders.prepare"];
         readonly available: false;
         readonly operation: {
@@ -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. Order control supports place, cancel, bounded cancel-all, atomic replace, and atomic heterogeneous batches of up to six operations. 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",
@@ -78,11 +79,11 @@ export const STRATA_AGENT_HARNESS = {
         },
         {
             "id": "authorize_writes",
-            "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."
+            "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 supports place, cancel, bounded cancel-all, atomic replace, and atomic heterogeneous batches of up to six operations."
         },
         {
             "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": [
@@ -367,7 +368,7 @@ export const STRATA_ACTION_GRAPH = {
         {
             "id": "request_order_challenge",
             "kind": "prepare",
-            "summary": "Bind a product-level place, cancel, or cancel-all operation to canonical authorization bytes.",
+            "summary": "Bind a product-level place, cancel, bounded cancel-all, atomic replace, or atomic batch operation to canonical authorization bytes.",
             "required_capabilities": [
                 "orders.prepare"
             ],
@@ -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. Order control supports place, cancel, bounded cancel-all, atomic replace, and atomic heterogeneous batches of up to six operations. Stop on ambiguity, unavailable capabilities, paused markets, unsupported contracts, inconsistent bindings, expiry, or missing signer authority.";

package/dist/src/server.js

@@ -182,7 +182,7 @@ export async function createStrataMcpServer(options = {}) {
         };
         const response = await client.quote(request);
         return toolResult(response, `Sonar ${response.side} quote: ${response.amount_in_consumed_atoms} input atoms `
-            + `for ${response.amount_out_atoms} output atoms; minimum `
+            + `for ${response.amount_out_atoms} user-net output atoms; user-net minimum `
             + `${response.minimum_output_atoms}; expires at ${response.expires_at_ms}.`);
     }));
     const executionChallenge = server.registerTool("strata_execution_challenge", {
@@ -291,10 +291,10 @@ export async function createStrataMcpServer(options = {}) {
     }));
     const orderChallenge = server.registerTool("strata_order_challenge", {
         title: "Strata order challenge",
-        description: "Bind a product-level place, cancel, or cancel-all request to canonical bytes for the agent owner's external signer.",
+        description: "Bind an atomic place, cancel, cancel-all, replace, or bounded batch request to canonical bytes for the agent owner's external signer.",
         inputSchema: {
             marketId: z.string().regex(/^market_[0-9a-f]{32}$/),
-            action: z.enum(["place", "cancel", "cancel_all"]),
+            action: z.enum(["place", "cancel", "cancel_all", "replace", "batch"]),
             ownerWallet: z.string().min(32).max(44),
             sessionPublicKey: z.string().min(32).max(44),
             accountSequence: z.string().regex(/^[0-9]+$/).max(20).optional(),
@@ -304,6 +304,16 @@ export async function createStrataMcpServer(options = {}) {
             limitPriceAtoms: z.string().regex(/^[1-9][0-9]*$/).max(20).optional(),
             sizeAtoms: z.string().regex(/^[1-9][0-9]*$/).max(20).optional(),
             orderId: z.string().regex(/^order_[0-9a-f]{32}$/).optional(),
+            operations: z.array(z.object({
+                action: z.enum(["place", "cancel", "replace"]),
+                accountSequence: z.string().regex(/^[0-9]+$/).max(20).optional(),
+                clientOrderId: z.string().min(1).max(64).regex(/^[A-Za-z0-9._-]+$/).optional(),
+                side: z.enum(["buy", "sell"]).optional(),
+                orderType: z.enum(["good_until_cancelled", "post_only"]).optional(),
+                limitPriceAtoms: z.string().regex(/^[1-9][0-9]*$/).max(20).optional(),
+                sizeAtoms: z.string().regex(/^[1-9][0-9]*$/).max(20).optional(),
+                orderId: z.string().regex(/^order_[0-9a-f]{32}$/).optional(),
+            }).strict()).min(1).max(6).optional(),
         },
         annotations: {
             readOnlyHint: false,
@@ -345,13 +355,77 @@ export async function createStrataMcpServer(options = {}) {
                 orderId: args.orderId,
             };
         }
-        else {
+        else if (args.action === "cancel_all") {
             request = {
                 action: "cancel_all",
                 ownerWallet: args.ownerWallet,
                 sessionPublicKey: args.sessionPublicKey,
             };
         }
+        else if (args.action === "replace") {
+            if (args.orderId === undefined
+                || args.accountSequence === undefined
+                || args.clientOrderId === undefined
+                || args.side === undefined
+                || args.orderType === undefined
+                || args.limitPriceAtoms === undefined
+                || args.sizeAtoms === undefined) {
+                return toolError("invalid_request", "Replace requires orderId, accountSequence, clientOrderId, side, orderType, limitPriceAtoms, and sizeAtoms.", false);
+            }
+            request = {
+                action: "replace",
+                ownerWallet: args.ownerWallet,
+                sessionPublicKey: args.sessionPublicKey,
+                orderId: args.orderId,
+                accountSequence: args.accountSequence,
+                clientOrderId: args.clientOrderId,
+                side: args.side,
+                orderType: args.orderType,
+                limitPriceAtoms: args.limitPriceAtoms,
+                sizeAtoms: args.sizeAtoms,
+            };
+        }
+        else {
+            if (args.operations === undefined) {
+                return toolError("invalid_request", "Batch requires operations.", false);
+            }
+            const operations = [];
+            for (const operation of args.operations) {
+                if (operation.action === "cancel") {
+                    if (operation.orderId === undefined) {
+                        return toolError("invalid_request", "Batch cancel requires orderId.", false);
+                    }
+                    operations.push({ action: "cancel", orderId: operation.orderId });
+                    continue;
+                }
+                if (operation.accountSequence === undefined
+                    || operation.clientOrderId === undefined
+                    || operation.side === undefined
+                    || operation.orderType === undefined
+                    || operation.limitPriceAtoms === undefined
+                    || operation.sizeAtoms === undefined
+                    || (operation.action === "replace" && operation.orderId === undefined)) {
+                    return toolError("invalid_request", `Batch ${operation.action} has incomplete fields.`, false);
+                }
+                const place = {
+                    accountSequence: operation.accountSequence,
+                    clientOrderId: operation.clientOrderId,
+                    side: operation.side,
+                    orderType: operation.orderType,
+                    limitPriceAtoms: operation.limitPriceAtoms,
+                    sizeAtoms: operation.sizeAtoms,
+                };
+                operations.push(operation.action === "replace"
+                    ? { action: "replace", orderId: operation.orderId, ...place }
+                    : { action: "place", ...place });
+            }
+            request = {
+                action: "batch",
+                ownerWallet: args.ownerWallet,
+                sessionPublicKey: args.sessionPublicKey,
+                operations,
+            };
+        }
         const response = await platformClient.orders.challenge(args.marketId, request);
         return toolResult(response, `Order challenge ${response.challenge_id} binds ${response.order_ids.length} opaque order ID(s); expires at ${response.expires_at_ms}.`);
     }));
@@ -407,6 +481,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 +508,7 @@ export async function createStrataMcpServer(options = {}) {
         orderChallenge,
         orderPrepare,
         orderSubmit,
+        orderStatus,
     };
     applyCapabilityCatalog(handles, initialCatalog);
     let closed = false;
@@ -449,6 +542,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.8",
   "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.7",
     "zod": "^3.25.76"
   },
   "devDependencies": {