@crossly/mcp 0.0.0-stage → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-reports.js","sourceRoot":"","sources":["../../src/tools/vault-markets-reports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAc;IACjD;QACE,IAAI,EAAE,yCAAyC;QAC/C,WAAW,EAAE,2TAA2T;QACxU,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wCAAwC,EAAE,EAAE,CAAC;KACpE;IACD;QACE,IAAI,EAAE,wCAAwC;QAC9C,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8EAA8E,EAAE;gBACnH,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,CAAC;oBACjF,WAAW,EAAE,sNAAsN;iBACpO;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;oBACnC,WAAW,EAAE,yGAAyG;iBACvH;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,6GAA6G,EAAE;gBACpK,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,qFAAqF,EAAE;gBAC/I,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE;gBAC1G,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,gFAAgF,EAAE;aAC7J;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;YACrD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAEtF,CAAC;YACF,OAAO,OAAO,CAAC,0CAA0C,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QACtK,CAAC;KACF;CACF,CAAC"}

package/dist/tools/vault-markets-set-goals.d.ts

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

package/dist/tools/vault-markets-set-goals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-set-goals.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-set-goals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAoBrC,eAAO,MAAM,yBAAyB,EAAE,OAAO,EAmI9C,CAAC"}

package/dist/tools/vault-markets-set-goals.js

@@ -0,0 +1,150 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../api.js';
+/**
+ * Vault Markets set goals and the "complete my set" basket bid (api
+ * routes/v1/write/vault-markets-set-goals.ts). A goal is one catalogue set;
+ * progress is computed from what the user holds in the Crossly vault and each
+ * missing piece is listed with its mark. One basket bid places a GTC limit buy
+ * per missing piece under a hard total budget (limits plus the worst-case
+ * buyer fee), paid by a saved card or the custodian account, every leg through
+ * pre-trade risk; the legs are cancelled once the set is complete.
+ */
+const GOAL_ID = { type: 'string', description: 'The set goal id (a UUID) from list_vault_set_goals or create_vault_set_goal.' };
+const CONDITION = { type: ['string', 'null'], description: 'The condition a piece must be in to count (as the goal options list them, e.g. "near_mint"), or null for any condition.' };
+const GRADE_MODE = { type: 'string', enum: ['any', 'ungraded', 'exact'], description: 'Which grades count: "any" (any grade or none), "ungraded" (only ungraded units) or "exact" (only gradeKey).' };
+const GRADE_KEY = { type: ['string', 'null'], description: 'The grade an "exact" goal wants, as the goal options list it (e.g. "psa:10"); null otherwise.' };
+const BUDGET = { type: 'integer', description: 'The hard total budget, in cents of US dollars (100 to 25000000): every leg limit plus the worst-case buyer fee never adds up past it.' };
+const BPS = { type: 'integer', description: 'How far over each piece mark a leg may pay, in basis points (0 to 2000; 500 = 5%). Default 500.' };
+const SKU_IDS = { type: 'array', items: { type: 'string' }, description: 'Only these missing pieces (catalogue SKU ids from get_vault_set_goal). Leave out for every missing piece.' };
+export const vaultMarketsSetGoalsTools = [
+    {
+        name: 'find_vault_sets',
+        description: 'Find catalogue sets to start a set goal on. With q (2 or more characters): a word-start search of every set (a card set, a comic series, a sneaker line). Without q: the sets the user holds pieces of in the vault, then the collections they are building. Each has category, brandSlug and modelSlug (what create_vault_set_goal needs), pieces when known, and goalId when the user already has a goal on it.',
+        inputSchema: {
+            type: 'object',
+            properties: { q: { type: 'string', description: 'Words to search set names for (up to 80 characters). Leave out for the sets the user already holds pieces of.' } },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { q } = args;
+            return apiGet('/v1/vault-markets/set-goals/sets', q ? { q } : {});
+        },
+    },
+    {
+        name: 'list_vault_set_goals',
+        description: 'The user set goals: each set, the target a piece must meet, pieces held of the total (computed from the vault), complete or not, and the working basket bid (budgetCents, committedCents and spentCents in cents of US dollars; legs working and filled).',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/set-goals', {}),
+    },
+    {
+        name: 'create_vault_set_goal',
+        description: 'Start a set goal on a catalogue set (from find_vault_sets), optionally with a target: one condition, and any grade, ungraded, or one exact grade. One live goal per set, at most 20. Places no order and moves no money.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                category: { type: 'string', description: 'The set category slug, from find_vault_sets.' },
+                brandSlug: { type: 'string', description: 'The set brand slug, from find_vault_sets.' },
+                modelSlug: { type: 'string', description: 'The set model slug, from find_vault_sets.' },
+                condition: CONDITION,
+                gradeMode: GRADE_MODE,
+                gradeKey: GRADE_KEY,
+            },
+            required: ['category', 'brandSlug', 'modelSlug'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/set-goals', args),
+    },
+    {
+        name: 'get_vault_set_goal',
+        description: 'One set goal: every piece in set order, held (with the vault unit) or missing (bid: the cheapest marked book key that meets the target, markCents in cents of US dollars, or null when it has no price yet), the conditions and grades seen (options), and the working basket bid with each leg.',
+        inputSchema: { type: 'object', properties: { goalId: GOAL_ID }, required: ['goalId'], additionalProperties: false },
+        handler: (args) => {
+            const { goalId } = args;
+            return apiGet(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}`, {});
+        },
+    },
+    {
+        name: 'update_vault_set_goal',
+        description: 'Change what a piece must be to count toward a set goal. Refused while a basket bid works on the goal: cancel it first. Moves no money.',
+        inputSchema: {
+            type: 'object',
+            properties: { goalId: GOAL_ID, condition: CONDITION, gradeMode: GRADE_MODE, gradeKey: GRADE_KEY },
+            required: ['goalId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { goalId, ...patch } = args;
+            return apiPatch(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}`, patch);
+        },
+    },
+    {
+        name: 'remove_vault_set_goal',
+        description: 'Remove a set goal. A working basket bid on it is cancelled first; whatever already filled stays in the vault. Ask the user before calling.',
+        inputSchema: { type: 'object', properties: { goalId: GOAL_ID }, required: ['goalId'], additionalProperties: false },
+        handler: (args) => {
+            const { goalId } = args;
+            return apiDelete(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}`);
+        },
+    },
+    {
+        name: 'plan_vault_set_basket',
+        description: 'Preview the "complete my set" basket bid without placing anything: one leg per missing piece, cheapest first (limitCents = the mark plus maxBpsOverMark; costCents adds the worst-case buyer fee), the pieces skipped and why ("no_price", "over_budget", "not_chosen" or "too_many"), and committedCents, the most it can cost, never more than budgetCents. All money in cents of US dollars.',
+        inputSchema: {
+            type: 'object',
+            properties: { goalId: GOAL_ID, budgetCents: BUDGET, maxBpsOverMark: BPS, skuIds: SKU_IDS },
+            required: ['goalId', 'budgetCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { goalId, budgetCents, maxBpsOverMark, skuIds } = args;
+            return apiGet(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}/basket-plan`, {
+                budgetCents, ...(maxBpsOverMark != null ? { maxBpsOverMark } : {}), ...(skuIds?.length ? { skuIds: skuIds.join(',') } : {}),
+            });
+        },
+    },
+    {
+        name: 'place_vault_set_basket',
+        description: 'Place the "complete my set" basket bid: one GTC limit buy for one unit of each planned missing piece, under the hard budget. Each leg is an ordinary order that passes pre-trade risk and the ID check, paid at the match by the chosen saved card or the custodian account; the legs are cancelled once the set is complete. Show the user plan_vault_set_basket first and ask before calling. Pass the same clientBasketId on a retry so it is never placed twice.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                goalId: GOAL_ID,
+                budgetCents: BUDGET,
+                maxBpsOverMark: BPS,
+                skuIds: SKU_IDS,
+                funding: { type: 'string', enum: ['card', 'custodian'], description: 'How the legs are paid: "card" (one of the user saved cards, charged when a leg fills) or "custodian" (the Vault Markets custodian account; needs it open and active).' },
+                stripePaymentMethodId: { type: 'string', description: 'For funding "card": the saved card id (pm_...), which must be one of the user own saved cards.' },
+                clientBasketId: { type: 'string', description: 'Your own id for this basket (6 to 64 characters): a retry with the same id returns the basket already placed.' },
+            },
+            required: ['goalId', 'budgetCents', 'funding'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { goalId, ...body } = args;
+            return apiPost(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}/basket`, body, body.clientBasketId);
+        },
+    },
+    {
+        name: 'cancel_vault_set_basket',
+        description: 'Cancel the working basket bid on a set goal: every working leg comes off the book; whatever already filled stays in the vault. Ask the user before calling.',
+        inputSchema: { type: 'object', properties: { goalId: GOAL_ID }, required: ['goalId'], additionalProperties: false },
+        handler: (args) => {
+            const { goalId } = args;
+            return apiPost(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}/basket/cancel`, {});
+        },
+    },
+    {
+        name: 'list_vault_set_baskets',
+        description: 'A set goal basket bids, newest first: status ("working", "completed", "ended" or "cancelled"), budgetCents, committedCents and spentCents (cents of US dollars), and every leg (piece, book key, limitCents, the pro order id, status "pending", "working", "filled", "cancelled" or "rejected", and why).',
+        inputSchema: {
+            type: 'object',
+            properties: { goalId: GOAL_ID, limit: { type: 'integer', description: 'How many basket bids to return, newest first (1 to 50; default 20).' } },
+            required: ['goalId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { goalId, limit } = args;
+            return apiGet(`/v1/vault-markets/set-goals/${encodeURIComponent(goalId)}/baskets`, limit ? { limit } : {});
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-set-goals.js.map

package/dist/tools/vault-markets-set-goals.js.map

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

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

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

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

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

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

@@ -0,0 +1,212 @@
+import { apiDelete, apiGet, apiPatch, apiPost, apiPut } from '../api.js';
+/**
+ * Vault Markets social (api routes/v1/write/vault-markets-social.ts):
+ * verified share cards (the % is the price move since the user's real fill,
+ * computed by Crossly; amounts hidden unless turned on), opt-in public vault
+ * profiles that show weights and never dollars, a feed of new vault buys by
+ * people the user follows (no copy trading), the Learn hub's server-graded
+ * quizzes (cosmetic pins only), the quarterly Vault Report, the press kit,
+ * index levels and the widget reads. Moves and weights are basis points.
+ */
+const ID = { type: 'string', description: 'The share card id (uuid) from list_vault_share_cards or create_vault_share_card.' };
+const HANDLE = { type: 'string', description: 'The person\'s Crossly handle, with or without the @.' };
+const CONCEPT = {
+    type: 'string',
+    enum: ['marks', 'instant-exit', 'lending', 'shorts', 'liens', 'auctions', 'indexes'],
+    description: 'The Learn concept.',
+};
+const SLUG = { type: 'string', description: 'The index slug (lowercase letters, digits and dashes) from list_vault_markets_indexes.' };
+const RANGE = { type: 'string', enum: ['1m', '3m', '6m', '1y', '5y'], description: 'How much history to include: "1m" = last 30 days, "3m" = 91 days, "6m" = 182 days, "1y" = 365 days, "5y" = 1825 days. Default "1y".' };
+const NONE = { type: 'object', properties: {}, additionalProperties: false };
+export const vaultMarketsSocialTools = [
+    {
+        name: 'list_vault_share_cards',
+        description: 'The user\'s verified share cards (not taken down), each as the public sees it: title, mark with quality, the % move since their real fill, and the image and link paths.',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/share-cards'),
+    },
+    {
+        name: 'create_vault_share_card',
+        description: 'Make a verified share card of a position, a vault unit, a public index or the user\'s portfolio. Crossly computes the % from the real fill and today\'s mark; dollar amounts stay hidden unless showAmounts is true. Returns the card with its link.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kind: { type: 'string', enum: ['position', 'unit', 'index', 'portfolio'], description: '"position" = a short or leveraged long; "unit" = one vault unit; "index" = a built-in or shared index; "portfolio" = everything the user holds in the vault.' },
+                refId: { type: 'string', description: 'The position id, vault unit id or index slug. Omit for "portfolio".' },
+                showAmounts: { type: 'boolean', description: 'Show dollar amounts on the card. Default false (% only).' },
+            },
+            required: ['kind'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/share-cards', args),
+    },
+    {
+        name: 'get_vault_share_card',
+        description: 'One share card as the public sees it.',
+        inputSchema: { type: 'object', properties: { id: ID }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/vault-markets/share-cards/${encodeURIComponent(id)}`);
+        },
+    },
+    {
+        name: 'set_vault_share_card_amounts',
+        description: 'Show or hide the dollar amounts on one of the user\'s share cards.',
+        inputSchema: { type: 'object', properties: { id: ID, showAmounts: { type: 'boolean', description: 'true = show amounts; false = % only.' } }, required: ['id', 'showAmounts'], additionalProperties: false },
+        handler: (args) => {
+            const { id, showAmounts } = args;
+            return apiPatch(`/v1/vault-markets/share-cards/${encodeURIComponent(id)}`, { showAmounts });
+        },
+    },
+    {
+        name: 'delete_vault_share_card',
+        description: 'Take one of the user\'s share cards down: its link and image stop working.',
+        inputSchema: { type: 'object', properties: { id: ID }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            return apiDelete(`/v1/vault-markets/share-cards/${encodeURIComponent(id)}`);
+        },
+    },
+    {
+        name: 'get_vault_profile_settings',
+        description: 'The user\'s public vault profile switch: whether it is on, whether followers see their new buys, the profile URL and follower count.',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/profile'),
+    },
+    {
+        name: 'update_vault_profile_settings',
+        description: 'Turn the user\'s public vault profile on or off and choose whether followers see their new vault buys. The profile shows weights by market, never dollars. Going public needs a handle.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                isPublic: { type: 'boolean', description: 'true = the profile is public at /shop/u/<handle>/vault.' },
+                showBuys: { type: 'boolean', description: 'true = followers see new vault buys (never prices).' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiPut('/v1/vault-markets/profile', args),
+    },
+    {
+        name: 'get_vault_public_profile',
+        description: 'Someone\'s public vault: each market\'s weight (basis points of the marked value), followers, whether the user follows them, and their recent buys (no prices).',
+        inputSchema: { type: 'object', properties: { handle: HANDLE }, required: ['handle'], additionalProperties: false },
+        handler: (args) => {
+            const { handle } = args;
+            return apiGet(`/v1/vault-markets/profiles/${encodeURIComponent(handle)}`);
+        },
+    },
+    {
+        name: 'follow_vault_profile',
+        description: 'Follow someone with a public vault so their new vault buys appear in the user\'s feed. This never copies their trades.',
+        inputSchema: { type: 'object', properties: { handle: HANDLE }, required: ['handle'], additionalProperties: false },
+        handler: (args) => {
+            const { handle } = args;
+            return apiPost(`/v1/vault-markets/profiles/${encodeURIComponent(handle)}/follow`, {});
+        },
+    },
+    {
+        name: 'unfollow_vault_profile',
+        description: 'Stop following someone.',
+        inputSchema: { type: 'object', properties: { handle: HANDLE }, required: ['handle'], additionalProperties: false },
+        handler: (args) => {
+            const { handle } = args;
+            return apiDelete(`/v1/vault-markets/profiles/${encodeURIComponent(handle)}/follow`);
+        },
+    },
+    {
+        name: 'get_vault_feed',
+        description: 'New vault buys by the people the user follows who share them, newest first, with each market\'s mark and a link to buy that market normally. No prices of their buys.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                before: { type: 'string', description: 'ISO time: only buys before it (the last item\'s "at" to page).' },
+                limit: { type: 'integer', minimum: 1, maximum: 50, default: 30, description: 'How many (1-50). Default 30.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { before, limit } = args;
+            return apiGet('/v1/vault-markets/feed', { before, limit });
+        },
+    },
+    {
+        name: 'get_vault_learn',
+        description: 'The Vault Learn hub: each concept (marks, Instant Exit, lending, shorts, liens, auctions, indexes) with whether the user passed its quiz. Quizzes earn cosmetic pins only.',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/learn'),
+    },
+    {
+        name: 'get_vault_learn_concept',
+        description: 'One Learn concept: its explanation and quiz questions (no answers).',
+        inputSchema: { type: 'object', properties: { concept: CONCEPT }, required: ['concept'], additionalProperties: false },
+        handler: (args) => {
+            const { concept } = args;
+            return apiGet(`/v1/vault-markets/learn/${encodeURIComponent(concept)}`);
+        },
+    },
+    {
+        name: 'answer_vault_learn_quiz',
+        description: 'Submit the user\'s answers to a concept\'s quiz, one choice index (0-based) per question in order. Graded on the server; says which were right. 5 tries an hour per concept.',
+        inputSchema: {
+            type: 'object',
+            properties: { concept: CONCEPT, answers: { type: 'array', items: { type: 'integer', minimum: 0 }, minItems: 1, maxItems: 10, description: 'The chosen choice index for each question.' } },
+            required: ['concept', 'answers'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { concept, answers } = args;
+            return apiPost(`/v1/vault-markets/learn/${encodeURIComponent(concept)}/quiz`, { answers });
+        },
+    },
+    {
+        name: 'get_vault_report',
+        description: 'The quarterly Crossly Vault Report: index levels, top movers, most-lent markets and grade premiums, from the order book only (A/B quality marks).',
+        inputSchema: { type: 'object', properties: { quarter: { type: 'string', description: 'Like "2026-q3". Default: the latest quarter.' } }, additionalProperties: false },
+        handler: (args) => {
+            const { quarter } = args;
+            return apiGet('/v1/vault-markets/report', { quarter });
+        },
+    },
+    {
+        name: 'get_vault_press_kit',
+        description: 'The press kit: each built-in index with its level, quality, n, CSV download and a "cite as" line, plus methodology links and the embed snippets.',
+        inputSchema: NONE,
+        handler: () => apiGet('/v1/vault-markets/press'),
+    },
+    {
+        name: 'get_vault_index_levels',
+        description: 'An index\'s daily closes (up to 5 years), oldest first.',
+        inputSchema: { type: 'object', properties: { slug: SLUG }, required: ['slug'], additionalProperties: false },
+        handler: (args) => {
+            const { slug } = args;
+            return apiGet(`/v1/vault-markets/indexes/${encodeURIComponent(slug)}/levels`);
+        },
+    },
+    {
+        name: 'get_vault_index_widget',
+        description: 'What the <crossly-index> widget shows for an index: level, closes, quality, n, as-of, or insufficient=true when too few reliable marks.',
+        inputSchema: { type: 'object', properties: { slug: SLUG, range: RANGE }, required: ['slug'], additionalProperties: false },
+        handler: (args) => {
+            const { slug, range } = args;
+            return apiGet(`/v1/vault-markets/widgets/index/${encodeURIComponent(slug)}`, { range });
+        },
+    },
+    {
+        name: 'get_vault_mark_widget',
+        description: 'What the <crossly-mark> widget shows for a market: mark, quality, trades over 30 days, as-of and a sparkline, or insufficient=true when there is no market yet.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: { type: 'string', description: 'The market: variantId:condition:gradeKey, with grade "-" when ungraded.' },
+                range: RANGE,
+            },
+            required: ['bookKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { bookKey, range } = args;
+            return apiGet('/v1/vault-markets/widgets/mark', { bookKey, range });
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-social.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,83 @@
+import { apiGet } from '../api.js';
+/**
+ * Vault Markets per-item analytics (api routes/v1/write/vault-markets-stats.ts):
+ * the Crossly Estimate, the liquidity score, risk statistics, the sector
+ * correlation matrix and the Crossly gem rate. Everything is DERIVED from
+ * Crossly trades and the firm book — labelled, with a band and an n, never a
+ * price, and never used for margin, loans or settlement. Under a data
+ * threshold the answer says "Not enough Crossly trades" and has no number;
+ * report that as is, never fill in a figure. Money is cents of US dollars;
+ * volatility, drawdown and spreads 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 KEY_ONLY = { type: 'object', properties: { bookKey: BOOK_KEY }, required: ['bookKey'], additionalProperties: false };
+const key = (args) => encodeURIComponent(args.bookKey);
+export const vaultMarketsStatsTools = [
+    {
+        name: 'get_vault_markets_key_stats',
+        description: 'Everything derived about one book key in one call: the Crossly Estimate, the liquidity score, risk statistics and the gem rate. A part that could not be read comes back as { error }.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet(`/v1/vault-markets/key-stats/${key(args)}`),
+    },
+    {
+        name: 'get_vault_markets_estimate',
+        description: 'The Crossly Estimate for a book key — a model, not a price. Returns the method used (own_trades, index_adjusted, grade_ratio), cents with 68% and 95% bands, High/Medium/Low confidence from the walk-forward backtest (FSD) and n. available=false means no number: say "Not enough Crossly trades" and give `why`.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet(`/v1/vault-markets/estimates/${key(args)}`),
+    },
+    {
+        name: 'get_vault_markets_estimate_accuracy',
+        description: "The Crossly Estimate's track record: backtested trades (n), FSD and bias per method, category and liquidity bucket, and whether estimates in each cell are shown (n >= 50 and FSD <= 0.30).",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/estimates-accuracy'),
+    },
+    {
+        name: 'get_vault_markets_liquidity',
+        description: 'The liquidity score (0-100) of a book key with every component: trades in 30/90 days, distinct counterparties, median days between trades, time-weighted quoted spread, two-sided share and depth within 5% from hourly book snapshots, Amihud and Roll, each as a percentile within the category. insufficient=true means no score.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet(`/v1/vault-markets/liquidity/${key(args)}`),
+    },
+    {
+        name: 'get_vault_markets_risk_stats',
+        description: 'Risk statistics from weekly returns: annualised volatility raw and Geltner-desmoothed (say which), max drawdown and beta to the Composite, with n. For a book key the returns come from trade-anchored (A-quality) marks only; an index slug uses its closes. Needs 26 weekly returns, else insufficient=true and no numbers.',
+        inputSchema: {
+            type: 'object',
+            properties: { bookKey: { type: 'string', description: 'A book key (variantId:condition:gradeKey) or an index slug from list_vault_markets_indexes.' } },
+            required: ['bookKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/vault-markets/risk-stats/${key(args)}`),
+    },
+    {
+        name: 'get_vault_markets_correlations',
+        description: "The correlation matrix of the sector indexes' weekly returns, pairwise-complete, with n per pair. rho[i][j] is null when the pair shares fewer than 26 weeks.",
+        inputSchema: {
+            type: 'object',
+            properties: { weeks: { type: 'integer', minimum: 26, maximum: 156, default: 52, description: 'Weeks back (26-156). Default 52.' } },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/vault-markets/correlations', { weeks: args.weeks }),
+    },
+    {
+        name: 'get_vault_markets_gem_rate',
+        description: "The Crossly gem rate for a book key's item and its category: of cards graded through Crossly, the share that came back at each grader's gem grade (e.g. PSA 10, BGS 9.5+), with a Wilson 95% band and n. Needs 10 returns per grader. Crossly's own returns only — not a grader population report, and not a prediction of a grade.",
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet(`/v1/vault-markets/gem-rate/${key(args)}`),
+    },
+    {
+        name: 'get_vault_markets_market_model',
+        description: 'How a book key trades: its liquidity tier (A continuous; B a call auction every 15 minutes; C one daily call; D listings only), the call collecting now with its indicative price (cents) and volume and nominal close, the next call, the LULD price band and any limit state, pause or halt. On B/C keys orders wait for the call: use a day or good-til-cancelled limit, never IOC/FOK.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet(`/v1/vault-markets/market-model/${key(args)}`),
+    },
+    {
+        name: 'list_vault_markets_calls',
+        description: 'Recent call-auction uncrosses on a book key: kind (open, reopen, periodic, daily, buy_in, sell_off), clearing price in cents of US dollars, and units.',
+        inputSchema: KEY_ONLY,
+        handler: (args) => apiGet(`/v1/vault-markets/calls/${key(args)}`),
+    },
+];
+//# sourceMappingURL=vault-markets-stats.js.map

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

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

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

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

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

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