@stratabook/mcp 0.1.7 → 0.1.8

package/README.md

@@ -76,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

@@ -50,7 +50,7 @@ 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. 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.";
@@ -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: {
@@ -448,4 +448,4 @@ export declare const STRATA_ACTION_GRAPH: {
     }];
 };
 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. 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.";
+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

@@ -79,7 +79,7 @@ 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",
@@ -368,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"
             ],
@@ -587,4 +587,4 @@ export const STRATA_ACTION_GRAPH = {
     ]
 };
 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. 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.";
+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}.`);
     }));

package/package.json

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