@stratabook/mcp 0.2.14 → 0.2.15

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to the Strata SDKs (`@stratabook/sdk`, `@stratabook/mcp`,
 and the `strata-sdk` Rust crate) are recorded here. Versions move together.
 
+## 0.2.15
+
+- Add explicit IntentBook prepare/submit tools in advanced mode and a one-call
+  post/permanent-revoke tool for locally configured Vault sessions.
+- Apply the existing ask/limits/instant slider, USD budgets, capability gates,
+  exact retry behavior, and sponsored-fee explanation to intent controls.
+
 ## 0.2.14
 
 - Make `strata-mcp connect` the complete client-neutral trading setup flow:

package/README.md

@@ -104,6 +104,7 @@ Advanced mode additionally exposes the complete protocol surface, including:
 - `strata_market_making_submit_and_wait` — submit the externally signed preparation idempotently and wait for matching chain-derived state
 - `strata_market_making_strand_prepare`, `strata_market_making_strand_submit`
 - `strata_market_making_current_prepare`, `strata_market_making_current_submit`
+- `strata_market_making_intent_prepare`, `strata_market_making_intent_submit` — control an existing curated IntentBook seat with a Vault session; Strata pays the fee
 - `strata_vault_status`
 - `strata_vault_setup`, `strata_vault_deposit`, `strata_vault_withdraw`, `strata_vault_delegate`, `strata_vault_policy`, `strata_vault_pause` — prepare owner actions with Strata as sponsored fee payer
 - `strata_vault_submit` — submit the owner-signed preparation; Strata pays and broadcasts
@@ -157,6 +158,12 @@ restart. Use `action: "stop"` through the same pair. The older product-specific
 tools remain available for strategies that deliberately manage every low-level
 array and safety field.
 
+With a local trading session, `strata_market_making_intent_execute` posts or
+permanently revokes an existing curated IntentBook seat in one call under the
+same ask/limits/instant slider. The session signs only the SDK-verified packet;
+the owner wallet does not sign each update. Exact submit retries return the
+original confirmed signature while the packet remains live.
+
 For maker funding, initialize the market Vault if needed, activate the Strand
 or Current, then deposit with `strata_vault_deposit`. The market keeps that
 available collateral while a control is live and returns it after the final

package/dist/src/autonomy.d.ts

@@ -17,8 +17,9 @@
  *                 caps (the owner's per-asset limits, tolerance, interval,
  *                 expiry). Hyperliquid-style.
  *
- * Withdraw, policy, pause, and revoke are never on this slider — they always
- * require the owner's wallet. The on-chain session caps are the hard ceiling;
+ * Vault withdrawal, policy, session rotation, and pause are never on this
+ * slider — they always require the owner's wallet. An IntentBook seat's own
+ * session-authorized revoke remains available as its permanent risk exit. The on-chain session caps are the hard ceiling;
  * this slider is a softer layer above them. An agent can *read* the level
  * (`strata_autonomy`) and *offer* to change it, but nothing an agent calls can
  * raise its own autonomy: the only knob is the human's (env / Agents page).

package/dist/src/autonomy.js

@@ -17,8 +17,9 @@
  *                 caps (the owner's per-asset limits, tolerance, interval,
  *                 expiry). Hyperliquid-style.
  *
- * Withdraw, policy, pause, and revoke are never on this slider — they always
- * require the owner's wallet. The on-chain session caps are the hard ceiling;
+ * Vault withdrawal, policy, session rotation, and pause are never on this
+ * slider — they always require the owner's wallet. An IntentBook seat's own
+ * session-authorized revoke remains available as its permanent risk exit. The on-chain session caps are the hard ceiling;
  * this slider is a softer layer above them. An agent can *read* the level
  * (`strata_autonomy`) and *offer* to change it, but nothing an agent calls can
  * raise its own autonomy: the only knob is the human's (env / Agents page).

package/dist/src/server.js

@@ -173,6 +173,9 @@ const LEGACY_TOOL_CAPABILITIES = {
     strata_market_making_strand_submit: { ids: ["mm.strand.manage"] },
     strata_market_making_current_prepare: { ids: ["mm.current.manage"] },
     strata_market_making_current_submit: { ids: ["mm.current.manage"] },
+    strata_market_making_intent_prepare: { ids: ["mm.intent.manage"] },
+    strata_market_making_intent_submit: { ids: ["mm.intent.manage"] },
+    strata_market_making_intent_execute: { ids: ["mm.intent.manage"] },
     strata_market_making_prepare: { ids: ["mm.strand.manage", "mm.current.manage"], match: "any" },
     strata_market_making_submit_and_wait: { ids: ["mm.strand.manage", "mm.current.manage"], match: "any" },
     strata_execute_quote: { ids: ["trade.submit"] },
@@ -216,6 +219,9 @@ const PLATFORM_TOOL_CAPABILITIES = {
     strata_market_making_strand_submit: { ids: ["mm.strand.manage"] },
     strata_market_making_current_prepare: { ids: ["mm.current.manage"] },
     strata_market_making_current_submit: { ids: ["mm.current.manage"] },
+    strata_market_making_intent_prepare: { ids: ["mm.intent.manage"] },
+    strata_market_making_intent_submit: { ids: ["mm.intent.manage"] },
+    strata_market_making_intent_execute: { ids: ["mm.intent.manage"] },
     strata_market_making_prepare: { ids: ["mm.strand.manage", "mm.current.manage"], match: "any" },
     strata_market_making_submit_and_wait: { ids: ["mm.strand.manage", "mm.current.manage"], match: "any" },
     strata_rewards: { ids: ["rewards.read"] },
@@ -2059,6 +2065,76 @@ export async function createStrataMcpServer(options = {}) {
         });
         return toolResult(response, `Submitted ${response.action} as ${response.signature}.`);
     }));
+    const makerIntentPrepare = registerTool("strata_market_making_intent_prepare", {
+        title: "Prepare Strata IntentBook control",
+        description: "Prepare one sponsored Vault-session transaction for an existing curated IntentBook seat. "
+            + "Post updates its side, price band, and maximum fill. Revoke permanently closes the seat; "
+            + "it cannot be posted again. The owner wallet does not sign each update.",
+        inputSchema: {
+            marketId: makerMarketIdSchema,
+            action: z.enum(["post", "revoke"]),
+            ownerWallet: makerPublicKeySchema,
+            sessionPublicKey: makerPublicKeySchema,
+            side: z.enum(["buy", "sell", "both"]).optional(),
+            minPriceAtoms: makerPositiveAtomicSchema.optional(),
+            maxPriceAtoms: makerPositiveAtomicSchema.optional(),
+            maxFillSizeAtoms: makerPositiveAtomicSchema.optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (args) => guardedTool(client, "mm.intent.manage", async () => {
+        let request;
+        if (args.action === "revoke") {
+            request = {
+                action: "revoke",
+                ownerWallet: args.ownerWallet,
+                sessionPublicKey: args.sessionPublicKey,
+            };
+        }
+        else {
+            if (args.side === undefined
+                || args.minPriceAtoms === undefined
+                || args.maxPriceAtoms === undefined
+                || args.maxFillSizeAtoms === undefined) {
+                return toolError("invalid_request", "Intent post requires side, minPriceAtoms, maxPriceAtoms, and maxFillSizeAtoms.", false);
+            }
+            request = {
+                action: "post",
+                ownerWallet: args.ownerWallet,
+                sessionPublicKey: args.sessionPublicKey,
+                side: args.side,
+                minPriceAtoms: args.minPriceAtoms,
+                maxPriceAtoms: args.maxPriceAtoms,
+                maxFillSizeAtoms: args.maxFillSizeAtoms,
+            };
+        }
+        const response = await platformClient.marketMaking.intent.prepare(args.marketId, request);
+        return toolResult(response, `Prepared IntentBook ${response.action}; verify and add only the session signature before ${response.expires_at_ms}. Strata pays the network fee.`);
+    }));
+    const makerIntentSubmit = registerTool("strata_market_making_intent_submit", {
+        title: "Submit Strata IntentBook control",
+        description: "Submit the exact session-signed IntentBook packet. Exact retries during the packet's live "
+            + "blockhash window return the original confirmed signature.",
+        inputSchema: {
+            marketId: makerMarketIdSchema,
+            signedTransactionBase64: makerBase64Schema,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ marketId, signedTransactionBase64 }) => guardedTool(client, "mm.intent.manage", async () => {
+        const response = await platformClient.marketMaking.intent.submit(marketId, {
+            signedTransactionBase64,
+        });
+        return toolResult(response, `Submitted IntentBook control as ${response.signature}.`);
+    }));
     registerAutonomyTools(registerTool, client, platformClient, options.sessionAutonomy, () => typeof Date !== "undefined" ? Date.now() : 0);
     void [
         markets,
@@ -2077,6 +2153,8 @@ export async function createStrataMcpServer(options = {}) {
         makerStrandSubmit,
         makerCurrentPrepare,
         makerCurrentSubmit,
+        makerIntentPrepare,
+        makerIntentSubmit,
     ];
     applyToolAvailability(registeredTools, initialCatalog, initialPlatformCatalog, toolMode);
     let closed = false;
@@ -2175,6 +2253,65 @@ function registerAutonomyTools(registerTool, client, platformClient, autonomy, n
         };
     };
     const refuse = (reason, prepared, summary) => toolResult({ executed: false, reason, prepared }, summary);
+    // ── one-shot existing IntentBook seat control ──────────────────────────────
+    registerTool("strata_market_making_intent_execute", {
+        title: "Execute Strata IntentBook control",
+        description: "Post or permanently revoke an existing curated IntentBook seat in one call. The configured "
+            + "Vault session verifies and signs; Strata pays the network fee. Under ask, or above a limits "
+            + "ceiling, this prepares the exact packet but does not sign it.",
+        inputSchema: {
+            marketId: makerMarketIdSchema,
+            action: z.enum(["post", "revoke"]),
+            side: z.enum(["buy", "sell", "both"]).optional(),
+            minPriceAtoms: makerPositiveAtomicSchema.optional(),
+            maxPriceAtoms: makerPositiveAtomicSchema.optional(),
+            maxFillSizeAtoms: makerPositiveAtomicSchema.optional(),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (args) => guardedTool(client, "mm.intent.manage", async () => {
+        let operation;
+        if (args.action === "revoke") {
+            operation = { action: "revoke", ownerWallet: autonomy.ownerWallet };
+        }
+        else {
+            if (args.side === undefined
+                || args.minPriceAtoms === undefined
+                || args.maxPriceAtoms === undefined
+                || args.maxFillSizeAtoms === undefined) {
+                return toolError("invalid_request", "Intent post requires side, minPriceAtoms, maxPriceAtoms, and maxFillSizeAtoms.", false);
+            }
+            operation = {
+                action: "post",
+                ownerWallet: autonomy.ownerWallet,
+                side: args.side,
+                minPriceAtoms: args.minPriceAtoms,
+                maxPriceAtoms: args.maxPriceAtoms,
+                maxFillSizeAtoms: args.maxFillSizeAtoms,
+            };
+        }
+        const baseAtoms = operation.action === "post" ? BigInt(operation.maxFillSizeAtoms) : 0n;
+        const notional = await estimateBaseNotionalUsd(resolver, markFor, args.marketId, baseAtoms);
+        const decision = decideAutonomy(autonomy, args.marketId, notional, nowMs());
+        if (!decision.allow) {
+            const prepared = await platformClient.marketMaking.intent.prepare(args.marketId, {
+                ...operation,
+                sessionPublicKey: autonomy.signer.publicKey,
+            });
+            return refuse(decision.reason, prepared, decision.reason);
+        }
+        const receipt = await platformClient.marketMaking.intent.execute(args.marketId, {
+            operation,
+            signer: autonomy.signer,
+        });
+        if (notional !== null)
+            autonomy.dailyBudget.record(notional, nowMs());
+        return toolResult({ executed: true, receipt, notional_usd: notional }, `Executed IntentBook ${operation.action} as ${receipt.signature}.`);
+    }));
     // ── one-shot immediate execution from a fresh Sonar quote ─────────────────
     registerTool("strata_execute_quote", {
         title: "Execute a Strata quote",

package/dist/src/usability.js

@@ -14,6 +14,7 @@ export const SIMPLE_TOOL_NAMES = new Set([
     "strata_market_making_status",
     "strata_market_making_prepare",
     "strata_market_making_submit_and_wait",
+    "strata_market_making_intent_execute",
     "strata_autonomy",
     "strata_trade",
 ]);

package/package.json

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