@suisei-mcp/mcp 0.1.0

package/dist/sui-client.js

@@ -0,0 +1,64 @@
+import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';
+import { SuiGrpcClient } from '@mysten/sui/grpc';
+/**
+ * Transport seam for the Sui Stack.
+ *
+ * Sui is deprecating public JSON-RPC fullnode endpoints (~mid-2026) in
+ * favour of gRPC and GraphQL. This file is the single place transport is
+ * chosen, so the rest of the toolkit never imports a client directly.
+ *
+ * Why JSON-RPC is still the default for `clientFor()`:
+ * building a transaction with `tx.build({ client })` needs *transaction
+ * resolution* (resolving object refs and gas coins). As of @mysten/sui
+ * 1.45.x that is implemented only for the JSON-RPC `SuiClient`. Verified
+ * against testnet:
+ *   - SuiGrpcClient     → "Transaction resolution is not supported with
+ *                          the GRPC client"
+ *   - SuiGraphQLClient  → "GraphQL client does not support transaction
+ *                          resolution yet"
+ * So every transaction-building tool (move_call, transfer, stake,
+ * unstake, mint_badge) must stay on JSON-RPC until the SDK ships build
+ * support over gRPC/GraphQL.
+ *
+ * Migration trigger: once `tx.build({ client: grpcClientFor(net) })`
+ * succeeds on a current SDK, switch `clientFor` to return the gRPC client
+ * and delete this note. Reads already work over gRPC today via
+ * `grpcClientFor()` below — wire individual read tools to it whenever we
+ * choose to move them off JSON-RPC ahead of the cutoff.
+ */
+/** gRPC-web fullnode endpoints, by network. */
+const GRPC_URL = {
+    testnet: 'https://fullnode.testnet.sui.io:443',
+    mainnet: 'https://fullnode.mainnet.sui.io:443',
+    devnet: 'https://fullnode.devnet.sui.io:443',
+};
+const jsonRpcCache = new Map();
+const grpcCache = new Map();
+/**
+ * The build-capable client every tool uses today. JSON-RPC until the SDK
+ * supports transaction resolution over gRPC/GraphQL (see note above).
+ */
+export function clientFor(network) {
+    let c = jsonRpcCache.get(network);
+    if (!c) {
+        c = new SuiClient({ url: getFullnodeUrl(network) });
+        jsonRpcCache.set(network, c);
+    }
+    return c;
+}
+/**
+ * gRPC client — the forward-looking transport. Reads (balances, coins,
+ * owned objects, dynamic fields, gas price, getTransaction, dryRun,
+ * execute) work today; transaction *building* does not yet. Exposed so
+ * read tools can migrate incrementally and so the eventual cutover is a
+ * one-line change in `clientFor`.
+ */
+export function grpcClientFor(network) {
+    let c = grpcCache.get(network);
+    if (!c) {
+        c = new SuiGrpcClient({ network, baseUrl: GRPC_URL[network] });
+        grpcCache.set(network, c);
+    }
+    return c;
+}
+//# sourceMappingURL=sui-client.js.map

package/dist/sui-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui-client.js","sourceRoot":"","sources":["../src/sui-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,+CAA+C;AAC/C,MAAM,QAAQ,GAA4B;IACxC,OAAO,EAAE,qCAAqC;IAC9C,OAAO,EAAE,qCAAqC;IAC9C,MAAM,EAAE,oCAAoC;CAC7C,CAAC;AAEF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;AACnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,IAAI,SAAS,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpD,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/D,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/tools/agent_wallet_fund.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build (do not sign) a tx that funds an agent wallet: split `amount_mist`
+ * from the owner's gas coin and send it to the agent address. The owner
+ * signs this (a real wallet / connected signer); the agent never touches
+ * the owner's key.
+ *
+ * This is the "allowance" in the Tier-1 agent wallet: the agent's spending
+ * power is bounded by whatever the owner funds here. Top up by funding
+ * again; cut the agent off with agent_wallet_sweep.
+ */
+export declare function agentWalletFund(raw: unknown): Promise<string>;

package/dist/tools/agent_wallet_fund.js

@@ -0,0 +1,31 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) a tx that funds an agent wallet: split `amount_mist`
+ * from the owner's gas coin and send it to the agent address. The owner
+ * signs this (a real wallet / connected signer); the agent never touches
+ * the owner's key.
+ *
+ * This is the "allowance" in the Tier-1 agent wallet: the agent's spending
+ * power is bounded by whatever the owner funds here. Top up by funding
+ * again; cut the agent off with agent_wallet_sweep.
+ */
+export async function agentWalletFund(raw) {
+    const { owner, agent, amount_mist, network } = raw;
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.setSender(owner);
+    const [coin] = tx.splitCoins(tx.gas, [tx.pure.u64(BigInt(amount_mist))]);
+    tx.transferObjects([coin], tx.pure.address(agent));
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        owner,
+        agent,
+        amount_mist,
+        network,
+        next_step: 'Owner signs and submits with sui_execute_signed_tx. After it lands, the agent wallet can spend up to its balance.',
+    });
+}
+//# sourceMappingURL=agent_wallet_fund.js.map

package/dist/tools/agent_wallet_fund.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_wallet_fund.js","sourceRoot":"","sources":["../../src/tools/agent_wallet_fund.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAY;IAChD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,KAAK;QACL,KAAK;QACL,WAAW;QACX,OAAO;QACP,SAAS,EACP,mHAAmH;KACtH,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/agent_wallet_status.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read an agent wallet's spendable state: native SUI balance and how many
+ * coin objects back it. Read-only. Use before asking the agent to spend,
+ * to confirm the allowance is funded and isn't empty.
+ */
+export declare function agentWalletStatus(raw: unknown): Promise<string>;

package/dist/tools/agent_wallet_status.js

@@ -0,0 +1,22 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Read an agent wallet's spendable state: native SUI balance and how many
+ * coin objects back it. Read-only. Use before asking the agent to spend,
+ * to confirm the allowance is funded and isn't empty.
+ */
+export async function agentWalletStatus(raw) {
+    const { agent, network } = raw;
+    const client = clientFor(network);
+    const balance = await client.getBalance({ owner: agent });
+    const mist = BigInt(balance.totalBalance);
+    return JSON.stringify({
+        agent,
+        network,
+        balance_mist: balance.totalBalance,
+        balance_sui: Number(mist) / 1e9,
+        coin_object_count: balance.coinObjectCount,
+        funded: mist > 0n,
+        note: 'Fund with agent_wallet_fund (owner-signed); drain with agent_wallet_sweep.',
+    });
+}
+//# sourceMappingURL=agent_wallet_status.js.map

package/dist/tools/agent_wallet_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_wallet_status.js","sourceRoot":"","sources":["../../src/tools/agent_wallet_status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAO3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAClD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE1C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK;QACL,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG;QAC/B,iBAAiB,EAAE,OAAO,CAAC,eAAe;QAC1C,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,IAAI,EAAE,4EAA4E;KACnF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/agent_wallet_sweep.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build (do not sign) the agent-wallet kill switch: send the agent's
+ * entire native SUI balance back to the owner. Transferring the gas coin
+ * moves its leftover (the whole balance minus gas) to the owner, emptying
+ * the wallet. Pass `object_ids` to also pull back specific non-SUI objects.
+ *
+ * The agent signs this with its own key (or the host signs on its behalf).
+ * Sweeping is how an owner revokes a Tier-1 allowance wallet: drain it and
+ * stop funding it.
+ */
+export declare function agentWalletSweep(raw: unknown): Promise<string>;

package/dist/tools/agent_wallet_sweep.js

@@ -0,0 +1,34 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+/**
+ * Build (do not sign) the agent-wallet kill switch: send the agent's
+ * entire native SUI balance back to the owner. Transferring the gas coin
+ * moves its leftover (the whole balance minus gas) to the owner, emptying
+ * the wallet. Pass `object_ids` to also pull back specific non-SUI objects.
+ *
+ * The agent signs this with its own key (or the host signs on its behalf).
+ * Sweeping is how an owner revokes a Tier-1 allowance wallet: drain it and
+ * stop funding it.
+ */
+export async function agentWalletSweep(raw) {
+    const { agent, owner, object_ids, network } = raw;
+    const client = clientFor(network);
+    const tx = new Transaction();
+    tx.setSender(agent);
+    // Transferring the gas coin sends its remaining balance (after gas) to
+    // the owner — i.e. sweeps all native SUI.
+    const toMove = [tx.gas, ...(object_ids ?? []).map((id) => tx.object(id))];
+    tx.transferObjects(toMove, tx.pure.address(owner));
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        agent,
+        owner,
+        object_ids: object_ids ?? [],
+        network,
+        note: 'Sweeps all native SUI (via the gas coin leftover) plus any object_ids back to the owner.',
+        next_step: 'Sign with the agent key and submit with sui_execute_signed_tx.',
+    });
+}
+//# sourceMappingURL=agent_wallet_sweep.js.map

package/dist/tools/agent_wallet_sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_wallet_sweep.js","sourceRoot":"","sources":["../../src/tools/agent_wallet_sweep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAY;IACjD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpB,uEAAuE;IACvE,0CAA0C;IAC1C,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1E,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,eAAe;QACf,KAAK;QACL,KAAK;QACL,UAAU,EAAE,UAAU,IAAI,EAAE;QAC5B,OAAO;QACP,IAAI,EAAE,0FAA0F;QAChG,SAAS,EAAE,gEAAgE;KAC5E,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_decode_tx_bytes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Decode unsigned tx bytes (from any builder tool) back into a structured,
+ * human-readable summary: sender, gas data, inputs, and a step-by-step
+ * list of commands ("split N MIST from gas", "transfer to 0x…",
+ * "call pkg::module::function with [args]").
+ *
+ * The "look before you sign" tool. A wallet shows the user what they're
+ * authorising; this lets an agent — or a person reading the agent's
+ * output — verify a built tx matches the stated intent. Pairs naturally
+ * with sui_dry_run for cost; this one is about *meaning*.
+ *
+ * Works offline (no RPC). All addresses are kept full-form so the caller
+ * can match them against expected values.
+ */
+export declare function suiDecodeTxBytes(raw: unknown): Promise<string>;

package/dist/tools/sui_decode_tx_bytes.js

@@ -0,0 +1,140 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { bcs } from '@mysten/sui/bcs';
+/**
+ * Decode unsigned tx bytes (from any builder tool) back into a structured,
+ * human-readable summary: sender, gas data, inputs, and a step-by-step
+ * list of commands ("split N MIST from gas", "transfer to 0x…",
+ * "call pkg::module::function with [args]").
+ *
+ * The "look before you sign" tool. A wallet shows the user what they're
+ * authorising; this lets an agent — or a person reading the agent's
+ * output — verify a built tx matches the stated intent. Pairs naturally
+ * with sui_dry_run for cost; this one is about *meaning*.
+ *
+ * Works offline (no RPC). All addresses are kept full-form so the caller
+ * can match them against expected values.
+ */
+export async function suiDecodeTxBytes(raw) {
+    const { tx_bytes_base64 } = raw;
+    const bytes = new Uint8Array(Buffer.from(tx_bytes_base64, 'base64'));
+    const tx = Transaction.from(bytes);
+    const data = tx.getData();
+    const inputs = data.inputs.map((input, i) => describeInput(input, i));
+    const commands = data.commands.map((c, i) => {
+        const kind = c.$kind;
+        return { index: i, kind, summary: describeCommand(c, inputs), raw: c };
+    });
+    return JSON.stringify({
+        sender: data.sender,
+        gas_data: {
+            budget: data.gasData.budget,
+            price: data.gasData.price,
+            owner: data.gasData.owner,
+            payment_count: data.gasData.payment?.length ?? 0,
+        },
+        expiration: data.expiration,
+        inputs,
+        command_count: commands.length,
+        commands,
+        plain_english: commands.map((c) => `${c.index + 1}. ${c.summary}`).join('\n'),
+        note: 'Decoded from BCS offline. Compare against the agent’s stated intent before signing.',
+    });
+}
+function describeInput(input, i) {
+    const kind = input.$kind;
+    if (kind === 'Pure') {
+        const b64 = input.Pure.bytes;
+        const raw = new Uint8Array(Buffer.from(b64, 'base64'));
+        const guess = guessPure(raw);
+        return { index: i, kind: 'Pure', value: guess.value, pretty: guess.pretty };
+    }
+    if (kind === 'Object') {
+        const inner = input.Object;
+        const objKind = inner.$kind;
+        const objectId = inner.ImmOrOwnedObject?.objectId ??
+            inner.SharedObject?.objectId ??
+            inner.Receiving?.objectId ??
+            null;
+        return {
+            index: i,
+            kind: `Object/${objKind}`,
+            value: objectId,
+            pretty: objectId ? `object ${objectId}` : `object (${objKind})`,
+        };
+    }
+    return { index: i, kind, value: input, pretty: `${kind} (raw)` };
+}
+function guessPure(bytes) {
+    // Addresses / object ids are 32 bytes; u64s are 8.
+    if (bytes.length === 32) {
+        const hex = '0x' + Buffer.from(bytes).toString('hex');
+        return { value: hex, pretty: `address ${hex}` };
+    }
+    if (bytes.length === 8) {
+        try {
+            const n = bcs.U64.parse(bytes);
+            return { value: n.toString(), pretty: `u64 ${n.toString()}` };
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    if (bytes.length === 1)
+        return { value: bytes[0], pretty: `u8 ${bytes[0]}` };
+    // Best effort: try utf-8
+    const text = Buffer.from(bytes).toString('utf8');
+    if (/^[\x20-\x7e]+$/.test(text))
+        return { value: text, pretty: `string \"${text}\"` };
+    return {
+        value: Buffer.from(bytes).toString('hex'),
+        pretty: `bytes 0x${Buffer.from(bytes).toString('hex')}`,
+    };
+}
+function describeCommand(cmd, inputs) {
+    const kind = cmd.$kind;
+    const refStr = (ref) => {
+        if (!ref || typeof ref !== 'object')
+            return String(ref);
+        const k = ref.$kind;
+        if (k === 'Input')
+            return inputs[ref.Input]?.pretty ?? `input#${ref.Input}`;
+        if (k === 'GasCoin')
+            return 'gas coin';
+        if (k === 'Result')
+            return `result#${ref.Result}`;
+        if (k === 'NestedResult') {
+            const nr = ref.NestedResult;
+            return `command#${nr[0]} result[${nr[1]}]`;
+        }
+        return k;
+    };
+    if (kind === 'SplitCoins') {
+        const c = cmd.SplitCoins;
+        return `Split [${c.amounts.map(refStr).join(', ')}] MIST from ${refStr(c.coin)}.`;
+    }
+    if (kind === 'TransferObjects') {
+        const c = cmd.TransferObjects;
+        return `Transfer [${c.objects.map(refStr).join(', ')}] to ${refStr(c.address)}.`;
+    }
+    if (kind === 'MergeCoins') {
+        const c = cmd.MergeCoins;
+        return `Merge [${c.sources.map(refStr).join(', ')}] into ${refStr(c.destination)}.`;
+    }
+    if (kind === 'MoveCall') {
+        const c = cmd.MoveCall;
+        const target = `${c.package}::${c.module}::${c.function}`;
+        const types = c.typeArguments?.length ? `<${c.typeArguments.join(', ')}>` : '';
+        const args = c.arguments?.map(refStr).join(', ') ?? '';
+        return `Call ${target}${types}(${args}).`;
+    }
+    if (kind === 'MakeMoveVec') {
+        const c = cmd.MakeMoveVec;
+        return `Make Move vector${c.type ? ` of ${c.type}` : ''} from [${c.elements.map(refStr).join(', ')}].`;
+    }
+    if (kind === 'Publish')
+        return `Publish a new Move package.`;
+    if (kind === 'Upgrade')
+        return `Upgrade an existing Move package.`;
+    return `${kind} (raw)`;
+}
+//# sourceMappingURL=sui_decode_tx_bytes.js.map

package/dist/tools/sui_decode_tx_bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_decode_tx_bytes.js","sourceRoot":"","sources":["../../src/tools/sui_decode_tx_bytes.ts"],"names":[],"mappings":"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"}

package/dist/tools/sui_deepbook_quote.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Read-only DeepBook v3 quote. Calls pool::get_quote_quantity_out (selling
+ * base) or get_base_quantity_out (selling quote) via devInspect — no gas,
+ * no signing, no funds. Returns the expected output and the DEEP fee
+ * required, so an agent can size min_out for sui_deepbook_swap before
+ * building the real transaction.
+ *
+ * All values are raw smallest-units (matching sui_deepbook_swap), so the
+ * quote's expected_out can be fed straight into the swap's min_out (minus
+ * whatever slippage the agent chooses).
+ */
+export declare function suiDeepbookQuote(raw: unknown): Promise<string>;

package/dist/tools/sui_deepbook_quote.js

@@ -0,0 +1,72 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { bcs } from '@mysten/sui/bcs';
+import { clientFor } from '../sui-client.js';
+import { DEEPBOOK_PACKAGE_ID, POOLS } from '../deepbook.js';
+/**
+ * Read-only DeepBook v3 quote. Calls pool::get_quote_quantity_out (selling
+ * base) or get_base_quantity_out (selling quote) via devInspect — no gas,
+ * no signing, no funds. Returns the expected output and the DEEP fee
+ * required, so an agent can size min_out for sui_deepbook_swap before
+ * building the real transaction.
+ *
+ * All values are raw smallest-units (matching sui_deepbook_swap), so the
+ * quote's expected_out can be fed straight into the swap's min_out (minus
+ * whatever slippage the agent chooses).
+ */
+export async function suiDeepbookQuote(raw) {
+    const a = raw;
+    const network = a.network;
+    const pkg = a.deepbook_package ?? DEEPBOOK_PACKAGE_ID[network];
+    if (!pkg)
+        throw new Error(`No DeepBook package for ${network}; pass deepbook_package.`);
+    const known = a.pool ? POOLS[network]?.[a.pool] : undefined;
+    const poolId = a.pool_id ?? known?.pool_id;
+    const baseType = a.base_type ?? known?.base_type;
+    const quoteType = a.quote_type ?? known?.quote_type;
+    if (!poolId || !baseType || !quoteType) {
+        throw new Error(`Unknown pool. Pass a known "pool" key for ${network} (${Object.keys(POOLS[network] ?? {}).join(', ') || 'none'}) or pass pool_id + base_type + quote_type.`);
+    }
+    const baseToQuote = a.direction === 'base_to_quote';
+    const fn = baseToQuote ? 'get_quote_quantity_out' : 'get_base_quantity_out';
+    const tx = new Transaction();
+    // devInspect needs a sender; any address works for a read. Use 0x0.
+    tx.setSender(a.sender ?? '0x0000000000000000000000000000000000000000000000000000000000000000');
+    tx.moveCall({
+        target: `${pkg}::pool::${fn}`,
+        arguments: [tx.object(poolId), tx.pure.u64(BigInt(a.amount)), tx.object.clock()],
+        typeArguments: [baseType, quoteType],
+    });
+    const client = clientFor(network);
+    const res = await client.devInspectTransactionBlock({
+        sender: a.sender ?? '0x0000000000000000000000000000000000000000000000000000000000000000',
+        transactionBlock: tx,
+    });
+    const status = res.effects?.status?.status ?? 'unknown';
+    if (status !== 'success') {
+        throw new Error(`Quote inspect failed: ${res.effects?.status?.error ?? 'unknown error'}`);
+    }
+    const ret = res.results?.[0]?.returnValues;
+    if (!ret || ret.length < 3) {
+        throw new Error(`Unexpected quote result shape from ${fn}.`);
+    }
+    // Each returnValue is [bytes[], type]. Move returns (baseOut, quoteOut, deepRequired) as u64.
+    const u64 = (i) => bcs.U64.parse(Uint8Array.from(ret[i][0])).toString();
+    const baseOut = u64(0);
+    const quoteOut = u64(1);
+    const deepRequired = u64(2);
+    const expectedOut = baseToQuote ? quoteOut : baseOut;
+    return JSON.stringify({
+        network,
+        pool_id: poolId,
+        base_type: baseType,
+        quote_type: quoteType,
+        direction: a.direction,
+        amount_in: a.amount,
+        expected_out: expectedOut,
+        base_out: baseOut,
+        quote_out: quoteOut,
+        deep_required: deepRequired,
+        next_step: 'Use expected_out (minus your slippage) as min_out, and deep_required as deep_amount, in sui_deepbook_swap.',
+    });
+}
+//# sourceMappingURL=sui_deepbook_quote.js.map

package/dist/tools/sui_deepbook_quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_deepbook_quote.js","sourceRoot":"","sources":["../../src/tools/sui_deepbook_quote.ts"],"names":[],"mappings":"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"}

package/dist/tools/sui_deepbook_swap.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build (do not sign) a DeepBook v3 market swap. Mirrors the exact PTB the
+ * official @mysten/deepbook-v3 SDK emits — pool::swap_exact_base_for_quote
+ * / swap_exact_quote_for_base — but on @mysten/sui v1, so the toolkit
+ * stays non-custodial and on its current SDK.
+ *
+ * Amounts are raw smallest-unit strings (like MIST): the caller handles
+ * decimals and picks min_out for slippage. The swap returns three coins
+ * (leftover base, output quote, leftover DEEP); we transfer all three back
+ * to the sender so nothing is dropped.
+ *
+ * DeepBook charges fees in DEEP. Whitelisted pools take deep_amount "0";
+ * others require the sender to hold DEEP (set deep_amount accordingly).
+ */
+export declare function suiDeepbookSwap(raw: unknown): Promise<string>;

package/dist/tools/sui_deepbook_swap.js

@@ -0,0 +1,72 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { coinWithBalance } from '@mysten/sui/transactions';
+import { clientFor } from '../sui-client.js';
+import { buildToB64 } from '../tx.js';
+import { DEEPBOOK_PACKAGE_ID, DEEP_TYPE, POOLS } from '../deepbook.js';
+/**
+ * Build (do not sign) a DeepBook v3 market swap. Mirrors the exact PTB the
+ * official @mysten/deepbook-v3 SDK emits — pool::swap_exact_base_for_quote
+ * / swap_exact_quote_for_base — but on @mysten/sui v1, so the toolkit
+ * stays non-custodial and on its current SDK.
+ *
+ * Amounts are raw smallest-unit strings (like MIST): the caller handles
+ * decimals and picks min_out for slippage. The swap returns three coins
+ * (leftover base, output quote, leftover DEEP); we transfer all three back
+ * to the sender so nothing is dropped.
+ *
+ * DeepBook charges fees in DEEP. Whitelisted pools take deep_amount "0";
+ * others require the sender to hold DEEP (set deep_amount accordingly).
+ */
+export async function suiDeepbookSwap(raw) {
+    const a = raw;
+    const network = a.network;
+    const pkg = a.deepbook_package ?? DEEPBOOK_PACKAGE_ID[network];
+    const deepType = a.deep_type ?? DEEP_TYPE[network];
+    if (!pkg)
+        throw new Error(`No DeepBook package for ${network}; pass deepbook_package.`);
+    if (!deepType)
+        throw new Error(`No DEEP coin type for ${network}; pass deep_type.`);
+    // Resolve pool: explicit ids win, else look up the named pool.
+    const known = a.pool ? POOLS[network]?.[a.pool] : undefined;
+    const poolId = a.pool_id ?? known?.pool_id;
+    const baseType = a.base_type ?? known?.base_type;
+    const quoteType = a.quote_type ?? known?.quote_type;
+    if (!poolId || !baseType || !quoteType) {
+        throw new Error(`Unknown pool. Pass a known "pool" key for ${network} (${Object.keys(POOLS[network] ?? {}).join(', ') || 'none'}) or pass pool_id + base_type + quote_type.`);
+    }
+    const baseToQuote = a.direction === 'base_to_quote';
+    const inputType = baseToQuote ? baseType : quoteType;
+    const fn = baseToQuote ? 'swap_exact_base_for_quote' : 'swap_exact_quote_for_base';
+    const tx = new Transaction();
+    tx.setSender(a.sender);
+    const inputCoin = coinWithBalance({ type: inputType, balance: BigInt(a.amount) });
+    const deepCoin = coinWithBalance({ type: deepType, balance: BigInt(a.deep_amount) });
+    const [baseOut, quoteOut, deepOut] = tx.moveCall({
+        target: `${pkg}::pool::${fn}`,
+        arguments: [
+            tx.object(poolId),
+            inputCoin,
+            deepCoin,
+            tx.pure.u64(BigInt(a.min_out)),
+            tx.object.clock(),
+        ],
+        typeArguments: [baseType, quoteType],
+    });
+    tx.transferObjects([baseOut, quoteOut, deepOut], tx.pure.address(a.sender));
+    const client = clientFor(network);
+    const tx_bytes_base64 = await buildToB64(tx, client);
+    return JSON.stringify({
+        tx_bytes_base64,
+        target: `${pkg}::pool::${fn}`,
+        pool_id: poolId,
+        base_type: baseType,
+        quote_type: quoteType,
+        direction: a.direction,
+        amount: a.amount,
+        min_out: a.min_out,
+        deep_amount: a.deep_amount,
+        network,
+        next_step: 'Dry-run with sui_dry_run to confirm output and gas, then sign and submit with sui_execute_signed_tx.',
+    });
+}
+//# sourceMappingURL=sui_deepbook_swap.js.map

package/dist/tools/sui_deepbook_swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_deepbook_swap.js","sourceRoot":"","sources":["../../src/tools/sui_deepbook_swap.ts"],"names":[],"mappings":"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"}

package/dist/tools/sui_dry_run.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Simulate a built (unsigned) transaction without spending gas. Returns
+ * the execution status, gas cost, and balance/object changes so an agent
+ * can verify a transaction before asking the host to sign it.
+ */
+export declare function suiDryRun(raw: unknown): Promise<string>;

package/dist/tools/sui_dry_run.js

@@ -0,0 +1,24 @@
+import { clientFor } from '../sui-client.js';
+import { fromB64 } from '../tx.js';
+/**
+ * Simulate a built (unsigned) transaction without spending gas. Returns
+ * the execution status, gas cost, and balance/object changes so an agent
+ * can verify a transaction before asking the host to sign it.
+ */
+export async function suiDryRun(raw) {
+    const { tx_bytes_base64, network } = raw;
+    const client = clientFor(network);
+    const res = await client.dryRunTransactionBlock({
+        transactionBlock: fromB64(tx_bytes_base64),
+    });
+    return JSON.stringify({
+        network,
+        status: res.effects.status.status,
+        error: res.effects.status.error ?? null,
+        gas_used: res.effects.gasUsed,
+        balance_changes: res.balanceChanges,
+        object_changes_count: res.objectChanges?.length ?? 0,
+        events_count: res.events?.length ?? 0,
+    });
+}
+//# sourceMappingURL=sui_dry_run.js.map

package/dist/tools/sui_dry_run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_dry_run.js","sourceRoot":"","sources":["../../src/tools/sui_dry_run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAOnC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY;IAC1C,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC;QAC9C,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC;KAC3C,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM;QACjC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI;QACvC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO;QAC7B,eAAe,EAAE,GAAG,CAAC,cAAc;QACnC,oBAAoB,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;QACpD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;KACtC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/sui_execute_signed_tx.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Submit a host-signed transaction. The toolkit never holds keys: the
+ * caller signs the bytes from a tx-builder tool elsewhere and passes the
+ * signature(s) here. Returns the digest and execution effects.
+ */
+export declare function suiExecuteSignedTx(raw: unknown): Promise<string>;

package/dist/tools/sui_execute_signed_tx.js

@@ -0,0 +1,25 @@
+import { clientFor } from '../sui-client.js';
+/**
+ * Submit a host-signed transaction. The toolkit never holds keys: the
+ * caller signs the bytes from a tx-builder tool elsewhere and passes the
+ * signature(s) here. Returns the digest and execution effects.
+ */
+export async function suiExecuteSignedTx(raw) {
+    const { tx_bytes_base64, signatures, network } = raw;
+    const client = clientFor(network);
+    const res = await client.executeTransactionBlock({
+        transactionBlock: tx_bytes_base64,
+        signature: signatures,
+        options: { showEffects: true, showEvents: true, showBalanceChanges: true },
+    });
+    return JSON.stringify({
+        network,
+        digest: res.digest,
+        status: res.effects?.status.status ?? 'unknown',
+        error: res.effects?.status.error ?? null,
+        gas_used: res.effects?.gasUsed ?? null,
+        balance_changes: res.balanceChanges ?? [],
+        events_count: res.events?.length ?? 0,
+    });
+}
+//# sourceMappingURL=sui_execute_signed_tx.js.map

package/dist/tools/sui_execute_signed_tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui_execute_signed_tx.js","sourceRoot":"","sources":["../../src/tools/sui_execute_signed_tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AAQ3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAY;IACnD,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAW,CAAC;IAC7D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC;QAC/C,gBAAgB,EAAE,eAAe;QACjC,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE;KAC3E,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO;QACP,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;QAC/C,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;QACxC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI;QACtC,eAAe,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACzC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;KACtC,CAAC,CAAC;AACL,CAAC"}