@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/vault-markets-mm.js

@@ -0,0 +1,282 @@
+import { apiGet, apiPost, apiPut } from '../api.js';
+/**
+ * Vault Markets fees by role, quote requests (RFQ), midpoint blocks,
+ * market-maker programmes and market-maker protection (api
+ * routes/v1/write/vault-markets-mm.ts). Fees follow the role: the resting
+ * order pays the maker rate, the order that fills against it pays the taker
+ * rate; a buyer's fee is added ON TOP of the price and a seller's comes out
+ * of the proceeds. Quote requests are anonymous; answers are firm for 60
+ * seconds and taking one fills it as a block. Market-maker rebates are paid
+ * only out of fees Crossly already took on that key that month. Every money
+ * figure is integer cents of US dollars; rates are basis points (100 = 1%).
+ * Never quote a price that did not come back from these tools.
+ */
+const BOOK_KEY = {
+    type: 'string',
+    description: 'The market: variantId:condition:gradeKey, with grade "-" when ungraded (e.g. "3f2a...:new:-"). Take it from list_vault_markets_movers or get_vault_markets_portfolio.',
+};
+const SIDE = { type: 'string', enum: ['buy', 'sell'], description: '"buy" or "sell", from your side of the trade.' };
+const QUANTITY = { type: 'integer', minimum: 1, description: 'Units (whole number, at least 1).' };
+const FUNDING = { type: 'string', enum: ['card', 'custodian'], description: 'How a buy is paid: "card" (a saved card; give stripePaymentMethodId) or "custodian" (your Vault Markets custodian account). Ignored for a sell.' };
+const PM = { type: 'string', description: 'Stripe payment method id (pm_...) of one of your saved cards, for funding "card".' };
+const NO_ARGS = { type: 'object', properties: {}, additionalProperties: false };
+const KEY_ONLY = { type: 'object', properties: { bookKey: BOOK_KEY }, required: ['bookKey'], additionalProperties: false };
+const idArg = (what) => ({
+    type: 'object',
+    properties: { id: { type: 'string', description: `${what} id (uuid).` } },
+    required: ['id'],
+    additionalProperties: false,
+});
+export const vaultMarketsMmTools = [
+    /* Fees */
+    {
+        name: 'get_vault_markets_fee_schedule',
+        description: 'The Vault Markets fee schedule by role: maker and taker rates in basis points for retail, 30-day volume, Registered LPs and DMMs, the volume threshold in cents of US dollars, the CBX discount, the referral share, and the 2% net floor Crossly always keeps.',
+        inputSchema: NO_ARGS,
+        handler: () => apiGet('/v1/vault-markets/fees/schedule'),
+    },
+    {
+        name: 'quote_vault_markets_fee',
+        description: 'Your fee for one order at a price, as maker (the order rests on the book) and as taker (it fills at once), with the programme that sets your rate and any Crossly One trim. paidOnTop=true means a buyer pays the fee on top of the price; a seller\'s fee comes out of the proceeds. All amounts are cents of US dollars.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: BOOK_KEY,
+                side: SIDE,
+                priceCents: { type: 'integer', minimum: 1, description: 'The price per unit, in cents of US dollars (e.g. 12500 = $125.00).' },
+                quantity: { type: 'integer', minimum: 1, default: 1, description: 'Units in the order (default 1).' },
+            },
+            required: ['bookKey', 'side', 'priceCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/vault-markets/fees/quote', args),
+    },
+    /* Quote requests */
+    {
+        name: 'open_vault_markets_rfq',
+        description: 'Ask for a firm quote on a block: dealers, the key\'s designated market maker and liquidity providers, and holders of the item are told, anonymously. Answers are firm for 60 seconds; your limit is never shown to them. Returns { id, expiresAt, invited }. Watch it with get_vault_markets_rfq and take an answer with accept_vault_markets_rfq.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: BOOK_KEY,
+                side: SIDE,
+                quantity: QUANTITY,
+                limitCents: { type: 'integer', minimum: 100, description: 'Optional worst price per unit, in cents of US dollars: the most you pay (buy) or the least you accept (sell). Answers outside it cannot be taken. Never shown to responders.' },
+                ttlSeconds: { type: 'integer', minimum: 30, maximum: 600, description: 'How long the request stays open, in seconds (30-600, default 120).' },
+                funding: FUNDING,
+                stripePaymentMethodId: PM,
+            },
+            required: ['bookKey', 'side', 'quantity'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/rfq', args),
+    },
+    {
+        name: 'list_vault_markets_rfqs',
+        description: 'Your quote requests, newest first, with status (open, filling, filled, expired, cancelled, failed), your limit in cents of US dollars and any fail reason.',
+        inputSchema: NO_ARGS,
+        handler: () => apiGet('/v1/vault-markets/rfq'),
+    },
+    {
+        name: 'list_vault_markets_rfq_inbox',
+        description: 'Open quote requests you were sent (as a dealer, designated market maker, liquidity provider or holder), each with how you were invited and your live answer. Answer with respond_vault_markets_rfq.',
+        inputSchema: NO_ARGS,
+        handler: () => apiGet('/v1/vault-markets/rfq/inbox'),
+    },
+    {
+        name: 'list_vault_markets_open_rfqs',
+        description: 'Open quote requests on one book key (all-to-all: anyone with ID may answer). Anonymous: side, quantity and expiry only.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet('/v1/vault-markets/rfq/open', args),
+    },
+    {
+        name: 'get_vault_markets_rfq',
+        description: 'One quote request. The requester sees every answer (anonymous) with its price in cents of US dollars and firm-until time; a responder sees the request and their own answer.',
+        inputSchema: idArg('Quote request'),
+        handler: (args) => {
+            const { id } = args;
+            const rid = encodeURIComponent(id);
+            return apiGet(`/v1/vault-markets/rfq/${rid}`);
+        },
+    },
+    {
+        name: 'respond_vault_markets_rfq',
+        description: 'Answer a quote request with a firm price for its full quantity, good for 60 seconds (a new answer replaces your old one). Selling needs the units free in your vault; buying pays from your Vault Markets custodian account. ID check needed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Quote request id (uuid), from list_vault_markets_rfq_inbox or list_vault_markets_open_rfqs.' },
+                priceCents: { type: 'integer', minimum: 100, description: 'Your firm price per unit, in cents of US dollars ($1 or more). Must be inside the key\'s LULD price band.' },
+            },
+            required: ['id', 'priceCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, priceCents } = args;
+            const rid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/rfq/${rid}/respond`, { priceCents });
+        },
+    },
+    {
+        name: 'accept_vault_markets_rfq',
+        description: 'Take one live answer to your quote request: it fills as a block through the normal fill path (fees by role, self-trade prevention, halts, LULD band). Returns { filled, blockId, tradeIds, reason, rfq }. Only do this when the user explicitly asks to take that answer.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Your quote request id (uuid).' },
+                responseId: { type: 'string', description: 'The answer to take (uuid), from get_vault_markets_rfq responses.' },
+            },
+            required: ['id', 'responseId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, responseId } = args;
+            const rid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/rfq/${rid}/accept`, { responseId });
+        },
+    },
+    {
+        name: 'cancel_vault_markets_rfq',
+        description: 'Cancel your open quote request; any live answers expire.',
+        inputSchema: idArg('Quote request'),
+        handler: (args) => {
+            const { id } = args;
+            const rid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/rfq/${rid}/cancel`, {});
+        },
+    },
+    {
+        name: 'withdraw_vault_markets_rfq_response',
+        description: 'Withdraw your live answer to a quote request.',
+        inputSchema: idArg('Your answer (response)'),
+        handler: (args) => {
+            const { id } = args;
+            const rid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/rfq/responses/${rid}/withdraw`, {});
+        },
+    },
+    /* Midpoint blocks */
+    {
+        name: 'list_vault_markets_midpoints',
+        description: 'Your midpoint block orders: side, quantity, minimum match, filled so far, limit in cents of US dollars, status (open, filled, cancelled, expired) and expiry.',
+        inputSchema: NO_ARGS,
+        handler: () => apiGet('/v1/vault-markets/midpoint'),
+    },
+    {
+        name: 'place_vault_markets_midpoint',
+        description: 'Place a hidden block order that trades only at the firm-book midpoint, against another midpoint order of at least your minimum size. Nothing shows on the book. A sell needs the units free in your vault.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: BOOK_KEY,
+                side: SIDE,
+                quantity: QUANTITY,
+                minQuantity: { type: 'integer', minimum: 1, description: 'The smallest block to match with (1 to quantity, default 1).' },
+                limitCents: { type: 'integer', minimum: 100, description: 'Optional worst price per unit, in cents of US dollars: if the midpoint moves past it, the order waits.' },
+                funding: FUNDING,
+                stripePaymentMethodId: PM,
+                hours: { type: 'integer', minimum: 1, maximum: 720, description: 'How long the order lasts, in hours (1-720, default 24).' },
+            },
+            required: ['bookKey', 'side', 'quantity'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/midpoint', args),
+    },
+    {
+        name: 'cancel_vault_markets_midpoint',
+        description: 'Cancel an open midpoint block order.',
+        inputSchema: idArg('Midpoint order'),
+        handler: (args) => {
+            const { id } = args;
+            const mid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/midpoint/${mid}/cancel`, {});
+        },
+    },
+    /* Market makers */
+    {
+        name: 'get_vault_markets_mm_programs',
+        description: 'Your market-maker programmes (liquidity provider or designated market maker, per key), the last 30 days of obligations (two-sided coverage, calls joined, quote requests answered in time, met or not), rebates in cents of US dollars (paid only from fees Crossly already took on that key that month), and the rules.',
+        inputSchema: NO_ARGS,
+        handler: () => apiGet('/v1/vault-markets/mm'),
+    },
+    {
+        name: 'join_vault_markets_lp',
+        description: 'Join a key as a Registered Liquidity Provider (ID check needed; active at once). Meeting coverage earns the LP fee rates the next day.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiPost('/v1/vault-markets/mm/lp', args),
+    },
+    {
+        name: 'apply_vault_markets_dmm',
+        description: 'Apply to be the designated market maker on a tier B or C key (one per key; Crossly approves). Obligations: two-sided quote inside the spread cap most of the trading time, every opening and re-opening call, and answering 60% of quote requests within 60 s.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: BOOK_KEY,
+                displayName: { type: 'string', maxLength: 60, description: 'Optional name shown on the item\'s page as its market maker (1-60 characters).' },
+                note: { type: 'string', maxLength: 1000, description: 'Optional note for Crossly\'s reviewers (up to 1000 characters).' },
+            },
+            required: ['bookKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/mm/dmm', args),
+    },
+    {
+        name: 'leave_vault_markets_mm_program',
+        description: 'Leave a market-maker programme; its fee rate and benefits stop with it.',
+        inputSchema: idArg('Programme (from get_vault_markets_mm_programs)'),
+        handler: (args) => {
+            const { id } = args;
+            const pid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/mm/${pid}/leave`, {});
+        },
+    },
+    {
+        name: 'get_vault_markets_key_makers',
+        description: 'A book key\'s designated market maker (by the name it chose, and whether it is meeting its obligations) and how many liquidity providers quote it.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet('/v1/vault-markets/mm/key', args),
+    },
+    {
+        name: 'get_vault_markets_mmp',
+        description: 'Your market-maker protection: the fill trigger (units or notional in cents of US dollars within a window of seconds), the freeze length, and whether you are frozen now.',
+        inputSchema: NO_ARGS,
+        handler: () => apiGet('/v1/vault-markets/mm/mmp'),
+    },
+    {
+        name: 'set_vault_markets_mmp',
+        description: 'Set market-maker protection: when maxUnits units or maxNotionalCents filled on your quotes within windowSeconds, every quote is pulled at once and quoting freezes for freezeSeconds. Turning it on needs at least one of maxUnits / maxNotionalCents.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                enabled: { type: 'boolean', description: 'Protection on (true) or off (false).' },
+                windowSeconds: { type: 'integer', minimum: 1, maximum: 300, description: 'The window fills are counted over, in seconds (1-300, default 10).' },
+                maxUnits: { type: ['integer', 'null'], minimum: 1, maximum: 10000, description: 'Units filled on your quotes inside the window that trip it (null = no unit trigger).' },
+                maxNotionalCents: { type: ['integer', 'null'], minimum: 100, description: 'Value filled on your quotes inside the window that trips it, in cents of US dollars (null = no value trigger).' },
+                freezeSeconds: { type: 'integer', minimum: 1, maximum: 3600, description: 'How long quoting stays frozen after a trip, in seconds (1-3600, default 60).' },
+            },
+            required: ['enabled'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPut('/v1/vault-markets/mm/mmp', args),
+    },
+    {
+        name: 'reset_vault_markets_mmp',
+        description: 'End a market-maker protection freeze early.',
+        inputSchema: NO_ARGS,
+        handler: () => apiPost('/v1/vault-markets/mm/mmp/reset', {}),
+    },
+    {
+        name: 'mass_cancel_vault_markets_orders',
+        description: 'Cancel every open Vault Markets order (optionally on one key, or only market-making quotes) and every resting leg in one statement: nothing fills between the first cancel and the last. Returns { orders, legs }. Only on the user\'s explicit ask.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: { ...BOOK_KEY, description: `Optional: only this key. ${BOOK_KEY.description}` },
+                quotesOnly: { type: 'boolean', description: 'true = cancel only market-making quotes; false or absent = every open order.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/mm/mass-cancel', args),
+    },
+];
+//# sourceMappingURL=vault-markets-mm.js.map

package/dist/tools/vault-markets-mm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-mm.js","sourceRoot":"","sources":["../../src/tools/vault-markets-mm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGpD;;;;;;;;;;;GAWG;AACH,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,uKAAuK;CAC5K,CAAC;AACX,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAW,CAAC;AAC9H,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAW,CAAC;AAC5G,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,iJAAiJ,EAAW,CAAC;AACzO,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mFAAmF,EAAW,CAAC;AACzI,MAAM,OAAO,GAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;AACxG,MAAM,QAAQ,GAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;AACnJ,MAAM,KAAK,GAAG,CAAC,IAAY,EAA0B,EAAE,CAAC,CAAC;IACvD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,aAAa,EAAE,EAAE;IACzE,QAAQ,EAAE,CAAC,IAAI,CAAC;IAChB,oBAAoB,EAAE,KAAK;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAc;IAC5C,UAAU;IACV;QACE,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,iQAAiQ;QAC9Q,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iCAAiC,CAAC;KACzD;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,4TAA4T;QACzU,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,oEAAoE,EAAE;gBAC9H,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE;aACtG;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC;YAC3C,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,8BAA8B,EAAE,IAA+B,CAAC;KAC3F;IAED,oBAAoB;IACpB;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,oVAAoV;QACjW,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,QAAQ;gBAClB,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,8KAA8K,EAAE;gBAC1O,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,oEAAoE,EAAE;gBAC7I,OAAO,EAAE,OAAO;gBAChB,qBAAqB,EAAE,EAAE;aAC1B;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;YACzC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,uBAAuB,EAAE,IAAI,CAAC;KAC1D;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,4JAA4J;QACzK,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;KAC/C;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,qMAAqM;QAClN,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC;KACrD;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,yHAAyH;QACtI,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,4BAA4B,EAAE,IAA+B,CAAC;KACzF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,8KAA8K;QAC3L,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC;QACnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;KACF;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,+OAA+O;QAC5P,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6FAA6F,EAAE;gBAClI,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,2GAA2G,EAAE;aACxK;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;YAC9B,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,IAA0C,CAAC;YACtE,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,yBAAyB,GAAG,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,2QAA2Q;QACxR,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;gBACpE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;aAChH;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;YAC9B,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,IAA0C,CAAC;YACtE,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,yBAAyB,GAAG,SAAS,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACxE,CAAC;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC;QACnC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,yBAAyB,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;KACF;IACD;QACE,IAAI,EAAE,qCAAqC;QAC3C,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,KAAK,CAAC,wBAAwB,CAAC;QAC5C,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,mCAAmC,GAAG,WAAW,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;KACF;IAED,qBAAqB;IACrB;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,+JAA+J;QAC5K,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;KACpD;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,4MAA4M;QACzN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,IAAI;gBACV,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE;gBACzH,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,wGAAwG,EAAE;gBACpK,OAAO,EAAE,OAAO;gBAChB,qBAAqB,EAAE,EAAE;gBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,yDAAyD,EAAE;aAC7H;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC;YACzC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,4BAA4B,EAAE,IAAI,CAAC;KAC/D;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC;QACpC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,8BAA8B,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;KACF;IAED,mBAAmB;IACnB;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,0TAA0T;QACvU,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;KAC9C;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,wIAAwI;QACrJ,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC;KAC5D;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,gQAAgQ;QAC7Q,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,QAAQ;gBACjB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,gFAAgF,EAAE;gBAC7I,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,iEAAiE,EAAE;aAC1H;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,0BAA0B,EAAE,IAAI,CAAC;KAC7D;IACD;QACE,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE,KAAK,CAAC,gDAAgD,CAAC;QACpE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,wBAAwB,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1D,CAAC;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,oJAAoJ;QACjK,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,0BAA0B,EAAE,IAA+B,CAAC;KACvF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,0KAA0K;QACvL,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC;KAClD;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,wPAAwP;QACrQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;gBACjF,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,oEAAoE,EAAE;gBAC/I,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,sFAAsF,EAAE;gBACxK,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,gHAAgH,EAAE;gBAC5L,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,8EAA8E,EAAE;aAC3J;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,0BAA0B,EAAE,IAAI,CAAC;KAC5D;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC;KAC7D;IACD;QACE,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,sPAAsP;QACnQ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,4BAA4B,QAAQ,CAAC,WAAW,EAAE,EAAE;gBACzF,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8EAA8E,EAAE;aAC7H;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC;KACrE;CACF,CAAC"}

package/dist/tools/vault-markets-mode.d.ts

@@ -0,0 +1,11 @@
+import { ToolDef } from './types.js';
+/**
+ * Vault Markets Simple and Pro modes, and "What's it worth" (api
+ * routes/v1/write/vault-markets-mode.ts). The mode is a display preference
+ * remembered for the person on the web and in the app. The worth reads use
+ * only the order book: the mark and its quality, what Instant Exit would pay
+ * for one unit now, and the person's own units. Nothing here places an order
+ * or moves money.
+ */
+export declare const vaultMarketsModeTools: ToolDef[];
+//# sourceMappingURL=vault-markets-mode.d.ts.map

package/dist/tools/vault-markets-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-mode.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-mode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,EA6C1C,CAAC"}

package/dist/tools/vault-markets-mode.js

@@ -0,0 +1,56 @@
+import { apiGet, apiPut } from '../api.js';
+/**
+ * Vault Markets Simple and Pro modes, and "What's it worth" (api
+ * routes/v1/write/vault-markets-mode.ts). The mode is a display preference
+ * remembered for the person on the web and in the app. The worth reads use
+ * only the order book: the mark and its quality, what Instant Exit would pay
+ * for one unit now, and the person's own units. Nothing here places an order
+ * or moves money.
+ */
+export const vaultMarketsModeTools = [
+    {
+        name: 'get_vault_markets_mode',
+        description: 'Your Vault Markets mode: "simple" (three things: buy, sell, and what it is worth) or "pro" (the full trading terminal). source is "chosen" when you picked it, or "default" when it was set for you once (new people start in simple; people already trading start in pro). explain says what each mode shows.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/mode', {}),
+    },
+    {
+        name: 'set_vault_markets_mode',
+        description: 'Choose your Vault Markets mode, remembered on the web and in the Crossly app. A display preference only: it places nothing and moves no money.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                mode: { type: 'string', enum: ['simple', 'pro'], description: 'Which mode: "simple" (buy, sell and what it is worth) or "pro" (the full trading terminal).' },
+            },
+            required: ['mode'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { mode } = args;
+            return apiPut('/v1/vault-markets/mode', { mode });
+        },
+    },
+    {
+        name: 'get_vault_markets_key_worth',
+        description: 'What one Vault Markets item is worth: the mark (market price from the order book, in cents of US dollars) with its quality ("A" from trades, "B" from firm quotes, "C" indicative, "none" no price yet) and band; instantExit, what one unit would sell for right now into the best resting bid (bestBidCents, shareOfMarkBps, or the reason it cannot); and mine, your units, how many are free to sell, their value at the mark and what selling every free one now would fetch (sellNow, cents). headline and lines are plain words to repeat. Read only.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: { type: 'string', description: 'The book key: variantId:condition:gradeKey (gradeKey "-" when ungraded), as the market pages and vault holdings give it.' },
+            },
+            required: ['bookKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { bookKey } = args;
+            return apiGet('/v1/vault-markets/worth', { bookKey });
+        },
+    },
+    {
+        name: 'get_vault_markets_vault_worth',
+        description: 'What your whole Crossly vault is worth now: valueCents at the marks (cents of US dollars) split into reliable (A or B) and indicative (C) marks with units that have no mark, cost and P&L, today change, and sellNow, an estimate of what the units free to sell would fetch from the bids resting on the book right now. note says how far to trust the value. Read only.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/worth/vault', {}),
+    },
+];
+//# sourceMappingURL=vault-markets-mode.js.map

package/dist/tools/vault-markets-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-mode.js","sourceRoot":"","sources":["../../src/tools/vault-markets-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAc;IAC9C;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,gTAAgT;QAC7T,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,EAAE,EAAE,CAAC;KACpD;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,gJAAgJ;QAC7J,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,6FAA6F,EAAE;aAC9J;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAkC,CAAC;YACpD,OAAO,MAAM,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;KACF;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,8hBAA8hB;QAC3iB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0HAA0H,EAAE;aACrK;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,OAAO,EAAE,GAAG,IAA2B,CAAC;YAChD,OAAO,MAAM,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,6WAA6W;QAC1X,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,+BAA+B,EAAE,EAAE,CAAC;KAC3D;CACF,CAAC"}

package/dist/tools/vault-markets-ops.d.ts

@@ -0,0 +1,3 @@
+import { ToolDef } from './types.js';
+export declare const vaultMarketsOpsTools: ToolDef[];
+//# sourceMappingURL=vault-markets-ops.d.ts.map

package/dist/tools/vault-markets-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-ops.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-ops.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAsBrC,eAAO,MAAM,oBAAoB,EAAE,OAAO,EA0LzC,CAAC"}

package/dist/tools/vault-markets-ops.js

@@ -0,0 +1,208 @@
+import { apiGet, apiPost } from '../api.js';
+/**
+ * Vault Markets ops (api routes/v1/write/vault-markets-ops.ts): units move
+ * between vaults (gifts to another user, gifts to Crossly Cares) without
+ * leaving the shelf; money only ever moves through the order book. Also the
+ * investor tax centre, scheduled vault auctions with proxy bidding, and
+ * Instant Exit on one unit.
+ *
+ * The tax-year PDF is not a tool: it is a binary file, and a tool returns
+ * text. get_vault_markets_tax returns its link; export_vault_markets_tax_csv
+ * returns the same year as CSV text.
+ */
+const ID = (what) => ({ type: 'string', description: `${what} id (uuid).` });
+const CENTS = (what) => ({ type: 'integer', minimum: 100, maximum: 100_000_000, description: `${what}, in cents of US dollars (the currency), a whole number.` });
+const NULL_CENTS = (what) => ({ type: ['integer', 'null'], minimum: 100, maximum: 100_000_000, description: `Optional ${what}, in cents of US dollars (the currency), a whole number; null or left out = none.` });
+const NONE = { type: 'object', properties: {}, additionalProperties: false };
+const ID_ONLY = (what) => ({ type: 'object', properties: { id: ID(what) }, required: ['id'], additionalProperties: false });
+const UNIT_ONLY = (what) => ({ type: 'object', properties: { vaultItemId: ID(what) }, required: ['vaultItemId'], additionalProperties: false });
+const YEAR = { type: 'integer', minimum: 2020, maximum: 2100, description: 'The tax year (e.g. 2026). Default: the current year.' };
+const KIND = { type: 'string', enum: ['weekly', 'premier'], description: '"weekly" = the weekly event, ending Sunday; "premier" = the premier event, for units marked $10,000 or more.' };
+export const vaultMarketsOpsTools = [
+    {
+        name: 'gift_vault_markets_unit',
+        description: 'Give a unit in your vault to another Crossly user (by @username or email). It stays on its shelf; they have 7 days to accept. ID needed above $1,000 at the mark. Returns { id, expiresAt }.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                vaultItemId: ID('Vault unit to give'),
+                to: { type: 'string', description: 'Who gets it: a Crossly @username / handle or an email address.' },
+                note: { type: ['string', 'null'], description: 'Optional note to the recipient (up to 280 characters).' },
+            },
+            required: ['vaultItemId', 'to'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { vaultItemId, to, note } = args;
+            return apiPost('/v1/vault-markets/gifts', { vaultItemId, to, note });
+        },
+    },
+    {
+        name: 'list_vault_markets_gifts',
+        description: 'Gifts you sent and received, newest first, with their status.',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/gifts', {}),
+    },
+    {
+        name: 'accept_vault_markets_gift',
+        description: 'Accept a gift: the unit becomes yours in place. Returns { status }.',
+        inputSchema: ID_ONLY('Gift'),
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/vault-markets/gifts/${encodeURIComponent(id)}/accept`, {});
+        },
+    },
+    {
+        name: 'decline_vault_markets_gift',
+        description: 'Decline a gift: the unit stays with the giver. Returns { status }.',
+        inputSchema: ID_ONLY('Gift'),
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/vault-markets/gifts/${encodeURIComponent(id)}/decline`, {});
+        },
+    },
+    {
+        name: 'cancel_vault_markets_gift',
+        description: 'Cancel a gift you sent, before it is accepted. Returns { status }.',
+        inputSchema: ID_ONLY('Gift'),
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/vault-markets/gifts/${encodeURIComponent(id)}/cancel`, {});
+        },
+    },
+    {
+        name: 'donate_vault_markets_unit',
+        description: 'Give a vault unit to Crossly Cares (once the charity can receive; otherwise the answer says why not). Returns { id, markCents }.',
+        inputSchema: UNIT_ONLY('Vault unit to donate'),
+        handler: (args) => {
+            const { vaultItemId } = args;
+            return apiPost('/v1/vault-markets/donations', { vaultItemId });
+        },
+    },
+    {
+        name: 'get_vault_markets_tax',
+        description: 'Your tax year on the vault markets: units bought and sold with cost, proceeds, gain and term (in cents); lending fees, staking interest (estimate), market-maker rewards; closed positions. Includes links to the CSV and PDF files.',
+        inputSchema: { type: 'object', properties: { year: YEAR }, additionalProperties: false },
+        handler: (args) => {
+            const { year } = args;
+            return apiGet('/v1/vault-markets/tax', { year });
+        },
+    },
+    {
+        name: 'export_vault_markets_tax_csv',
+        description: 'The tax year as CSV text: one row per sale, purchase, gift, income line and closed position.',
+        inputSchema: { type: 'object', properties: { year: YEAR }, additionalProperties: false },
+        handler: (args) => {
+            const { year } = args;
+            return apiGet('/v1/vault-markets/tax.csv', { year });
+        },
+    },
+    {
+        name: 'list_vault_markets_auctions',
+        description: 'Open vault auction events and their lots, soonest ending first.',
+        inputSchema: { type: 'object', properties: { kind: { ...KIND, description: `Optional filter. ${KIND.description}` } }, additionalProperties: false },
+        handler: (args) => {
+            const { kind } = args;
+            return apiGet('/v1/vault-markets/auctions', { kind });
+        },
+    },
+    {
+        name: 'list_my_vault_markets_auctions',
+        description: 'Lots you consigned (with your reserve) and lots you bid on (with your maximum and whether you lead).',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/auctions/mine', {}),
+    },
+    {
+        name: 'get_vault_markets_auction_lot',
+        description: 'One auction lot: the price showing, the next minimum bid (in cents), whether a reserve exists and is met, the end (extended by late bids), the bid history and your standing.',
+        inputSchema: ID_ONLY('Lot'),
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/vault-markets/auctions/lots/${encodeURIComponent(id)}`, {});
+        },
+    },
+    {
+        name: 'consign_vault_markets_auction_lot',
+        description: 'Consign a stored, authenticated vault unit to the next weekly or premier auction, with an optional opening price and reserve. The unit is held until the close. Returns { lotId, eventId, endsAt }.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                vaultItemId: ID('Vault unit to auction'),
+                kind: { ...KIND, default: 'weekly', description: `Which event (default "weekly"). ${KIND.description}` },
+                startCents: NULL_CENTS('opening price'),
+                reserveCents: NULL_CENTS('reserve (the lot does not sell below it)'),
+            },
+            required: ['vaultItemId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { vaultItemId, kind, startCents, reserveCents } = args;
+            return apiPost('/v1/vault-markets/auctions/lots', { vaultItemId, kind, startCents, reserveCents });
+        },
+    },
+    {
+        name: 'withdraw_vault_markets_auction_lot',
+        description: 'Withdraw your lot before any bid; the unit goes back on your shelf. Returns { ok }.',
+        inputSchema: ID_ONLY('Lot'),
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/vault-markets/auctions/lots/${encodeURIComponent(id)}/withdraw`, {});
+        },
+    },
+    {
+        name: 'bid_vault_markets_auction_lot',
+        description: "Leave or raise your maximum on a lot; the system bids for you up to it. A bid in the last 2 minutes extends the lot by 2 minutes. The winner's saved card is charged at the close. ID needed above $10,000.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: ID('Lot'),
+                maxCents: CENTS('Your maximum bid'),
+                stripePaymentMethodId: { type: 'string', description: 'The saved card (Stripe payment method id, "pm_...") charged if you win.' },
+            },
+            required: ['id', 'maxCents', 'stripePaymentMethodId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, maxCents, stripePaymentMethodId } = args;
+            return apiPost(`/v1/vault-markets/auctions/lots/${encodeURIComponent(id)}/bids`, { maxCents, stripePaymentMethodId });
+        },
+    },
+    {
+        name: 'feature_vault_markets_auction_lot',
+        description: 'Feature an open lot on your live show, or pass lotId null to take it off. Viewers see the pin change. Returns { ok }.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: ID('Live show (live stream)'), lotId: { type: ['string', 'null'], description: 'The lot id (uuid) to feature, or null to clear the featured lot.' } },
+            required: ['id', 'lotId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, lotId } = args;
+            return apiPost(`/v1/vault-markets/live-streams/${encodeURIComponent(id)}/featured-lot`, { lotId });
+        },
+    },
+    {
+        name: 'get_vault_markets_unit_quote',
+        description: "The market around a vault unit: its mark and source, the best bid that could take it, the Instant Exit price (the best bid) and a pack pull's own sell-back credit. Prices in cents.",
+        inputSchema: ID_ONLY('Vault unit'),
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/vault-markets/units/${encodeURIComponent(id)}/quote`, {});
+        },
+    },
+    {
+        name: 'sell_vault_markets_unit_now',
+        description: 'Sell one unit of this item now into the best bid (an immediate-or-cancel pro order), never below minCents. Returns { status: filled | missed, filledCents, quote, order }.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: ID('Vault unit'), minCents: NULL_CENTS('lowest price you accept') },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, minCents } = args;
+            return apiPost(`/v1/vault-markets/units/${encodeURIComponent(id)}/sell-now`, minCents == null ? {} : { minCents });
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-ops.js.map

package/dist/tools/vault-markets-ops.js.map

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

package/dist/tools/vault-markets-oracle-dcm.d.ts

@@ -0,0 +1,10 @@
+import { ToolDef } from './types.js';
+/**
+ * Vault Markets oracle publishing and the partner exchange's index futures and
+ * options (api routes/v1/write/vault-markets-oracle-dcm.ts). Crossly publishes
+ * its built-in indexes as a signed oracle feed and shows the partner
+ * exchange's market read-only: it never lists, prices, matches or clears a
+ * contract, never holds a position, and never reads its own feed back.
+ */
+export declare const vaultMarketsOracleDcmTools: ToolDef[];
+//# sourceMappingURL=vault-markets-oracle-dcm.d.ts.map

package/dist/tools/vault-markets-oracle-dcm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-oracle-dcm.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-oracle-dcm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,EA+I/C,CAAC"}