@crossly/mcp 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,172 @@
+import { apiDelete, apiGet, apiPost } from '../api.js';
+/**
+ * Vault Markets bullion keys and spot-pegged maker quotes (api
+ * routes/v1/write/vault-markets-bullion.ts). A key family is metal + form +
+ * size + mint (or any mint) and groups the bullion catalogue so there is one
+ * market for "an ounce of gold"; trading stays per book key. Spot is a
+ * REFERENCE only, labelled "Spot (reference, not a Crossly price)": never
+ * present it as a Crossly price. A pegged quote is "spot plus or minus N
+ * cents or basis points"; it rests as a pro limit order re-priced every spot
+ * tick and is pulled while spot is stale. Money is integer cents of US
+ * dollars; spot is cents of US dollars per troy ounce of pure metal.
+ */
+const BOOK_KEY = {
+    type: 'string',
+    description: 'The market: variantId:condition:gradeKey, with grade "-" when ungraded. Take it from the books of get_vault_markets_bullion_key.',
+};
+const KIND = {
+    type: 'string',
+    enum: ['spot_plus_cents', 'spot_plus_bps'],
+    description: 'How the quote follows spot: "spot_plus_cents" (melt plus premiumCents per unit) or "spot_plus_bps" (melt plus premiumBps basis points).',
+};
+const PREMIUM_CENTS = { type: 'integer', minimum: -500000, maximum: 500000, description: 'For spot_plus_cents: the premium per unit over melt, in cents of US dollars; negative = under spot (e.g. -2000 = spot minus $20.00).' };
+const PREMIUM_BPS = { type: 'integer', minimum: -5000, maximum: 5000, description: 'For spot_plus_bps: the premium over melt in basis points (100 = 1%); negative = under spot.' };
+const FLOOR = { type: 'integer', minimum: 100, description: 'Optional lowest price per unit a seller accepts, in cents of US dollars.' };
+const CAP = { type: 'integer', minimum: 100, description: 'Optional highest price per unit a buyer pays, in cents of US dollars.' };
+export const vaultMarketsBullionTools = [
+    {
+        name: 'list_vault_markets_bullion_keys',
+        description: 'Bullion key families (metal, form, size, mint or any mint) with vault units, best resting bid and ask across their books in cents of US dollars, and spot as a labelled reference (never a Crossly price) with one unit of metal valued at it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                metal: { type: 'string', enum: ['gold', 'silver', 'platinum', 'palladium'], description: 'Only this metal: "gold", "silver", "platinum" or "palladium".' },
+                form: { type: 'string', enum: ['bullion_coin', 'bar', 'round'], description: 'Only this form: "bullion_coin", "bar" or "round".' },
+                size: { type: 'string', description: 'Only this nominal size slug, e.g. "1oz", "1-10oz", "10oz", "1kg", "100g".' },
+                anyMint: { type: 'boolean', description: 'true = only the any-mint families.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { metal, form, size, anyMint } = args;
+            return apiGet('/v1/vault-markets/bullion/keys', { metal, form, size, anyMint: anyMint === undefined ? undefined : String(anyMint) });
+        },
+    },
+    {
+        name: 'get_vault_markets_bullion_key',
+        description: 'One bullion key family: its catalogue products, every live book key with best bid, best ask, vault units and its mark (built from the book only; spot never sets it), live pegged quote counts, and spot as a labelled reference.',
+        inputSchema: {
+            type: 'object',
+            properties: { slug: { type: 'string', description: 'The family slug from list_vault_markets_bullion_keys, e.g. "gold-bullion_coin-1oz-any".' } },
+            required: ['slug'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { slug } = args;
+            const s = encodeURIComponent(slug);
+            return apiGet(`/v1/vault-markets/bullion/keys/${s}`);
+        },
+    },
+    {
+        name: 'get_vault_markets_bullion_families_for',
+        description: 'Which bullion key families a book key belongs to, with spot for its metal as a labelled reference and the melt value of one unit at that spot in cents of US dollars. Empty families when the item is not keyed bullion.',
+        inputSchema: { type: 'object', properties: { bookKey: BOOK_KEY }, required: ['bookKey'], additionalProperties: false },
+        handler: (args) => apiGet('/v1/vault-markets/bullion/for', args),
+    },
+    {
+        name: 'preview_vault_markets_bullion_peg',
+        description: 'The price a spot-pegged quote would rest at right now, in cents of US dollars, from fresh spot only. priceCents is null while spot is stale or missing: such a quote waits off the book.',
+        inputSchema: {
+            type: 'object',
+            properties: { bookKey: BOOK_KEY, kind: KIND, premiumCents: PREMIUM_CENTS, premiumBps: PREMIUM_BPS, floorCents: FLOOR, capCents: CAP },
+            required: ['bookKey', 'kind'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/vault-markets/bullion/pegs/preview', args),
+    },
+    {
+        name: 'list_vault_markets_bullion_pegs',
+        description: 'Your spot-pegged quotes: side, units, filled, the peg in words, the order it rests as, the last price and spot it was priced from (cents of US dollars), and why it is pulled (spot_stale, or the reason the book refused it).',
+        inputSchema: {
+            type: 'object',
+            properties: { status: { type: 'string', enum: ['live', 'all'], description: '"live" (active or pulled, the default) or "all" (also filled and stopped).' } },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/vault-markets/bullion/pegs', args),
+    },
+    {
+        name: 'set_vault_markets_bullion_peg',
+        description: 'Set a spot-pegged maker quote on a bullion book key: it rests as a pro limit order at melt plus the premium, clamped to floor and cap, re-priced every spot tick and pulled off the book while spot is stale. Replaces your live quote on the same key and side. It is your own money and risk. Needs a verified ID; only set it when the user asked for it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookKey: BOOK_KEY,
+                side: { type: 'string', enum: ['buy', 'sell'], description: '"buy" (a bid) or "sell" (an ask on units you hold in the vault).' },
+                quantity: { type: 'integer', minimum: 1, maximum: 50, description: 'Units (1-50).' },
+                kind: KIND,
+                premiumCents: PREMIUM_CENTS,
+                premiumBps: PREMIUM_BPS,
+                floorCents: FLOOR,
+                capCents: CAP,
+                funding: { type: 'string', enum: ['card', 'custodian'], description: 'How a buy is paid: "card" (give stripePaymentMethodId) or "custodian" (your Vault Markets custodian account). Ignored for a sell.' },
+                stripePaymentMethodId: { type: 'string', description: 'Stripe payment method id (pm_...) of one of your saved cards, for funding "card".' },
+            },
+            required: ['bookKey', 'side', 'quantity', 'kind'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/bullion/pegs', args),
+    },
+    {
+        name: 'stop_vault_markets_bullion_peg',
+        description: 'Stop a spot-pegged quote: its resting order comes off the book; units already filled stay filled.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Pegged quote id (uuid) from list_vault_markets_bullion_pegs.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id } = args;
+            const pid = encodeURIComponent(id);
+            return apiDelete(`/v1/vault-markets/bullion/pegs/${pid}`);
+        },
+    },
+    {
+        name: 'list_vault_markets_bullion_family_pegs',
+        description: 'Your family-wide spot-pegged quotes: one quote resting across a bullion family books at one condition, with units left, the peg in words, status ("active", "filled" or "stopped") and every leg (the pegged quote on each book, with the order it rests as).',
+        inputSchema: {
+            type: 'object',
+            properties: { status: { type: 'string', enum: ['live', 'all'], description: '"live" (active, the default) or "all" (also filled and stopped).' } },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/vault-markets/bullion/family-pegs', args),
+    },
+    {
+        name: 'set_vault_markets_bullion_family_peg',
+        description: 'Set a family-wide spot-pegged quote: one quote such as "buy any 1 oz gold coin at spot plus $40" resting on each product book of a bullion family at one condition. When any leg fills it comes off the others and goes back on only for what is left; two fills at once are settled one at a time against what is left. A bid pays from the custodian account; a sell uses units you hold in the vault. It is your own money and risk. Needs a verified ID; only set it when the user asked for it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: { type: 'string', description: 'The family slug, from list_vault_markets_bullion_keys (for example gold-bullion_coin-1oz-any).' },
+                condition: { type: 'string', enum: ['DS', 'VNDS', 'Used'], description: 'The condition every leg rests in: "DS" (brilliant uncirculated or sealed), "VNDS" (handled) or "Used" (circulated).' },
+                side: { type: 'string', enum: ['buy', 'sell'], description: '"buy" (bid) or "sell" (ask on units you hold in the vault).' },
+                quantity: { type: 'integer', minimum: 1, maximum: 50, description: 'Units across the whole family (1-50).' },
+                kind: KIND,
+                premiumCents: PREMIUM_CENTS,
+                premiumBps: PREMIUM_BPS,
+                floorCents: FLOOR,
+                capCents: CAP,
+                funding: { type: 'string', enum: ['custodian'], description: 'How a bid is paid: "custodian" (your Vault Markets custodian account; a card is not allowed for a family bid). Ignored for a sell.' },
+            },
+            required: ['slug', 'condition', 'side', 'quantity', 'kind'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/vault-markets/bullion/family-pegs', args),
+    },
+    {
+        name: 'stop_vault_markets_bullion_family_peg',
+        description: 'Stop a family-wide quote: every leg order comes off the book; units already filled stay filled.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Family quote id (uuid) from list_vault_markets_bullion_family_pegs.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id } = args;
+            const fid = encodeURIComponent(id);
+            return apiDelete(`/v1/vault-markets/bullion/family-pegs/${fid}`);
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-bullion.js.map

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

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

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

@@ -0,0 +1,10 @@
+import { ToolDef } from './types.js';
+/**
+ * Vault Markets channels (api routes/v1/write/vault-markets-growth-channels.ts):
+ * the Telegram and nudge-cap switches, the weekly vault digest, a catalogue
+ * item's vault value, a collection valued at the order book's display marks,
+ * and ship-in deposits. Prices are display marks with a quality (A / B / C /
+ * none); `cents: null` means no market yet.
+ */
+export declare const vaultMarketsChannelsTools: ToolDef[];
+//# sourceMappingURL=vault-markets-channels.d.ts.map

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

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

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

@@ -0,0 +1,93 @@
+import { apiGet, apiPost, apiPut } from '../api.js';
+/**
+ * Vault Markets channels (api routes/v1/write/vault-markets-growth-channels.ts):
+ * the Telegram and nudge-cap switches, the weekly vault digest, a catalogue
+ * item's vault value, a collection valued at the order book's display marks,
+ * and ship-in deposits. Prices are display marks with a quality (A / B / C /
+ * none); `cents: null` means no market yet.
+ */
+export const vaultMarketsChannelsTools = [
+    {
+        name: 'get_vault_markets_channels',
+        description: 'Your Vault Markets channel switches: Telegram alerts and digest, the daily cap on vault nudges by push (default 5; margin calls and recalls are never capped), whether a Telegram chat is linked, and nudges sent today.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/channels', {}),
+    },
+    {
+        name: 'update_vault_markets_channels',
+        description: 'Change the Vault Markets channel switches. Returns the new view.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                telegramAlerts: { type: 'boolean', description: 'Copy vault alerts and account notices to the linked Telegram chat.' },
+                telegramDigest: { type: 'boolean', description: 'Send the weekly vault digest to the linked Telegram chat.' },
+                pushCapPerDay: { type: 'integer', minimum: 0, maximum: 20, description: 'Most vault nudges (price alerts, offers, first marks, the digest) by push per day.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { telegramAlerts, telegramDigest, pushCapPerDay } = args;
+            return apiPut('/v1/vault-markets/channels', { telegramAlerts, telegramDigest, pushCapPerDay });
+        },
+    },
+    {
+        name: 'preview_vault_markets_digest',
+        description: "This week's vault digest as it would go out: units at the display marks (unmarked units counted, not valued), the like-for-like change from a week ago, offers on your units, watched items that got a first mark, and one Learn card. Returns { week, value, offers, firstMarks, learn, lines }.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/digest/preview', {}),
+    },
+    {
+        name: 'list_vault_markets_digests',
+        description: 'Your past weekly vault digests: week, status (sent / skipped / failed), the channels used and a summary.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/digest/history', {}),
+    },
+    {
+        name: 'get_vault_value_for_item',
+        description: "What a catalogue item is worth in the vault: each vault book key's display mark with quality and n, units in the vault, the Instant Exit price a holder gets now, and whether it can be shipped in. Answer 'what is my item worth in the vault'.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skuId: { type: 'string', description: 'Catalogue item id (uuid).' },
+                variantId: { type: 'string', description: 'Optional: one variant (size, printing) of the item (uuid).' },
+            },
+            required: ['skuId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { skuId, variantId } = args;
+            return apiGet('/v1/vault-markets/value', variantId ? { skuId, variantId } : { skuId });
+        },
+    },
+    {
+        name: 'get_vault_collection_worth',
+        description: "What your collection is worth at the vault book's display marks. Items with no mark or no catalogue match are counted, never valued. Returns { data, meta: { totals } }.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/vault-markets/collection-worth', {}),
+    },
+    {
+        name: 'watch_vault_collection',
+        description: 'Add every collection item that sits on a vault book key to your Vault Markets watchlist. Returns { watched, skipped }.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiPost('/v1/vault-markets/collection-worth/watch', {}),
+    },
+    {
+        name: 'open_vault_deposit',
+        description: 'Open a ship-in deposit for an ungraded catalogue item. It is inbound until the vault receives and checks it, then stored in your name. Nothing is listed or sold. Returns { vaultItem: { id, status } }.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                skuId: { type: 'string', description: 'Catalogue item id (uuid).' },
+                variantId: { type: 'string', description: 'The variant (size, printing) id (uuid).' },
+                condition: { type: 'string', enum: ['DS', 'VNDS', 'Used'], description: 'DS = deadstock (default), VNDS = very near deadstock, Used.' },
+            },
+            required: ['skuId', 'variantId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { skuId, variantId, condition } = args;
+            return apiPost('/v1/vault-markets/deposits', { skuId, variantId, condition });
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-channels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-channels.js","sourceRoot":"","sources":["../../src/tools/vault-markets-channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAc;IAClD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,0NAA0N;QACvO,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,EAAE,EAAE,CAAC;KACxD;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,kEAAkE;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oEAAoE,EAAE;gBACtH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBAC7G,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,oFAAoF,EAAE;aAC/J;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,IAAsF,CAAC;YACjJ,OAAO,MAAM,CAAC,4BAA4B,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;QACjG,CAAC;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,mSAAmS;QAChT,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kCAAkC,EAAE,EAAE,CAAC;KAC9D;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,0GAA0G;QACvH,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kCAAkC,EAAE,EAAE,CAAC;KAC9D;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,kPAAkP;QAC/P,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBACnE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;aACzG;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAA6C,CAAC;YAC3E,OAAO,MAAM,CAAC,yBAAyB,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACzF,CAAC;KACF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,0KAA0K;QACvL,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oCAAoC,EAAE,EAAE,CAAC;KAChE;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,wHAAwH;QACrI,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,0CAA0C,EAAE,EAAE,CAAC;KACvE;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,0MAA0M;QACvN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBACnE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACrF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE;aACxI;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;YAChC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAgE,CAAC;YACzG,OAAO,OAAO,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAChF,CAAC;KACF;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,164 @@
+import { apiGet, apiPost } from '../api.js';
+/**
+ * Vault credit (api routes/v1/write/vault-markets-credit.ts): cash-out loans
+ * against stored vault units and advances against units listed for sale, lent
+ * by the market pool into your custodian account. Pledged units cannot be
+ * listed, lent or withdrawn until repaid. Opening a loan or advance needs a
+ * verified ID (start_vault_markets_identity_check). Reads need
+ * vault-markets:read, anything that moves money vault-markets:trade.
+ */
+const ID = (what) => ({ type: 'string', description: `${what} id (uuid).` });
+const UNIT_IDS = (what) => ({ type: 'array', items: { type: 'string' }, minItems: 1, maxItems: 50, description: `${what}: 1-50 vault unit ids (uuids) from get_vault_markets_portfolio.` });
+const AMOUNT = (what) => ({ type: 'integer', minimum: 1, maximum: 100_000_000, description: `${what}, in cents of US dollars (the currency), a whole number.` });
+const ID_ONLY = (what) => ({ type: 'object', properties: { id: ID(what) }, required: ['id'], additionalProperties: false });
+export const vaultMarketsCreditTools = [
+    {
+        name: 'list_vault_markets_credit',
+        description: 'Your vault loans and advances: what is owed, interest accrued (in cents), loan-to-value, the liquidation line and the collateral value it is called at.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: { type: 'string', enum: ['live', 'closed', 'all'], default: 'live', description: '"live" = still owed (the default); "closed" = repaid or liquidated; "all" = both.' },
+                kind: { type: 'string', enum: ['loan', 'advance'], description: 'Optional filter: "loan" = borrowed against stored units; "advance" = against a unit listed for sale.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { status, kind } = args;
+            return apiGet('/v1/vault-markets/credit', { status, kind });
+        },
+    },
+    {
+        name: 'get_vault_markets_credit',
+        description: 'One loan or advance with its pledged units and its money log (draws, interest, repayments, sale proceeds).',
+        inputSchema: ID_ONLY('Loan or advance'),
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/vault-markets/credit/${encodeURIComponent(id)}`, {});
+        },
+    },
+    {
+        name: 'repay_vault_markets_credit',
+        description: 'Repay a loan or advance from your custodian account, interest first. Leave amountCents out to repay everything. Repaid in full, the items are free.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: ID('Loan or advance'),
+                amountCents: AMOUNT('How much to repay (leave out to repay everything owed)'),
+                requestId: { type: 'string', description: 'Optional id of your own for this repayment (letters, digits, _ . : -; up to 80): a retry with the same id never pays twice.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, amountCents, requestId } = args;
+            return apiPost(`/v1/vault-markets/credit/${encodeURIComponent(id)}/repay`, { amountCents, requestId });
+        },
+    },
+    {
+        name: 'quote_vault_markets_loan',
+        description: "How much you can borrow against vault units: each unit's tier, mark (in cents) and limit, the pool's rate and yours.",
+        inputSchema: { type: 'object', properties: { vaultItemIds: { ...UNIT_IDS('Units to quote'), description: 'Optional: up to 50 vault unit ids (uuids) to quote. Leave out to quote every stored unit you hold.' } }, additionalProperties: false },
+        handler: (args) => {
+            const { vaultItemIds } = args;
+            return apiGet('/v1/vault-markets/loans/quote', { vaultItemIds: vaultItemIds?.length ? vaultItemIds.join(',') : undefined });
+        },
+    },
+    {
+        name: 'open_vault_markets_loan',
+        description: 'Borrow against stored vault units: they are pledged (no listing, lending or withdrawal) and the market pool lends amountCents into your custodian account. Needs a verified ID.',
+        inputSchema: {
+            type: 'object',
+            properties: { vaultItemIds: UNIT_IDS('Units to pledge'), amountCents: AMOUNT('How much to borrow') },
+            required: ['vaultItemIds', 'amountCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { vaultItemIds, amountCents } = args;
+            return apiPost('/v1/vault-markets/loans', { vaultItemIds, amountCents });
+        },
+    },
+    {
+        name: 'pledge_vault_markets_loan_units',
+        description: 'Pledge more stored units to a loan (answers a loan call, or makes room to borrow more).',
+        inputSchema: { type: 'object', properties: { id: ID('Loan'), vaultItemIds: UNIT_IDS('Units to add') }, required: ['id', 'vaultItemIds'], additionalProperties: false },
+        handler: (args) => {
+            const { id, vaultItemIds } = args;
+            return apiPost(`/v1/vault-markets/loans/${encodeURIComponent(id)}/units`, { vaultItemIds });
+        },
+    },
+    {
+        name: 'release_vault_markets_loan_unit',
+        description: "Free one pledged unit from a loan, if what is owed still fits inside the other units' limit.",
+        inputSchema: { type: 'object', properties: { id: ID('Loan'), vaultItemId: ID('Pledged vault unit') }, required: ['id', 'vaultItemId'], additionalProperties: false },
+        handler: (args) => {
+            const { id, vaultItemId } = args;
+            return apiPost(`/v1/vault-markets/loans/${encodeURIComponent(id)}/units/${encodeURIComponent(vaultItemId)}/release`, {});
+        },
+    },
+    {
+        name: 'get_vault_markets_loan_unit_sale_floor',
+        description: "The lowest price a pledged unit can be sold at to repay its loan: after the sale (less the vault fee and storage) what is still owed must fit inside the other units' limit. Returns { floorCents, owedCents, otherUnitsCarryCents }, in cents.",
+        inputSchema: { type: 'object', properties: { id: ID('Loan'), vaultItemId: ID('Pledged vault unit') }, required: ['id', 'vaultItemId'], additionalProperties: false },
+        handler: (args) => {
+            const { id, vaultItemId } = args;
+            return apiGet(`/v1/vault-markets/loans/${encodeURIComponent(id)}/units/${encodeURIComponent(vaultItemId)}/sale-floor`, {});
+        },
+    },
+    {
+        name: 'sell_vault_markets_loan_unit',
+        description: 'Sell a pledged unit to repay its loan: it is listed at priceCents (at least the sale floor) and stays pledged until it sells; the proceeds repay the loan first and the rest is yours. Calling it again re-prices it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: ID('Loan'),
+                vaultItemId: ID('Pledged vault unit'),
+                priceCents: { type: 'integer', minimum: 100, maximum: 100_000_000, description: 'The asking price, in cents of US dollars (the currency), a whole number; at least the sale floor from get_vault_markets_loan_unit_sale_floor.' },
+            },
+            required: ['id', 'vaultItemId', 'priceCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, vaultItemId, priceCents } = args;
+            return apiPost(`/v1/vault-markets/loans/${encodeURIComponent(id)}/units/${encodeURIComponent(vaultItemId)}/sell`, { priceCents });
+        },
+    },
+    {
+        name: 'quote_vault_markets_advance',
+        description: 'What an advance on a vault unit listed for sale could be: up to half of the lower of its mark and asking price (in cents), free for 60 days.',
+        inputSchema: { type: 'object', properties: { vaultItemId: ID('Listed vault unit') }, required: ['vaultItemId'], additionalProperties: false },
+        handler: (args) => {
+            const { vaultItemId } = args;
+            return apiGet('/v1/vault-markets/advances/quote', { vaultItemId });
+        },
+    },
+    {
+        name: 'open_vault_markets_advance',
+        description: 'Take an advance against a vault unit listed for sale: paid into your custodian account, netted from the sale. Free for 60 days, then the pool rate. Needs a verified ID.',
+        inputSchema: {
+            type: 'object',
+            properties: { vaultItemId: ID('Listed vault unit'), amountCents: AMOUNT('How much to advance') },
+            required: ['vaultItemId', 'amountCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { vaultItemId, amountCents } = args;
+            return apiPost('/v1/vault-markets/advances', { vaultItemId, amountCents });
+        },
+    },
+    {
+        name: 'relist_vault_markets_advance',
+        description: "Relist an advance's unit at a new price (never so low its sale could not repay the advance).",
+        inputSchema: {
+            type: 'object',
+            properties: { id: ID('Advance'), priceCents: { type: 'integer', minimum: 100, maximum: 100_000_000, description: 'The new asking price, in cents of US dollars (the currency), a whole number.' } },
+            required: ['id', 'priceCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, priceCents } = args;
+            return apiPost(`/v1/vault-markets/advances/${encodeURIComponent(id)}/relist`, { priceCents });
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-credit.js.map

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

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

package/dist/tools/vault-markets-curve-pools.d.ts

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

package/dist/tools/vault-markets-curve-pools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-markets-curve-pools.d.ts","sourceRoot":"","sources":["../../src/tools/vault-markets-curve-pools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA+BrC,eAAO,MAAM,2BAA2B,EAAE,OAAO,EAqFhD,CAAC"}

package/dist/tools/vault-markets-curve-pools.js

@@ -0,0 +1,116 @@
+import { apiGet, apiPatch, apiPost } from '../api.js';
+/**
+ * Vault Markets dealer curve pools, sudoswap-style (api
+ * routes/v1/write/vault-markets-curve-pools.ts). An approved dealer (ID
+ * checked) runs a bonding curve on one book key from their own vault units
+ * and their own custodian cash. Linear: each unit the pool sells moves spot up
+ * by delta cents and each unit it buys moves it down by delta. Exponential:
+ * delta is basis points and spot multiplies or divides by (1 + delta/10000).
+ * The pool asks up(spot) plus its fee and bids spot less its fee, one unit a
+ * level. Crossly is only the venue: every leg is an ordinary resting order
+ * paying the ordinary maker fee. Every money figure is integer cents of US
+ * dollars. 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 POOL_ID = { type: 'string', description: 'Curve pool id (uuid), from list_vault_markets_curve_pools.' };
+const KIND = { type: 'string', enum: ['linear', 'exponential'], description: '"linear" (delta is cents a step) or "exponential" (delta is basis points a step, 10 to 5000).' };
+const SPOT = { type: 'integer', minimum: 100, description: 'Spot price in cents of US dollars ($1 or more). The pool bids spot less the fee and asks one step up plus the fee.' };
+const DELTA = { type: 'integer', minimum: 1, description: 'The step: cents of US dollars for "linear" (smaller than spot), basis points for "exponential" (100 = 1%).' };
+const FEE = { type: 'integer', minimum: 0, maximum: 2000, description: 'Your own fee on each side in basis points (100 = 1%, at most 2000). Default 0.' };
+const DEPTH = { type: 'integer', minimum: 1, maximum: 5, description: 'Single-unit levels shown on each side (1 to 5). Default 1.' };
+const UNITS = { type: 'integer', minimum: 0, description: 'Units of the item the pool may sell. You must hold that many free (stored, not listed, lent or liened) in your vault.' };
+const CASH = { type: 'integer', minimum: 0, description: 'Buy budget in cents of US dollars, from your Vault Markets custodian account (must hold at least this). 0 = sell only.' };
+const FLOOR = { type: ['integer', 'null'], minimum: 1, description: 'Never bid below this, in cents of US dollars; null for no floor.' };
+const CEILING = { type: ['integer', 'null'], minimum: 1, description: 'Never ask above this, in cents of US dollars; null for no ceiling.' };
+const RECYCLE = { type: 'boolean', description: 'Proceeds recycling: true puts the proceeds of each sale back into the buy budget, but only after the custodian confirms the cash is in your account; false (default) pays sales out the ordinary way.' };
+const SETTINGS = { kind: KIND, spotCents: SPOT, delta: DELTA, feeBps: FEE, depth: DEPTH, units: UNITS, cashCents: CASH, minPriceCents: FLOOR, maxPriceCents: CEILING };
+export const vaultMarketsCurvePoolsTools = [
+    {
+        name: 'list_vault_markets_curve_pools',
+        description: 'Your dealer curve pools: curve, spot, units, buy budget, totals bought and sold, the ladder each shows, its live legs, and its state (quoting, one_sided, idle, paused, closed) with the reason. All money in cents of US dollars.',
+        inputSchema: {
+            type: 'object',
+            properties: { status: { type: 'string', enum: ['open', 'all'], description: '"open" (default: active and paused pools) or "all" (closed ones too).' } },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/vault-markets/dealer/pools', args),
+    },
+    {
+        name: 'preview_vault_markets_curve_pool',
+        description: 'The bids and asks a set of curve settings would show, with why each side stops (no_units, no_cash, floor, ceiling, curve_end). Places nothing; no account needed.',
+        inputSchema: { type: 'object', properties: SETTINGS, required: ['kind', 'spotCents', 'delta'], additionalProperties: false },
+        handler: (args) => apiPost('/v1/vault-markets/dealer/pools/preview', args),
+    },
+    {
+        name: 'create_vault_markets_curve_pool',
+        description: 'Open a curve pool on a key (approved dealers only, ID checked; one open pool per key). Its single-unit bids and asks go on the book at once and move along the curve as they fill. It is your money and your inventory risk; a buy budget needs your custodian account. Ask the user to confirm the settings first.',
+        inputSchema: { type: 'object', properties: { bookKey: BOOK_KEY, ...SETTINGS, recycleProceeds: RECYCLE }, required: ['bookKey', 'kind', 'spotCents', 'delta'], additionalProperties: false },
+        handler: (args) => apiPost('/v1/vault-markets/dealer/pools', args),
+    },
+    {
+        name: 'get_vault_markets_curve_pool',
+        description: 'One of your curve pools, with its ladder and live legs. Money in cents of US dollars.',
+        inputSchema: { type: 'object', properties: { id: POOL_ID }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            const pid = encodeURIComponent(id);
+            return apiGet(`/v1/vault-markets/dealer/pools/${pid}`);
+        },
+    },
+    {
+        name: 'update_vault_markets_curve_pool',
+        description: 'Change a curve pool: spot, step, fee, levels, units, buy budget, floor, ceiling, or pause / resume it. The ladder is re-quoted at once. Ask the user to confirm first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: POOL_ID,
+                spotCents: SPOT,
+                delta: DELTA,
+                feeBps: FEE,
+                depth: DEPTH,
+                units: UNITS,
+                cashCents: CASH,
+                minPriceCents: FLOOR,
+                maxPriceCents: CEILING,
+                status: { type: 'string', enum: ['active', 'paused'], description: '"paused" takes every leg off the book; "active" puts the ladder back (refused while Crossly operations hold it paused).' },
+                recycleProceeds: RECYCLE,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, ...body } = args;
+            const pid = encodeURIComponent(id);
+            return apiPatch(`/v1/vault-markets/dealer/pools/${pid}`, body);
+        },
+    },
+    {
+        name: 'close_vault_markets_curve_pool',
+        description: 'Close a curve pool: its legs come off the book; what filled stays filled. Ask the user to confirm first.',
+        inputSchema: { type: 'object', properties: { id: POOL_ID }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            const pid = encodeURIComponent(id);
+            return apiPost(`/v1/vault-markets/dealer/pools/${pid}/close`, {});
+        },
+    },
+    {
+        name: 'list_vault_markets_curve_pool_fills',
+        description: 'A curve pool fills, newest first: side ("bid" = the pool bought, "ask" = it sold), price in cents of US dollars, and spot after.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: POOL_ID, limit: { type: 'integer', minimum: 1, maximum: 500, description: 'How many fills (default 100).' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, limit } = args;
+            const pid = encodeURIComponent(id);
+            return apiGet(`/v1/vault-markets/dealer/pools/${pid}/fills`, limit ? { limit } : undefined);
+        },
+    },
+];
+//# sourceMappingURL=vault-markets-curve-pools.js.map