@crossly/mcp 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,146 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardDisbursements = [
+    {
+        name: 'get_cbx_disbursement_progress',
+        description: 'How close each disbursement rule is to firing — safe to show users. A climbing counter '
+            + 'toward a known number is why this uses cadence-plus-threshold rather than a pure '
+            + 'threshold: people can see the pool rising and know roughly when the next community '
+            + 'event is possible. `nextEligibleAt` is the earliest a rule can fire again.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/disbursement-progress'),
+    },
+    {
+        name: 'check_cbx_disbursement_rule',
+        description: 'Evaluate a disbursement rule now, firing it if every gate passes. Gates in order: '
+            + 'cadence, threshold, coverage — `outcome` names the one that stopped it. '
+            + 'A missing or stale treasury snapshot declines on `coverage`, because unknown coverage '
+            + 'is not healthy coverage. '
+            + 'Firing opens a campaign in PREVIEWED state; it still needs approval and execution, so '
+            + 'this does not pay anybody. Send dryRun to evaluate without writing anything.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ruleId: {
+                    type: 'string',
+                    description: 'The disbursement rule to evaluate.',
+                },
+                dryRun: {
+                    type: 'boolean',
+                    description: 'Evaluate the gates and report the outcome without opening a campaign or '
+                        + 'writing anything.',
+                },
+            },
+            required: ['ruleId'],
+        },
+        handler: (args) => {
+            const { ruleId, ...body } = args;
+            return apiPost(`/v1/cbx/disbursement-rules/${encodeURIComponent(ruleId)}/check`, body);
+        },
+    },
+    {
+        name: 'get_cbx_ad_credit_ledger',
+        description: 'Movements on a merchant\'s CBX ad credit — purchases, spends and grants. '
+            + 'This is GRANTED balance: in-platform spend ONLY and NEVER withdrawable, unlike '
+            + 'the earned cashback balance. If somebody asks to cash out ad credit, the answer '
+            + 'is that it is not that kind of balance, and that is deliberate rather than a '
+            + 'missing feature. '
+            + 'Spend is recorded AT COST for offsite media — media and management fee are '
+            + 'separate lines, so `mediaCostCents` against `managementFeeCents` answers "how '
+            + 'much of my budget actually reached the auction". '
+            + 'Amounts are STRINGS of base units; never use float arithmetic.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/cbx/ad-credit/ledger'),
+    },
+    {
+        name: 'list_cbx_disbursement_rules',
+        description: 'Threshold rules that fire community distributions from the EVENTS POOL. '
+            + 'Read this before `check_cbx_disbursement_rule`, which needs a ruleId. '
+            + 'Each rule decides WHEN only — firing opens a campaign that still needs preview, '
+            + 'approval and execution, so a rule being over its threshold does not mean money '
+            + 'has moved. '
+            + 'Never describe these as paying holders or stakers: a distribution decided by its '
+            + 'own recipients is a dividend, and the beneficiary set is closed against exactly '
+            + 'that. Use `get_cbx_disbursement_progress` for how close each is to firing.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/cbx/disbursement-rules'),
+    },
+    {
+        name: 'create_cbx_disbursement_rule',
+        description: 'Create a threshold rule that fires a community distribution. '
+            + 'APPLIES TO THE EVENTS POOL ONLY, never free reserve surplus — reserve surplus '
+            + 'funds the next accrual without touching the market, so distributing it would '
+            + 'force buying the same tokens back at spread plus MEV. '
+            + '`checkCadenceHours` bounds how often it can fire even when the pool is over the '
+            + 'line. That matters: a pure threshold fires at an unpredictable moment, and the '
+            + 'pool jumps most right after a lapse sweep — precisely when engagement was worst. '
+            + 'The rule decides WHEN only. It cannot move value on its own.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Human-readable rule name.' },
+                thresholdBaseUnits: {
+                    type: 'string',
+                    description: 'Events-pool size at which the rule may fire, as a STRING of base units '
+                        + '(never a float).',
+                },
+                distributeBps: {
+                    type: 'integer',
+                    description: 'Share of the pool to distribute when it fires, in basis points. Omit for '
+                        + 'the default.',
+                },
+                checkCadenceHours: {
+                    type: 'integer',
+                    description: 'Minimum hours between firings, even while over threshold. Omit for the '
+                        + 'default.',
+                },
+                requireCoverageBps: {
+                    type: 'integer',
+                    description: 'Minimum reserve coverage, in basis points, before firing is allowed. A '
+                        + 'missing or stale treasury snapshot declines — unknown coverage is not '
+                        + 'healthy coverage.',
+                },
+                metric: {
+                    type: 'string',
+                    description: 'Which activity metric ranks recipients. Read the rules list for the values '
+                        + 'in use rather than guessing one.',
+                },
+                lookbackDays: {
+                    type: 'integer',
+                    description: 'Window the metric is measured over.',
+                },
+                maxRecipients: {
+                    type: 'integer',
+                    description: 'Cap on how many subjects a single firing pays.',
+                },
+            },
+            required: ['name', 'thresholdBaseUnits'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/cbx/disbursement-rules', args),
+    },
+    {
+        name: 'set_cbx_disbursement_rule_active',
+        description: 'Enable or disable a disbursement rule. Disabling stops it firing and changes '
+            + 'nothing already distributed — there is no unwind.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ruleId: {
+                    type: 'string',
+                    description: 'From list_cbx_disbursement_rules.',
+                },
+                isActive: {
+                    type: 'boolean',
+                    description: 'True to enable, false to disable.',
+                },
+            },
+            required: ['ruleId', 'isActive'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { ruleId, ...body } = args;
+            return apiPost(`/v1/cbx/disbursement-rules/${encodeURIComponent(ruleId)}/active`, body);
+        },
+    },
+];
+//# sourceMappingURL=disbursements.js.map

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

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

package/dist/tools/cbx-rewards/earn-boosts.d.ts

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

package/dist/tools/cbx-rewards/earn-boosts.d.ts.map

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

package/dist/tools/cbx-rewards/earn-boosts.js

@@ -0,0 +1,152 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardEarn = [
+    {
+        name: 'list_cbx_earn_tiers',
+        description: 'The earn terms this merchant offers — a longer maturation window buys a higher rate. '
+            + 'This is a term structure on a REBATE, not a yield: the user chooses when to be paid '
+            + 'for a purchase they already made, and nothing accrues to a balance for being held. '
+            + 'Do not describe it as interest or staking rewards.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/earn-tiers'),
+    },
+    {
+        name: 'quote_cbx_rate',
+        description: 'What an order would earn and WHY, without accruing anything. `source` says whether the '
+            + 'rate came from the base rate, an earn tier, or a merchant-funded boost; '
+            + '`stakeBoostBps` is the part the user\'s own stake contributed. '
+            + 'Does NOT reserve boost budget, so a quote and the later accrual can differ if the '
+            + 'budget runs out in between — the accrual response repeats the rate actually granted, '
+            + 'and that is the authoritative one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: {
+                    type: 'string',
+                    description: 'The CBX subject id, from create_cbx_subject. Not the merchant\'s own user id.',
+                },
+                paidCents: { type: 'integer', description: 'What the buyer paid, in CENTS.' },
+                tierSlug: { type: 'string', description: 'Which earn term. Omit for the default.' },
+                target: {
+                    type: 'object',
+                    description: 'What was bought, for boost matching.',
+                    properties: {
+                        category: { type: 'string', description: "The item's category, as the merchant names it." },
+                        sku: { type: 'string', description: "The item's SKU." },
+                        collection: { type: 'string', description: 'The collection it belongs to.' },
+                    },
+                },
+            },
+            required: ['subjectId', 'paidCents'],
+        },
+        handler: (args) => apiPost('/v1/cbx/rates/quote', args),
+    },
+    {
+        name: 'accrue_cbx_for_purchase',
+        description: 'Accrue cashback for an order and let CBX do the rate maths — resolves the earn tier, '
+            + 'any matching boost and the user\'s stake boost, charges the merchant\'s boost budget '
+            + 'in the same transaction, and records the rate actually granted. '
+            + 'CREATES A LIABILITY. Prefer this over accrue_cbx unless the merchant computes its own '
+            + 'rates. If a matching boost cannot fund the order the accrual falls back to the '
+            + 'un-boosted rate and boostBudgetExhausted is true — that is expected behaviour, not an '
+            + 'error. Idempotent on externalId: a retried webhook neither accrues twice nor charges '
+            + 'the budget twice.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: {
+                    type: 'string',
+                    description: 'The CBX subject id, from create_cbx_subject.',
+                },
+                paidCents: {
+                    type: 'integer',
+                    description: 'What the buyer paid, in CENTS. The cashback is computed from this.',
+                },
+                externalId: { type: 'string', description: "The merchant's order id. Idempotency key." },
+                tierSlug: {
+                    type: 'string',
+                    description: 'Which earn term the user chose. Omit for the merchant default.',
+                },
+                target: {
+                    type: 'object',
+                    description: 'What was bought, so a boost can match it.',
+                    properties: {
+                        category: { type: 'string', description: "The item's category." },
+                        sku: { type: 'string', description: "The item's SKU." },
+                        collection: { type: 'string', description: 'The collection it belongs to.' },
+                    },
+                },
+            },
+            required: ['subjectId', 'paidCents', 'externalId'],
+        },
+        handler: (args) => apiPost('/v1/cbx/accruals/purchase', args),
+    },
+    {
+        name: 'list_cbx_boosts',
+        description: 'The merchant\'s funded cashback boosts, with live burn against budget. `budgetCents` is '
+            + 'a hard ceiling enforced inside the accrual transaction, so a boost cannot overspend — '
+            + 'when it runs out, matching orders quietly fall back to the base rate. '
+            + '`committedCents` in the meta is cashback promised across all live boosts but not yet '
+            + 'claimed by an order: a forward commitment worth mentioning when reporting coverage.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/boosts'),
+    },
+    {
+        name: 'create_cbx_boost',
+        description: 'Fund elevated cashback on matching items. COMMITS THE MERCHANT\'S MONEY — budgetCents '
+            + 'is a real spend. '
+            + 'A boost REPLACES the base or tier rate rather than adding to it: the merchant is '
+            + 'stating the total it will pay, priced against its margin. Most specific target wins '
+            + '(sku > collection > category > all). '
+            + 'Better than a discount for the merchant, because the spend lands as a durable balance '
+            + 'the buyer returns to use rather than a one-time price cut they pocket.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Label for the boost, shown to the merchant.' },
+                targetKind: {
+                    type: 'string',
+                    enum: ['all', 'category', 'sku', 'collection'],
+                    description: 'What the boost matches on. "all" applies to every order and takes no '
+                        + 'targetValue; the other three require one and are matched by exact equality. '
+                        + 'Most specific wins: sku beats collection beats category beats all.',
+                },
+                targetValue: {
+                    type: 'string',
+                    description: 'The category, SKU or collection to match, exactly. Required unless '
+                        + 'targetKind is "all".',
+                },
+                boostedRateBps: {
+                    type: 'integer',
+                    description: 'Cashback rate in basis points — 500 = 5%. Replaces the base rate.',
+                },
+                budgetCents: {
+                    type: 'integer',
+                    description: 'Hard ceiling on cashback this boost will fund, in CENTS. Enforced inside the '
+                        + 'accrual transaction, so it cannot be exceeded.',
+                },
+                startsAt: { type: 'string', description: 'ISO 8601.' },
+                endsAt: { type: 'string', description: 'ISO 8601.' },
+            },
+            required: ['name', 'boostedRateBps', 'budgetCents', 'startsAt', 'endsAt'],
+        },
+        handler: (args) => apiPost('/v1/cbx/boosts', args),
+    },
+    {
+        name: 'pause_cbx_boost',
+        description: 'Stop a boost matching further orders. Refunds NOTHING already accrued — cashback a buyer '
+            + 'was shown at checkout is a promise already made, and unwinding it would take it back '
+            + 'from them. The remaining budget simply stops being spendable.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                boostId: { type: 'string', description: 'The boost to pause, from list_cbx_boosts.' },
+            },
+            required: ['boostId'],
+        },
+        handler: (args) => {
+            const { boostId } = args;
+            return apiPost(`/v1/cbx/boosts/${encodeURIComponent(boostId)}/pause`, {});
+        },
+    },
+];
+//# sourceMappingURL=earn-boosts.js.map

package/dist/tools/cbx-rewards/earn-boosts.js.map

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

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

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

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

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

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

@@ -0,0 +1,61 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardRedemptions = [
+    {
+        name: 'list_cbx_redeemable_services',
+        description: 'Services payable in CBX, and the discount each carries. Paying in CBX costs less than '
+            + 'paying in dollars, which is what makes anybody choose it. These are real services '
+            + 'with real cost behind them — grading, authentication, evidence sealing, listing '
+            + 'promotion, subscriptions.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/redemptions/services'),
+    },
+    {
+        name: 'quote_cbx_redemption',
+        description: 'What a service costs in tokens right now. Fails with 409 when there is no fresh price: '
+            + 'a dollar-priced service has no honest token quantity without a spot, and guessing '
+            + 'would either overcharge the user or undercharge the operator. Retry later rather than '
+            + 'inventing a number.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                serviceKind: {
+                    type: 'string',
+                    description: 'Which service, from list_cbx_redeemable_services — e.g. subscription. '
+                        + 'grading and authentication are listed but refused (paid out in dollars).',
+                },
+                listPriceCents: {
+                    type: 'integer',
+                    description: 'The dollar list price in CENTS, before the pay-in-CBX discount.',
+                },
+            },
+            required: ['serviceKind', 'listPriceCents'],
+        },
+        handler: (args) => apiPost('/v1/cbx/redemptions/quote', args),
+    },
+    {
+        name: 'redeem_cbx_service',
+        description: 'Pay for a service in CBX. DEBITS THE USER\'S BALANCE. '
+            + 'Staked tokens cannot pay — the debit checks spendable balance, not total. '
+            + 'Idempotent on (serviceKind, externalId) rather than externalId alone, because a '
+            + 'grading submission and a listing boost can share an id when they refer to the same '
+            + 'item.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id being debited.' },
+                serviceKind: {
+                    type: 'string',
+                    description: 'Which service, from list_cbx_redeemable_services.',
+                },
+                listPriceCents: {
+                    type: 'integer',
+                    description: 'The dollar list price in CENTS, before the pay-in-CBX discount.',
+                },
+                externalId: { type: 'string', description: "The merchant's id for the thing paid for." },
+            },
+            required: ['subjectId', 'serviceKind', 'listPriceCents', 'externalId'],
+        },
+        handler: (args) => apiPost('/v1/cbx/redemptions', args),
+    },
+];
+//# sourceMappingURL=redemptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redemptions.js","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/redemptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,CAAC,MAAM,oBAAoB,GAAc;IAC7C;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EACT,wFAAwF;cACtF,oFAAoF;cACpF,kFAAkF;cAClF,2BAA2B;QAC/B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,8BAA8B,CAAC;KACtD;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,yFAAyF;cACvF,oFAAoF;cACpF,wFAAwF;cACxF,qBAAqB;QACzB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,wEAAwE;0BACtE,0EAA0E;iBAC/E;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,iEAAiE;iBAC/E;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC;SAC5C;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,2BAA2B,EAAE,IAAI,CAAC;KAC9D;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,wDAAwD;cACtD,4EAA4E;cAC5E,kFAAkF;cAClF,qFAAqF;cACrF,OAAO;QACX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAC/E,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,iEAAiE;iBAC/E;gBACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;aACzF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,CAAC;SACvE;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC;KACxD;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,74 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cbxRewardStaking = [
+    {
+        name: 'list_cbx_stake_tiers',
+        description: 'Staking tiers and what locking tokens buys. Staking pays NOTHING — it confers a lower '
+            + 'withdrawal fee and a higher earn rate on FUTURE purchases. That is a discount for '
+            + 'commitment, not a return on a holding, and the distinction matters: describing it as '
+            + 'yield, rewards or interest would be wrong and would misrepresent the product.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: () => apiGet('/v1/cbx/stake-tiers'),
+    },
+    {
+        name: 'get_cbx_stake',
+        description: 'A subject\'s staking state and SPENDABLE balance. Use `availableBaseUnits` for any '
+            + 'checkout — it is the balance minus anything locked. Reading the plain balance instead '
+            + 'would let a user try to spend staked tokens and be refused. '
+            + '`earnBoostBps` reads zero once an unstake is requested, because the boost ends with '
+            + 'the commitment; `feeDiscountBps` survives the cooldown, since withdrawing is exactly '
+            + 'what somebody in cooldown is trying to do.',
+        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)}/stake`);
+        },
+    },
+    {
+        name: 'stake_cbx',
+        description: 'Lock a subject\'s tokens for a tier. MAKES THEIR BALANCE UNSPENDABLE — it stays their '
+            + 'money and stays backed, but they cannot use it until they unstake and wait out the '
+            + 'cooldown. Confirm the user actually wants this before calling it. '
+            + 'Refuses an amount that clears no tier, because locking tokens for no benefit is never '
+            + 'what somebody meant to do. One stake per subject.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id.' },
+                baseUnits: {
+                    type: 'string',
+                    description: 'Tokens to lock, as a decimal STRING of base units. A string because a balance '
+                        + 'can exceed what a JSON number holds exactly.',
+                },
+            },
+            required: ['subjectId', 'baseUnits'],
+        },
+        handler: (args) => {
+            const { subjectId, ...body } = args;
+            return apiPost(`/v1/cbx/subjects/${encodeURIComponent(subjectId)}/stake`, body);
+        },
+    },
+    {
+        name: 'unstake_cbx',
+        description: 'Start the unstake cooldown. The earn boost stops immediately; the tokens stay locked '
+            + 'until `unlocksAt`. Tell the user the date — the cooldown is what makes the discount '
+            + 'real, and being surprised by it is the main complaint it generates.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id.' },
+            },
+            required: ['subjectId'],
+        },
+        handler: (args) => {
+            const { subjectId } = args;
+            return apiPost(`/v1/cbx/subjects/${encodeURIComponent(subjectId)}/stake/unstake`, {});
+        },
+    },
+];
+//# sourceMappingURL=staking.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staking.js","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/staking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,wFAAwF;cACtF,oFAAoF;cACpF,uFAAuF;cACvF,+EAA+E;QACnF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC;KAC7C;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,qFAAqF;cACnF,wFAAwF;cACxF,8DAA8D;cAC9D,sFAAsF;cACtF,uFAAuF;cACvF,4CAA4C;QAChD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAC;YACpD,OAAO,MAAM,CAAC,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3E,CAAC;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,wFAAwF;cACtF,qFAAqF;cACrF,oEAAoE;cACpE,wFAAwF;cACxF,mDAAmD;QACvD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBACjE,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gFAAgF;0BAC9E,8CAA8C;iBACnD;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;SACrC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAgD,CAAC;YAChF,OAAO,OAAO,CAAC,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClF,CAAC;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,uFAAuF;cACrF,sFAAsF;cACtF,qEAAqE;QACzE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;aAClE;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,SAAS,EAAE,GAAG,IAA6B,CAAC;YACpD,OAAO,OAAO,CAAC,oBAAoB,kBAAkB,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QACxF,CAAC;KACF;CACF,CAAC"}

package/dist/tools/cbx-rewards/tier-admin.d.ts

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

package/dist/tools/cbx-rewards/tier-admin.d.ts.map

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

package/dist/tools/cbx-rewards/tier-admin.js

@@ -0,0 +1,75 @@
+import { apiPost } from '../../api.js';
+export const cbxRewardTierAdmin = [
+    {
+        name: 'create_cbx_earn_tier',
+        description: 'Create a cashback earn tier — a maturation window and a rate. '
+            + 'MATURATION IS THE LOAD-BEARING FIELD. An accrual is CENTS until it matures and '
+            + 'becomes a token quantity only then, priced at that moment; the window is how '
+            + 'long a refund can still reverse it cleanly. A short window means less reversible '
+            + 'cashback, not a better deal. '
+            + '`isDefault` moves every new subject onto this tier. Existing accruals keep the '
+            + 'tier they were written under.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: { type: 'string', description: 'Stable machine identifier.' },
+                label: { type: 'string', description: 'Name shown to users.' },
+                maturationDays: {
+                    type: 'integer',
+                    description: 'Days before a pending accrual becomes tokens. Also the window in which a '
+                        + 'refund reverses it cleanly.',
+                },
+                earnRateBps: {
+                    type: 'integer',
+                    description: 'Cashback rate in basis points of order value (100 = 1%).',
+                },
+                isDefault: {
+                    type: 'boolean',
+                    description: 'Make this the tier new subjects start on.',
+                },
+            },
+            required: ['slug', 'label', 'maturationDays', 'earnRateBps'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/cbx/earn-tiers', args),
+    },
+    {
+        name: 'create_cbx_stake_tier',
+        description: 'Create a staking tier — a minimum stake and what it unlocks. '
+            + 'A tier grants a fee discount, an earn-rate boost and governance weight. IT PAYS '
+            + 'NO RETURN ON THE STAKE ITSELF, which is the property that keeps staking a '
+            + 'loyalty mechanism rather than a yield product. Never describe a tier as earning '
+            + 'anything passively. '
+            + '`cooldownDays` is the unstaking delay. Tokens in cooldown stop counting for '
+            + 'governance immediately — the commitment a vote is priced against is already '
+            + 'leaving.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: { type: 'string', description: 'Stable machine identifier.' },
+                label: { type: 'string', description: 'Name shown to users.' },
+                minBaseUnits: {
+                    type: 'string',
+                    description: 'Minimum stake to reach this tier, as a STRING of base units (never a float).',
+                },
+                feeDiscountBps: {
+                    type: 'integer',
+                    description: 'Marketplace fee discount in basis points — 100 = 1 percent OFF the fee '
+                        + 'rate, not a cash amount. 250 on a 5% fee leaves 4.75%.',
+                },
+                earnBoostBps: {
+                    type: 'integer',
+                    description: 'Multiplier on the earn RATE, in basis points. Not a yield.',
+                },
+                cooldownDays: {
+                    type: 'integer',
+                    description: 'Unstaking delay. Stake in cooldown stops counting for governance at once.',
+                },
+            },
+            required: ['slug', 'label', 'minBaseUnits'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/cbx/stake-tiers', args),
+    },
+];
+//# sourceMappingURL=tier-admin.js.map

package/dist/tools/cbx-rewards/tier-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-admin.js","sourceRoot":"","sources":["../../../src/tools/cbx-rewards/tier-admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gEAAgE;cAC9D,iFAAiF;cACjF,+EAA+E;cAC/E,mFAAmF;cACnF,+BAA+B;cAC/B,iFAAiF;cACjF,+BAA+B;QACnC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBAC9D,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,2EAA2E;0BACzE,6BAA6B;iBAClC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,0DAA0D;iBACxE;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2CAA2C;iBACzD;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,CAAC;YAC5D,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC;KACvD;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,+DAA+D;cAC7D,kFAAkF;cAClF,4EAA4E;cAC5E,kFAAkF;cAClF,sBAAsB;cACtB,8EAA8E;cAC9E,8EAA8E;cAC9E,UAAU;QACd,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACnE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBAC9D,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8EAA8E;iBACjF;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,yEAAyE;0BACvE,wDAAwD;iBAC7D;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,2EAA2E;iBAC9E;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC;YAC3C,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC;KACxD;CACF,CAAC"}

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

@@ -0,0 +1,40 @@
+import { ToolDef } from './types.js';
+/**
+ * CBX rewards, staking, advertising, balances, and wholesale credit.
+ *
+ * Split from `cbx.ts` to stay under the repo's file-size cap, and
+ * registered alongside it.
+ *
+ * ── WHAT AN AGENT MUST UNDERSTAND BEFORE USING THESE ──────────────────
+ * Several of these commit money forward or move it, and the descriptions
+ * say so rather than reading as neutral CRUD:
+ *
+ *   create_cbx_boost         commits a merchant's budget to cashback.
+ *   stake_cbx                makes a user's balance UNSPENDABLE. It is
+ *                            their money and this locks it.
+ *   redeem_cbx_service       debits a user for a service.
+ *   purchase_cbx_ad_credit   claims an advertising budget against a
+ *                            token transfer. One signature, one claim.
+ *   draw_cbx_credit          advances real value against a credit line.
+ *   grant_cbx                issues spendable value out of the reserve.
+ *
+ * ── THE THREE BALANCES ────────────────────────────────────────────────
+ * A subject can hold three, and they are not interchangeable:
+ *
+ *   EARNED     cashback. Withdrawable once matured.
+ *   GRANTED    ad credit, wholesale draws, promos. Spendable in the
+ *              marketplace ONLY — never withdrawable.
+ *   CONNECTED  the user's own self-custodied CBX, via a bounded
+ *              delegation. Never a platform liability.
+ *
+ * Spends always consume granted → earned → connected, and that order is
+ * not configurable. Never tell a user their granted balance can be
+ * withdrawn or cashed out; it cannot, by construction.
+ *
+ * ── AMOUNTS ───────────────────────────────────────────────────────────
+ * Cents are plain integers. TOKEN amounts are decimal STRINGS of base
+ * units, because a balance can exceed what a JSON number holds exactly.
+ * Never convert a token amount through a float before displaying it.
+ */
+export declare const cbxRewardTools: ToolDef[];
+//# sourceMappingURL=cbx-rewards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cbx-rewards.d.ts","sourceRoot":"","sources":["../../src/tools/cbx-rewards.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,EASnC,CAAC"}