@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/listings/core.js

@@ -0,0 +1,300 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP, PAGINATION_PROPS } from '../types.js';
+export const listingsCore = [
+    {
+        name: 'list_listings',
+        description: 'List the seller\'s listings across all connected marketplaces. Use this to see what\'s live, ' +
+            'find a listing to edit or delist, or audit coverage per platform. Filter by ' +
+            'platform="poshmark"|"mercari"|"ebay"|"etsy"|"shopify"|"depop"|"grailed"|"vinted"|"whatnot"|"vestiaire"|"facebook"|"offerup" ' +
+            'and/or status="active"|"sold"|"draft", and kind="physical"|"web3" (NFT listings, whose marketplaces are ' +
+            'web3_crossly, web3_opensea, web3_tensor, web3_magic_eden, web3_rarible). Paginated.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...PAGINATION_PROPS,
+                platform: {
+                    type: 'string',
+                    description: 'Restrict to one marketplace, e.g. "ebay", "poshmark" or "web3_opensea". Omit for all platforms.',
+                },
+                status: {
+                    type: 'string',
+                    description: 'Filter by lifecycle: "draft" (never published), "active" (live on at least one '
+                        + 'marketplace), "sold" (the sale cascade closed it), "paused" (held back by the seller) or '
+                        + '"archived" (soft-deleted, recoverable). Most users want "active".',
+                },
+                kind: {
+                    type: 'string',
+                    enum: ['physical', 'web3'],
+                    description: 'Physical goods or Web3 assets (NFT listings). Omit for both.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/listings', {
+            page: args.page,
+            limit: args.limit,
+            platform: args.platform,
+            status: args.status,
+            kind: args.kind,
+        }),
+    },
+    {
+        name: 'get_listing',
+        description: 'Fetch one listing by UUID, including every per-platform row (platformListingId, URL, status). ' +
+            'Use this to find the public URL on each marketplace, or to inspect failure reasons.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Listing UUID from list_listings.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/listings/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'crosspost_listing',
+        description: 'Crosspost an item to one or more marketplaces. This is the primary "list it for me" action. ' +
+            'Pass either an existing inventoryItemId (recommended — preserves linkage so a sale on one platform ' +
+            'auto-delists the others), or a fresh `data` blob WITH createInventoryItem set to true. ' +
+            'Do not create listings with neither: without an inventory item nothing decrements when it sells, ' +
+            'there is no cost basis or aging, and the listing is invisible to every inventory report — ' +
+            'building a catalogue that way produces a shelf that reads as empty. ' +
+            '`platforms` is an array of platform slugs; each ' +
+            'gets a background job. Returns the created listing row plus a job-id per platform — they run async. ' +
+            'ALWAYS pass an idempotencyKey on retries to avoid double-listing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inventoryItemId: {
+                    type: 'string',
+                    description: 'UUID of an existing inventory item. Strongly preferred over passing data alone.',
+                },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 15,
+                    description: 'Slugs of platforms to crosspost to, e.g. ["poshmark","mercari","ebay"]. Each must be a connected account on the seller\'s side.',
+                },
+                data: {
+                    type: 'object',
+                    description: 'Listing payload merged with inventory-item defaults. At minimum: { title, description, price, images }. Extra platform-specific fields (e.g. shipping policies for eBay) are passed through.',
+                },
+                createInventoryItem: {
+                    type: 'boolean',
+                    description: 'Create the inventory item behind this listing from `data`. Use this whenever you are NOT passing an inventoryItemId. Ignored if one is supplied.',
+                },
+                inventoryItemQuantity: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: "Physical units on the shelf. Defaults to data.quantity, then 1.",
+                },
+                compositionQuantity: {
+                    type: 'integer',
+                    minimum: 1,
+                    description: 'Units of the item consumed per sale of this listing. Defaults to 1.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platforms', 'data'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/listings', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'update_listing',
+        description: 'Edit a live listing on one or more platforms (price drop, title fix, image swap). ' +
+            '`changes` is a sparse object of fields to update. Omit `platforms` to push the edit to every platform ' +
+            'this listing is live on; pass an array to restrict (e.g. ["poshmark"]). Each affected platform gets ' +
+            'an async job. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Listing UUID.' },
+                changes: {
+                    type: 'object',
+                    description: 'Sparse object — only the fields you want changed (e.g. { price: 24.99 }). Title/description/images/price are universally supported.',
+                },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional. Restrict the edit to these platforms. Omit for all.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'changes'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPatch(`/v1/listings/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'delist',
+        description: 'End / remove a listing from one or more marketplaces. Without `platforms`, delists from EVERY platform ' +
+            'this listing is currently live on. Each platform gets an async job. Use this for manual takedowns; the ' +
+            'sale cascade auto-delists when an item sells, so you rarely need this for sold items. ' +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Listing UUID.' },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional. Restrict to these platforms. Omit to delist everywhere.',
+                },
+                platformListingIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: "Optional. End only these marketplace copies (the platformListings[].id from get_listing) — e.g. one " +
+                        "eBay site's copy of an item live on several eBay sites (ebay.co.uk, ebay.com …).",
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const q = {};
+            if (Array.isArray(args.platforms) && args.platforms.length > 0)
+                q.platforms = args.platforms.join(',');
+            if (Array.isArray(args.platformListingIds) && args.platformListingIds.length > 0) {
+                q.platformListingIds = args.platformListingIds.join(',');
+            }
+            const query = Object.keys(q).length > 0 ? q : undefined;
+            return apiDelete(`/v1/listings/${encodeURIComponent(args.id)}`, args.idempotencyKey, query);
+        },
+    },
+    {
+        name: 'set_listing_site_price',
+        description: "Set the price of ONE marketplace copy of a listing, in that copy's own currency. A listing can be live on " +
+            'several sites of one marketplace account (eBay: ebay.co.uk, ebay.com, ebay.ca …), each copy its own ' +
+            "listing with its own price. The listing's main price (update_listing) prices the account's own site; " +
+            'use this for any other site. Only that copy is updated on the marketplace.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Listing UUID.' },
+                platformListingId: { type: 'string', description: "The copy's platformListings[].id (from get_listing), not the marketplace item id." },
+                price: { type: 'number', description: "The price, in that copy's currency (platformListings[].currency)." },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'platformListingId', 'price'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPatch(`/v1/listings/${encodeURIComponent(args.id)}/platform-listings/${encodeURIComponent(args.platformListingId)}`, { price: args.price }, args.idempotencyKey),
+    },
+    {
+        name: 'import_listing_by_url',
+        description: 'Attach a real platform listing to an existing Crossly listing by pasting its live URL — fetches the ' +
+            'actual title/price/images/condition from the marketplace (not a URL-only stub) and links it as that ' +
+            'listing\'s platform channel. Use when the seller already has an item live on a marketplace and wants ' +
+            'Crossly to track/manage it going forward. Supported platforms: ebay, etsy, shopify, poshmark, mercari, ' +
+            'depop, grailed, vinted, whatnot, offerup, curtsy, vestiaire, facebook. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Crossly listing UUID to attach onto.' },
+                platform: { type: 'string', description: 'Marketplace slug, e.g. "ebay", "poshmark".' },
+                url: { type: 'string', description: 'The live listing URL on that platform.' },
+                accountSlot: {
+                    type: 'integer',
+                    description: 'Optional — which connected account slot to resolve against. Defaults to 1.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'platform', 'url'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/listings/${encodeURIComponent(id)}/import-by-url`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'listing_magic_fill',
+        description: 'Auto-fill empty fields on ONE platform tab of an existing listing from the master listing\'s own data, ' +
+            'using the same deterministic taxonomy resolvers + AI category/facet pickers Magic List uses — scoped to ' +
+            'just this platform, so it works even if the seller is not currently connected to it (many resolvers are ' +
+            'pure local lookups with no live-connection dependency). Never overwrites a field the seller already set. ' +
+            'Use when a marketplace was added/connected after the listing was created, or a platform tab looks sparse ' +
+            'compared to the master. Not applicable to the master listing itself — platform must be a real marketplace slug.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Crossly listing UUID.' },
+                platform: { type: 'string', description: 'Marketplace slug, e.g. "depop", "grailed".' },
+                note: {
+                    type: 'string',
+                    maxLength: 300,
+                    description: "The seller's own words about the item, e.g. \"it's the 1968 reissue, not the 1964\". "
+                        + 'Passed to the category and attribute pickers as authoritative over anything inferred '
+                        + 'from the title.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/listings/${encodeURIComponent(id)}/magic-fill`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'listing_list_discrepancies',
+        description: 'List detected marketplace-drift discrepancies for a listing — per-field cases where Crossly\'s stored ' +
+            'value (condition/price/title/category/brand/size/quantity) diverges from what the platform\'s own detail ' +
+            'fetch currently reports, found by the periodic listing-health sweep. Use to check whether a seller edited ' +
+            'a listing directly on the marketplace outside Crossly.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Crossly listing UUID.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/listings/${encodeURIComponent(args.id)}/discrepancies`),
+    },
+    {
+        name: 'listing_resolve_discrepancy',
+        description: 'Resolve one detected discrepancy (see listing_list_discrepancies). Each row has a `source`: ' +
+            '\'remote_drift\' rows (the platform\'s own live data disagrees with Crossly) take "accept_remote" ' +
+            '(the platform\'s current value becomes the Crossly override) or "push_ours" (push Crossly\'s stored value ' +
+            'back to the platform). \'override_vs_master\' rows (this listing\'s own stored per-platform override ' +
+            'disagrees with its own master field, no live fetch involved) take "sync_from_master" (clears the stale ' +
+            'override so the effective value falls through to master, and re-pushes live if already published). ' +
+            '"relist" applies to \'remote_drift\' or \'sync_failed\' and is the escape hatch for a value the platform '
+            + 'refuses to edit in place at all (Grailed will not raise a price after a price drop, permanently) — it '
+            + 'delists and posts a fresh listing, minting a NEW listing id and URL and losing the original\'s age, '
+            + 'watchers and saves, so only use it when an in-place push has already failed for that reason. '
+            + '"dismiss" applies to any source — acknowledges the drift and stops nagging unless it drifts further.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Crossly listing UUID.' },
+                discrepancyId: { type: 'string', description: 'Discrepancy row UUID from listing_list_discrepancies.' },
+                action: {
+                    type: 'string',
+                    enum: ['accept_remote', 'push_ours', 'sync_from_master', 'relist', 'dismiss'],
+                    description: 'How to resolve the discrepancy — must match the row\'s source, see above.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'discrepancyId', 'action'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, discrepancyId, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/listings/${encodeURIComponent(id)}/discrepancies/${encodeURIComponent(discrepancyId)}/resolve`, body, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=core.js.map

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

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

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

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

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

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

package/dist/tools/listings/discovery.js

@@ -0,0 +1,153 @@
+import { apiGet, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+export const listingsDiscovery = [
+    {
+        name: 'list_listings_facets',
+        description: "Distinct brands + main categories across this user's listings AND inventory items. Drives filter chips in " +
+            "the listings UI and is the canonical 'what brands does this seller stock?' lookup.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/listings/facets'),
+    },
+    {
+        name: 'list_listing_ids',
+        description: "Filter listings → return the matching id list (no pagination). Use this BEFORE bulk actions to materialize " +
+            "the target set. Filters: status / platform / search (title or brand ilike).",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    description: 'Exact listing lifecycle to match on the MASTER listing row (not the per-platform rows): '
+                        + '"draft" (created in Crossly, never published anywhere), "active" (published and live), '
+                        + '"sold" (the sale cascade closed it out), "paused" (deliberately held back by the seller, '
+                        + 'e.g. vacation mode) or "archived" (soft-deleted — still recoverable, and the only state '
+                        + 'besides "sold" that list_bulk_hard_delete will accept). Omit to match every status.',
+                },
+                platform: {
+                    type: 'string',
+                    description: 'Platform id from the shared platform list — e.g. "ebay", "etsy", "shopify", "poshmark", '
+                        + '"mercari", "depop", "grailed", "vinted", "whatnot", "vestiaire", "facebook", "offerup", '
+                        + '"curtsy". Narrows to listings that have a platform row for that marketplace in ANY state, '
+                        + 'so a delisted or failed channel still matches — this is "has ever been wired to X", not '
+                        + '"is live on X". Omit for all platforms.',
+                },
+                search: {
+                    type: 'string',
+                    description: 'Case-insensitive substring; a listing matches when the term appears anywhere in its title '
+                        + 'OR its brand (SQL ILIKE %term%). Not fuzzy and not tokenized — "nike air" will not match '
+                        + 'a listing whose title says "Air Max" and whose brand says "Nike". Omit for no text filter.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/listings/ids', {
+            status: args.status,
+            platform: args.platform,
+            search: args.search,
+        }),
+    },
+    {
+        name: 'listings_sku_exists',
+        description: "Check whether a SKU is already used by one of this user's items (scoped to the listings+inventory join). " +
+            "Returns { exists: boolean }. Use during import flows to dedupe SKUs before creating duplicate items.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sku: {
+                    type: 'string',
+                    description: "The SKU to test, matched EXACTLY and case-sensitively against this seller's "
+                        + 'inventory_items.sku — no trimming, no normalization, so "ABC-1" and "abc-1" are different '
+                        + 'SKUs. Required: an empty or missing value is a 400 sku_required, not { exists: false }. '
+                        + 'SKUs are only unique per seller, so this says nothing about other users\' items.',
+                },
+            },
+            required: ['sku'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/listings/sku-exists', { sku: args.sku }),
+    },
+    {
+        name: 'check_listing_duplicates',
+        description: "Check whether the seller ALREADY owns something matching this title/photo before you create a listing. " +
+            "Call this first whenever you are creating listings in bulk - an automated caller is the one most likely " +
+            "to list the same item twice without anyone noticing. Each match comes back with a `suggested` action: " +
+            "restock (same item, bump the existing listing's stock instead of making a second one that competes with " +
+            "it), variation (another size of the same thing - chain them via the variation group), or duplicate " +
+            "(they listed this already). Matches are suggestions, not verdicts - surface them to the seller rather " +
+            "than acting unilaterally. An empty matches array means nothing was found; this never errors.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'The title of the listing you are about to create.' },
+                size: { type: 'string', description: 'Its size, if any. Drives the restock-vs-variation suggestion.' },
+                images: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Image URLs. Only the first is used, and it must be publicly reachable.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { title, size, images } = args;
+            return apiPost('/v1/listings/check-duplicates', { title, size, images });
+        },
+    },
+    {
+        name: 'combine_duplicate_listings',
+        description: "Fold DUPLICATE listings of the same item into one, adding their stock together. Use this when a seller " +
+            "has listed the same physical item more than once (a bad import, a re-scan) - two listings for one pile " +
+            "of stock compete with each other and each carries a wrong quantity. This is NOT for sizes or colours: " +
+            "those are a variation group, where each option keeps its own stock. " +
+            "The keeper survives with everyone's stock on it and keeps its sales history, photos and live marketplace " +
+            "listings; the rest are DELISTED from every marketplace and archived (never deleted). " +
+            "Ask the seller which listing to keep - it is not a detail you should pick for them. " +
+            "Returns 409 with a code when something has to happen first: reserved_stock (ship or cancel the open " +
+            "order), chained (dissolve the bundle or variation group), no_inventory_item, sold, keeper_in_sources.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                keepListingId: { type: 'string', description: 'UUID of the listing that survives.' },
+                mergeListingIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'UUIDs of the listings folded into it and archived. Must not include the keeper.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['keepListingId', 'mergeListingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { keepListingId, mergeListingIds, idempotencyKey } = args;
+            return apiPost('/v1/listings/combine', { keepListingId, mergeListingIds }, idempotencyKey);
+        },
+    },
+    {
+        name: 'merge_listings',
+        description: "Merge the SAME item listed on DIFFERENT marketplaces into one Crossly listing (e.g. a ring imported from " +
+            "eBay and again from Vinted as two listings). Every marketplace stays LIVE - nothing is delisted; the kept " +
+            "listing gains the others' marketplace listings and per-marketplace prices, and the rest are archived " +
+            "(never deleted). For duplicates on the SAME marketplace use combine_duplicate_listings instead. " +
+            "Ask the seller which listing to keep. Returns 409 same_platform_live when two of them are live on one marketplace.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                keepListingId: { type: 'string', description: 'UUID of the listing that survives (its title and photos win).' },
+                mergeListingIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'UUIDs of the listings merged into it and archived. Must not include the keeper.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['keepListingId', 'mergeListingIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { keepListingId, mergeListingIds, idempotencyKey } = args;
+            return apiPost('/v1/listings/merge', { keepListingId, mergeListingIds }, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=discovery.js.map

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

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

package/dist/tools/listings.d.ts

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

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

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

package/dist/tools/listings.js

@@ -0,0 +1,26 @@
+/**
+ * Listings tools — re-export shim.
+ *
+ * Split into `listings/` when describing every bulk argument pushed the
+ * single file past the 650-line cap. `listingsTools` is unchanged: same
+ * name, same order, same path templates (v1-parity.test.ts scans the tool
+ * files as text, and it walks this directory recursively).
+ *
+ *   core.ts       one listing at a time — CRUD, crosspost, delist,
+ *                 import-by-url, magic-fill, drift discrepancies
+ *   bulk.ts       /v1/listings/bulk-* fan-out + the hydrated by-ids fetch
+ *   discovery.ts  facets, id materialization, SKU + duplicate checks
+ *   ai-image.ts   BYOK AI listing photos (generate / preview prompt / image provider)
+ *   _shared.ts    argument blocks reused across the bulk tools
+ */
+import { listingsCore } from './listings/core.js';
+import { listingsBulk } from './listings/bulk.js';
+import { listingsDiscovery } from './listings/discovery.js';
+import { listingsAiImage } from './listings/ai-image.js';
+export const listingsTools = [
+    ...listingsCore,
+    ...listingsBulk,
+    ...listingsDiscovery,
+    ...listingsAiImage,
+];
+//# sourceMappingURL=listings.js.map

package/dist/tools/listings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../src/tools/listings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,iBAAiB;IACpB,GAAG,eAAe;CACnB,CAAC"}

package/dist/tools/live-shows.d.ts

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

package/dist/tools/live-shows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-shows.d.ts","sourceRoot":"","sources":["../../src/tools/live-shows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAqCrC,eAAO,MAAM,aAAa,EAAE,OAAO,EAmClC,CAAC"}

package/dist/tools/live-shows.js

@@ -0,0 +1,70 @@
+import { apiGet, apiPost, apiPut } from '../api.js';
+/**
+ * Live shows (W8a): the buyer side (lineup, "sold here" replay moment, one
+ * box per show, gifts sent) and the seller side (set a lineup, ship a show box
+ * with one label). Dispatches through functions declared above the array, so
+ * the v1-parity scanner cannot cross GET / PUT / POST actions.
+ */
+const enc = encodeURIComponent;
+const need = (v, what) => {
+    if (typeof v !== 'string' || !v)
+        throw new Error(`${what} is required for this action`);
+    return enc(v);
+};
+function buyerLive(args) {
+    const a = args;
+    switch (a.action) {
+        case 'lineup': return apiGet(`/v1/buyer/live-streams/${need(a.streamId, "streamId")}/lineup`);
+        case 'moment': return apiGet(`/v1/buyer/purchases/${need(a.purchaseId, "purchaseId")}/live-moment`);
+        case 'shipments': return apiGet('/v1/buyer/live-shipments');
+        case 'gifts_sent': return apiGet('/v1/buyer/gifts/sent');
+        default: throw new Error(`Unknown action ${a.action}`);
+    }
+}
+function sellerLive(args) {
+    const a = args;
+    switch (a.action) {
+        case 'set_lineup': return apiPut(`/v1/live-streams/${need(a.streamId, "streamId")}/lineup`, { platformListingIds: a.platformListingIds ?? [] });
+        case 'shipments': return apiGet('/v1/live-shipments', { ...(a.streamId ? { streamId: a.streamId } : {}), ...(a.status ? { status: a.status } : {}) });
+        case 'buy_label': return apiPost(`/v1/live-shipments/${need(a.shipmentId, "shipmentId")}/label`, {});
+        case 'ship': return apiPost(`/v1/live-shipments/${need(a.shipmentId, "shipmentId")}/ship`, { trackingNumber: a.trackingNumber, ...(a.carrier ? { carrier: a.carrier } : {}) });
+        default: throw new Error(`Unknown action ${a.action}`);
+    }
+}
+export const liveShowTools = [
+    {
+        name: 'live_show_buyer',
+        description: "Buyer side of live shows: lineup lists what a show will sell, in order, with prices and availability; moment says which show a purchase was bought in and the offset in seconds into its replay where it sold (null if not bought live); shipments lists the buyer's one-box-per-show shipments (postage charged once, the rest refunded when it ships); gifts_sent lists items sent as gifts with teaser/opened/thank-you status. Needs buyer:catalog:read (lineup) or buyer:orders:read.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['lineup', 'moment', 'shipments', 'gifts_sent'], description: 'lineup: a show’s items in order. moment: where a purchase sold in a replay. shipments: your show boxes. gifts_sent: gifts you sent.' },
+                streamId: { type: 'string', description: 'lineup: the live show id.' },
+                purchaseId: { type: 'string', description: 'moment: the purchase id (from your orders).' },
+            },
+            required: ['action'],
+            additionalProperties: false,
+        },
+        handler: (args) => buyerLive(args),
+    },
+    {
+        name: 'live_show_seller',
+        description: "Seller side of live shows: set_lineup orders your Crossly listings into a show's lineup (buyers see it before joining; a lineup item sold during the show is recorded at its replay moment); shipments lists each buyer's box of orders from one show; buy_label buys ONE label rated for the whole box; ship marks the box shipped with your own tracking. Shipping a box refunds the buyer's postage on every order but the most expensive one. Needs listings:write (lineup) or orders:read / orders:write.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['set_lineup', 'shipments', 'buy_label', 'ship'], description: 'set_lineup: replace a show’s lineup. shipments: list show boxes. buy_label: one label for a box. ship: ship a box with your own tracking.' },
+                streamId: { type: 'string', description: 'set_lineup (required) / shipments (optional filter): the live show id.' },
+                platformListingIds: { type: 'array', items: { type: 'string' }, description: 'set_lineup: your Crossly platform listing ids, in selling order (max 200).' },
+                status: { type: 'string', enum: ['open', 'shipped'], description: 'shipments: open = still to ship, shipped = done.' },
+                shipmentId: { type: 'string', description: 'buy_label / ship: the show box id (from shipments).' },
+                trackingNumber: { type: 'string', description: 'ship: the tracking number of the label you used.' },
+                carrier: { type: 'string', description: 'ship: the carrier (e.g. USPS, UPS).' },
+            },
+            required: ['action'],
+            additionalProperties: false,
+        },
+        handler: (args) => sellerLive(args),
+    },
+];
+//# sourceMappingURL=live-shows.js.map

package/dist/tools/live-shows.js.map

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

package/dist/tools/magic.d.ts

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

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

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