project-cpu-mcp 0.12.0 → 0.12.2

package/dist/tools/market/accept-offer/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/accept-offer/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,QAyB/B,CAAC"}

package/dist/tools/market/accept-offer/constants.js

@@ -0,0 +1,27 @@
+export const ACCEPT_CELL_OFFER_DESCRIPTION = [
+    'Sell ONE Cell you own by accepting ONE exact offer on the NFT marketplace, in a single call. This is the land',
+    'market — Cells traded as NFTs for a configured currency — and it is entirely separate from `cpu_create_lot`,',
+    'which sells RESOURCES for $CPU inside the game.',
+    "YOU PICK THE OFFER AND THE CELL. Read `cpu_get_my_offers_received` first and pass that offer's exact",
+    '`orderHash`. An offer for one exact Cell already names the Cell; a trait or collection offer bids for a SET of',
+    'Cells, so you must also pass the `tokenId` you are willing to sell — the call fails before sending anything',
+    'when a criteria offer is not given one.',
+    'If the pinned offer has been filled, cancelled, expired, or cannot be fulfilled as it stands, the call fails',
+    'with `staleOffer` or `unfulfillable` and sells NOTHING — it never substitutes a different offer or a',
+    'different Cell for you.',
+    'The call performs the whole action itself: it prepares the acceptance, checks that the prepared work is still',
+    'that exact offer and that exact Cell of yours, sends any collection approval the wallet still owes and waits',
+    'for its receipt, then sends the one fulfilment transaction. There is nothing to confirm afterwards.',
+    "Success is proven, not assumed: the receipt must carry the protocol's own fulfilment event for that exact",
+    'order, the transaction must have been sent by your wallet, and the Cell must no longer be owned by you. A',
+    'trait or collection offer may stay ACTIVE afterwards — it can still buy other Cells — and that is not a',
+    'failure and never a second sale of the same Cell.',
+    'Retrying is safe for your Cells: once ownership has moved, a repeat refuses before sending anything, and a',
+    'repeat of a transaction already broadcast re-checks that transaction instead of selling again. At worst a',
+    'retry spends gas on a transaction the protocol rejects.',
+    'The result reports `status` (`completed`, or `already_completed` when the sale proved to be done already), the',
+    "`orderHash` accepted, the Cell sold, the buyer, the offer amount and currency before the marketplace's",
+    'mandatory fee split, and every transaction',
+    'hash in `txHashes` in the order it was broadcast.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/market/accept-offer/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/market/accept-offer/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IACzC,+GAA+G;IAC/G,8GAA8G;IAC9G,iDAAiD;IACjD,sGAAsG;IACtG,gHAAgH;IAChH,6GAA6G;IAC7G,yCAAyC;IACzC,8GAA8G;IAC9G,sGAAsG;IACtG,yBAAyB;IACzB,+GAA+G;IAC/G,8GAA8G;IAC9G,qGAAqG;IACrG,2GAA2G;IAC3G,2GAA2G;IAC3G,yGAAyG;IACzG,mDAAmD;IACnD,4GAA4G;IAC5G,2GAA2G;IAC3G,yDAAyD;IACzD,gHAAgH;IAChH,wGAAwG;IACxG,4CAA4C;IAC5C,mDAAmD;CACtD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/market/accept-offer/format.utils.d.ts

@@ -0,0 +1,3 @@
+import type { AcceptCellOfferResult } from '../../../services/market/acceptance.types.js';
+export declare function summarizeSoldCell(result: AcceptCellOfferResult): string;
+//# sourceMappingURL=format.utils.d.ts.map

package/dist/tools/market/accept-offer/format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/accept-offer/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAS1F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAiBvE"}

package/dist/tools/market/accept-offer/format.utils.js

@@ -0,0 +1,22 @@
+import { MarketActionStatus, MarketOfferKind } from '../../../services/market/types.js';
+function offerShape(kind) {
+    return kind === MarketOfferKind.Item
+        ? 'an offer for that exact Cell'
+        : `a ${kind} offer, which may stay active and buy other Cells`;
+}
+export function summarizeSoldCell(result) {
+    const opening = result.status === MarketActionStatus.AlreadyCompleted
+        ? `Cell ${result.tokenId} was already sold on this exact offer — no second sale was made`
+        : `Cell ${result.tokenId} is sold`;
+    const approvals = result.approvalTxHashes.length === 0
+        ? 'no collection approval was needed'
+        : `collection approvals broadcast in order: ${result.approvalTxHashes.join(', ')}`;
+    return [
+        `${opening} (order ${result.orderHash}, seller ${result.wallet}, buyer ${result.buyer})`,
+        `offer amount before the marketplace's mandatory fee split: ${result.amount} ${result.currency.symbol} ` +
+            `base units (decimals=${result.currency.decimals}), from ${offerShape(result.offer.kind)}`,
+        approvals,
+        `fulfilment transaction: ${result.fulfilmentTxHash}`,
+    ].join('\n');
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/tools/market/accept-offer/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../../../src/tools/market/accept-offer/format.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAExF,SAAS,UAAU,CAAC,IAAqB;IACrC,OAAO,IAAI,KAAK,eAAe,CAAC,IAAI;QAChC,CAAC,CAAC,8BAA8B;QAChC,CAAC,CAAC,KAAK,IAAI,mDAAmD,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC3D,MAAM,OAAO,GACT,MAAM,CAAC,MAAM,KAAK,kBAAkB,CAAC,gBAAgB;QACjD,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,iEAAiE;QACzF,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,UAAU,CAAC;IAC3C,MAAM,SAAS,GACX,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAChC,CAAC,CAAC,mCAAmC;QACrC,CAAC,CAAC,4CAA4C,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAE3F,OAAO;QACH,GAAG,OAAO,WAAW,MAAM,CAAC,SAAS,YAAY,MAAM,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,GAAG;QACxF,8DAA8D,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG;YACpG,wBAAwB,MAAM,CAAC,QAAQ,CAAC,QAAQ,WAAW,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAC9F,SAAS;QACT,2BAA2B,MAAM,CAAC,gBAAgB,EAAE;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/tools/market/accept-offer/types.d.ts

@@ -0,0 +1,9 @@
+import type { IMarketAcceptanceService } from '../../../services/market/acceptance.types.js';
+export interface AcceptCellOfferContext {
+    marketAcceptance: IMarketAcceptanceService;
+}
+export declare const acceptCellOfferInputSchema: {
+    orderHash: import("zod").ZodString;
+    tokenId: import("zod").ZodDefault<import("zod").ZodNullable<import("zod").ZodEffects<import("zod").ZodString, string, string>>>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/market/accept-offer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/accept-offer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAG7F,MAAM,WAAW,sBAAsB;IACnC,gBAAgB,EAAE,wBAAwB,CAAC;CAC9C;AAED,eAAO,MAAM,0BAA0B;;;CAetC,CAAC"}

package/dist/tools/market/accept-offer/types.js

@@ -0,0 +1,14 @@
+import { cellTokenIdSchema, orderHashSchema } from '../../../services/market/types.js';
+export const acceptCellOfferInputSchema = {
+    orderHash: orderHashSchema.describe('The exact 32-byte 0x-prefixed `orderHash` of the offer you decided to accept, copied from ' +
+        '`cpu_get_my_offers_received` or `cpu_get_cell_market`. This tool accepts that offer or nothing: it ' +
+        'never falls back to a higher, newer or otherwise different offer.'),
+    tokenId: cellTokenIdSchema
+        .nullable()
+        .default(null)
+        .describe('The one Cell of yours to sell, as a decimal token id with no leading zeroes (e.g. "0" or "1234", never ' +
+        '"01234"). REQUIRED for a trait or collection offer, because such an offer names a set of Cells ' +
+        'and never picks one for you. For an item offer you may omit it (or pass null) and the Cell the ' +
+        'offer bids for is used; if you do pass it, it must be that same Cell.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/market/accept-offer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/market/accept-offer/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAMvF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACtC,SAAS,EAAE,eAAe,CAAC,QAAQ,CAC/B,4FAA4F;QACxF,qGAAqG;QACrG,mEAAmE,CAC1E;IACD,OAAO,EAAE,iBAAiB;SACrB,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,yGAAyG;QACrG,iGAAiG;QACjG,iGAAiG;QACjG,uEAAuE,CAC9E;CACR,CAAC"}

package/dist/tools/market/buy-cell/buy-cell.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../../types.js';
+import type { MarketToolDefinition } from '../types.js';
+export declare function createBuyCellTool(context: AppContext): MarketToolDefinition;
+//# sourceMappingURL=buy-cell.d.ts.map

package/dist/tools/market/buy-cell/buy-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buy-cell.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/buy-cell.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,oBAAoB,CAwB3E"}

package/dist/tools/market/buy-cell/buy-cell.js

@@ -0,0 +1,30 @@
+import { BUY_CELL_DESCRIPTION } from './constants.js';
+import { summarizeBoughtCell } from './format.utils.js';
+import { buyCellInputSchema } from './types.js';
+import { ToolEventType } from '../../types.js';
+import { buyCellOutputSchema } from '../output.types.js';
+export function createBuyCellTool(context) {
+    return {
+        name: 'cpu_buy_cell',
+        description: BUY_CELL_DESCRIPTION,
+        inputSchema: buyCellInputSchema,
+        outputSchema: buyCellOutputSchema,
+        handler: async (args) => {
+            const input = args;
+            const result = await context.marketPurchase.buyCell({
+                tokenId: input.tokenId,
+                expectedOrderHash: input.expectedOrderHash,
+                maxAmount: input.maxAmount,
+            });
+            const output = { ...result, eventType: ToolEventType.CellBought };
+            return {
+                content: [
+                    { type: 'text', text: summarizeBoughtCell(result) },
+                    { type: 'text', text: JSON.stringify(output) },
+                ],
+                structuredContent: output,
+            };
+        },
+    };
+}
+//# sourceMappingURL=buy-cell.js.map

package/dist/tools/market/buy-cell/buy-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buy-cell.js","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/buy-cell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACjD,OAAO;QACH,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE,mBAAmB;QACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,MAAM,KAAK,GAAG,IAAsB,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC;gBAChD,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;YAElE,OAAO;gBACH,OAAO,EAAE;oBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE;oBACnD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;iBACjD;gBACD,iBAAiB,EAAE,MAAM;aAC5B,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/market/buy-cell/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const BUY_CELL_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/market/buy-cell/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,QAqBtB,CAAC"}

package/dist/tools/market/buy-cell/constants.js

@@ -0,0 +1,23 @@
+export const BUY_CELL_DESCRIPTION = [
+    'Buy ONE exact Cell listing on the NFT marketplace, in a single call. This is the land market — Cells traded',
+    'as NFTs for a configured currency — and it is entirely separate from `cpu_buy_lot`, which buys RESOURCES for',
+    '$CPU inside the game.',
+    "YOU PICK THE ORDER. Read `cpu_get_cell_market` first and pass that listing's exact `expectedOrderHash`. If",
+    'that order has been filled, cancelled, expired, or repriced above your `maxAmount`, the call fails with',
+    '`staleListing`, `unfulfillable`, or a local price-limit error and buys NOTHING — it never substitutes a',
+    'different listing or a different Cell for you.',
+    '`maxAmount` is a hard ceiling in the currency base units, as a decimal integer STRING (never a number). The',
+    'call refuses to send anything that would cost more.',
+    'The call performs the whole action itself: it prepares the purchase, checks that the prepared work is still',
+    'that exact order, sends any currency approval the wallet still owes and waits for its receipt, then sends the',
+    'one fulfilment transaction. There is nothing to confirm afterwards.',
+    "Success is proven, not assumed: the receipt must carry the protocol's own fulfilment event for that exact",
+    'order, the transaction must have been sent by your wallet, and the Cell must end up owned by you. Ownership',
+    'alone is never accepted as proof that you were the buyer.',
+    'Retrying is safe for your money: a repeated call re-checks the transaction it already sent instead of buying',
+    'again, and can never bind a second order. At worst a retry spends gas on a transaction the protocol rejects.',
+    'The result reports `status` (`completed`, or `already_completed` when the purchase proved to be done',
+    'already), the `orderHash` bought, the seller, the price paid, and every transaction hash in `txHashes` in the',
+    'order it was broadcast.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/market/buy-cell/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,6GAA6G;IAC7G,8GAA8G;IAC9G,uBAAuB;IACvB,4GAA4G;IAC5G,yGAAyG;IACzG,yGAAyG;IACzG,gDAAgD;IAChD,6GAA6G;IAC7G,qDAAqD;IACrD,6GAA6G;IAC7G,+GAA+G;IAC/G,qEAAqE;IACrE,2GAA2G;IAC3G,6GAA6G;IAC7G,2DAA2D;IAC3D,8GAA8G;IAC9G,8GAA8G;IAC9G,sGAAsG;IACtG,+GAA+G;IAC/G,yBAAyB;CAC5B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/market/buy-cell/format.utils.d.ts

@@ -0,0 +1,3 @@
+import type { BuyCellResult } from '../../../services/market/purchase.types.js';
+export declare function summarizeBoughtCell(result: BuyCellResult): string;
+//# sourceMappingURL=format.utils.d.ts.map

package/dist/tools/market/buy-cell/format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAGhF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiBjE"}

package/dist/tools/market/buy-cell/format.utils.js

@@ -0,0 +1,17 @@
+import { MarketActionStatus } from '../../../services/market/types.js';
+export function summarizeBoughtCell(result) {
+    const opening = result.status === MarketActionStatus.AlreadyCompleted
+        ? `Cell ${result.tokenId} was already bought on this exact order — no second purchase was made`
+        : `Cell ${result.tokenId} is bought`;
+    const approvals = result.approvalTxHashes.length === 0
+        ? 'no currency approval was needed'
+        : `currency approvals broadcast in order: ${result.approvalTxHashes.join(', ')}`;
+    return [
+        `${opening} (order ${result.orderHash}, buyer ${result.wallet}, seller ${result.seller})`,
+        `paid: ${result.price} ${result.currency.symbol} base units (decimals=${result.currency.decimals}), ` +
+            `within your ceiling of ${result.maxAmount}`,
+        approvals,
+        `fulfilment transaction: ${result.fulfilmentTxHash}`,
+    ].join('\n');
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/tools/market/buy-cell/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/format.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACrD,MAAM,OAAO,GACT,MAAM,CAAC,MAAM,KAAK,kBAAkB,CAAC,gBAAgB;QACjD,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,uEAAuE;QAC/F,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,YAAY,CAAC;IAC7C,MAAM,SAAS,GACX,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAChC,CAAC,CAAC,iCAAiC;QACnC,CAAC,CAAC,0CAA0C,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAEzF,OAAO;QACH,GAAG,OAAO,WAAW,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,GAAG;QACzF,SAAS,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,yBAAyB,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK;YACjG,0BAA0B,MAAM,CAAC,SAAS,EAAE;QAChD,SAAS;QACT,2BAA2B,MAAM,CAAC,gBAAgB,EAAE;KACvD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/tools/market/buy-cell/types.d.ts

@@ -0,0 +1,6 @@
+export declare const buyCellInputSchema: {
+    tokenId: import("zod").ZodEffects<import("zod").ZodString, string, string>;
+    expectedOrderHash: import("zod").ZodString;
+    maxAmount: import("zod").ZodEffects<import("zod").ZodString, string, string>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/market/buy-cell/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/types.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;;;;CAa9B,CAAC"}

package/dist/tools/market/buy-cell/types.js

@@ -0,0 +1,10 @@
+import { cellTokenIdSchema, orderHashSchema, positiveBaseUnitAmountSchema } from '../../../services/market/types.js';
+export const buyCellInputSchema = {
+    tokenId: cellTokenIdSchema.describe('The Cell the listing sells, as a decimal token id with no leading zeroes (e.g. "0" or "1234", never "01234").'),
+    expectedOrderHash: orderHashSchema.describe('The exact 32-byte 0x-prefixed `orderHash` of the listing you decided to buy, copied from ' +
+        '`cpu_get_cell_market`. This tool buys that order or nothing: it never falls back to a cheaper, ' +
+        'newer or otherwise different listing.'),
+    maxAmount: positiveBaseUnitAmountSchema.describe('The most you are willing to pay, as a positive decimal integer of the currency base units — never a ' +
+        'decimal fraction. If the pinned order costs more than this, the call fails without sending anything.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/market/buy-cell/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/market/buy-cell/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAErH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAC/B,+GAA+G,CAClH;IACD,iBAAiB,EAAE,eAAe,CAAC,QAAQ,CACvC,2FAA2F;QACvF,iGAAiG;QACjG,uCAAuC,CAC9C;IACD,SAAS,EAAE,4BAA4B,CAAC,QAAQ,CAC5C,sGAAsG;QAClG,sGAAsG,CAC7G;CACJ,CAAC"}

package/dist/tools/market/cancel-order/cancel-order.d.ts

@@ -0,0 +1,4 @@
+import { type CancelOrderContext } from './types.js';
+import type { MarketToolDefinition } from '../types.js';
+export declare function createCancelOrderTool(context: CancelOrderContext): MarketToolDefinition;
+//# sourceMappingURL=cancel-order.d.ts.map

package/dist/tools/market/cancel-order/cancel-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-order.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/cancel-order.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,CAuBvF"}

package/dist/tools/market/cancel-order/cancel-order.js

@@ -0,0 +1,29 @@
+import { CANCEL_ORDER_DESCRIPTION } from './constants.js';
+import { summarizeCancelledOrder } from './format.utils.js';
+import { cancelOrderInputSchema } from './types.js';
+import { ToolEventType } from '../../types.js';
+import { cancelOrderOutputSchema } from '../output.types.js';
+export function createCancelOrderTool(context) {
+    return {
+        name: 'cpu_cancel_order',
+        description: CANCEL_ORDER_DESCRIPTION,
+        inputSchema: cancelOrderInputSchema,
+        outputSchema: cancelOrderOutputSchema,
+        handler: async (args) => {
+            const input = args;
+            const result = await context.marketCancel.cancelOrder({ orderHash: input.orderHash });
+            const output = { ...result, eventType: ToolEventType.MarketOrderCancelled };
+            return {
+                content: [
+                    { type: 'text', text: summarizeCancelledOrder(result) },
+                    {
+                        type: 'text',
+                        text: JSON.stringify(output),
+                    },
+                ],
+                structuredContent: output,
+            };
+        },
+    };
+}
+//# sourceMappingURL=cancel-order.js.map

package/dist/tools/market/cancel-order/cancel-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-order.js","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/cancel-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAA2B,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC7D,OAAO;QACH,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,uBAAuB;QACrC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,MAAM,KAAK,GAAG,IAA0B,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,oBAAoB,EAAE,CAAC;YAE5E,OAAO;gBACH,OAAO,EAAE;oBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAAE;oBACvD;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;qBAC/B;iBACJ;gBACD,iBAAiB,EAAE,MAAM;aAC5B,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/market/cancel-order/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const CANCEL_ORDER_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/market/cancel-order/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,QAoB1B,CAAC"}

package/dist/tools/market/cancel-order/constants.js

@@ -0,0 +1,22 @@
+export const CANCEL_ORDER_DESCRIPTION = [
+    'Cancel ONE exact Market order you made on the NFT marketplace, in a single call. One action covers both',
+    'sides: a Cell listing you published with `cpu_list_cell` and a Cell offer you published with',
+    '`cpu_make_cell_offer` are cancelled by the same input, because the side is a fact of the order rather than',
+    'something you select. This is the land market — Cells traded as NFTs — and a Market order is not a resource',
+    'Lot: ending one of those is `cpu_return_lot`, and this call never touches it.',
+    "YOU PICK THE ORDER. Read `cpu_get_my_listings` or `cpu_get_my_offers` first and pass that order's exact",
+    "`orderHash`. Only the wallet that made the order can cancel it: another wallet's order fails before anything",
+    'is broadcast.',
+    'The call performs the whole action itself: it prepares the cancellation, checks that the prepared transaction',
+    'goes to the pinned marketplace protocol contract on this chain and that its bytes cancel exactly the order you',
+    'named, then sends that one transaction and waits for its receipt.',
+    "Success is proven, not assumed: the receipt must carry the protocol's own cancellation event for that exact",
+    'order, naming your wallet as the maker, and the transaction must have been sent by your wallet. An order that',
+    'merely stopped being active is NEVER reported as cancelled — it may have been filled or expired instead, so an',
+    'order that is gone without that proof fails with `staleListing` or `staleOffer` and no other order is touched.',
+    'Retrying is safe: a repeated call re-checks the transaction it already sent instead of cancelling again, and',
+    'can never bind another order. At worst a retry spends gas on a transaction the protocol rejects.',
+    'The result reports `status` (`completed`, or `already_completed` when the cancellation proved to be done',
+    'already), the `orderHash` cancelled, whether it was a listing or an offer, and the `cancellationTxHash`.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/market/cancel-order/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,yGAAyG;IACzG,8FAA8F;IAC9F,4GAA4G;IAC5G,6GAA6G;IAC7G,+EAA+E;IAC/E,yGAAyG;IACzG,8GAA8G;IAC9G,eAAe;IACf,+GAA+G;IAC/G,gHAAgH;IAChH,mEAAmE;IACnE,6GAA6G;IAC7G,+GAA+G;IAC/G,gHAAgH;IAChH,gHAAgH;IAChH,8GAA8G;IAC9G,kGAAkG;IAClG,0GAA0G;IAC1G,0GAA0G;CAC7G,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/market/cancel-order/format.utils.d.ts

@@ -0,0 +1,3 @@
+import type { CancelOrderResult } from '../../../services/market/cancel.types.js';
+export declare function summarizeCancelledOrder(result: CancelOrderResult): string;
+//# sourceMappingURL=format.utils.d.ts.map

package/dist/tools/market/cancel-order/format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAGlF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAYzE"}

package/dist/tools/market/cancel-order/format.utils.js

@@ -0,0 +1,13 @@
+import { MarketActionStatus } from '../../../services/market/types.js';
+export function summarizeCancelledOrder(result) {
+    const opening = result.status === MarketActionStatus.AlreadyCompleted
+        ? `Your ${result.orderKind} was already cancelled on-chain — no second cancellation was sent`
+        : `Your ${result.orderKind} is cancelled`;
+    const subject = result.tokenId === null ? 'it names no single Cell' : `it was made on Cell ${result.tokenId}`;
+    return [
+        `${opening} (order ${result.orderHash}, maker ${result.wallet})`,
+        subject,
+        `cancellation transaction: ${result.cancellationTxHash}`,
+    ].join('\n');
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/tools/market/cancel-order/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/format.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,MAAM,UAAU,uBAAuB,CAAC,MAAyB;IAC7D,MAAM,OAAO,GACT,MAAM,CAAC,MAAM,KAAK,kBAAkB,CAAC,gBAAgB;QACjD,CAAC,CAAC,QAAQ,MAAM,CAAC,SAAS,mEAAmE;QAC7F,CAAC,CAAC,QAAQ,MAAM,CAAC,SAAS,eAAe,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,uBAAuB,MAAM,CAAC,OAAO,EAAE,CAAC;IAE9G,OAAO;QACH,GAAG,OAAO,WAAW,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,MAAM,GAAG;QAChE,OAAO;QACP,6BAA6B,MAAM,CAAC,kBAAkB,EAAE;KAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/tools/market/cancel-order/types.d.ts

@@ -0,0 +1,8 @@
+import type { IMarketCancelService } from '../../../services/market/cancel.types.js';
+export interface CancelOrderContext {
+    marketCancel: IMarketCancelService;
+}
+export declare const cancelOrderInputSchema: {
+    orderHash: import("zod").ZodString;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/market/cancel-order/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAGrF,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,oBAAoB,CAAC;CACtC;AAED,eAAO,MAAM,sBAAsB;;CAMlC,CAAC"}

package/dist/tools/market/cancel-order/types.js

@@ -0,0 +1,7 @@
+import { orderHashSchema } from '../../../services/market/types.js';
+export const cancelOrderInputSchema = {
+    orderHash: orderHashSchema.describe('The exact 32-byte 0x-prefixed `orderHash` of YOUR OWN Market order, copied from `cpu_get_my_listings` or ' +
+        '`cpu_get_my_offers`. The same input cancels a listing and an offer alike — the side is a fact of the ' +
+        'order, not something you choose here.'),
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/market/cancel-order/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/market/cancel-order/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAMpE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,SAAS,EAAE,eAAe,CAAC,QAAQ,CAC/B,2GAA2G;QACvG,uGAAuG;QACvG,uCAAuC,CAC9C;CACJ,CAAC"}

package/dist/tools/market/cell-market/cell-market.d.ts

@@ -0,0 +1,4 @@
+import type { AppContext } from '../../../types.js';
+import { type MarketToolDefinition } from '../types.js';
+export declare function createGetCellMarketTool(context: AppContext): MarketToolDefinition;
+//# sourceMappingURL=cell-market.d.ts.map

package/dist/tools/market/cell-market/cell-market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-market.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/cell-market/cell-market.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAElF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,GAAG,oBAAoB,CAmBjF"}

package/dist/tools/market/cell-market/cell-market.js

@@ -0,0 +1,24 @@
+import { GET_CELL_MARKET_DESCRIPTION } from './constants.js';
+import { summarizeCellMarket } from '../format.utils.js';
+import { getCellMarketOutputSchema } from '../output.types.js';
+import { getCellMarketInputSchema } from '../types.js';
+export function createGetCellMarketTool(context) {
+    return {
+        name: 'cpu_get_cell_market',
+        description: GET_CELL_MARKET_DESCRIPTION,
+        inputSchema: getCellMarketInputSchema,
+        outputSchema: getCellMarketOutputSchema,
+        handler: async (args) => {
+            const { tokenId } = args;
+            const snapshot = await context.market.getCellMarket(tokenId);
+            return {
+                content: [
+                    { type: 'text', text: summarizeCellMarket(snapshot) },
+                    { type: 'text', text: JSON.stringify(snapshot) },
+                ],
+                structuredContent: snapshot,
+            };
+        },
+    };
+}
+//# sourceMappingURL=cell-market.js.map

package/dist/tools/market/cell-market/cell-market.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-market.js","sourceRoot":"","sources":["../../../../src/tools/market/cell-market/cell-market.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAA6B,MAAM,aAAa,CAAC;AAElF,MAAM,UAAU,uBAAuB,CAAC,OAAmB;IACvD,OAAO;QACH,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,2BAA2B;QACxC,WAAW,EAAE,wBAAwB;QACrC,YAAY,EAAE,yBAAyB;QACvC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,MAAM,EAAE,OAAO,EAAE,GAAG,IAA2B,CAAC;YAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAE7D,OAAO;gBACH,OAAO,EAAE;oBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAAE;oBACrD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;iBACnD;gBACD,iBAAiB,EAAE,QAAQ;aAC9B,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/market/cell-market/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const GET_CELL_MARKET_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/market/cell-market/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/cell-market/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAc7B,CAAC"}

package/dist/tools/market/cell-market/constants.js

@@ -0,0 +1,16 @@
+export const GET_CELL_MARKET_DESCRIPTION = [
+    'The NFT marketplace snapshot for ONE Cell: the best (lowest) active listing anyone has published for it and',
+    'the best (highest) active offer standing against it. This is the land market — Cells traded as NFTs for a',
+    'configured currency — and it is entirely separate from `cpu_get_markets` / `cpu_list_lots`, which trade',
+    'RESOURCES for $CPU inside the game.',
+    'BOTH SIDES ARE INDEPENDENTLY NULLABLE. `bestListing: null` means nobody is selling that Cell right now;',
+    '`bestOffer: null` means nobody is bidding on it. Neither null is an error and neither implies the other.',
+    'An offer carries its `kind`: `item` (bound to this exact Cell), `trait`, or `collection`. A trait or',
+    'collection offer is not made for this Cell specifically, so its `tokenId` may be null — it would still be',
+    'fillable with this Cell.',
+    'Every price is a base-unit decimal integer STRING (never a number), paired with a `currency` carrying the',
+    'address, symbol and decimals you need to read it. Times are Unix seconds.',
+    'The snapshot is about 10 seconds old; re-reading it faster than that returns the same picture and burns the',
+    'read budget. Ordinary map and Cell reads carry no marketplace data — ask here.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/market/cell-market/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/market/cell-market/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACvC,6GAA6G;IAC7G,2GAA2G;IAC3G,yGAAyG;IACzG,qCAAqC;IACrC,yGAAyG;IACzG,0GAA0G;IAC1G,sGAAsG;IACtG,2GAA2G;IAC3G,0BAA0B;IAC1B,2GAA2G;IAC3G,2EAA2E;IAC3E,6GAA6G;IAC7G,gFAAgF;CACnF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/market/format.utils.d.ts

@@ -0,0 +1,8 @@
+import type { ListCellResult } from '../../services/market/listing.types.js';
+import type { MarketListingPage, MarketOfferPage } from '../../services/market/profile.schemas.js';
+import { type CellMarketSnapshot } from '../../services/market/types.js';
+export declare function summarizeListingPage(page: MarketListingPage): string;
+export declare function summarizeOfferPage(heading: string, page: MarketOfferPage): string;
+export declare function summarizeListedCell(result: ListCellResult): string;
+export declare function summarizeCellMarket(snapshot: CellMarketSnapshot): string;
+//# sourceMappingURL=format.utils.d.ts.map

package/dist/tools/market/format.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.d.ts","sourceRoot":"","sources":["../../../src/tools/market/format.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AACnG,OAAO,EAAsB,KAAK,kBAAkB,EAAuB,MAAM,gCAAgC,CAAC;AAwBlH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAUpE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAUjF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAkBlE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAyBxE"}

package/dist/tools/market/format.utils.js

@@ -0,0 +1,75 @@
+import { MarketActionStatus } from '../../services/market/types.js';
+function describeMoney(amount, currency) {
+    return `${amount} ${currency.symbol} base units (decimals=${currency.decimals})`;
+}
+function describeNextCursor(nextCursor) {
+    if (nextCursor === null) {
+        return 'no further pages — nextCursor is null';
+    }
+    return `more pages remain — call again with cursor "${nextCursor}"`;
+}
+function describeListingRow(listing) {
+    return `Cell ${listing.tokenId} — ${describeMoney(listing.price, listing.currency)} (order ${listing.orderHash})`;
+}
+function describeOfferRow(offer) {
+    const bound = offer.tokenId === null ? 'no bound Cell (criteria offer)' : `Cell ${offer.tokenId}`;
+    return `[${offer.kind}] ${bound} — ${describeMoney(offer.amount, offer.currency)} (order ${offer.orderHash})`;
+}
+export function summarizeListingPage(page) {
+    if (page.items.length === 0) {
+        return [`Your Cell listings — no listings on this page`, describeNextCursor(page.nextCursor)].join('\n');
+    }
+    return [
+        `Your Cell listings — ${page.items.length} on this page`,
+        ...page.items.map(describeListingRow),
+        describeNextCursor(page.nextCursor),
+    ].join('\n');
+}
+export function summarizeOfferPage(heading, page) {
+    if (page.items.length === 0) {
+        return [`${heading} — no offers on this page`, describeNextCursor(page.nextCursor)].join('\n');
+    }
+    return [
+        `${heading} — ${page.items.length} on this page`,
+        ...page.items.map(describeOfferRow),
+        describeNextCursor(page.nextCursor),
+    ].join('\n');
+}
+export function summarizeListedCell(result) {
+    const opening = result.status === MarketActionStatus.AlreadyCompleted
+        ? `Cell ${result.tokenId} was already listed on these exact terms — no second listing was published`
+        : `Cell ${result.tokenId} is listed`;
+    const approvals = result.approvalTxHashes.length === 0
+        ? 'no collection approval was needed'
+        : `collection approvals broadcast in order: ${result.approvalTxHashes.join(', ')}`;
+    return [
+        `${opening} (order ${result.listing.orderHash}, seller ${result.wallet})`,
+        `gross price: ${describeMoney(result.grossPrice, result.currency)}`,
+        `platform fee ${result.platformFee}, creator fee ${result.creatorFee}, ` +
+            `your estimated proceeds ${result.estimatedProceeds} (same base units)`,
+        `expires at ${result.listing.expirationTime}`,
+        approvals,
+    ].join('\n');
+}
+export function summarizeCellMarket(snapshot) {
+    const lines = [`Cell ${snapshot.tokenId} — marketplace snapshot`];
+    if (snapshot.bestListing === null) {
+        lines.push('best listing: none — this Cell is not for sale right now');
+    }
+    else {
+        const listing = snapshot.bestListing;
+        lines.push(`best listing: ${describeMoney(listing.price, listing.currency)} from ${listing.maker}, ` +
+            `expires at ${listing.expirationTime} (order ${listing.orderHash})`);
+    }
+    if (snapshot.bestOffer === null) {
+        lines.push('best offer: none — nobody is bidding on this Cell right now');
+    }
+    else {
+        const offer = snapshot.bestOffer;
+        const bound = offer.tokenId === null ? 'no bound Cell (criteria offer)' : `Cell ${offer.tokenId}`;
+        lines.push(`best offer [${offer.kind}]: ${describeMoney(offer.amount, offer.currency)} from ${offer.maker}, ` +
+            `${bound}, expires at ${offer.expirationTime} (order ${offer.orderHash})`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.utils.js.map

package/dist/tools/market/format.utils.js.map

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

package/dist/tools/market/list-cell/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const LIST_CELL_DESCRIPTION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/market/list-cell/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/market/list-cell/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAqBvB,CAAC"}

package/dist/tools/market/list-cell/constants.js

@@ -0,0 +1,23 @@
+export const LIST_CELL_DESCRIPTION = [
+    'Publish ONE Cell of yours for sale on the NFT marketplace, in a single call. This is the land market —',
+    'Cells traded as NFTs for a configured currency — and it is entirely separate from `cpu_create_lot`, which',
+    'sells RESOURCES for $CPU inside the game.',
+    'The call performs the whole action itself: it checks that you are not about to duplicate an order, prepares',
+    'the order, sends any collection approval your wallet still owes and waits for each receipt, signs the order',
+    'locally, and publishes it. There is nothing to confirm afterwards.',
+    'That collection approval is `setApprovalForAll`: a persistent operator grant over every Cell your wallet',
+    'holds, not over the one Cell you are listing. It is sent once and then stays in force.',
+    '`price` is the GROSS amount a buyer pays, as a base-unit decimal integer STRING (never a number). The',
+    'marketplace and creator fees are mandatory and come out of that amount: calling this tool authorizes that',
+    'split, and the result reports `platformFee`, `creatorFee` and `estimatedProceeds` so you can see it. There',
+    'is no minimum-proceeds input.',
+    'Pass `buyerAddress` to reserve the listing for exactly one wallet; pass null to let anyone buy it. The',
+    'seller is always the authenticated wallet.',
+    'Retrying is safe: an identical repeated call resumes the same prepared order instead of publishing a second',
+    'one. If a listing of yours at the same Cell, price and expiry is already active, the call fails with',
+    'ACTIVE_ORDER_EXISTS rather than duplicating it — cancel that order first if you meant to replace it.',
+    'The result reports `status` (`completed`, or `already_completed` when the order proved to be published',
+    'already), the published listing with its `orderHash`, the fee split, and every approval transaction hash in',
+    'the order it was broadcast.',
+].join(' ');
+//# sourceMappingURL=constants.js.map

package/dist/tools/market/list-cell/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/market/list-cell/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,wGAAwG;IACxG,2GAA2G;IAC3G,2CAA2C;IAC3C,6GAA6G;IAC7G,6GAA6G;IAC7G,oEAAoE;IACpE,0GAA0G;IAC1G,wFAAwF;IACxF,uGAAuG;IACvG,2GAA2G;IAC3G,4GAA4G;IAC5G,+BAA+B;IAC/B,wGAAwG;IACxG,4CAA4C;IAC5C,6GAA6G;IAC7G,sGAAsG;IACtG,sGAAsG;IACtG,wGAAwG;IACxG,6GAA6G;IAC7G,6BAA6B;CAChC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}