@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/listings/_shared.js

@@ -0,0 +1,59 @@
+/**
+ * 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 const BULK_LISTING_IDS_PROP = {
+    listingIds: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Master Crossly listing UUIDs — the `id` from list_listings / list_listing_ids, NOT a '
+            + 'platformListingId (that is a marketplace\'s own id for ONE channel of a listing and is '
+            + 'rejected here). 1 to 50,000 per call. Ids that are not the caller\'s never act: depending on '
+            + 'the endpoint they either fail the whole call with 404 not_found naming them, or are skipped.',
+    },
+};
+/** The advanced narrowing block — `BulkAdvancedFiltersSchema`. */
+export const BULK_FILTERS_PROP = {
+    filters: {
+        type: 'object',
+        description: 'Optional server-side narrowing applied to `listingIds` BEFORE any fan-out — the effective '
+            + 'selection is the intersection, so filters only ever SHRINK the set, never add to it. All keys '
+            + 'optional: listedMoreThanDays / noSaleDays (integer days, 1-3650); priceMin / priceMax '
+            + '(effective price in US DOLLARS, e.g. 24.99, range 0-1000000 — the listing\'s price falling back '
+            + 'to its inventory item\'s default); viewsLessThan / favoritesLessThan (integers 0-10000000, '
+            + 'summed across the listing\'s active platform rows); quantityAvailableLessThanOrEqual (integer '
+            + '0-10000; 0 catches out-of-stock); listedOnLessThan / listedOnAtLeast (integers 1-20, a count of '
+            + 'ACTIVE platform rows — listedOnLessThan=2 means "live on only one marketplace"); brandContains '
+            + '(case-insensitive substring, 1-120 chars); hasAnyLabels / hasNoneLabels (up to 40 inventory '
+            + 'labels each); condition (exact effective condition, e.g. "new", "good"). Omit for no narrowing.',
+    },
+};
+/** `platforms` on the bulk take-down endpoints (delist / archive). */
+export const BULK_DELIST_PLATFORMS_PROP = {
+    platforms: {
+        type: 'array',
+        items: { type: 'string' },
+        description: 'Optional platform ids restricting which marketplaces are taken down, e.g. ["poshmark","ebay"]. '
+            + 'Ids come from the shared platform list (ebay, etsy, shopify, poshmark, mercari, depop, grailed, '
+            + 'vinted, whatnot, vestiaire, facebook, offerup, curtsy, goat, reverb, stockx, …). Omit to act on '
+            + 'EVERY marketplace the selection is currently live on. Read straight off the body without '
+            + 'validation — an unrecognised id simply matches no platform row and silently does nothing.',
+    },
+};
+/** eBay's free-listing overage opt-in. Same semantics on every endpoint that has it. */
+export const EBAY_QUOTA_PROP = {
+    confirmOverFreeQuota: {
+        type: 'boolean',
+        description: 'eBay only, and only consulted when "ebay" is among the targets. Left unset, the call stops at '
+            + '402 free_quota_exceeded as soon as the selection would cross eBay\'s monthly free-listing '
+            + 'allowance; set true to accept eBay\'s per-listing insertion fee of roughly $0.35 US DOLLARS on '
+            + 'each listing past that allowance. It does NOT bypass eBay\'s separate monthly selling cap, '
+            + 'which still rejects with 409 selling_cap_reached.',
+    },
+};
+//# sourceMappingURL=_shared.js.map

package/dist/tools/listings/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/tools/listings/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,EAAE;QACV,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EACT,uFAAuF;cACrF,yFAAyF;cACzF,+FAA+F;cAC/F,8FAA8F;KACnG;CACO,CAAC;AAEX,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,4FAA4F;cAC1F,gGAAgG;cAChG,wFAAwF;cACxF,kGAAkG;cAClG,6FAA6F;cAC7F,gGAAgG;cAChG,kGAAkG;cAClG,iGAAiG;cACjG,8FAA8F;cAC9F,iGAAiG;KACtG;CACO,CAAC;AAEX,sEAAsE;AACtE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,SAAS,EAAE;QACT,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EACT,iGAAiG;cAC/F,kGAAkG;cAClG,kGAAkG;cAClG,2FAA2F;cAC3F,2FAA2F;KAChG;CACO,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oBAAoB,EAAE;QACpB,IAAI,EAAE,SAAS;QACf,WAAW,EACT,gGAAgG;cAC9F,4FAA4F;cAC5F,iGAAiG;cACjG,6FAA6F;cAC7F,mDAAmD;KACxD;CACO,CAAC"}

package/dist/tools/listings/ai-image.d.ts

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

package/dist/tools/listings/ai-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-image.d.ts","sourceRoot":"","sources":["../../../src/tools/listings/ai-image.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAmCxD,eAAO,MAAM,eAAe,EAAE,OAAO,EA2GpC,CAAC"}

package/dist/tools/listings/ai-image.js

@@ -0,0 +1,145 @@
+/**
+ * AI listing images (BYOK) — generate a product photo with the seller's OWN
+ * image-provider key, preview the prompt, choose the image provider.
+ * Backed by POST /v1/listings/ai-image(+/prompt) and PUT /v1/ai/image-config.
+ * Plus Crossly's AI-image DETECTION on listing photos: GET
+ * /v1/listings/:id/ai-detections and POST /v1/ai-detections/:id/dispute.
+ */
+import { apiGet, apiPost, apiPut } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+const FIELDS = {
+    listingId: {
+        type: 'string',
+        format: 'uuid',
+        description: 'A listing the seller owns. Blank fields below are filled from it, and the generated image is recorded on it as AI-generated.',
+    },
+    title: { type: 'string', description: 'Listing title, max 500 characters.' },
+    brand: { type: 'string', description: 'Brand, e.g. "Nike". Max 200 characters.' },
+    model: { type: 'string', description: 'Model / style name, e.g. "Air Jordan 1 Retro High OG". Max 200 characters.' },
+    color: {
+        description: 'Colourway — one string or an array of colour names (max 10), e.g. ["Varsity Red", "White"].',
+        anyOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+    },
+    material: { type: 'string', description: 'Main material, e.g. "leather". Max 200 characters.' },
+    size: { type: 'string', description: 'Size label, used only to keep proportions true. Max 60 characters.' },
+    condition: {
+        type: 'string',
+        description: 'Condition label ("New with tags", "Used - Good", "Fair"…). The image stays true to it: a used item is never rendered as new and visible wear is kept.',
+    },
+    category: { type: 'string', description: 'Category path, e.g. "Shoes › Sneakers". Steers the lifestyle setting. Max 300 characters.' },
+    description: { type: 'string', description: 'Listing description — physical details only; it is never rendered as text in the image. Max 8000 characters.' },
+    style: {
+        type: 'string',
+        enum: ['studio', 'lifestyle', 'flatlay', 'detail'],
+        description: 'studio (default: seamless light backdrop, softbox, 3/4 hero, square) | lifestyle (real-world setting; the only style that may include people) | flatlay (top-down on a neutral surface) | detail (macro of materials/labels).',
+    },
+    extra: { type: 'string', description: "Short seller direction appended to the prompt (max 300 characters), e.g. \"show the outsole\". It cannot override the no-invented-logos / one-item rules." },
+    referenceImageUrl: {
+        type: 'string',
+        description: "One of the listing's own photos on the Crossly CDN. The model keeps that exact item (colour, shape, markings, wear) and only changes background, lighting and framing. URLs on any other host are refused.",
+    },
+};
+export const listingsAiImage = [
+    {
+        name: 'generate_listing_image',
+        description: "Generate a product photo for a listing using the seller's OWN AI key (BYOK — OpenAI, Google Gemini, " +
+            'xAI Grok or Together FLUX, whichever is set as the image provider in Settings → AI; the seller pays their ' +
+            'provider per image). The image is stored on the Crossly CDN and MARKED AI-GENERATED: with `listingId` it ' +
+            "is recorded in that listing's aiMediaUrls, so the shop shows an AI tag while it is on the listing; without " +
+            'one, send the returned url in `aiMediaUrls` when creating/updating the listing. It is NOT added to the ' +
+            "listing's photos — add `url` to `images` yourself. Returns `{ url, prompt, provider, model, listingId, " +
+            'aiGenerated }`. 400 with details.settingsPath when no image-capable key is saved. Ask before generating ' +
+            'many — each call spends the seller\'s credits.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...FIELDS,
+                prompt: {
+                    type: 'string',
+                    description: 'Optional prompt to use verbatim instead of the built one (e.g. from preview_listing_image_prompt, edited). Max 4000 characters.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/ai-image', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'preview_listing_image_prompt',
+        description: 'Return the product-photography prompt generate_listing_image would send for these fields — `{ prompt }`. ' +
+            'No image is generated and no AI credits are spent.',
+        inputSchema: {
+            type: 'object',
+            properties: { ...FIELDS },
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/listings/ai-image/prompt', args),
+    },
+    {
+        name: 'set_ai_image_provider',
+        description: "Choose which of the seller's saved AI keys makes listing images, independently of the text provider. " +
+            'Returns `{ success, image: { provider, model, resolvedProvider, resolvedModel, supportedProviders, error } }`.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                provider: {
+                    type: ['string', 'null'],
+                    enum: ['openai', 'google', 'xai', 'together', null],
+                    description: 'Image provider. null = automatic (the main AI provider if it can make images, else the first image-capable provider with a saved key).',
+                },
+                model: {
+                    type: ['string', 'null'],
+                    description: "Image model id override (e.g. \"gpt-image-2.5-sunburst\"). null/omitted = the provider's default.",
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['provider'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPut('/v1/ai/image-config', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_listing_ai_detections',
+        description: "Crossly's AI-image detections for a listing's photos — `{ data: [{ id, url, verdict, flagged, status, source, " +
+            "score, generator, evidence, disputedAt, resolvedAt, resolution }] }`. Crossly flags a photo when the file's own " +
+            'metadata says it was generated (Content Credentials / IPTC DigitalSourceType / generator tags) or a hosted ' +
+            'detector scores it over the threshold; a flagged photo on the listing makes the shop show "AI images · detected ' +
+            'by Crossly". Photos with no detection row are simply not in the list.',
+        inputSchema: {
+            type: 'object',
+            properties: { listingId: { type: 'string', format: 'uuid', description: 'A listing the seller owns.' } },
+            required: ['listingId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { listingId } = args;
+            return apiGet(`/v1/listings/${encodeURIComponent(listingId)}/ai-detections`);
+        },
+    },
+    {
+        name: 'dispute_ai_detection',
+        description: 'The seller says a flagged photo is NOT AI-generated: sends it to Crossly review (`status` becomes "disputed"). ' +
+            'The flag and the shop tag stay until Crossly decides. Refused (409) once already reviewed. Only dispute when ' +
+            'the seller confirms the photo is a real photograph.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                detectionId: { type: 'string', format: 'uuid', description: 'The `id` from list_listing_ai_detections.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['detectionId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { detectionId, idempotencyKey } = args;
+            return apiPost(`/v1/ai-detections/${encodeURIComponent(detectionId)}/dispute`, {}, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=ai-image.js.map

package/dist/tools/listings/ai-image.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../../src/tools/listings/bulk.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAQxD,eAAO,MAAM,YAAY,EAAE,OAAO,EAiRjC,CAAC"}

package/dist/tools/listings/bulk.js

@@ -0,0 +1,262 @@
+import { apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+import { BULK_DELIST_PLATFORMS_PROP, BULK_FILTERS_PROP, BULK_LISTING_IDS_PROP, EBAY_QUOTA_PROP, } from './_shared.js';
+export const listingsBulk = [
+    {
+        name: 'list_bulk_relist',
+        description: 'Bulk relist a selection across platforms. Posts the canonical listings + dispatches list jobs for each (listing, platform) ' +
+            'pair. Body shape mirrors the web UI: { listingIds, platforms?, filters?, confirmOverFreeQuota? }. eBay free-tier quota + ' +
+            'selling cap are checked synchronously and the call short-circuits with 402/409 before any fan-out. Pass an idempotencyKey ' +
+            'on retries — this is one of the most expensive operations in the API.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingIds: { type: 'array', items: { type: 'string' }, description: 'Listing UUIDs to relist.' },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional platform allowlist. Omit to relist on every platform that already has a row.',
+                },
+                filters: { type: 'object', description: 'Optional secondary filter narrowing the selection (status / price band / etc.).' },
+                confirmOverFreeQuota: {
+                    type: 'boolean',
+                    description: 'Set true to opt into eBay overage fees when the selection exceeds free-listing tier.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-relist', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_crosspost',
+        description: 'Bulk crosspost a selection to one or more NEW platforms (no delist phase). Unlike bulk-relist, this requires an explicit ' +
+            '`platforms` array. Returns a bulkJobId you can poll for progress. eBay quota + selling-cap guards mirror bulk-relist. ' +
+            'Always pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Master Crossly listing UUIDs to crosspost — the `id` from list_listings / list_listing_ids, '
+                        + 'NOT a platformListingId. At least one required and no upper bound here (unlike the other '
+                        + 'bulk endpoints, which cap at 50,000). Any id not owned by the caller fails the whole call '
+                        + 'with 404 not_found naming the offenders, before anything is dispatched.',
+                },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'REQUIRED — the target marketplaces, e.g. ["poshmark","mercari","ebay"]. Platform ids come '
+                        + 'from the shared platform list (ebay, etsy, shopify, poshmark, mercari, depop, grailed, '
+                        + 'vinted, whatnot, vestiaire, facebook, offerup, curtsy, reverb, stockx, …). An empty array '
+                        + 'is a 400: unlike bulk-relist there is no "everywhere it already lives" default, because '
+                        + 'this endpoint opens NEW channels rather than refreshing existing ones.',
+                },
+                ...BULK_FILTERS_PROP,
+                ...EBAY_QUOTA_PROP,
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds', 'platforms'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-crosspost', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_delist',
+        description: 'Bulk delist a selection from platforms. Omit `platforms` to delist everywhere; supply an array to restrict. ' +
+            'Returns a bulkJobId for progress polling. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...BULK_LISTING_IDS_PROP,
+                ...BULK_DELIST_PLATFORMS_PROP,
+                ...BULK_FILTERS_PROP,
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-delist', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_delete',
+        description: 'Bulk archive (soft-delete) a selection. Local listings go to status=archived inline; platform delists fan out via the ' +
+            'coordinator queue and surface as a bulkJobId. Use this for "tidy up" actions; for irrecoverable deletes use ' +
+            'list_bulk_hard_delete. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...BULK_LISTING_IDS_PROP,
+                ...BULK_DELIST_PLATFORMS_PROP,
+                ...BULK_FILTERS_PROP,
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-delete', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_hard_delete',
+        description: 'Permanently delete archived (or sold) listings. Sales get soft-deleted with tombstones so the cookie-sales poller does ' +
+            'not re-insert them. Refuses with 400/not_archived if any selected listing is still active — archive first via ' +
+            'list_bulk_delete. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Master Crossly listing UUIDs to destroy permanently, 1 to 50,000 — the `id` from '
+                        + 'list_listings, NOT a platformListingId. Archived and sold listings delete freely. If ANY '
+                        + 'is still live (active/draft/inactive) the call fails with 409 listings_live and deletes '
+                        + 'nothing — the error details say how many and on which marketplaces — unless allowLive is '
+                        + 'true. This is the irreversible path — the listing rows are gone, and their sales are '
+                        + 'tombstoned so the pollers cannot resurrect them.',
+                },
+                filters: {
+                    type: 'object',
+                    description: 'Optional narrowing filters (same shape as the other bulk tools). Applied server-side: only '
+                        + 'ids that match are deleted.',
+                },
+                allowLive: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'true = also delete listings that are not archived/sold. Deleting NEVER delists: their '
+                        + 'marketplace copies stay live and Crossly stops tracking them (no sale sync, no auto-delist). '
+                        + 'To take them down too, use list_bulk_delete (archive) instead. Only set this after the '
+                        + 'user has seen the 409 listings_live counts and confirmed.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-hard-delete', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_update',
+        description: 'Bulk text + price update across a listing selection. `updates` carries optional title/description/price ops — title and ' +
+            'description support set/insert_start/insert_end/find_replace/remove; price supports set/drop_percent/drop_amount/' +
+            'raise_percent/raise_amount with rounding=up|down|none. All in one SQL UPDATE — no per-platform fan-out. Pass an ' +
+            'idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...BULK_LISTING_IDS_PROP,
+                ...BULK_FILTERS_PROP,
+                updates: {
+                    type: 'object',
+                    description: 'The edit to apply, as up to three independent ops: { title?, description?, price? } — at '
+                        + 'least one is needed for anything to change. `title` and `description` each take '
+                        + '{ action: "set" | "insert_start" | "insert_end" | "find_replace" | "remove", value?, '
+                        + 'find?, replace? }: set replaces outright, insert_start / insert_end concatenate `value` '
+                        + 'onto the front or back, find_replace swaps every occurrence of `find` for `replace`, '
+                        + 'remove strips every occurrence of `value`. `price` takes { action: "set" | "drop_percent" '
+                        + '| "drop_amount" | "raise_percent" | "raise_amount", value, rounding?: "up" | "down" | '
+                        + '"none" (default "none") }, where `value` is US DOLLARS for set / drop_amount / '
+                        + 'raise_amount and a PERCENT for drop_percent / raise_percent (25 means 25%, not 0.25); the '
+                        + 'result is floored at $0 and rounded to 2 decimal places. Every op runs against the '
+                        + 'EFFECTIVE value (the listing\'s own field falling back to its inventory item default) and '
+                        + 'writes the MASTER listing only — per-platform overrides are left untouched, and only the '
+                        + 'fields named here are pushed out to the marketplaces afterwards.',
+                    properties: {
+                        title: { type: 'object' },
+                        description: { type: 'object' },
+                        price: { type: 'object' },
+                    },
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds', 'updates'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-update', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_check_status',
+        description: 'Queue a status-refresh check against the originating marketplace for each selected listing. Useful for "is this still ' +
+            'really live?" audits after extension issues. Returns a bulkJobId. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...BULK_LISTING_IDS_PROP,
+                ...BULK_FILTERS_PROP,
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-check-status', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_bulk_delist_preview',
+        description: 'Preview which marketplaces a bulk delist would touch — returns per-marketplace activeCount + accountStatus so an agent ' +
+            'can show the seller the blast radius before committing. Read-only. Pass an idempotencyKey for cache-replay safety.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...BULK_LISTING_IDS_PROP,
+                ...BULK_FILTERS_PROP,
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/bulk-delist-preview', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_by_ids',
+        description: 'Hydrated fetch — returns listing rows merged with their parent inventory item defaults + every platformListings row. ' +
+            'Useful for "open this selection in an editor" workflows. Up to 200 ids per call. Pass an idempotencyKey for cache-replay.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 200,
+                    description: 'Master Crossly listing UUIDs to hydrate — the `id` from list_listings / list_listing_ids, '
+                        + 'NOT platformListingIds (those come back on each platformListings row in the response). '
+                        + '1 to 200 per call; 201 or more is a 400. Ids belonging to another user are dropped '
+                        + 'silently rather than erroring, so compare the returned count against what you sent.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['ids'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings/by-ids', body, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=bulk.js.map

package/dist/tools/listings/bulk.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/tools/listings/core.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1E,eAAO,MAAM,YAAY,EAAE,OAAO,EAoVjC,CAAC"}