@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/inventory.js

@@ -0,0 +1,572 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP, PAGINATION_PROPS } from './types.js';
+export const inventoryTools = [
+    {
+        name: 'list_inventory',
+        description: 'List the seller\'s inventory items (the source-of-truth catalog, separate from per-platform listings). ' +
+            'Use this to find an item by title, get its ID for crossposting, or audit what\'s in stock. ' +
+            'Filter by status="active"|"sold"|"archived" or a free-text search. Returns paginated rows with ' +
+            'defaultTitle, defaultPrice, brand, size, condition, images, quantity, createdAt.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...PAGINATION_PROPS,
+                search: {
+                    type: 'string',
+                    description: 'Free-text match against title/description. Omit to list everything.',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['active', 'sold', 'archived'],
+                    description: 'Filter by lifecycle status. Most users only care about "active".',
+                },
+                kind: {
+                    type: 'string',
+                    enum: ['physical', 'web3'],
+                    description: 'Physical goods or Web3 assets (NFTs synced from a linked wallet). Omit for both.',
+                },
+                platforms: {
+                    type: 'string',
+                    description: 'Comma-separated marketplaces, e.g. "ebay,vinted": items with an active listing on any of them.',
+                },
+                platformMode: {
+                    type: 'string',
+                    enum: ['listed', 'not_listed'],
+                    description: '"not_listed" inverts platforms: items live on NONE of them (what still needs crossposting there).',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/inventory', {
+            page: args.page,
+            limit: args.limit,
+            search: args.search,
+            status: args.status,
+            kind: args.kind,
+            platforms: args.platforms,
+            platformMode: args.platformMode,
+        }),
+    },
+    {
+        name: 'merge_inventory_items',
+        description: 'Merge inventory items that are the SAME physical item into one - e.g. an import from two marketplaces ' +
+            'created one item per platform for a single ring. The kept item gets every listing link, sale, order and ' +
+            'conversation; the others are archived (never deleted). Stock is NOT added together: one item listed ' +
+            'twice is still one item. Ask the seller which item to keep.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                keepItemId: { type: 'string', description: 'UUID of the inventory item that survives.' },
+                mergeItemIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'UUIDs of the items folded into it and archived. Must not include the keeper.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['keepItemId', 'mergeItemIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { keepItemId, mergeItemIds, idempotencyKey } = args;
+            return apiPost('/v1/inventory/merge', { keepItemId, mergeItemIds }, idempotencyKey);
+        },
+    },
+    {
+        name: 'get_inventory_item',
+        description: 'Fetch one inventory item by its UUID, plus every platform-listing row attached to it ' +
+            '(so you can see which marketplaces it\'s currently live on, their per-platform IDs, and their URLs). ' +
+            'Use this before deciding to crosspost (to know which platforms are already covered) or before editing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Inventory item UUID. Get this from list_inventory.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/inventory/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'create_inventory_item',
+        description: 'Add a new item to the seller\'s catalog. This does NOT list it on any marketplace — call crosspost_listing ' +
+            'afterward with the returned id. Required: defaultTitle. Recommended: defaultPrice, brand, size, condition, ' +
+            'images (array of public URLs). Returns the created row with its UUID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                defaultTitle: { type: 'string', maxLength: 140, description: 'Item title used as the default across platforms.' },
+                defaultDescription: {
+                    type: 'string',
+                    maxLength: 8000,
+                    description: 'Long-form item description, max 8000 chars. In Crossly a description is a LISTING fact (one item can read '
+                        + 'differently on eBay than on Poshmark), so the canonical copy lives on the listing — set it with '
+                        + 'create_listing/update_listing rather than relying on this.',
+                },
+                defaultPrice: { type: 'number', description: 'Asking price in US DOLLARS as a decimal, e.g. 45.99 — NOT cents. Fields ending in `Cents` elsewhere in this API are integer cents; do not mix them up.' },
+                originalPrice: { type: 'number', description: 'Original/MSRP in US DOLLARS as a decimal, e.g. 120.00 — NOT cents. Used only for "X% off" displays; it is never charged.' },
+                brand: {
+                    type: 'string',
+                    maxLength: 80,
+                    description: 'Brand/maker as free text, max 80 chars, e.g. "Patagonia". Stored verbatim — each platform matches it to '
+                        + 'its own brand picker at publish time.',
+                },
+                size: {
+                    type: 'string',
+                    maxLength: 40,
+                    description: 'Size exactly as the seller writes it, max 40 chars, e.g. "M", "10.5", "32x30". Free text, no unit or '
+                        + 'sizing-system validation.',
+                },
+                condition: {
+                    type: 'string',
+                    maxLength: 40,
+                    description: 'e.g. "new_with_tags", "like_new", "good", "fair". Each platform maps to its own enum at publish time.',
+                },
+                color: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Colors as free-text strings, e.g. ["black","cream"]. Defaults to [] when omitted; platforms that accept '
+                        + 'only one color take the first entry.',
+                },
+                category: {
+                    type: 'object',
+                    properties: {
+                        main: { type: 'string' },
+                        sub: { type: 'string' },
+                        sub2: { type: 'string' },
+                    },
+                    description: 'Hierarchical category. Free-form strings; the dispatcher maps to platform-specific IDs.',
+                },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Hashtag/keyword list.' },
+                labels: { type: 'array', items: { type: 'string' }, description: 'User-defined organisational labels.' },
+                sku: {
+                    type: 'string',
+                    maxLength: 80,
+                    description: 'Seller-chosen stock-keeping code, max 80 chars. Never generated for you and NOT uniqueness-enforced — '
+                        + 'call inventory_sku_exists first to avoid a duplicate. It is also the key import_inventory_csv matches '
+                        + 'on, so it is what makes the export → edit → re-import round trip update instead of duplicate.',
+                },
+                quantity: {
+                    type: 'integer',
+                    minimum: 0,
+                    default: 1,
+                    description: 'Units on hand as a whole count (not a weight or a pack size). Minimum 0, defaults to 1. This is total '
+                        + 'stock; the server derives available/reserved/sold from it as orders arrive.',
+                },
+                images: {
+                    type: 'array',
+                    items: { type: 'string', format: 'uri' },
+                    description: 'Public HTTPS image URLs. First is the cover.',
+                },
+                notes: { type: 'string', maxLength: 8000, description: 'Private notes — never shown to buyers.' },
+                weightLb: { type: 'number', minimum: 0, description: 'Package weight (pounds part) for dimensional-shipping box selection.' },
+                weightOz: { type: 'number', minimum: 0, description: 'Package weight (ounces part).' },
+                dimensionLIn: { type: 'number', minimum: 0, description: 'Package length in inches.' },
+                dimensionWIn: { type: 'number', minimum: 0, description: 'Package width in inches.' },
+                dimensionHIn: { type: 'number', minimum: 0, description: 'Package height in inches.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['defaultTitle'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/inventory', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'update_inventory_item',
+        description: 'Edit an inventory item\'s defaults. Only the fields you pass are changed (PATCH semantics). ' +
+            'This updates the local catalog but does NOT propagate edits to live marketplace listings — ' +
+            'use update_listing for that. Pass an idempotencyKey if you may retry.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Inventory item UUID (inventory_items.id) — the `id` from list_inventory or get_inventory_item. Must belong to the calling seller or the call 404s.' },
+                defaultTitle: {
+                    type: 'string',
+                    maxLength: 140,
+                    description: 'Replacement item NAME, max 140 chars. This is how the seller identifies the physical thing (it backs '
+                        + 'inventory search and CSV re-import matching); it does NOT rewrite the titles of live marketplace '
+                        + 'listings — use update_listing for those.',
+                },
+                defaultDescription: {
+                    type: 'string',
+                    maxLength: 8000,
+                    description: 'Replacement description, max 8000 chars. Descriptions are a listing fact in Crossly, so editing it here '
+                        + 'changes no live marketplace copy — use update_listing for what buyers read.',
+                },
+                defaultPrice: { type: 'number', description: 'In DOLLARS as a decimal, e.g. 45.99 — this column is decimal(10,2), NOT cents. Other Crossly fields ending in `Cents` are integers of cents; do not mix them up.' },
+                originalPrice: { type: 'number', description: 'In DOLLARS as a decimal, e.g. 45.99 — this column is decimal(10,2), NOT cents. Other Crossly fields ending in `Cents` are integers of cents; do not mix them up.' },
+                brand: { type: 'string', description: 'Replacement brand as free text, max 80 chars. Omit to leave the current brand alone (PATCH semantics).' },
+                size: { type: 'string', description: 'Replacement size string, max 40 chars, e.g. "M" or "10.5". Free text — no sizing-system validation.' },
+                condition: { type: 'string', description: 'Replacement condition slug, max 40 chars — e.g. "new_with_tags", "like_new", "good", "fair". Each platform maps it to its own condition enum at publish time.' },
+                color: { type: 'array', items: { type: 'string' }, description: 'REPLACES the whole color array — not merged. Pass every color you want to keep; [] clears them.' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'REPLACES the whole hashtag/keyword array — not merged. Pass the full list; [] clears it.' },
+                labels: { type: 'array', items: { type: 'string' }, description: 'REPLACES the whole label array — not merged. For add/remove semantics across many items use inventory_bulk_labels instead.' },
+                sku: {
+                    type: 'string',
+                    description: 'Replacement stock-keeping code, max 80 chars. Changing it breaks the CSV round-trip match for this item: '
+                        + 'a later import_inventory_csv still carrying the OLD sku will add a duplicate rather than update.',
+                },
+                quantity: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'New total units on hand, a whole count of 0 or more. NOTE: this writes the Crossly row ONLY — it does not '
+                        + 'push the new stock to live marketplace listings and will not delist at 0. Use '
+                        + 'bulk_set_inventory_quantity when the change has to reach the marketplaces.',
+                },
+                images: { type: 'array', items: { type: 'string', format: 'uri' }, description: 'REPLACES the whole image array — not merged. Public HTTPS URLs; the first is the cover photo.' },
+                notes: { type: 'string', maxLength: 8000, description: 'Replacement private notes, max 8000 chars. Seller-only — never shown to buyers and never pushed to a marketplace.' },
+                weightLb: { type: 'number', minimum: 0, description: 'Package weight (pounds part).' },
+                weightOz: { type: 'number', minimum: 0, description: 'Package weight (ounces part).' },
+                dimensionLIn: { type: 'number', minimum: 0, description: 'Package length in inches.' },
+                dimensionWIn: { type: 'number', minimum: 0, description: 'Package width in inches.' },
+                dimensionHIn: { type: 'number', minimum: 0, description: 'Package height in inches.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPatch(`/v1/inventory/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'archive_inventory_item',
+        description: 'Soft-delete (archive) an inventory item — it disappears from the active catalog but is preserved for ' +
+            'analytics. Does NOT delist active marketplace listings; call delist for that first if needed. ' +
+            'Safe to retry with the same idempotencyKey.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Inventory item UUID.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/inventory/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+    {
+        name: 'get_inventory_activity',
+        description: 'List the activity log for an inventory item — created/sold/edited/quantity-changed/etc. Useful for ' +
+            'debugging "why does this look weird?" or building an item history view.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Inventory item UUID.' },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 50,
+                    description: 'Max events to return, 1-100, default 50. Newest first; there is no cursor, so raise this rather than paging.',
+                },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/inventory/${encodeURIComponent(args.id)}/activity`, {
+            limit: args.limit,
+        }),
+    },
+    // ── Bulk inventory operations + label management ───────────────────────
+    {
+        name: 'inventory_bulk_labels',
+        description: 'Bulk add/remove labels on inventory items. Pass addLabels and/or removeLabels arrays; at least one of the two must be ' +
+            'non-empty. Idempotent — duplicates in the existing array are de-duplicated. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 50000,
+                    description: 'Inventory item UUIDs (inventory_items.id) to relabel, 1-50000 of them. Get the set from '
+                        + 'list_inventory_ids. Ids that are not this seller\'s are silently skipped, so compare the returned '
+                        + '`updated` count against the length you sent.',
+                },
+                addLabels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Label strings to ADD to every listed item, each max 100 chars. Merged into the existing labels and '
+                        + 'de-duplicated, so re-running is harmless. Defaults to [].',
+                },
+                removeLabels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Label strings to STRIP from every listed item, each max 100 chars; exact match, case-sensitive. Applied '
+                        + 'before addLabels. Defaults to []; the call 400s ("no_changes") if both arrays end up empty.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['ids'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/inventory/bulk-labels', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'inventory_bulk_archive',
+        description: 'Bulk archive inventory items (soft delete — status=archived). Items disappear from active rollups but are preserved ' +
+            'for analytics. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 50000,
+                    description: 'Inventory item UUIDs (inventory_items.id) to archive, 1-50000 of them. Get the set from '
+                        + 'list_inventory_ids. Archiving only sets status="archived" — it does NOT delist anything, so items '
+                        + 'stay live and buyable on every marketplace until you delist them separately.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['ids'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/inventory/bulk-archive', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'inventory_bulk_delete',
+        description: "Bulk delete inventory items. Returns 409 when items are still linked to listings unless force=true; its details " +
+            "carry cascadeByPlatform/cascadeTotal — the LIVE marketplace listings deleteListings=true would END (e.g. 2,786 on " +
+            "eBay) — and deleteListingsDefault, what omitting deleteListings does for this seller (their saved setting). " +
+            "Before forcing, tell the user both outcomes in numbers and get an explicit choice; ending listings takes them off " +
+            "the marketplaces and cannot be undone from Crossly. Always pass deleteListings explicitly when forcing. Pass an " +
+            "idempotencyKey on retries.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 50000,
+                    description: 'Inventory item UUIDs (inventory_items.id) to delete permanently, 1-50000 of them. Get the set from '
+                        + 'list_inventory_ids. Any id still linked to a non-archived listing or an active platform listing is '
+                        + 'counted in the 409 `blockedCount` and nothing is deleted unless force=true.',
+                },
+                force: { type: 'boolean', default: false, description: 'Skip the linked-listings guard.' },
+                deleteListings: {
+                    type: 'boolean',
+                    description: 'true = also END every linked live marketplace listing (irreversible from Crossly); false = keep them live, '
+                        + 'only delink. Omitted = the seller\'s saved setting (see the 409\'s deleteListingsDefault). Pass it explicitly.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['ids'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/inventory/bulk-delete', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'inventory_labels_stats',
+        description: "List every distinct label the seller has used across their catalog, with item-count and assigned color. Use this to " +
+            "show a 'manage labels' UI or audit which labels actually have items.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/inventory/labels/stats'),
+    },
+    {
+        name: 'inventory_labels_rename',
+        description: "Rename a label across every inventory item that carries it. Color metadata is migrated atomically. Pass an " +
+            "idempotencyKey on retries.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                from: {
+                    type: 'string',
+                    description: 'The existing label to rename, 1-100 chars. Exact, case-sensitive match — items that do not carry this '
+                        + 'exact string are untouched and the response `updated` count will be 0.',
+                },
+                to: {
+                    type: 'string',
+                    description: 'The new label text, 1-100 chars. If an item already carries it the two labels MERGE and the duplicate '
+                        + 'collapses. Passing the same value as `from` is a no-op returning updated: 0.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['from', 'to'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/inventory/labels/rename', body, idempotencyKey);
+        },
+    },
+    // ── Discovery helpers ──────────────────────────────────────────────────
+    {
+        name: 'list_inventory_facets',
+        description: "Distinct brands + main categories across this user's inventory. Drives the filter chips on the inventory page.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/inventory/facets'),
+    },
+    {
+        name: 'list_inventory_ids',
+        description: "Filter inventory → return the matching id list. Canonical pattern for bulk actions: materialize the id set " +
+            "here, then dispatch to inventory_bulk_* tools. Filters: status / search (title or brand ilike) / category / " +
+            "platform (only items currently listed there) / labels (comma-separated).",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    description: 'Exact lifecycle status to match — "active", "sold" or "archived". Omit to match every status.',
+                },
+                search: {
+                    type: 'string',
+                    description: 'Case-insensitive substring (SQL ILIKE %term%) matched against the item title OR the brand. Omit for no '
+                        + 'text filter.',
+                },
+                category: {
+                    type: 'string',
+                    description: 'Exact main-category name. Category is a LISTING fact in Crossly, so this keeps items that have at least '
+                        + 'one listing whose category.main equals this string exactly.',
+                },
+                platform: {
+                    type: 'string',
+                    description: 'Platform slug — "ebay", "poshmark", "mercari", "etsy", … Keeps only items that have a platform-listing '
+                        + 'row on that platform for this seller, in ANY status (so sold and delisted rows still match).',
+                },
+                labels: { type: 'string', description: 'Comma-separated label list.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/inventory/ids', {
+            status: args.status,
+            search: args.search,
+            category: args.category,
+            platform: args.platform,
+            labels: args.labels,
+        }),
+    },
+    {
+        name: 'inventory_sku_exists',
+        description: "Check whether a SKU is already in use on this user's inventory. Returns { exists: boolean }. Use during " +
+            "import flows or before create_inventory_item to dedupe.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sku: {
+                    type: 'string',
+                    description: 'The SKU string to look for. Exact, case-sensitive match, scoped to the calling seller only — another '
+                        + "seller's identical SKU does not count as taken.",
+                },
+            },
+            required: ['sku'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/inventory/sku-exists', { sku: args.sku }),
+    },
+    {
+        name: 'list_inventory_labels',
+        description: "List every distinct label across this user's inventory. Drives the labels filter chip in the web/mobile " +
+            "inventory page. Pair with inventory_labels_stats for counts + colors.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/inventory/labels'),
+    },
+    {
+        name: 'import_inventory_csv',
+        description: 'Import a CSV into the seller\'s inventory. Rows whose `sku` matches an item they already have UPDATE ' +
+            'that item; rows without a usable SKU are ADDED as new items. That is the whole round-trip: export, edit, ' +
+            'import back. If you strip or omit the sku column you will duplicate their catalog, so keep it. ' +
+            'ALWAYS call once with dryRun=true first and show the seller the created/updated/skipped counts before ' +
+            'committing - this endpoint can damage a whole catalog and a preview costs one call. ' +
+            'Columns: title (required), price (required), quantity, condition, brand, size, color, sku, cost_of_goods, ' +
+            'description, images, category_main, category_sub, tags, notes, warehouse_location, storage_bin. ' +
+            'Multi-value cells use ";". Rows carrying price/description/category also create a DRAFT listing - ' +
+            'nothing is ever published by an import. Bad rows are skipped and reported with their spreadsheet line ' +
+            'number, not fatal.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                csv: { type: 'string', description: 'The CSV text, header row included.' },
+                dryRun: {
+                    type: 'boolean',
+                    description: 'Report what would happen without writing anything. Do this first.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['csv'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { csv, dryRun, idempotencyKey } = args;
+            return apiPost('/v1/inventory/csv/import', { csv, dryRun }, idempotencyKey);
+        },
+    },
+    {
+        name: 'export_inventory_csv',
+        description: 'Export the seller\'s inventory as CSV text. Emits exactly the columns import_inventory_csv reads, so the ' +
+            'output can be edited and imported straight back. Pass itemIds to export a subset; omit for everything. ' +
+            'Price, description and category come from each item\'s most recent listing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                itemIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Inventory item UUIDs. Omit to export the whole inventory.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { itemIds } = args;
+            return apiPost('/v1/inventory/csv/export', itemIds?.length ? { itemIds } : {});
+        },
+    },
+    {
+        name: 'bulk_set_inventory_quantity',
+        description: "Set, add to, or subtract from the stock on many inventory items at once. " +
+            "This is NOT just a column write - stock is mirrored by every marketplace the items are listed on, so " +
+            "the push fans out: live listings get the new quantity, anything dropping to 0 is DELISTED before someone " +
+            "can buy air, and anything rising from 0 reactivates or raises a restock prompt. " +
+            "mode='set' means 'this many are on the shelf'; increase/decrease adjust by the value. A decrease is " +
+            "floored at 0. " +
+            "The numbers change immediately and the returned bulkJobId tracks the marketplace push. `skipped` counts " +
+            "ids that did not move (already at that number, or not this seller's). " +
+            "Confirm the count with the seller before running this over a large selection - it changes what buyers see.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Inventory item UUIDs. Get them from list_inventory or the ids endpoint.',
+                },
+                mode: {
+                    type: 'string',
+                    enum: ['set', 'increase', 'decrease'],
+                    description: "'set' assigns the number; the others adjust by it.",
+                },
+                value: { type: 'number', description: 'Non-negative whole number.' },
+                syncMarketplaces: {
+                    type: 'boolean',
+                    description: 'False changes Crossly only and leaves live listings alone. Defaults to true.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['ids', 'mode', 'value'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { ids, mode, value, syncMarketplaces, idempotencyKey } = args;
+            return apiPost('/v1/inventory/bulk-quantity', { ids, mode, value, syncMarketplaces }, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=inventory.js.map

package/dist/tools/inventory.js.map

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

package/dist/tools/listings/_shared.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Reusable argument blocks for the bulk listing tools.
+ *
+ * Every `/v1/listings/bulk-*` route parses the same `BulkListingIdsSchema`
+ * (`listingIds` + optional `filters`), so the prose lives here once instead
+ * of drifting per tool. These are NOT tool arrays — do not name anything in
+ * this file `*Tools`.
+ */
+/** The selection itself. Shared by every bulk-* endpoint. */
+export declare const BULK_LISTING_IDS_PROP: {
+    readonly listingIds: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: string;
+    };
+};
+/** The advanced narrowing block — `BulkAdvancedFiltersSchema`. */
+export declare const BULK_FILTERS_PROP: {
+    readonly filters: {
+        readonly type: "object";
+        readonly description: string;
+    };
+};
+/** `platforms` on the bulk take-down endpoints (delist / archive). */
+export declare const BULK_DELIST_PLATFORMS_PROP: {
+    readonly platforms: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: string;
+    };
+};
+/** eBay's free-listing overage opt-in. Same semantics on every endpoint that has it. */
+export declare const EBAY_QUOTA_PROP: {
+    readonly confirmOverFreeQuota: {
+        readonly type: "boolean";
+        readonly description: string;
+    };
+};
+//# sourceMappingURL=_shared.d.ts.map

package/dist/tools/listings/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/tools/listings/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB;;;;;;;;CAUxB,CAAC;AAEX,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;;;;CAepB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,0BAA0B;;;;;;;;CAW7B,CAAC;AAEX,wFAAwF;AACxF,eAAO,MAAM,eAAe;;;;;CAUlB,CAAC"}