@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/trade-block.js

@@ -0,0 +1,308 @@
+import { apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * The Trade Block — peer-to-peer swaps on the Crossly Market.
+ *
+ * Post a WANT or an OFFER, respond with a concrete one-item-each-side swap (plus
+ * optional cash boot), and accept/decline/counter/withdraw. Accepting charges
+ * BOTH parties the 9.5% market fee and sends both items to authentication;
+ * nothing releases until BOTH pass. Market items only.
+ */
+const ITEM_SCHEMA = {
+    type: 'object',
+    properties: {
+        variantId: { type: 'string', description: 'Market variant UUID.' },
+        condition: { type: 'string', description: 'Condition code (default DS).' },
+        gradeKey: { type: 'string', description: 'Grade key, e.g. psa:10. Omit for ungraded.' },
+        portfolioId: { type: 'string', description: 'Optional link to your known holding.' },
+    },
+    required: ['variantId'],
+    additionalProperties: false,
+};
+export const tradeBlockTools = [
+    {
+        name: 'list_trade_block_posts',
+        description: 'Browse open Trade Block posts on the Crossly Market — WANTs (someone looking for an item) and OFFERs ' +
+            '(items up for trade). Filter by `kind`, `categorySlug`, or a text `q`. Each post lists the items on the ' +
+            'table and, for wants, the target item + any cash bounty.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['want', 'offer'],
+                    description: 'Filter the board. `want` = the poster is looking for something; `offer` = the poster has items up for trade. Omit for both.',
+                },
+                categorySlug: { type: 'string', description: 'Filter to one Crossly Market category slug. Omit for every category.' },
+                brand: { type: 'string', description: 'Filter to posts with a product of this brand (case-insensitive).' },
+                model: { type: 'string', description: 'Filter to posts with a product of this catalogue model (case-insensitive).' },
+                q: { type: 'string', description: 'Free-text search over post titles and want text.' },
+                limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Max posts to return, 1–100. Defaults to 40.' },
+                offset: { type: 'integer', minimum: 0, description: 'Rows to skip for paging. Defaults to 0.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/trade-block/posts', args),
+    },
+    {
+        name: 'list_my_trades',
+        description: 'List the Trade Block trades you are a party to, newest first, with their status and cross-verification state.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/trade-block/trades', {}),
+    },
+    {
+        name: 'create_trade_block_post',
+        description: 'RETIRED — always refused. Trades are listed by sellers as a listing in Trade mode (create a listing with ' +
+            'platformOverrides.crossly.isTrade = "true", tradeItems and tradeWants), so the trade is tied to their inventory. ' +
+            'Buyers respond to posts with an offer instead (create_trade_block_offer).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['want', 'offer'],
+                    description: '`want` = you are hunting something, and the post needs at least one of `target`, `wantText` or a non-zero ' +
+                        '`wantCashCents`. `offer` = you have things up for trade, and the post needs at least one entry in `items`.',
+                },
+                title: { type: 'string', description: 'Headline for the post, 1–140 characters.' },
+                note: { type: 'string', description: 'Optional body text — terms, condition notes, what you are after. Up to 2000 characters.' },
+                categorySlug: { type: 'string', description: 'Crossly Market category slug to file the post under, up to 40 characters.' },
+                target: {
+                    type: 'object',
+                    description: 'WANT only: the specific market item you are hunting. Both `variantId` and `condition` are required here.',
+                    properties: {
+                        variantId: { type: 'string', description: 'Market variant UUID of the item you want.' },
+                        condition: { type: 'string', description: 'Condition code you will accept, e.g. DS.' },
+                        gradeKey: { type: 'string', description: 'Grade key, e.g. psa:10. Omit to accept any grade.' },
+                    },
+                    required: ['variantId', 'condition'],
+                    additionalProperties: false,
+                },
+                wantText: {
+                    type: 'string',
+                    description: 'WANT only: prose for what you are after when no single variant captures it. Up to 500 characters.',
+                },
+                wantCashCents: { type: 'integer', minimum: 0, description: 'Cash bounty added on top of a want, in cents.' },
+                items: { type: 'array', items: ITEM_SCHEMA, description: 'Items the poster puts up.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['kind', 'title'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/trade-block/posts', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'create_trade_block_offer',
+        description: 'Respond to a post with a concrete swap: the items you give (`fromItems`, 0..N) and the items you want ' +
+            'back (`toItems`, 0..N), plus optional cash (`cashCents` + `cashPayer`). At least one item must exist across ' +
+            'the trade, and each side must bring value (items or cash) — this covers even swaps, boot, and cash ' +
+            'bounties. On accept both parties pay the market fee and every item goes to authentication. Pass an ' +
+            'idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                postId: { type: 'string', description: 'The post UUID to respond to.' },
+                proposerStripePaymentMethodId: { type: 'string', description: 'Your saved card, charged your fee (+ cash) on accept.' },
+                cashCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Cash boot riding on top of the items, in US CENTS (integer, 0–100,000,000 — so $0.00 to $1,000,000.00). ' +
+                        '1000 means $10.00, not $1000. Defaults to 0; anything above 0 makes `cashPayer` required.',
+                },
+                cashPayer: {
+                    type: 'string',
+                    enum: ['responder', 'poster'],
+                    description: 'Which side owes `cashCents`. `responder` = you, the one making this offer; `poster` = the person whose post ' +
+                        'you are answering (i.e. you are asking THEM for cash). Required whenever cashCents is above 0.',
+                },
+                note: { type: 'string', description: 'Optional message to the poster explaining the swap. Up to 2000 characters.' },
+                fromItems: { type: 'array', items: ITEM_SCHEMA, description: 'Items you give.' },
+                toItems: { type: 'array', items: ITEM_SCHEMA, description: 'Items you want from the poster.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['postId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { postId, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/trade-block/posts/${encodeURIComponent(postId)}/offers`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'respond_to_trade_block_offer',
+        description: 'Accept, decline, counter, or withdraw a Trade Block offer. `accept` charges both parties and opens the ' +
+            'two auth intakes (pass your `stripePaymentMethodId` if you are the accepting party). `counter` opens a ' +
+            'child offer with new cash terms over the same items. `withdraw` is for the party who made the offer; ' +
+            '`decline` is for the party it is addressed to. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Offer UUID.' },
+                action: {
+                    type: 'string',
+                    enum: ['accept', 'decline', 'counter', 'withdraw'],
+                    description: '`accept` — take the deal: charges BOTH parties the 9.5% market fee plus whatever cash their side owes, and ' +
+                        'opens an authentication intake per item. `decline` — refuse it (for the party the offer is addressed to). ' +
+                        '`counter` — open a child offer with new cash terms over the same items. `withdraw` — pull an offer you made.',
+                },
+                stripePaymentMethodId: { type: 'string', description: 'Your saved card (accept, or counter where you become the proposer).' },
+                cashCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Counter only: the replacement cash boot, in US CENTS (integer, 0–100,000,000). 1000 means $10.00. ' +
+                        'Omit to keep the cash terms of the offer you are countering.',
+                },
+                cashPayer: {
+                    type: 'string',
+                    enum: ['responder', 'poster'],
+                    description: 'Counter only: which side owes the new `cashCents` — `responder` (whoever answered the post) or `poster` ' +
+                        '(whoever made it). Required when the countered amount is above 0 and the original offer named no payer.',
+                },
+                note: { type: 'string', description: 'Counter only: optional message carried on the counter-offer. Up to 2000 characters.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'action'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, action, stripePaymentMethodId, cashCents, cashPayer, note } = args;
+            let body;
+            if (action === 'accept')
+                body = { action, stripePaymentMethodId };
+            else if (action === 'counter')
+                body = { action, cashCents, cashPayer, stripePaymentMethodId, note };
+            else
+                body = { action }; // decline | withdraw
+            return apiPost(`/v1/trade-block/offers/${encodeURIComponent(id)}/respond`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'get_trade_block_post',
+        description: 'Get one Trade Block post with its items and open-offer count.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Post UUID.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/trade-block/posts/${encodeURIComponent(id)}`, {});
+        },
+    },
+    {
+        name: 'close_trade_block_post',
+        description: 'Close one of your Trade Block posts so it stops taking offers.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Post UUID.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/trade-block/posts/${encodeURIComponent(id)}/close`, {});
+        },
+    },
+    {
+        name: 'list_trade_block_evolutions',
+        description: 'List your Trade Evolution unlocks — completed swaps that unlocked a designer-authored evolved or set-master cosmetic you can mint by burning COSM.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/trade-block/evolutions', {}),
+    },
+    {
+        name: 'claim_trade_block_evolution',
+        description: 'Burn COSM and mint the evolved (or set-master) NFT for one of your evolution unlocks. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Unlock UUID.' }, ...IDEMPOTENCY_PROP },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey } = args;
+            return apiPost(`/v1/trade-block/evolutions/${encodeURIComponent(id)}/claim`, {}, idempotencyKey);
+        },
+    },
+    {
+        name: 'create_trade_block_evolution_recipe',
+        description: 'Author a Trade Evolution recipe: a graded item (or a pair) that, when swapped, unlocks an evolved cosmetic you designed. Born unreviewed until ops approves.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'e.g. "Charizard + Blastoise → Charizard-EX (Holo)".' },
+                note: { type: 'string', description: 'Optional note about the recipe, up to 2000 characters — ops reads this when reviewing it.' },
+                inputA: {
+                    type: 'object',
+                    description: 'The required input: the item that must change hands in a completed swap for the unlock to fire.',
+                    properties: {
+                        variantId: { type: 'string', description: 'Market variant UUID of the input item.' },
+                        condition: { type: 'string', description: 'Condition code the input must be in. Omit to match any condition.' },
+                        gradeKey: { type: 'string', description: 'Grade key, e.g. psa:10. Omit to match any grade.' },
+                    },
+                    required: ['variantId'],
+                    additionalProperties: false,
+                },
+                inputB: {
+                    type: 'object',
+                    description: 'Optional second input — a two-item fusion.',
+                    properties: {
+                        variantId: { type: 'string' },
+                        condition: { type: 'string' },
+                        gradeKey: { type: 'string' },
+                    },
+                    required: ['variantId'],
+                    additionalProperties: false,
+                },
+                outputCosmeticId: { type: 'string', description: 'A cosmetic you designed, with a COSM price.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['name', 'inputA', 'outputCosmeticId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/trade-block/evolution-recipes', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'create_trade_block_set_recipe',
+        description: 'Author a set-completion recipe: a set of items (2–60) that, once a trader assembles the whole set through trading, unlocks a set-master cosmetic you designed. Born unreviewed until ops approves.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'e.g. "Gen-1 Starters — Master Set".' },
+                note: { type: 'string', description: 'Optional note about the set, up to 2000 characters — ops reads this when reviewing it.' },
+                members: {
+                    type: 'array',
+                    minItems: 2,
+                    maxItems: 60,
+                    description: 'The items that make up the set — 2 to 60 of them. A trader unlocks the set-master cosmetic only once every ' +
+                        'member has been acquired through trading.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            variantId: { type: 'string', description: 'Market variant UUID of this set member.' },
+                            condition: { type: 'string', description: 'Condition code this member must be in. Omit to match any condition.' },
+                            gradeKey: { type: 'string', description: 'Grade key, e.g. psa:10. Omit to match any grade.' },
+                        },
+                        required: ['variantId'],
+                        additionalProperties: false,
+                    },
+                },
+                outputCosmeticId: { type: 'string', description: 'A set-master cosmetic you designed, with a COSM price.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['name', 'members', 'outputCosmeticId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/trade-block/set-recipes', body, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=trade-block.js.map

package/dist/tools/trade-block.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared shape for every MCP tool definition in this server.
+ *
+ * `inputSchema` is a plain JSON Schema object the MCP runtime forwards
+ * verbatim to the agent — keep it minimal and self-describing.
+ * `handler` returns anything JSON-serializable; we wrap it as a text
+ * content block at the call site.
+ */
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+}
+/** Common pagination block — reused so every list tool exposes it the same way. */
+export declare const PAGINATION_PROPS: {
+    readonly page: {
+        readonly type: "integer";
+        readonly minimum: 1;
+        readonly default: 1;
+        readonly description: "1-indexed page number. Increment to walk the next page of results.";
+    };
+    readonly limit: {
+        readonly type: "integer";
+        readonly minimum: 1;
+        readonly maximum: 100;
+        readonly default: 25;
+        readonly description: "Items per page (1-100). Default 25.";
+    };
+};
+/** Idempotency arg — mention this on every mutation. */
+export declare const IDEMPOTENCY_PROP: {
+    readonly idempotencyKey: {
+        readonly type: "string";
+        readonly description: "Optional unique key (e.g. a UUID or stable hash of the action). If the same key is replayed within 24h the server returns the original response instead of re-executing — pass one whenever you might retry on a transient error.";
+    };
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CAcnB,CAAC;AAEX,wDAAwD;AACxD,eAAO,MAAM,gBAAgB;;;;;CAMnB,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,24 @@
+/** Common pagination block — reused so every list tool exposes it the same way. */
+export const PAGINATION_PROPS = {
+    page: {
+        type: 'integer',
+        minimum: 1,
+        default: 1,
+        description: '1-indexed page number. Increment to walk the next page of results.',
+    },
+    limit: {
+        type: 'integer',
+        minimum: 1,
+        maximum: 100,
+        default: 25,
+        description: 'Items per page (1-100). Default 25.',
+    },
+};
+/** Idempotency arg — mention this on every mutation. */
+export const IDEMPOTENCY_PROP = {
+    idempotencyKey: {
+        type: 'string',
+        description: 'Optional unique key (e.g. a UUID or stable hash of the action). If the same key is replayed within 24h the server returns the original response instead of re-executing — pass one whenever you might retry on a transient error.',
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAoBA,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oEAAoE;KAClF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,qCAAqC;KACnD;CACO,CAAC;AAEX,wDAAwD;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,mOAAmO;KACtO;CACO,CAAC"}

package/dist/tools/units.d.ts

@@ -0,0 +1,9 @@
+import { ToolDef } from './types.js';
+/**
+ * Per-unit identity. Every description here spends a sentence on WHEN an
+ * identifier was recorded, because that is the only thing that decides what it
+ * proves — and an agent that records serials only once a dispute opens has
+ * built a log, not evidence.
+ */
+export declare const unitsTools: ToolDef[];
+//# sourceMappingURL=units.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/tools/units.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,EAwK/B,CAAC"}

package/dist/tools/units.js

@@ -0,0 +1,156 @@
+import { apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * Per-unit identity. Every description here spends a sentence on WHEN an
+ * identifier was recorded, because that is the only thing that decides what it
+ * proves — and an agent that records serials only once a dispute opens has
+ * built a log, not evidence.
+ */
+export const unitsTools = [
+    {
+        name: 'list_inventory_units',
+        description: 'List the individually identified units of an inventory item (serials, IMEIs, licence keys). Each identifier ' +
+            'carries a `strength`: `strong` = recorded before the item sold, `good` = recorded at packing, `weak` = first ' +
+            'recorded only after it shipped. Strength is derived from the recording time relative to the sale, never from ' +
+            'the value itself. An empty list means nothing was recorded, not that the item has no units.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inventoryItemId: {
+                    type: 'string',
+                    description: 'UUID of the inventory ITEM — the quantity-tracked stock row (`inventory_items.id`), NOT a unit id. ' +
+                        'An item is "3 x PS5 slim"; a unit is one specific console with its own serial. Returns every unit ' +
+                        'recorded under that item. Must belong to the calling account, otherwise 404.',
+                },
+            },
+            required: ['inventoryItemId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/inventory/${encodeURIComponent(args.inventoryItemId)}/units`),
+    },
+    {
+        name: 'list_order_units',
+        description: 'List the identified units that physically shipped on an order — the read to make when a buyer disputes or ' +
+            'returns something. Compare the serial on the returned item against this list. An empty list means no identity ' +
+            'was recorded for that order, which is NOT evidence that the right unit came back.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                orderId: {
+                    type: 'string',
+                    description: "UUID of the Crossly order (`orders.id`) — not the marketplace's own order number and not a sale id. " +
+                        'Returns the units that were attributed to this order at ship time (FIFO over available units unless ' +
+                        'specific ones were picked). Must belong to the calling account, otherwise 404.',
+                },
+            },
+            required: ['orderId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/orders/${encodeURIComponent(args.orderId)}/units`),
+    },
+    {
+        name: 'record_unit_identifier',
+        description: 'Record a serial / IMEI / licence key against an inventory item, creating the unit if no unitId is given. ' +
+            'Record at INTAKE, before the item sells: an identifier that predates the sale cannot have been chosen to fit a ' +
+            'specific dispute, and that is the entire reason the record is worth anything. `source` is a hint stored ' +
+            "alongside the value — the server re-derives strength from the timestamp, so declaring 'intake' late does not " +
+            'upgrade it. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inventoryItemId: {
+                    type: 'string',
+                    description: 'UUID of the inventory ITEM this piece of stock belongs to (`inventory_items.id`) — the quantity-tracked ' +
+                        'row, not a unit id. When no `unitId` is given the unit is created lazily under this item. Must belong ' +
+                        'to the calling account, otherwise 404.',
+                },
+                value: {
+                    type: 'string',
+                    maxLength: 120,
+                    description: 'The identifier exactly as read off the physical item, 1-120 characters. Stored verbatim (trimmed) and ' +
+                        'also normalised for matching — uppercased with every non-alphanumeric stripped — so "SN-1234 5678" and ' +
+                        '"sn12345678" are the same unit. Must be at least 4 characters AFTER normalisation or the server rejects ' +
+                        'it with 400. Re-posting a value this account already has attaches to that existing unit instead of ' +
+                        'minting a second one, and the FIRST recording keeps its timestamp (a repeat never overwrites it).',
+                },
+                namespace: {
+                    type: 'string',
+                    enum: ['serial', 'imei', 'licence_key', 'gtin', 'custom'],
+                    default: 'serial',
+                    description: 'What kind of identifier `value` is; defaults to `serial`. `serial` = a manufacturer serial number. ' +
+                        '`imei` = a phone/tablet IMEI. `licence_key` = a software or product key. `gtin` = the UPC/EAN barcode, ' +
+                        'which identifies the MODEL rather than one copy, so it cannot tell two units apart — use it for lookup ' +
+                        'convenience, not as return evidence. `custom` = your own numbering scheme; an escape hatch, not a ' +
+                        'default. Uniqueness is per (unit, namespace, normalised value), so the same digits filed under two ' +
+                        'namespaces are two separate identifiers and will not match each other on lookup.',
+                },
+                source: {
+                    type: 'string',
+                    enum: ['intake', 'packing', 'import', 'manual', 'dispute'],
+                    default: 'intake',
+                    description: 'Where the identifier was collected; defaults to `intake`. This is a declaration stored alongside the ' +
+                        'value — the readable `strength` grade comes from it WEIGHED AGAINST the recording timestamp and the ' +
+                        'sale date, so a late record cannot buy pre-sale provenance. `intake` = scanned when the item entered ' +
+                        'stock, before any sale existed. `packing` = scanned while packing the outgoing order. `import` = loaded ' +
+                        'in bulk from a spreadsheet or warehouse system. `manual` = typed in ad hoc afterwards. `dispute` = ' +
+                        'first written down while answering a buyer claim, the weakest thing you can record.',
+                },
+                unitId: {
+                    type: 'string',
+                    description: 'UUID of an EXISTING unit (`inventory_units.id` — one physical piece of stock, as returned by ' +
+                        'list_inventory_units) to hang this identifier on, instead of creating a unit. Use it to record a ' +
+                        'second identifier for the same object, e.g. an IMEI on a phone that already has a serial. Omit for ' +
+                        'the normal case.',
+                },
+                notes: {
+                    type: 'string',
+                    maxLength: 500,
+                    description: 'Free-text note about this physical unit (condition quirks, box contents, where it is shelved), max 500 ' +
+                        'characters. Written only when this call CREATES the unit — it is ignored when `unitId` is passed or ' +
+                        'when the value resolves to a unit that already exists, so it cannot be used to amend an existing unit.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['inventoryItemId', 'value'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { inventoryItemId, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/inventory/${encodeURIComponent(inventoryItemId)}/units/identifiers`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'lookup_unit_by_identifier',
+        description: '"Have I ever seen this serial?" — resolve an identifier to a unit and the order it shipped on. Use when ' +
+            'something arrives back with no paperwork: a hit on a DIFFERENT order usually means a mixed-up return rather ' +
+            'than fraud. Scoped to the caller, so it cannot be used to probe another account.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                value: {
+                    type: 'string',
+                    maxLength: 120,
+                    description: 'The identifier to look up, 1-120 characters, as read off the item in hand. Compared after the same ' +
+                        'normalisation used when recording (uppercase, non-alphanumerics stripped), so hyphens, spaces and case ' +
+                        'do not matter; the match is exact after that, never fuzzy. Under 4 normalised characters the call ' +
+                        "succeeds with `{ found: false, reason: 'too_short' }` rather than erroring. A miss means this account " +
+                        'has never recorded that identifier — it is not proof the unit is counterfeit.',
+                },
+                namespace: {
+                    type: 'string',
+                    enum: ['serial', 'imei', 'licence_key', 'gtin', 'custom'],
+                    default: 'serial',
+                    description: 'Which identifier space to search; defaults to `serial`. Must be the same namespace the value was ' +
+                        'recorded under — the lookup keys on (namespace, normalised value), so an IMEI filed as `imei` will not ' +
+                        'be found by searching `serial`. `serial` = manufacturer serial, `imei` = phone/tablet IMEI, ' +
+                        '`licence_key` = software/product key, `gtin` = UPC/EAN (identifies the model, so it can match several ' +
+                        'units), `custom` = your own scheme.',
+                },
+            },
+            required: ['value'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/inventory/units/lookup', args),
+    },
+];
+//# sourceMappingURL=units.js.map

package/dist/tools/units.js.map

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

package/dist/tools/variation_groups.d.ts

@@ -0,0 +1,17 @@
+import { ToolDef } from './types.js';
+/**
+ * Variation groups — several of the seller's listings sold as one product.
+ *
+ * The fact an agent most needs from these tools is counter-intuitive enough
+ * to repeat in every description: a group's members are STANDALONE listings,
+ * not children. They appear in list_listings, they publish independently to
+ * platforms with no variation support, and each has its own inventory, COGS
+ * and lifecycle. The group is an extra fact about them, not a container.
+ *
+ * Getting that wrong is not cosmetic. An agent repricing "every listing"
+ * would treat four sizes of one shirt as four unrelated products and can
+ * happily undercut the seller against themselves; one counting products
+ * would report four where the seller has one.
+ */
+export declare const variationGroupTools: ToolDef[];
+//# sourceMappingURL=variation_groups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"variation_groups.d.ts","sourceRoot":"","sources":["../../src/tools/variation_groups.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,EAkFxC,CAAC"}