@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/catalog-matches.js

@@ -0,0 +1,91 @@
+import { apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * Catalog matching: linking the seller's inventory items to Crossly catalog
+ * products so sold comps and market pricing apply. A suggestion binds NOTHING
+ * — only confirm_catalog_match does. Never confirm on the seller's behalf
+ * without asking them: a wrong link prices their item against a different
+ * product's sales.
+ */
+export const catalogMatchesTools = [
+    {
+        name: 'list_catalog_matches',
+        description: "List pending catalog-match suggestions across the seller's inventory: items that look like a Crossly " +
+            'catalog product (by photo, title and brand, or by an identifier that matched several products). Each has ' +
+            'the item, the catalog product (name, photo), a score and the reasons. Show these to the seller and let ' +
+            'THEM decide; confirm_catalog_match links one, dismiss_catalog_match rejects it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Max suggestions to return (1-100). Default 25.' },
+                before: {
+                    type: 'string',
+                    description: 'Keyset cursor: the createdAt (ISO 8601) of the last suggestion already seen, to page older ones.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/catalog-matches', {
+            ...(args.limit ? { limit: args.limit } : {}),
+            ...(args.before ? { before: args.before } : {}),
+        }),
+    },
+    {
+        name: 'get_item_catalog_matches',
+        description: "One inventory item's catalog link: the confirmed catalog product (if linked) and any pending suggestions.",
+        inputSchema: {
+            type: 'object',
+            properties: { inventoryItemId: { type: 'string', description: 'Inventory item UUID.' } },
+            required: ['inventoryItemId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/inventory/${encodeURIComponent(args.inventoryItemId)}/catalog-matches`),
+    },
+    {
+        name: 'refresh_item_catalog_matches',
+        description: 'Run catalog matching for one inventory item now. A UPC / style code / catalogue number that resolves to ' +
+            'exactly one product links the item automatically; otherwise likely products come back as suggestions for ' +
+            'the seller to confirm. Returns the item\'s link and suggestions afterwards.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inventoryItemId: { type: 'string', description: 'Inventory item UUID.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['inventoryItemId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/inventory/${encodeURIComponent(args.inventoryItemId)}/catalog-matches/refresh`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'confirm_catalog_match',
+        description: 'Confirm a catalog-match suggestion the SELLER has agreed is the same product. Links the item to the ' +
+            'catalog product (sets its market_sku_id), after which sold comps and market pricing use that product. ' +
+            'Only call this after the seller says yes — do not confirm on your own judgement.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Suggestion UUID (from list_catalog_matches or get_item_catalog_matches).' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/catalog-matches/${encodeURIComponent(args.id)}/confirm`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'dismiss_catalog_match',
+        description: 'Dismiss a catalog-match suggestion (not the same product). That product is never suggested for the item again.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Suggestion UUID (from list_catalog_matches or get_item_catalog_matches).' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/catalog-matches/${encodeURIComponent(args.id)}/dismiss`, {}, args.idempotencyKey),
+    },
+];
+//# sourceMappingURL=catalog-matches.js.map

package/dist/tools/catalog-matches.js.map

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

package/dist/tools/cbx-ops.d.ts

@@ -0,0 +1,11 @@
+import { ToolDef } from './types.js';
+/**
+ * The CBX ad-credit ledger.
+ *
+ * This file started with six tools for routes that had an SDK method and no
+ * MCP tool. Five of them — the disbursement rules and the earn/stake tier
+ * creators — landed independently in cbx-rewards.ts, so only this one is
+ * left rather than shipping two tools per route.
+ */
+export declare const cbxOpsTools: ToolDef[];
+//# sourceMappingURL=cbx-ops.d.ts.map

package/dist/tools/cbx-ops.d.ts.map

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

package/dist/tools/cbx-ops.js

@@ -0,0 +1,35 @@
+import { apiGet, apiPost } from '../api.js';
+/**
+ * The CBX ad-credit ledger.
+ *
+ * This file started with six tools for routes that had an SDK method and no
+ * MCP tool. Five of them — the disbursement rules and the earn/stake tier
+ * creators — landed independently in cbx-rewards.ts, so only this one is
+ * left rather than shipping two tools per route.
+ */
+export const cbxOpsTools = [
+    {
+        name: 'list_cbx_ad_credit_ledger',
+        description: 'Ad-credit movements for this merchant, newest first. Append-only and there is no refund '
+            + 'kind: a correction is another entry, so the history is never rewritten. Ad credit is '
+            + 'GRANTED balance — in-platform advertising spend only, never withdrawable.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/ad-credit/ledger'),
+    },
+    {
+        name: 'register_cbx_reserve',
+        description: 'Register the merchant reserve token account after granting the platform payout key an '
+            + 'SPL allowance on it. Only the address is sent; mint, delegate and allowance are read from '
+            + 'the chain and a mismatch is refused. Needs treasury scope.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                reserveTokenAccount: { type: 'string', description: 'The reserve SPL token account address.' },
+                approveTxSig: { type: 'string', description: 'Signature of the approve transaction, for the record.' },
+            },
+            required: ['reserveTokenAccount'],
+        },
+        handler: (args) => apiPost('/v1/cbx/reserve', args),
+    },
+];
+//# sourceMappingURL=cbx-ops.js.map

package/dist/tools/cbx-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbx-ops.js","sourceRoot":"","sources":["../../src/tools/cbx-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAc;IACpC;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,0FAA0F;cACxF,uFAAuF;cACvF,2EAA2E;QAC/E,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,sBAAsB;QAC5B,WAAW,EACT,wFAAwF;cACtF,4FAA4F;cAC5F,4DAA4D;QAChE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;gBAC9F,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;aACvG;YACD,QAAQ,EAAE,CAAC,qBAAqB,CAAC;SAClC;QACD,OAAO,EAAE,CAAC,IAA6B,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC;KAC7E;CACF,CAAC"}

package/dist/tools/cbx-rewards/ad-credit.d.ts

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

package/dist/tools/cbx-rewards/ad-credit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ad-credit.d.ts","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/ad-credit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAyEtC,CAAC"}

package/dist/tools/cbx-rewards/ad-credit.js

@@ -0,0 +1,72 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardAdCredit = [
+    {
+        name: 'get_cbx_ad_credit',
+        description: 'Unspent advertising budget, in cents. Advertising is payable in CBX and NOTHING ELSE — '
+            + 'there is no dollar path. The budget is denominated in dollars, priced when the payment '
+            + 'finalized, deliberately not held as a token quantity: a price move would otherwise '
+            + 'silently change the budget the advertiser prepaid. '
+            + 'Credit is spendable on advertising only and is NOT refundable to dollars or tokens. '
+            + 'Never tell an advertiser they can cash it out.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/ad-credit'),
+    },
+    {
+        name: 'quote_cbx_ad_credit',
+        description: 'How much advertising a given number of tokens buys. Credit is 1:1 with market value at '
+            + 'confirmation — with CBX the only way to pay, there is nothing to discount against.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                baseUnits: {
+                    type: 'string',
+                    description: 'Tokens to price, as a decimal STRING of base units.',
+                },
+            },
+            required: ['baseUnits'],
+        },
+        handler: (args) => apiPost('/v1/cbx/ad-credit/quote', args),
+    },
+    {
+        name: 'purchase_cbx_ad_credit',
+        description: 'Claim an advertising budget against a CBX transfer the advertiser already sent. '
+            + 'They transfer to the merchant\'s reserve themselves and present the signature; the '
+            + 'balance delta is read at FINALIZED commitment, because a merely confirmed transaction '
+            + 'can still be dropped by a fork and this grants real advertising. '
+            + 'ONE SIGNATURE CAN BE CLAIMED EXACTLY ONCE. '
+            + 'A 409 means it has not finalized yet — retry. A 400 means it will never be claimable '
+            + '(failed, wrong mint, wrong destination) and retrying will not help. '
+            + 'Priced at claim time, not send time.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                txSig: { type: 'string', description: 'Signature of the transfer the advertiser sent.' },
+            },
+            required: ['txSig'],
+        },
+        handler: (args) => apiPost('/v1/cbx/ad-credit/purchase', args),
+    },
+    {
+        name: 'spend_cbx_ad_credit',
+        description: 'Consume advertising budget for a billing period. Spends what the balance covers and '
+            + 'reports the rest as shortfallCents — the campaign should stop there rather than '
+            + 'running on credit that does not exist. '
+            + '20% of what is spent moves to the community events pool and 80% is operator revenue; '
+            + 'the split happens on SPEND rather than at purchase, because the pool\'s share is '
+            + 'earned when the advertising is actually delivered. Idempotent on externalId.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cents: {
+                    type: 'integer',
+                    description: 'Advertising to bill, in CENTS. Spends what the budget covers.',
+                },
+                externalId: { type: 'string', description: 'Billing period or campaign id. Idempotency key.' },
+                memo: { type: 'string', description: 'Free-text note stored on the ledger row.' },
+            },
+            required: ['cents', 'externalId'],
+        },
+        handler: (args) => apiPost('/v1/cbx/ad-credit/spend', args),
+    },
+];
+//# sourceMappingURL=ad-credit.js.map

package/dist/tools/cbx-rewards/ad-credit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ad-credit.js","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/ad-credit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,yFAAyF;cACvF,yFAAyF;cACzF,qFAAqF;cACrF,qDAAqD;cACrD,sFAAsF;cACtF,gDAAgD;QACpD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,yFAAyF;cACvF,oFAAoF;QACxF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC;KAC5D;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,kFAAkF;cAChF,qFAAqF;cACrF,wFAAwF;cACxF,mEAAmE;cACnE,6CAA6C;cAC7C,uFAAuF;cACvF,sEAAsE;cACtE,sCAAsC;QAC1C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;aACzF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,4BAA4B,EAAE,IAAI,CAAC;KAC/D;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,sFAAsF;cACpF,kFAAkF;cAClF,yCAAyC;cACzC,uFAAuF;cACvF,mFAAmF;cACnF,8EAA8E;QAClF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,+DAA+D;iBAC7E;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;gBAC9F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;aAClF;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC;SAClC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC;KAC5D;CACF,CAAC"}

package/dist/tools/cbx-rewards/balances.d.ts

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

package/dist/tools/cbx-rewards/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/balances.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAqHtC,CAAC"}

package/dist/tools/cbx-rewards/balances.js

@@ -0,0 +1,114 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardBalances = [
+    {
+        name: 'get_cbx_balances',
+        description: 'All three balances a subject holds — earned, granted, and connected. '
+            + 'EARNED is cashback, withdrawable once matured. GRANTED is ad credit, wholesale draws '
+            + 'and promos: spendable in the marketplace only and NEVER withdrawable. CONNECTED is the '
+            + 'user\'s own self-custodied CBX reachable through a bounded delegation. '
+            + '`connectedAvailableBaseUnits` is delegation HEADROOM, not a wallet balance — the user '
+            + 'may hold less than they approved or have revoked on chain, so it is a ceiling. '
+            + 'When reporting a total, say which parts can leave the platform and which cannot.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id.' },
+            },
+            required: ['subjectId'],
+        },
+        handler: (args) => {
+            const { subjectId } = args;
+            return apiGet(`/v1/cbx/subjects/${encodeURIComponent(subjectId)}/balances`);
+        },
+    },
+    {
+        name: 'plan_cbx_spend',
+        description: 'Which balances would pay for a spend, and in what order. The order is '
+            + 'granted -> earned -> connected and it is not configurable — granted first is a '
+            + 'security property, because spending earned first would let a user convert a '
+            + 'non-withdrawable grant into a withdrawable balance one purchase at a time. '
+            + 'Returns shortfallBaseUnits rather than failing, so a checkout can charge the '
+            + 'remainder to a card. Plans nothing and moves nothing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id.' },
+                baseUnits: {
+                    type: 'string',
+                    description: 'Amount to plan for, as a decimal STRING of base units.',
+                },
+                excludeConnected: {
+                    type: 'boolean',
+                    description: 'Set on a flow that cannot wait for an on-chain transfer.',
+                },
+            },
+            required: ['subjectId', 'baseUnits'],
+        },
+        handler: (args) => {
+            const { subjectId, ...body } = args;
+            return apiPost(`/v1/cbx/subjects/${encodeURIComponent(subjectId)}/spend-plan`, body);
+        },
+    },
+    {
+        name: 'list_cbx_grants',
+        description: 'A subject\'s live grants, soonest-expiring first. That ordering is the allocation order: '
+            + 'a spend consumes the grant closest to lapsing, so value about to expire is used before '
+            + 'value that will not. Mention upcoming expiry dates when a user asks about their '
+            + 'balance — unused grant credit lapsing is the main surprise this generates.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id.' },
+            },
+            required: ['subjectId'],
+        },
+        handler: (args) => {
+            const { subjectId } = args;
+            return apiGet(`/v1/cbx/subjects/${encodeURIComponent(subjectId)}/grants`);
+        },
+    },
+    {
+        name: 'grant_cbx',
+        description: 'Issue grant credit — in-platform, non-withdrawable. SPENDS REAL VALUE out of the '
+            + 'reserve. '
+            + 'Requires a funding batchId for every kind except grant_makegood, because grant credit '
+            + 'is spendable at merchants who receive real value and the tokens have to exist. '
+            + 'There is no path that converts a grant to withdrawable balance or pays it to an '
+            + 'address, and the database enforces that. Do not promise a recipient otherwise.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id receiving the grant.' },
+                baseUnits: {
+                    type: 'string',
+                    description: 'Tokens to grant, as a decimal STRING of base units.',
+                },
+                kind: {
+                    type: 'string',
+                    enum: ['grant_ad_credit', 'grant_wholesale_credit', 'grant_promo', 'grant_makegood'],
+                    description: 'Why the grant is being made. grant_ad_credit funds advertising; '
+                        + 'grant_wholesale_credit is a credit draw; grant_promo is a promotional gift; '
+                        + 'grant_makegood compensates for a platform failure and is the ONLY kind that '
+                        + 'does not require a funding batchId.',
+                },
+                expiresAt: { type: 'string', description: 'ISO 8601. Omit for no expiry.' },
+                batchId: { type: 'string', description: 'Required unless kind is grant_makegood.' },
+                externalId: {
+                    type: 'string',
+                    description: "The granting program's own id. Makes the grant idempotent, so a retried "
+                        + 'grant run does not issue twice.',
+                },
+                memo: {
+                    type: 'string',
+                    description: 'Free-text note stored on the ledger row, for explaining the grant later.',
+                },
+            },
+            required: ['subjectId', 'baseUnits', 'kind'],
+        },
+        handler: (args) => {
+            const { subjectId, ...body } = args;
+            return apiPost(`/v1/cbx/subjects/${encodeURIComponent(subjectId)}/grants`, body);
+        },
+    },
+];
+//# sourceMappingURL=balances.js.map

package/dist/tools/cbx-rewards/balances.js.map

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

package/dist/tools/cbx-rewards/credit.d.ts

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

package/dist/tools/cbx-rewards/credit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit.d.ts","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/credit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,eAAO,MAAM,eAAe,EAAE,OAAO,EAuIpC,CAAC"}

package/dist/tools/cbx-rewards/credit.js

@@ -0,0 +1,131 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardCredit = [
+    {
+        name: 'get_cbx_credit_line',
+        description: 'A seller\'s wholesale credit line. This is TRADE CREDIT, not token-collateralized '
+            + 'lending: it is secured by receivables the platform already holds (the payout stream, '
+            + 'under a hold with an exposure ceiling) and secondarily by goods bought from the '
+            + 'platform\'s own wholesale channel. '
+            + 'CBX is the alignment mechanism, not the collateral — a stake raises the limit and '
+            + 'lowers the rate, bounded to a share of the earned limit. '
+            + 'The limit may FALL, but a drawn balance is NEVER accelerated or margin-called. There '
+            + 'is no liquidation engine. If a seller asks whether a price drop can call their loan, '
+            + 'the answer is no.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sellerUserId: {
+                    type: 'string',
+                    description: "The Crossly seller's user id. Their payout history is the underwriting input.",
+                },
+            },
+            required: ['sellerUserId'],
+        },
+        handler: (args) => {
+            const { sellerUserId } = args;
+            return apiGet(`/v1/cbx/credit?sellerUserId=${encodeURIComponent(sellerUserId)}`);
+        },
+    },
+    {
+        name: 'refresh_cbx_credit_line',
+        description: 'Recompute a seller\'s limit from trading history and stake. The earned limit is a share '
+            + 'of trailing SETTLED payout volume — money that actually reached them, not listed '
+            + 'inventory or projected sales. The stake bonus is capped at a share of that, so a '
+            + 'seller with no history gets nothing however much they stake. '
+            + 'A frozen line stays frozen: freezing is a credit decision somebody made.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sellerUserId: { type: 'string', description: "The Crossly seller's user id." },
+            },
+            required: ['sellerUserId'],
+        },
+        handler: (args) => apiPost('/v1/cbx/credit/refresh', args),
+    },
+    {
+        name: 'draw_cbx_credit',
+        description: 'Draw against a credit line. ADVANCES REAL VALUE the seller will owe. '
+            + 'The advance lands as GRANT balance: in-platform only, so it cannot be withdrawn or '
+            + 'turned into cash. Restricted to wholesale channels, because the limit was sized on '
+            + 'the theory that the advance buys goods that get sold and generate the payout stream '
+            + 'repaying it. '
+            + 'Refuses if the reserve has no unallocated tokens. Idempotent on externalId. '
+            + 'Tell the seller the dueAt date.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sellerUserId: { type: 'string', description: "The Crossly seller's user id." },
+                cents: {
+                    type: 'integer',
+                    description: 'Amount to advance, in CENTS. The seller will owe this in dollars.',
+                },
+                channel: {
+                    type: 'string',
+                    enum: ['wholesale_lot', 'supplier_order', 'bulk_purchase'],
+                    description: 'Which wholesale channel the advance buys from. Restricted to these because '
+                        + 'the limit was sized on the theory that the advance buys goods that get sold '
+                        + 'and generate the payout stream repaying it.',
+                },
+                externalId: {
+                    type: 'string',
+                    description: 'Draw request or wholesale order id. Idempotency key.',
+                },
+            },
+            required: ['sellerUserId', 'cents', 'channel', 'externalId'],
+        },
+        handler: (args) => apiPost('/v1/cbx/credit/draw', args),
+    },
+    {
+        name: 'repay_cbx_credit',
+        description: 'Apply a repayment to a credit line. REDUCES A RECORDED DEBT — getting this wrong writes '
+            + 'off real money owed to the platform, which is why it needs the treasury scope while a '
+            + 'draw needs only spend. '
+            + 'Clamped to what is outstanding: a payout larger than the debt would otherwise push the '
+            + 'balance negative and read as credit nobody underwrote. Idempotent on externalId.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sellerUserId: { type: 'string', description: "The Crossly seller's user id." },
+                cents: {
+                    type: 'integer',
+                    description: 'Amount repaid, in CENTS. Clamped to what is outstanding.',
+                },
+                kind: {
+                    type: 'string',
+                    enum: ['repay_payout', 'repay_invoice'],
+                    description: 'repay_payout when a released seller payout was applied to the balance — the '
+                        + 'normal path. repay_invoice when the seller paid directly.',
+                },
+                externalId: {
+                    type: 'string',
+                    description: 'The payout or payment id. Idempotency key.',
+                },
+                purchaseId: {
+                    type: 'string',
+                    description: 'The purchase whose payout funded this, on a repay_payout.',
+                },
+            },
+            required: ['sellerUserId', 'cents', 'kind', 'externalId'],
+        },
+        handler: (args) => apiPost('/v1/cbx/credit/repay', args),
+    },
+    {
+        name: 'freeze_cbx_credit_line',
+        description: 'Stop new draws on a line. Leaves the drawn balance on its ORIGINAL terms — there is no '
+            + 'mechanism to call or accelerate what has already been advanced, and this is the only '
+            + 'lever over a line. A seller who took inventory on Tuesday keeps Tuesday\'s terms.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sellerUserId: { type: 'string', description: "The Crossly seller's user id." },
+                reason: {
+                    type: 'string',
+                    description: 'Why the line is being frozen. Stored and shown to the seller.',
+                },
+            },
+            required: ['sellerUserId', 'reason'],
+        },
+        handler: (args) => apiPost('/v1/cbx/credit/freeze', args),
+    },
+];
+//# sourceMappingURL=credit.js.map

package/dist/tools/cbx-rewards/credit.js.map

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

package/dist/tools/cbx-rewards/disbursements.d.ts

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

package/dist/tools/cbx-rewards/disbursements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disbursements.d.ts","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/disbursements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,eAAO,MAAM,sBAAsB,EAAE,OAAO,EA2J3C,CAAC"}