@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/cosm/designer.js.map

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

package/dist/tools/cosm/fusion-handles.d.ts

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

package/dist/tools/cosm/fusion-handles.d.ts.map

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

package/dist/tools/cosm/fusion-handles.js

@@ -0,0 +1,82 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cosmFusionHandles = [
+    {
+        name: 'fuse_cosm_cosmetics',
+        description: 'Fuse two cosmetics plus COSM into a rarer one. THIS DESTROYS BOTH INPUT ITEMS AND '
+            + 'THE COSM — permanently and with no undo. Inputs must be owned, unbound and '
+            + 'flagged fusable; stake-exclusive items can never be consumed. '
+            + 'Always confirm explicitly with the user and name what will be destroyed before '
+            + 'calling this. An open listing on a consumed input is cancelled.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                recipeId: {
+                    type: 'string',
+                    description: 'The fusion recipe to run. It names which two cosmetics are consumed and how '
+                        + 'much COSM is burned — read it and state both to the user before calling.',
+                },
+                subjectId: {
+                    type: 'string',
+                    description: 'The CBX subject whose items and COSM are destroyed. Must be one you own.',
+                },
+            },
+            required: ['recipeId', 'subjectId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/cosm/fusion/${encodeURIComponent(String(args.recipeId))}`, {
+            subjectId: String(args.subjectId),
+        }),
+    },
+    {
+        name: 'check_cosm_handle',
+        description: 'Is a vanity handle available, and what does it cost in COSM? Reasons for '
+            + 'unavailability: invalid_shape, reserved, taken. Priced by length — short names '
+            + 'are scarcer. Uniqueness is platform-wide, since it is a URL namespace.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                handle: { type: 'string', description: 'With or without a leading @.' },
+            },
+            required: ['handle'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/cosm/handles/${encodeURIComponent(String(args.handle))}`),
+    },
+    {
+        name: 'claim_cosm_handle',
+        description: 'Claim a vanity storefront handle, burning COSM. ONE live handle per subject — '
+            + 'claiming a second is refused rather than replacing the first. '
+            + 'There is NO REFUND if it is released later: the COSM was burned. Check '
+            + 'availability and price first, and confirm the spend.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: {
+                    type: 'string',
+                    description: 'The CBX subject claiming it, and whose COSM is burned. Must be one you own.',
+                },
+                handle: {
+                    type: 'string',
+                    description: 'The handle to claim, with or without a leading @. Check availability and '
+                        + 'price first — the COSM is burned and there is no refund.',
+                },
+            },
+            required: ['subjectId', 'handle'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/cosm/handles', {
+            subjectId: String(args.subjectId),
+            handle: String(args.handle),
+        }),
+    },
+    {
+        name: 'list_cosm_burn_goals',
+        description: 'Community burn goal progress. Aggregate COSM burned crossing a threshold unlocks a '
+            + 'cosmetic for everyone who CONTRIBUTED — not for everybody. Only burns inside the '
+            + 'goal window count, and `progressBps` is capped at 10000 because the total is '
+            + 'snapshotted on completion.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/cosm/goals'),
+    },
+];
+//# sourceMappingURL=fusion-handles.js.map

package/dist/tools/cosm/fusion-handles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-handles.js","sourceRoot":"","sources":["../../../src/tools/cosm/fusion-handles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,oFAAoF;cAClF,6EAA6E;cAC7E,gEAAgE;cAChE,iFAAiF;cACjF,iEAAiE;QACrE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8EAA8E;0BAC5E,0EAA0E;iBAC/E;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,0EAA0E;iBAC7E;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;YACnC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,OAAO,CAAC,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE;YACtE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;SAClC,CAAC;KACL;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,2EAA2E;cACzE,iFAAiF;cACjF,wEAAwE;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;aACxE;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;KACzF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,gFAAgF;cAC9E,gEAAgE;cAChE,yEAAyE;cACzE,sDAAsD;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,6EAA6E;iBAChF;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,2EAA2E;0BACzE,0DAA0D;iBAC/D;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;YACjC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,OAAO,CAAC,kBAAkB,EAAE;YAC1B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YACjC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAC5B,CAAC;KACL;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,qFAAqF;cACnF,mFAAmF;cACnF,+EAA+E;cAC/E,4BAA4B;QAChC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC;KACxC;CACF,CAAC"}

package/dist/tools/cosm/pegs.d.ts

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

package/dist/tools/cosm/pegs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pegs.d.ts","sourceRoot":"","sources":["../../../src/tools/cosm/pegs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,eAAO,MAAM,QAAQ,EAAE,OAAO,EAsH7B,CAAC"}

package/dist/tools/cosm/pegs.js

@@ -0,0 +1,112 @@
+import { apiDelete, apiGet, apiPut } from '../../api.js';
+export const cosmPegs = [
+    {
+        name: 'list_cbx_listing_pegs',
+        description: "A seller's CBX-pegged listings and why each price last moved. "
+            + '`lastReason` is the useful field: repriced, no_rate, below_threshold, '
+            + 'clamped_floor, clamped_ceiling or clamped_change. A seller asking why their '
+            + 'price has not moved deserves that answer rather than "it should have" — read it '
+            + 'before speculating. '
+            + 'The repricer uses a 24h MINIMUM rate, never spot. Tracking spot would let '
+            + 'somebody pump CBX, watch every pegged ask drop, and buy with cheaply acquired '
+            + 'tokens.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sellerUserId: {
+                    type: 'string',
+                    description: 'The seller whose pegs to list.',
+                },
+            },
+            required: ['sellerUserId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/cosm/pegs', { sellerUserId: String(args.sellerUserId) }),
+    },
+    {
+        name: 'set_cbx_listing_peg',
+        description: 'Hold a listing\'s CBX ask at a dollar target, repriced hourly against a 24h '
+            + 'MINIMUM rate. '
+            + 'THREE BOUNDS, EACH FOR A DIFFERENT FAILURE, and they are not interchangeable: '
+            + '`maxChangeBps` stops one bad reading posting an absurd ask (it converges over '
+            + 'cycles instead); `floorBaseUnits` and `ceilingBaseUnits` are the SELLER\'s own '
+            + 'limits, so a sustained real move never posts a price they did not consider; '
+            + '`minChangeBps` stops the ask being rewritten for a fraction of a percent. '
+            + 'Suggest setting a floor and ceiling — without them a genuine sustained move '
+            + 'reprices without any seller-defined stop. '
+            + 'BE CLEAR ABOUT WHAT A PEG DOES NOT DO. Accepting CBX means holding CBX. The peg '
+            + 'protects the dollar value of the ASK; it cannot protect the value of the tokens '
+            + 'once the seller has them.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platformListingId: {
+                    type: 'string',
+                    description: 'The platform listing to peg.',
+                },
+                sellerUserId: {
+                    type: 'string',
+                    description: 'The seller who owns the listing.',
+                },
+                enabled: {
+                    type: 'boolean',
+                    description: 'False keeps the peg configured but stops repricing.',
+                },
+                targetCents: {
+                    type: 'integer',
+                    description: 'The dollar target to hold, in CENTS. The ask in CBX is derived from this '
+                        + 'each cycle.',
+                },
+                floorBaseUnits: {
+                    type: 'string',
+                    description: 'Lowest CBX ask to post, as a STRING of base units. The seller\'s own stop.',
+                },
+                ceilingBaseUnits: {
+                    type: 'string',
+                    description: 'Highest CBX ask to post, as a STRING of base units. The seller\'s own stop.',
+                },
+                maxChangeBps: {
+                    type: 'integer',
+                    description: 'Largest single-cycle move, in basis points. Bounds the damage of one bad '
+                        + 'reading; the peg converges over several cycles instead.',
+                },
+                minChangeBps: {
+                    type: 'integer',
+                    description: 'Smallest move worth rewriting the ask for, in basis points. Stops churn.',
+                },
+            },
+            required: ['platformListingId', 'sellerUserId', 'enabled', 'targetCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPut('/v1/cosm/pegs', args),
+    },
+    {
+        name: 'remove_cbx_listing_peg',
+        description: 'Stop repricing a listing. The ask STAYS AT ITS CURRENT VALUE — removing a peg '
+            + 'does not restore an earlier price, so tell the seller what the ask is now '
+            + 'rather than implying a revert.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingId: {
+                    type: 'string',
+                    description: 'The platform listing to unpeg.',
+                },
+                sellerUserId: {
+                    type: 'string',
+                    description: 'The seller who owns the listing.',
+                },
+            },
+            required: ['listingId', 'sellerUserId'],
+            additionalProperties: false,
+        },
+        handler: (args) => 
+        // apiDelete is (path, idempotencyKey?, query?) — there is no body
+        // parameter. The extra `undefined` pushed the query into a fourth slot
+        // that does not exist, so `sellerUserId` was never going to be sent.
+        apiDelete(`/v1/cosm/pegs/${encodeURIComponent(String(args.listingId))}`, undefined, {
+            sellerUserId: String(args.sellerUserId),
+        }),
+    },
+];
+//# sourceMappingURL=pegs.js.map

package/dist/tools/cosm/pegs.js.map

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

package/dist/tools/cosm/storefront.d.ts

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

package/dist/tools/cosm/storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront.d.ts","sourceRoot":"","sources":["../../../src/tools/cosm/storefront.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,eAAO,MAAM,cAAc,EAAE,OAAO,EAiJnC,CAAC"}

package/dist/tools/cosm/storefront.js

@@ -0,0 +1,138 @@
+import { apiDelete, apiGet, apiPost, apiPut } from '../../api.js';
+// ── Storefront: dollar-priced cosmetics paid in CBX, and what money cannot buy ────────────────────
+export const cosmStorefront = [
+    {
+        name: 'buy_cosmetic_with_cbx',
+        description: 'Buy a dollar-priced cosmetic, paying in CBX. Digital cosmetics are PRICED in dollars '
+            + 'and never sold for cash: the SKU' + "'" + 's priceCents is paid from the subject' + "'" + 's EARNED CBX '
+            + 'at spot. SPENDS MONEY: confirm the price with the user first. requestKey (8-64 '
+            + 'chars, a fresh one per purchase) makes a retry the same purchase; if the grant '
+            + 'fails after payment (sold out, already held) the spend is reversed. Refuses an '
+            + 'earned (COSM) or stake-exclusive SKU.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: { type: 'string', description: 'The dollar-priced SKU to buy.' },
+                subjectId: { type: 'string', description: 'The buyer, as a CBX subject.' },
+                requestKey: { type: 'string', description: 'A fresh 8-64 char key for this purchase.' },
+            },
+            required: ['cosmeticId', 'subjectId', 'requestKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { cosmeticId, subjectId, requestKey } = args;
+            return apiPost(`/v1/cosm/cosmetics/${encodeURIComponent(cosmeticId)}/buy-cbx`, { subjectId, requestKey });
+        },
+    },
+    {
+        name: 'claim_stake_exclusive_cosmetic',
+        description: 'Claim a stake-exclusive cosmetic once tenure qualifies. These are BOUND forever '
+            + 'and purchasable by nobody at any price in any currency — if a user asks to buy '
+            + 'one, the answer is that it cannot be bought, which is the point. '
+            + 'A short tenure returns granted:false with tenureDays and requiredDays: that is '
+            + 'the NORMAL answer, not an error, so report progress rather than failure. '
+            + 'Idempotent while the copy is held.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: { type: 'string', description: 'The stake-exclusive SKU.' },
+                subjectId: { type: 'string', description: 'The claimant, as a CBX subject.' },
+            },
+            required: ['cosmeticId', 'subjectId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/cosm/cosmetics/${encodeURIComponent(String(args.cosmeticId))}/claim`, {
+            subjectId: args.subjectId,
+        }),
+    },
+    {
+        name: 'get_cosm_stake_tenure',
+        description: 'How long a subject has held a stake CONTINUOUSLY, in days — the figure every '
+            + 'stake-exclusive claim is decided on. Not "time since they first staked": a gap '
+            + 'resets it and a cooling stake does not count, so do not describe it that way. '
+            + 'Use it to show progress toward a claim before attempting one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The subject to measure.' },
+            },
+            required: ['subjectId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/cosm/stake-tenure', { subjectId: String(args.subjectId) }),
+    },
+    {
+        name: 'set_cosmetic_unlock',
+        description: 'Set or clear what a cosmetic unlocks spatially. BOTH fields or neither: a key with '
+            + 'no value would claim every value of that key and silently gate the whole '
+            + 'control, so a half-pair is collapsed to two nulls — read the response, which '
+            + 'echoes what was APPLIED rather than what was sent. Passing two nulls removes the '
+            + 'gate and makes the control free for EVERYONE, which is rarely what somebody '
+            + 'means by "update the unlock" — confirm before clearing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: { type: 'string', description: 'The SKU whose gate is being set.' },
+                unlocksKey: {
+                    type: ['string', 'null'],
+                    description: 'The scene key this cosmetic gates. Null clears the gate.',
+                },
+                unlocksValue: {
+                    type: ['string', 'null'],
+                    description: 'The value of that key. Null clears the gate.',
+                },
+            },
+            required: ['cosmeticId', 'unlocksKey', 'unlocksValue'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPut(`/v1/cosm/cosmetics/${encodeURIComponent(String(args.cosmeticId))}/unlock`, {
+            unlocksKey: args.unlocksKey ?? null,
+            unlocksValue: args.unlocksValue ?? null,
+        }),
+    },
+    {
+        name: 'release_cosm_handle',
+        description: 'Release a handle. NOTHING IS REFUNDED — the COSM paid for it was BURNED, so there '
+            + 'is nothing to give back, and refunding would mean minting. Tell the user that '
+            + 'before calling this; somebody expecting a refund will read silence as a bug. '
+            + 'The handle returns to the pool and ANYONE may claim it, including somebody else, '
+            + 'so this is not a way to park one. Returns released:false if they held none.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The holder, as a CBX subject.' },
+                reason: { type: 'string', description: 'Why, for the audit trail. 1-200 chars.' },
+            },
+            required: ['subjectId', 'reason'],
+            additionalProperties: false,
+        },
+        // `apiDelete(path, idempotencyKey, query, body)` — the route reads
+        // these from the BODY, so they go in the fourth slot. Passing them
+        // second would send the pair as an idempotency key.
+        handler: (args) => apiDelete('/v1/cosm/handles', undefined, undefined, {
+            subjectId: String(args.subjectId),
+            reason: String(args.reason),
+        }),
+    },
+    {
+        name: 'quote_employee_fee',
+        description: 'What one shop-employee conversation will cost, in COSM. Priced with the SAME '
+            + 'functions the charge uses, so the figure quoted is the figure taken. Half BURNS '
+            + 'and half moves to the market pool as a tax, and the two always sum to the total '
+            + 'exactly. Charges nothing and changes nothing — safe to call freely, including '
+            + 'before every message.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                totalCents: {
+                    type: 'integer',
+                    description: 'The conversation value in cents, which the fee is derived from.',
+                },
+            },
+            required: ['totalCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/cosm/employee/fee-quote', { totalCents: Number(args.totalCents) }),
+    },
+];
+//# sourceMappingURL=storefront.js.map

package/dist/tools/cosm/storefront.js.map

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

package/dist/tools/cosm/supply.d.ts

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

package/dist/tools/cosm/supply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supply.d.ts","sourceRoot":"","sources":["../../../src/tools/cosm/supply.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,eAAO,MAAM,UAAU,EAAE,OAAO,EAwE/B,CAAC"}

package/dist/tools/cosm/supply.js

@@ -0,0 +1,67 @@
+import { apiGet } from '../../api.js';
+export const cosmSupply = [
+    {
+        name: 'get_cosm_balance',
+        description: "A subject's COSM balance and the emission taper currently in force. "
+            + 'Amounts are STRINGS of base units with six decimals — divide by 1e6 to display, '
+            + 'and never use float arithmetic. '
+            + '`taper.rateMultiplierBps` is 10000 at the full rate and steps down as lifetime '
+            + 'supply grows; it depends on total supply rather than on this subject, so every '
+            + 'earner in the same week sees the same figure. '
+            + 'COSM is NOT withdrawable and is NOT a yield — it is earned by activity, and '
+            + 'staking only multiplies the rate.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: { type: 'string', description: 'The CBX subject id.' },
+            },
+            required: ['subjectId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/cosm/balance', { subjectId: String(args.subjectId) }),
+    },
+    {
+        name: 'get_cosm_supply',
+        description: 'Total COSM supply — minted, burned, reversed, circulating — plus the taper in force. '
+            + 'Derived from the ledger rather than a cached counter, so it cannot drift from the '
+            + 'rows it summarises. '
+            + '`reconciles` is an integrity check: minted minus burned minus reversed must equal '
+            + 'the sum of every balance, and the auction debit/credit pair must cancel. FALSE '
+            + 'means a bug, not stale data — surface it as a problem rather than reporting the '
+            + 'numbers as if they were sound.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/cosm/supply'),
+    },
+    {
+        name: 'get_cosm_emission_schedule',
+        description: 'The published COSM emission taper. Fixed years ahead and indexed on CUMULATIVE '
+            + 'MINTED, which is monotonic and which nothing anybody does can move backwards. '
+            + 'Useful for answering "will my earn rate drop" honestly: the schedule is knowable '
+            + 'in advance, and the final step is a floor rather than zero.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/cosm/supply/schedule'),
+    },
+    {
+        name: 'list_cosm_epochs',
+        description: 'Per-epoch COSM emission against the backstop ceiling. `demanded` is what activity '
+            + 'would have earned at full rate; `emitted` is what was credited. If they differ, '
+            + 'the ceiling refused something — which should be rare, since the real governor is '
+            + 'the emission rate itself. `ceilingBound` true signals an anomaly rather than a '
+            + 'busy week.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 200,
+                    default: 26,
+                    description: 'How many recent epochs. Default 26 (half a year at 7-day epochs).',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/cosm/supply/epochs', args.limit === undefined ? undefined : { limit: String(args.limit) }),
+    },
+];
+//# sourceMappingURL=supply.js.map

package/dist/tools/cosm/supply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supply.js","sourceRoot":"","sources":["../../../src/tools/cosm/supply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,sEAAsE;cACpE,kFAAkF;cAClF,kCAAkC;cAClC,iFAAiF;cACjF,iFAAiF;cACjF,gDAAgD;cAChD,8EAA8E;cAC9E,mCAAmC;QACvC,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;YACvB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;KACrF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,uFAAuF;cACrF,oFAAoF;cACpF,sBAAsB;cACtB,oFAAoF;cACpF,iFAAiF;cACjF,kFAAkF;cAClF,gCAAgC;QACpC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC;KACzC;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,iFAAiF;cAC/E,gFAAgF;cAChF,mFAAmF;cACnF,6DAA6D;QACjE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC;KAClD;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,oFAAoF;cAClF,kFAAkF;cAClF,mFAAmF;cACnF,iFAAiF;cACjF,YAAY;QAChB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;oBACZ,OAAO,EAAE,EAAE;oBACX,WAAW,EAAE,mEAAmE;iBACjF;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,MAAM,CACJ,wBAAwB,EACxB,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CACrE;KACJ;CACF,CAAC"}

package/dist/tools/cosm/withdrawals.d.ts

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

package/dist/tools/cosm/withdrawals.d.ts.map

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

package/dist/tools/cosm/withdrawals.js

@@ -0,0 +1,63 @@
+import { apiGet, apiPost } from '../../api.js';
+export const cosmWithdrawals = [
+    {
+        name: 'get_cosm_withdrawals',
+        description: 'A subject\'s COSM withdrawal history, and whether withdrawals are open at all. '
+            + 'THEY ARE NOT OPEN TODAY: `meta.open` is false and `meta.outstanding` lists the '
+            + 'preconditions still to be met — an audited minter program, a securities opinion, '
+            + 'a money-transmission review, and the emission invariant proven under real volume. '
+            + 'If a user asks when they can cash out, the honest answer is that it is gated on '
+            + 'those and NONE of them has a date. Do not invent or imply a timeline.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: {
+                    type: 'string',
+                    description: 'The CBX subject whose withdrawals to list. Must be one you own. Read '
+                        + '`meta.open` in the response before offering withdrawal to anybody.',
+                },
+            },
+            required: ['subjectId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/cosm/withdrawals', { subjectId: String(args.subjectId) }),
+    },
+    {
+        name: 'request_cosm_withdrawal',
+        description: 'Request a COSM withdrawal to the subject\'s own proven wallet. '
+            + 'THIS REFUSES TODAY with a 409 listing the outstanding preconditions — check '
+            + 'get_cosm_withdrawals first rather than calling this to find out. '
+            + 'There is NO destination parameter: it goes to the subject\'s own VERIFIED '
+            + 'connected wallet, because a per-request destination is how a compromised session '
+            + 'drains a balance elsewhere. If a user asks you to send COSM to an address, that '
+            + 'is not something this API can do for them. '
+            + 'Pass a stable `externalId` so a retry returns the original withdrawal instead of '
+            + 'creating a second one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                subjectId: {
+                    type: 'string',
+                    description: 'The CBX subject withdrawing. Must be one you own. The destination is this '
+                        + "subject's own verified connected wallet — there is no address parameter.",
+                },
+                baseUnits: {
+                    type: 'string',
+                    description: 'Amount in base units as a string. Six decimals; minimum 1 COSM.',
+                },
+                externalId: {
+                    type: 'string',
+                    description: 'Your own stable id for this request. Makes a retry a no-op.',
+                },
+            },
+            required: ['subjectId', 'baseUnits', 'externalId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/cosm/withdrawals', {
+            subjectId: String(args.subjectId),
+            baseUnits: String(args.baseUnits),
+            externalId: String(args.externalId),
+        }),
+    },
+];
+//# sourceMappingURL=withdrawals.js.map

package/dist/tools/cosm/withdrawals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawals.js","sourceRoot":"","sources":["../../../src/tools/cosm/withdrawals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,iFAAiF;cAC/E,iFAAiF;cACjF,mFAAmF;cACnF,oFAAoF;cACpF,kFAAkF;cAClF,uEAAuE;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,uEAAuE;0BACrE,oEAAoE;iBACzE;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,MAAM,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;KACxE;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,iEAAiE;cAC/D,8EAA8E;cAC9E,mEAAmE;cACnE,4EAA4E;cAC5E,mFAAmF;cACnF,kFAAkF;cAClF,6CAA6C;cAC7C,mFAAmF;cACnF,wBAAwB;QAC5B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4EAA4E;0BAC1E,0EAA0E;iBAC/E;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iEAAiE;iBAC/E;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6DAA6D;iBAC3E;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC;YAClD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,OAAO,CAAC,sBAAsB,EAAE;YAC9B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YACjC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SACpC,CAAC;KACL;CACF,CAAC"}

package/dist/tools/cosm.d.ts

@@ -0,0 +1,57 @@
+import { ToolDef } from './types.js';
+/**
+ * COSM — the metaverse cosmetics currency.
+ *
+ * ── DO NOT CONFUSE IT WITH CBX ────────────────────────────────────────
+ * They are opposites, and describing one with the other's properties is
+ * the most likely way an agent misleads somebody here:
+ *
+ *   CBX   fixed supply · backed by a reserve · spends RECIRCULATE
+ *         · withdrawable once matured
+ *   COSM  minted on demand · backed by NOTHING · spends BURN
+ *         · not withdrawable at all yet
+ *
+ * ── AMOUNTS ARE STRINGS OF BASE UNITS WITH SIX DECIMALS ───────────────
+ * `"10000000000"` is ten thousand COSM. They are strings because a JSON
+ * number loses precision past 2^53 — about nine billion COSM. Never do
+ * float arithmetic on them, and divide by 1e6 before showing a figure to
+ * a person.
+ *
+ * ── WHAT AN AGENT MUST NOT MISREPRESENT ───────────────────────────────
+ * COSM IS NOT WITHDRAWABLE AND IS NOT A YIELD. It is earned by ACTIVITY
+ * — accepting CBX on a sale, selling, buying goods — and staking only
+ * multiplies the RATE. There is no entitlement without activity, however
+ * large a stake. If somebody asks whether they can stake COSM or CBX to
+ * earn COSM passively, the answer is no, and that is deliberate rather
+ * than a missing feature.
+ *
+ * THERE IS NO WAY TO CASH IT OUT TODAY. The withdrawal tools exist and
+ * they REFUSE — `request_cosm_withdrawal` returns a 409 listing what is
+ * outstanding. Call `get_cosm_withdrawals` and read `meta.open` before
+ * offering it to anybody; do not call the request tool to discover that
+ * it is closed.
+ *
+ * Do not tell anybody a market is coming on a date. It is gated on an
+ * audited minter, a securities opinion, a money-transmission review and
+ * the emission invariant proven under real volume, and NONE of those has
+ * a timetable. "Not yet, and here is what has to happen first" is the
+ * honest answer; a guessed quarter is not.
+ *
+ * A USER-TO-USER SEND DOES NOT EXIST AT ANY SETTING. If somebody asks to
+ * send COSM to another user or to an address, that is not a thing this
+ * API can do. The auction house moves COSM between users but only
+ * through a matched listing for amounts derived from it.
+ *
+ * THE TIERS ARE DISJOINT. `premium` cosmetics cost CASH only, `earned`
+ * cost COSM only, `stake_exclusive` cannot be bought at any price in any
+ * currency. Never imply a premium item can be earned or that a
+ * stake-exclusive one can be purchased.
+ *
+ * ── SPENDING COSM DESTROYS IT ─────────────────────────────────────────
+ * Buying an earned cosmetic, a fusion cost and the auction fee all BURN.
+ * Nothing is credited to Crossly. If a user asks where their COSM went,
+ * the honest answer is that it no longer exists — that is what makes the
+ * supply figures meaningful.
+ */
+export declare const cosmTools: ToolDef[];
+//# sourceMappingURL=cosm.d.ts.map

package/dist/tools/cosm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosm.d.ts","sourceRoot":"","sources":["../../src/tools/cosm.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,EAU9B,CAAC"}