@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/variation_groups.js

@@ -0,0 +1,92 @@
+import { apiGet } from '../api.js';
+/**
+ * Variation groups — several of the seller's listings sold as one product.
+ *
+ * The fact an agent most needs from these tools is counter-intuitive enough
+ * to repeat in every description: a group's members are STANDALONE listings,
+ * not children. They appear in list_listings, they publish independently to
+ * platforms with no variation support, and each has its own inventory, COGS
+ * and lifecycle. The group is an extra fact about them, not a container.
+ *
+ * Getting that wrong is not cosmetic. An agent repricing "every listing"
+ * would treat four sizes of one shirt as four unrelated products and can
+ * happily undercut the seller against themselves; one counting products
+ * would report four where the seller has one.
+ */
+export const variationGroupTools = [
+    {
+        name: 'list_variation_groups',
+        description: 'Every variation group the seller has — listings sold together as one product with '
+            + 'options (sizes, card conditions, vinyl pressings). Returns each group with its '
+            + 'members and a rollup: memberCount, fromPriceCents (the CHEAPEST option, not an '
+            + 'average), availableUnits, and needsAttention. '
+            + 'IMPORTANT: members are standalone listings that also appear in list_listings — '
+            + 'do not count them as separate products, and do not reprice them independently '
+            + 'without checking they belong to a group.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/api/v1/variation-groups'),
+    },
+    {
+        name: 'get_variation_group',
+        description: 'One variation group with every option, its value on the axis (e.g. "M", "10.5", '
+            + '"Near Mint"), price, stock and status. Use after list_variation_groups when you '
+            + 'need the individual options rather than the summary.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                groupId: { type: 'string', description: 'The group listing id.' },
+            },
+            required: ['groupId'],
+        },
+        handler: (args) => {
+            const { groupId } = args;
+            return apiGet(`/api/v1/variation-groups/${encodeURIComponent(groupId)}`);
+        },
+    },
+    {
+        name: 'get_listing_variation_group',
+        description: 'Which variation group a listing belongs to, or null. '
+            + 'Call this BEFORE acting on a listing in bulk — repricing, delisting or counting '
+            + 'four sizes of one shirt as four independent products is wrong in a way that only '
+            + 'shows up later in the numbers.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingId: { type: 'string', description: 'The listing id to look up.' },
+            },
+            required: ['listingId'],
+        },
+        handler: (args) => {
+            const { listingId } = args;
+            return apiGet(`/api/v1/listings/${encodeURIComponent(listingId)}/variation-group`);
+        },
+    },
+    {
+        name: 'plan_variation_group_publish',
+        description: 'What publishing a variation group to given platforms WOULD do — without publishing. '
+            + 'Platforms split two ways and the difference is large: eBay and Shopify produce ONE '
+            + 'listing with a dropdown, while Depop, Poshmark, Mercari, Vinted and the rest have no '
+            + 'variation concept at all and produce one listing PER OPTION. A four-option group on '
+            + 'Depop is four listings. '
+            + 'Returns per-platform mode/listingsProduced/explanation plus totalListings. Always '
+            + 'show totalListings before recommending a publish — it is the number the seller reacts '
+            + 'to, and finding out afterwards means unpicking several live listings.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                groupId: { type: 'string', description: 'The group listing id.' },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Platform ids to plan for, e.g. ["ebay","depop","poshmark"].',
+                },
+            },
+            required: ['groupId', 'platforms'],
+        },
+        handler: (args) => {
+            const { groupId, platforms } = args;
+            return apiGet(`/api/v1/variation-groups/${encodeURIComponent(groupId)}/publish-plan`, { platforms: (platforms ?? []).join(',') });
+        },
+    },
+];
+//# sourceMappingURL=variation_groups.js.map

package/dist/tools/variation_groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variation_groups.js","sourceRoot":"","sources":["../../src/tools/variation_groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAc;IAC5C;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,oFAAoF;cAClF,iFAAiF;cACjF,iFAAiF;cACjF,gDAAgD;cAChD,iFAAiF;cACjF,gFAAgF;cAChF,0CAA0C;QAC9C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC;KAClD;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,kFAAkF;cAChF,kFAAkF;cAClF,sDAAsD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,OAAO,EAAE,GAAG,IAA2B,CAAC;YAChD,OAAO,MAAM,CAAC,4BAA4B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;KACF;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACT,uDAAuD;cACrD,kFAAkF;cAClF,mFAAmF;cACnF,gCAAgC;QACpC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;aACzE;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAC;YACpD,OAAO,MAAM,CAAC,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QACrF,CAAC;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EACT,sFAAsF;cACpF,qFAAqF;cACrF,uFAAuF;cACvF,sFAAsF;cACtF,0BAA0B;cAC1B,oFAAoF;cACpF,wFAAwF;cACxF,uEAAuE;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBACjE,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,6DAA6D;iBAC3E;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;SACnC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAgD,CAAC;YAChF,OAAO,MAAM,CACX,4BAA4B,kBAAkB,CAAC,OAAO,CAAC,eAAe,EACtE,EAAE,SAAS,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC3C,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

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

@@ -0,0 +1,11 @@
+import { ToolDef } from './types.js';
+/**
+ * Vault Markets auto-deleveraging (api routes/v1/write/vault-markets-adl.ts).
+ * The loss waterfall: a position's own money, then the insurance fund (at
+ * most 25% of it for one event), then ADL: the most profitable, most
+ * levered opposite position on the same item closes against the bankrupt one
+ * at its bankruptcy price. Only then the market pool or Crossly operations;
+ * never Crossly money. Reads only.
+ */
+export declare const vaultMarketsAdlTools: ToolDef[];
+//# sourceMappingURL=vault-markets-adl.d.ts.map

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

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

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

@@ -0,0 +1,46 @@
+import { apiGet } from '../api.js';
+/**
+ * Vault Markets auto-deleveraging (api routes/v1/write/vault-markets-adl.ts).
+ * The loss waterfall: a position's own money, then the insurance fund (at
+ * most 25% of it for one event), then ADL: the most profitable, most
+ * levered opposite position on the same item closes against the bankrupt one
+ * at its bankruptcy price. Only then the market pool or Crossly operations;
+ * never Crossly money. Reads only.
+ */
+export const vaultMarketsAdlTools = [
+    {
+        name: 'get_vault_markets_adl_fund',
+        description: 'The Vault Markets insurance fund: insuranceFundCents (booked) and insuranceFreeCents (free to draw now), perEventCapCents (the most one loss may draw before auto-deleveraging starts), the waterfall in order, and the latest ADL events with no user or position ids. Money is in cents of US dollars.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/adl', {}),
+    },
+    {
+        name: 'list_vault_markets_adl_ranks',
+        description: 'Your live Vault Markets positions, each with its place in its item auto-deleveraging queue: lights 5 (first in line) to 1 (last), or 0 when not in the queue (only profitable positions are). Ranked by P&L percent times effective leverage; pnlBps is P&L over your own margin in basis points, effLeverageX100 is leverage times 100, markCents is in cents of US dollars.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/adl/positions', {}),
+    },
+    {
+        name: 'get_vault_markets_adl_rank',
+        description: 'One of your Vault Markets positions with its auto-deleveraging lights (5 first in line to 1 last; 0 when not in the queue or once it has ended).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Position id (uuid), from list_vault_markets_positions or list_vault_markets_adl_ranks.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/vault-markets/adl/positions/${encodeURIComponent(id)}`, {});
+        },
+    },
+    {
+        name: 'list_vault_markets_adl_events',
+        description: 'The auto-deleveraging events your Vault Markets positions were part of, newest first. role is "bankrupt" (yours went under water) or "counterparty" (yours was first in line); priceCents is the bankruptcy price both closed at, cents is what the short paid the long (both in cents of US dollars); status is "pending" (waiting for the short sale proceeds to be final), "sent", "settled", "refused" (with Crossly operations), "reversed" (the custodian did not move the cash, so it was undone), "void" (nothing to give) or "unknown" (with Crossly operations); kind is "unit" or "cash".',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/adl/events', {}),
+    },
+];
+//# sourceMappingURL=vault-markets-adl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-adl.js","sourceRoot":"","sources":["../../src/tools/vault-markets-adl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAc;IAC7C;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,0SAA0S;QACvT,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,EAAE,CAAC;KACnD;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,+WAA+W;QAC5X,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iCAAiC,EAAE,EAAE,CAAC;KAC7D;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,kJAAkJ;QAC/J,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wFAAwF,EAAE;aAC9H;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAsB,CAAC;YACtC,OAAO,MAAM,CAAC,mCAAmC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACjF,CAAC;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,skBAAskB;QACnlB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,8BAA8B,EAAE,EAAE,CAAC;KAC1D;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,82 @@
+import { apiDelete, apiGet, apiPost } from '../api.js';
+/**
+ * The shopping agent on Vault Markets (api routes/v1/write/vault-markets-agent.ts):
+ * price watches on a book key, and the limit orders the agent drafted.
+ * A watch never trades. A draft places nothing; there is deliberately no
+ * confirm tool: an order is placed only when the user asks for that exact
+ * order, with place_vault_markets_pro_order and the draft's orderBody.
+ * Reads need vault-markets:read, changes vault-markets:trade.
+ */
+const ID = (what) => ({ type: 'string', description: `${what} id (uuid).` });
+const BOOK_KEY = {
+    type: 'string',
+    description: 'The market: variantId:condition:gradeKey, with grade "-" when ungraded (e.g. "3f2a...:near_mint:psa:10"). Take it from list_vault_markets_movers or get_vault_markets_portfolio.',
+};
+export const vaultMarketsAgentTools = [
+    {
+        name: 'list_vault_markets_agent_watches',
+        description: 'Your price watches on Vault Markets book keys, live first. Each has the metric watched ("bid" best open bid, "ask" lowest open ask, "last" last trade, "mark" market price), its direction, the threshold and the last value seen (cents of US dollars), and its status ("live", "fired", "cancelled", "expired").',
+        inputSchema: {
+            type: 'object',
+            properties: { live: { type: 'boolean', description: 'true = only live watches; false or left out = live first, then ended ones.' } },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { live } = args;
+            return apiGet('/v1/vault-markets/agent/watches', live ? { live: 'true' } : {});
+        },
+    },
+    {
+        name: 'create_vault_markets_agent_watch',
+        description: 'Watch one book key and tell the user once when a number crosses a price, e.g. "tell me when the PSA 10 bid crosses $400". It fires on a crossing from the side the number was on when set, so a number already past the price waits for the next crossing. Never trades. At most 50 live watches, each for 90 days.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: BOOK_KEY,
+                metric: { type: 'string', enum: ['bid', 'ask', 'last', 'mark'], description: 'What to watch: "bid" the best open bid, "ask" the lowest open ask, "last" the last trade, "mark" the market price.' },
+                direction: { type: 'string', enum: ['above', 'below'], description: 'Optional. "above" fires when the number rises to or past the price; "below" when it falls to or under it. Leave out for "crosses": whichever way it has to move.' },
+                thresholdCents: { type: 'integer', minimum: 1, maximum: 100_000_000, description: 'The price, in cents of US dollars (the currency), a whole number.' },
+            },
+            required: ['bookKey', 'metric', 'thresholdCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { bookKey, metric, direction, thresholdCents } = args;
+            return apiPost('/v1/vault-markets/agent/watches', { bookKey, metric, ...(direction ? { direction } : {}), thresholdCents });
+        },
+    },
+    {
+        name: 'cancel_vault_markets_agent_watch',
+        description: 'Cancel a live price watch. Returns the watch.',
+        inputSchema: { type: 'object', properties: { id: ID('Watch') }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            return apiDelete(`/v1/vault-markets/agent/watches/${encodeURIComponent(id)}`);
+        },
+    },
+    {
+        name: 'list_vault_markets_agent_drafts',
+        description: 'Limit orders the shopping agent drafted for the user, newest first: item, side ("buy" or "sell"), units, limit and notional (cents of US dollars), the book when drafted, status ("drafted", "placing", "placed", "rejected", "cancelled", "expired") and the orderBody that would place it. A draft places nothing.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/agent/drafts', {}),
+    },
+    {
+        name: 'get_vault_markets_agent_draft',
+        description: 'One drafted order with its orderBody. Only if the user explicitly confirms this exact order may it be placed, with place_vault_markets_pro_order and that orderBody.',
+        inputSchema: { type: 'object', properties: { id: ID('Draft') }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/vault-markets/agent/drafts/${encodeURIComponent(id)}`, {});
+        },
+    },
+    {
+        name: 'cancel_vault_markets_agent_draft',
+        description: 'Throw a drafted order away (only while it is still a draft). Returns { ok, draft }.',
+        inputSchema: { type: 'object', properties: { id: ID('Draft') }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/vault-markets/agent/drafts/${encodeURIComponent(id)}/cancel`, {});
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-agent.js.map

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

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

package/dist/tools/vault-markets-alerts-hub.d.ts

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

package/dist/tools/vault-markets-alerts-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-alerts-hub.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-alerts-hub.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAYrC,eAAO,MAAM,0BAA0B,EAAE,OAAO,EA+D/C,CAAC"}

package/dist/tools/vault-markets-alerts-hub.js

@@ -0,0 +1,75 @@
+import { apiGet, apiPost, apiPut } from '../api.js';
+/**
+ * The Vault Markets alerts hub (api routes/v1/write/vault-markets-alerts.ts):
+ * which kinds of vault alert go to which channel, quiet hours, a test alert,
+ * and the log of what the hub did. Every alert also lands in the notification
+ * bell. Margin calls, ADL and P2P loan events always push and ignore quiet hours.
+ */
+const KINDS = ['price', 'fill', 'margin_call', 'adl', 'p2p_loan', 'auction', 'market_open', 'receipt_token', 'set_goal', 'follow', 'account'];
+const KIND_WORDS = 'price (price alerts and offers), fill (fills and sales), margin_call (margin calls, recalls and buy-ins), adl (auto-deleveraging), p2p_loan (collector loans), auction (vault auctions), market_open, receipt_token, set_goal, follow (collectors you follow) or account (everything else)';
+const CHANNEL_WORDS = 'push, telegram, terminal (the Crossly desktop app), email (the daily digest) or webhook (the event "vault.alert")';
+export const vaultMarketsAlertsHubTools = [
+    {
+        name: 'get_vault_alert_settings',
+        description: 'Your Vault Markets alert settings: every kind of vault alert, every channel with whether it is set up (and what to do if not), the full on/off grid, the switches that cannot be turned off, and quiet hours.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/alert-prefs', {}),
+    },
+    {
+        name: 'update_vault_alert_settings',
+        description: 'Change which kinds of vault alert go to which channel, set or clear quiet hours, or flip the Telegram master switch. Returns the new settings.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                matrix: {
+                    type: 'object',
+                    description: `Switches to change, as { kind: { channel: true or false } }. Kinds: ${KIND_WORDS}. Channels: ${CHANNEL_WORDS}. A critical kind's push cannot be turned off.`,
+                    additionalProperties: { type: 'object', additionalProperties: { type: 'boolean' } },
+                },
+                quietHours: {
+                    type: ['object', 'null'],
+                    description: 'Hold push and Telegram copies between these times (critical kinds still go): { start: "HH:MM", end: "HH:MM", tz: IANA time zone such as "America/New_York" }, or null to clear.',
+                    properties: {
+                        start: { type: 'string', description: 'Start time, "HH:MM" in 24-hour time.' },
+                        end: { type: 'string', description: 'End time, "HH:MM" in 24-hour time.' },
+                        tz: { type: 'string', description: 'IANA time zone, for example "Europe/London".' },
+                    },
+                },
+                telegram: { type: 'boolean', description: 'The Telegram master switch: copy vault alerts to the linked Telegram chat at all.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { matrix, quietHours, telegram } = args;
+            return apiPut('/v1/vault-markets/alert-prefs', { matrix, quietHours, telegram });
+        },
+    },
+    {
+        name: 'send_vault_test_alert',
+        description: 'Send yourself one test vault alert of a kind, through your own switches. Returns { sent, kind, plan } where plan says per channel: send, off, quiet (held by quiet hours) or unavailable (not set up).',
+        inputSchema: {
+            type: 'object',
+            properties: { kind: { type: 'string', enum: KINDS, description: `The kind of alert to test: ${KIND_WORDS}.` } },
+            required: ['kind'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { kind } = args;
+            return apiPost('/v1/vault-markets/alert-prefs/test', { kind });
+        },
+    },
+    {
+        name: 'list_vault_alert_log',
+        description: 'What the alerts hub did with your recent vault alerts: kind, title, the channels each went to, what was held and why (quiet hours, the daily cap, a switch, Telegram not linked) and the email digest state.',
+        inputSchema: {
+            type: 'object',
+            properties: { limit: { type: 'integer', minimum: 1, maximum: 200, description: 'How many recent alerts, 1 to 200 (default 50).' } },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { limit } = args;
+            return apiGet('/v1/vault-markets/alert-log', limit ? { limit } : {});
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-alerts-hub.js.map

package/dist/tools/vault-markets-alerts-hub.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-analytics.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-analytics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA4BrC,eAAO,MAAM,0BAA0B,EAAE,OAAO,EAsK/C,CAAC"}

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

@@ -0,0 +1,192 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../api.js';
+/**
+ * Vault Markets analytics (api routes/v1/write/vault-markets-analytics.ts):
+ * indexes over book keys valued only from the order book's marks (base 1000
+ * at inception), buying an index's basket as whole units, a watchlist,
+ * compare, portfolio value by day, the grading arbitrage signal and vault
+ * supply by day. An index is addressed by its slug (from
+ * list_vault_markets_indexes). Moves are basis points (100 = 1%).
+ */
+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 SLUG = { type: 'string', description: 'The index slug (lowercase letters, digits and dashes) from list_vault_markets_indexes.' };
+const DAYS = (dflt, min = 1) => ({ type: 'integer', minimum: min, maximum: 1825, default: dflt, description: `How many days back (${min}-1825). Default ${dflt}.` });
+const NONE = { type: 'object', properties: {}, additionalProperties: false };
+const KEY_ONLY = { type: 'object', properties: { bookKey: BOOK_KEY }, required: ['bookKey'], additionalProperties: false };
+const SLUG_ONLY = { type: 'object', properties: { slug: SLUG }, required: ['slug'], additionalProperties: false };
+const WEIGHTING = { type: 'string', enum: ['mark', 'equal'], description: '"mark" = each key weighted by its market price (the default on create); "equal" = every key weighted alike.' };
+const INDEX_PROPS = {
+    name: { type: 'string', description: 'Index name (1-80 characters).' },
+    description: { type: ['string', 'null'], description: 'Optional description (up to 280 characters); null clears it.' },
+    weighting: WEIGHTING,
+    isPublic: { type: 'boolean', description: 'true = others can see and follow it; false = only you (the default on create).' },
+    keys: { type: 'array', items: BOOK_KEY, minItems: 1, maxItems: 50, description: 'The book keys in the index, 1 to 50.' },
+};
+export const vaultMarketsAnalyticsTools = [
+    {
+        name: 'list_vault_markets_indexes',
+        description: 'Indexes over book keys: per category, per top brand, the Crossly 50 and your own. Each with its level now (base 1000 at inception) and change since the last daily close.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['category', 'brand', 'curated', 'custom', 'composite', 'segment'],
+                    description: 'Optional filter: "category" = one per category; "brand" = one per top brand; "curated" = Crossly-picked such as the Crossly 50; "custom" = your own indexes.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { kind } = args;
+            return apiGet('/v1/vault-markets/indexes', { kind });
+        },
+    },
+    {
+        name: 'list_vault_markets_index_movers',
+        description: 'The built-in indexes that moved most since their last daily close.',
+        inputSchema: { type: 'object', properties: { limit: { type: 'integer', minimum: 1, maximum: 50, default: 10, description: 'How many indexes (1-50). Default 10.' } }, additionalProperties: false },
+        handler: (args) => {
+            const { limit } = args;
+            return apiGet('/v1/vault-markets/indexes/movers', { limit });
+        },
+    },
+    {
+        name: 'get_vault_markets_index',
+        description: 'One index with its daily closes (oldest first) and its level now.',
+        inputSchema: { type: 'object', properties: { slug: SLUG, days: DAYS(365) }, required: ['slug'], additionalProperties: false },
+        handler: (args) => {
+            const { slug, days } = args;
+            return apiGet(`/v1/vault-markets/indexes/${encodeURIComponent(slug)}`, { days });
+        },
+    },
+    {
+        name: 'list_vault_markets_index_constituents',
+        description: "The book keys in an index with their weight, move since the last close and contribution to the index's move (basis points).",
+        inputSchema: SLUG_ONLY,
+        handler: (args) => {
+            const { slug } = args;
+            return apiGet(`/v1/vault-markets/indexes/${encodeURIComponent(slug)}/constituents`, {});
+        },
+    },
+    {
+        name: 'create_vault_markets_index',
+        description: 'Make an index of your own: 1 to 50 book keys, weighted by mark or equally. Up to 10 per account. Returns the index with its slug.',
+        inputSchema: { type: 'object', properties: INDEX_PROPS, required: ['name', 'keys'], additionalProperties: false },
+        handler: (args) => {
+            const { name, description, weighting, isPublic, keys } = args;
+            return apiPost('/v1/vault-markets/indexes', { name, description, weighting, isPublic, keys });
+        },
+    },
+    {
+        name: 'update_vault_markets_index',
+        description: 'Rename, re-weight, share or change the keys of an index of your own; its level carries on. Change at least one thing.',
+        inputSchema: { type: 'object', properties: { slug: SLUG, ...INDEX_PROPS }, required: ['slug'], additionalProperties: false },
+        handler: (args) => {
+            const { slug, name, description, weighting, isPublic, keys } = args;
+            return apiPatch(`/v1/vault-markets/indexes/${encodeURIComponent(slug)}`, { name, description, weighting, isPublic, keys });
+        },
+    },
+    {
+        name: 'delete_vault_markets_index',
+        description: 'Delete an index of your own. Returns { ok }.',
+        inputSchema: SLUG_ONLY,
+        handler: (args) => {
+            const { slug } = args;
+            return apiDelete(`/v1/vault-markets/indexes/${encodeURIComponent(slug)}`);
+        },
+    },
+    {
+        name: 'buy_vault_markets_index_basket',
+        description: "Buy an index's basket: one limit buy per key for 1-5 whole units each, at most maxBpsOverMark over each key's mark. Every unit is a real item that lands in your vault. Idempotent on clientBasketId; returns a result per key.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: SLUG,
+                unitsPerKey: { type: 'integer', minimum: 1, maximum: 5, default: 1, description: 'Whole units of each key to buy (1-5). Default 1.' },
+                maxBpsOverMark: { type: 'integer', minimum: 0, maximum: 2000, default: 200, description: "Pay at most this many basis points over each key's mark (market price); 200 = 2% (the default), up to 2000 = 20%." },
+                tif: { type: 'string', enum: ['ioc', 'gtc'], default: 'ioc', description: '"ioc" = buy what is offered now and cancel the rest (the default); "gtc" = leave unfilled buys resting until cancelled.' },
+                funding: { type: 'string', enum: ['card', 'custodian'], description: 'How the buys are paid: "card" = a saved card (give stripePaymentMethodId); "custodian" = cash in your custodian account.' },
+                stripePaymentMethodId: { type: 'string', description: 'The saved card (Stripe payment method id, "pm_...") that pays for a card-funded basket.' },
+                clientBasketId: { type: 'string', description: 'Optional id of your own (letters, digits, _ and -; up to 40): buying again with it returns the first result instead of buying twice.' },
+            },
+            required: ['slug'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { slug, unitsPerKey, maxBpsOverMark, tif, funding, stripePaymentMethodId, clientBasketId } = args;
+            return apiPost(`/v1/vault-markets/indexes/${encodeURIComponent(slug)}/buy`, { unitsPerKey, maxBpsOverMark, tif, funding, stripePaymentMethodId, clientBasketId });
+        },
+    },
+    {
+        name: 'list_vault_markets_watchlist',
+        description: 'Your watched book keys with mark (in cents), 24 h and 7 d change, and the last 30 daily marks (sparkline).',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/watchlist', {}),
+    },
+    {
+        name: 'watch_vault_markets_key',
+        description: 'Add a book key to your watchlist. Returns { bookKey, watching }.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => {
+            const { bookKey } = args;
+            return apiPost('/v1/vault-markets/watchlist', { bookKey });
+        },
+    },
+    {
+        name: 'unwatch_vault_markets_key',
+        description: 'Remove a book key from your watchlist. Returns { bookKey, watching }.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => {
+            const { bookKey } = args;
+            return apiDelete('/v1/vault-markets/watchlist', undefined, { bookKey });
+        },
+    },
+    {
+        name: 'compare_vault_markets',
+        description: 'Up to 5 book keys and/or index slugs as daily series on the same days, each rebased to 100.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                items: { type: 'array', items: { type: 'string' }, minItems: 1, maxItems: 5, description: 'Book keys (variantId:condition:gradeKey) and/or index slugs to compare, 1 to 5.' },
+                days: DAYS(90, 2),
+            },
+            required: ['items'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { items, days } = args;
+            return apiGet('/v1/vault-markets/compare', { items: items.join(','), days });
+        },
+    },
+    {
+        name: 'get_vault_markets_portfolio_history',
+        description: "Your Vault Markets value by day at the marks (vault units, units on loan, positions; in cents) and today's return against yesterday's close.",
+        inputSchema: { type: 'object', properties: { days: DAYS(90) }, additionalProperties: false },
+        handler: (args) => {
+            const { days } = args;
+            return apiGet('/v1/vault-markets/portfolio/history', { days });
+        },
+    },
+    {
+        name: 'get_vault_markets_grading_signal',
+        description: "For a raw (ungraded) book key: the marks of the same item's graded keys, the spread over raw, grading cost per grader (in cents), the margin tier grading lifts it to, your raw vault units it pays to grade, and where to act.",
+        inputSchema: KEY_ONLY,
+        handler: (args) => {
+            const { bookKey } = args;
+            return apiGet('/v1/vault-markets/grading-signal', { bookKey });
+        },
+    },
+    {
+        name: 'get_vault_markets_supply',
+        description: "A book key's units in the vault and authentications passed, by day (oldest first, today live).",
+        inputSchema: { type: 'object', properties: { bookKey: BOOK_KEY, days: DAYS(180) }, required: ['bookKey'], additionalProperties: false },
+        handler: (args) => {
+            const { bookKey, days } = args;
+            return apiGet('/v1/vault-markets/supply', { bookKey, days });
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-analytics.js.map

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

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

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

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

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

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