@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/production.js

@@ -0,0 +1,419 @@
+import { apiGet, apiPost, apiPatch } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * The four axes a landed cost is estimated from, shared by `estimate_production_cost`
+ * and `set_design_spec` so an estimate and the spec it was quoted against cannot
+ * describe the object differently.
+ */
+const SPEC_PROPS = {
+    category: {
+        type: 'string',
+        enum: ['tee', 'hoodie', 'outerwear', 'headwear', 'pants', 'pins', 'jewelry', 'bag', 'socks', 'belt', 'eyewear', 'sneakers', 'slides', 'figure_resin', 'figure_vinyl', 'other'],
+        description: 'What the physical piece IS. It selects the factory cost template — FOB band, tooling, sample cost, worst-case US ' +
+            'duty rate, freight, and the minimum edition the category can be run at. Apparel: `tee`, `hoodie`, `outerwear`, ' +
+            '`pants`, `headwear`, `socks`, `belt`. Accessories: `pins`, `jewelry`, `bag`, `eyewear`. Footwear: `sneakers`, ' +
+            '`slides` — heavy tooling and a 200–300 unit minimum. Collectibles: `figure_resin` (minimum 50), `figure_vinyl` ' +
+            '(minimum 500). `other` is a mid-priced generic template — use it only when nothing else fits.',
+    },
+    materialTier: {
+        type: 'string',
+        enum: ['standard', 'premium', 'luxury'],
+        description: 'Materials grade, applied as a multiplier on the per-unit factory cost: `standard` ×1.0 (blanks, stock trims), ' +
+            '`premium` ×1.5 (heavier/better fabric, branded hardware), `luxury` ×2.2 (top-end materials).',
+    },
+    complexity: {
+        type: 'string',
+        enum: ['simple', 'moderate', 'complex'],
+        description: 'How hard the piece is to build, a second multiplier on the per-unit factory cost: `simple` ×1.0 (few panels, ' +
+            'few operations), `moderate` ×1.3, `complex` ×1.7 (many panels, linings, multi-step finishing).',
+    },
+    packaging: {
+        type: 'string',
+        enum: ['poly', 'box', 'premium_box'],
+        description: 'Packaging tier, added straight onto the per-unit factory cost: `poly` = a polybag (+$0.20 a unit), `box` = a ' +
+            'plain box (+$2.00 a unit), `premium_box` = custom printed and finished box (+$5.00 a unit).',
+    },
+    customHardware: {
+        type: 'boolean',
+        description: 'True if the piece needs bespoke hardware or moulds (zippers, buckles, outsoles). Raises the one-time tooling line by 50%.',
+    },
+};
+/**
+ * Proof-of-Demand physical production — a digital design graduates into a
+ * limited physical run once its on-platform earnings cover the run's cost.
+ * Browse runs, accept terms as a designer, buy a limited unit.
+ */
+export const productionTools = [
+    {
+        name: 'list_production_ballot',
+        description: 'The production ballot: designs waiting for a physical run, most backed first, with your own votes and whether you may vote ' +
+            '(voters must have bought on Crossly). The order is the queue factory quotes are sourced in; funding still decides a run.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/production/ballot', {}),
+    },
+    {
+        name: 'vote_production_design',
+        description: 'Back (support: true) or take back your vote on a design on the production ballot. One vote per person per design.',
+        inputSchema: {
+            type: 'object',
+            properties: { candidateId: { type: 'string', description: 'The ballot entry id (candidateId).' }, support: { type: 'boolean', description: 'true to back the design, false to take your vote back.' } },
+            required: ['candidateId', 'support'],
+            additionalProperties: false,
+        },
+        handler: (a) => apiPost(`/v1/production/candidates/${encodeURIComponent(String(a.candidateId))}/vote`, { support: Boolean(a.support) }),
+    },
+    {
+        name: 'get_listing_provenance',
+        description: 'Crossly provenance behind a shop listing: how many owners it has had on Crossly and since when (never who or for how much). Null when it was not bought here.',
+        inputSchema: { type: 'object', properties: { slug: { type: 'string', description: 'The shop listing slug.' } }, required: ['slug'], additionalProperties: false },
+        handler: (a) => apiGet(`/v1/shop/listings/${encodeURIComponent(String(a.slug))}/provenance`, {}),
+    },
+    {
+        name: 'relist_purchase',
+        description: 'Sell it again: create a DRAFT listing of something you bought on Crossly, from its purchase receipt, carrying that receipt so the ' +
+            'next buyer inherits its provenance. Idempotent per receipt. Price and publish the draft afterwards.',
+        inputSchema: { type: 'object', properties: { receiptId: { type: 'string', description: 'The purchase receipt id of the item you bought on Crossly (your collection lists it).' } }, required: ['receiptId'], additionalProperties: false },
+        handler: (a) => apiPost(`/v1/receipts/${encodeURIComponent(String(a.receiptId))}/relist`, {}),
+    },
+    {
+        name: 'list_production_runs',
+        description: 'Browse open limited-edition PHYSICAL runs — designs that proved enough demand that their earnings funded a real production run.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/production/runs', {}),
+    },
+    {
+        name: 'list_production_candidates',
+        description: 'Your designs that have graduated toward a physical run (yours to accept terms on).',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/production/candidates', {}),
+    },
+    {
+        name: 'accept_production_terms',
+        description: 'Accept a graduated design\'s production terms: edition size, unit cost, retail price, and optional NFT-holder access (priority + holder price).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Production candidate UUID.' },
+                editionSize: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 10000,
+                    description: 'How many physical units this run makes, 1–10000. Must be at least the category\'s factory minimum ' +
+                        '(`minMoq` from estimate_production_cost) or the call is rejected.',
+                },
+                unitCostCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Fallback per-unit landed cost in US CENTS (integer). 4999 means $49.99. Used ONLY when the design has no ' +
+                        'production spec to estimate from — with a spec set the server computes the unit cost itself and this is ignored.',
+                },
+                retailPriceCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Public per-unit retail price in US CENTS (integer). 8500 means $85.00, not $8,500.',
+                },
+                designerRoyaltyBps: {
+                    type: 'integer',
+                    minimum: 0,
+                    maximum: 10000,
+                    description: 'Your royalty per unit sold, in BASIS POINTS of the sale price — not cents and not a percent: 0–10000, ' +
+                        'where 100 bps = 1% and 1000 bps = 10%. Omit to keep the rate already on the candidate.',
+                },
+                holderPriority: { type: 'boolean', description: 'Reserve the run for NFT holders.' },
+                holderPriceCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Discounted per-unit price for holders of the design\'s NFT, in US CENTS (integer). 6500 means $65.00. ' +
+                        'Omit or send null for no holder-specific price.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'editionSize', 'unitCostCents', 'retailPriceCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/production/candidates/${encodeURIComponent(id)}/accept`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'purchase_production_unit',
+        description: 'Buy a limited-edition unit of a physical run. Holder pricing applies automatically. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Run (production candidate) UUID.' },
+                paymentRef: { type: 'string', description: 'The captured payment reference from checkout.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, paymentRef } = args;
+            return apiPost(`/v1/production/runs/${encodeURIComponent(id)}/purchase`, { paymentRef }, idempotencyKey);
+        },
+    },
+    {
+        name: 'list_production_lines',
+        description: 'Your production-lines dashboard: each graduated design with its candidate, run and inventory.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/production/lines', {}),
+    },
+    {
+        name: 'list_production_drops',
+        description: 'Limited-edition physical units you own, with their fulfillment (ship/track/deliver) status.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/production/drops', {}),
+    },
+    {
+        name: 'estimate_production_cost',
+        description: 'Estimate a run\'s landed cost from a spec + edition size. Overshoots deliberately (these are estimates).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...SPEC_PROPS,
+                editionSize: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 10000,
+                    description: 'Units in the hypothetical run, 1–10000. The one-off lines (tooling, samples, QC) spread across it, so the ' +
+                        'per-unit landed cost falls as it rises. The response\'s `minMoq` is the floor the category can actually be run at.',
+                },
+            },
+            required: ['category', 'materialTier', 'complexity', 'packaging', 'editionSize'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { editionSize, ...spec } = args;
+            return apiPost('/v1/production/estimate', { spec, editionSize });
+        },
+    },
+    {
+        name: 'get_production_earnings',
+        description: 'Your CBX earnings from physical production: lifetime royalties, current CBX balance, recent credits, and the lines they came from.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/production/earnings', {}),
+    },
+    {
+        name: 'get_design_prefs',
+        description: 'Read a design\'s production preferences (spec, brief, opt-out).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: { type: 'string', description: 'UUID of the Crossly cosmetic (the digital design) whose production preferences you want.' },
+            },
+            required: ['cosmeticId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { cosmeticId } = args;
+            return apiGet(`/v1/production/designs/${encodeURIComponent(cosmeticId)}/prefs`, {});
+        },
+    },
+    {
+        name: 'set_design_spec',
+        description: 'Set a design\'s production spec (category, materials, complexity, packaging). Run cost self-determines from this.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: {
+                    type: 'string',
+                    description: 'UUID of the Crossly cosmetic (the digital design) to set the spec on. Must be a design you created.',
+                },
+                ...SPEC_PROPS,
+            },
+            required: ['cosmeticId', 'category', 'materialTier', 'complexity', 'packaging'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { cosmeticId, ...spec } = args;
+            return apiPost(`/v1/production/designs/${encodeURIComponent(cosmeticId)}/spec`, spec);
+        },
+    },
+    {
+        name: 'set_design_brief',
+        description: 'Set a design\'s production brief — the designer\'s IRL direction (materials, finish, colorway, box, reference images).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: {
+                    type: 'string',
+                    description: 'UUID of the Crossly cosmetic (the digital design) whose brief you are setting. Must be a design you created.',
+                },
+                materials: {
+                    type: 'string',
+                    description: 'Prose: the materials you want used, e.g. "14oz heavyweight cotton, YKK hardware". Up to 500 characters.',
+                },
+                finish: {
+                    type: 'string',
+                    description: 'Prose: finishing and treatment, e.g. "garment-dyed, enzyme wash, soft-enamel pins". Up to 500 characters.',
+                },
+                colorway: {
+                    type: 'string',
+                    description: 'Prose: the colours and where each one goes, e.g. "bone body, forest rib, gold foil hit". Up to 500 characters.',
+                },
+                packaging: {
+                    type: 'string',
+                    description: 'Prose packaging direction for the factory (box, hangtag, insert, COA), up to 500 characters. This is ' +
+                        'narrative only — the packaging TIER that drives cost is the `packaging` enum on set_design_spec.',
+                },
+                dimensions: {
+                    type: 'string',
+                    description: 'Prose: size or scale direction, e.g. "8in figure" or "S–3XL, boxy fit". Up to 200 characters.',
+                },
+                notes: { type: 'string', description: 'Any other direction for the factory. Up to 4000 characters.' },
+                referenceImageUrls: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    maxItems: 20,
+                    description: 'Up to 20 absolute image URLs the factory should work from — references, mockups, colour chips.',
+                },
+            },
+            required: ['cosmeticId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { cosmeticId, ...brief } = args;
+            return apiPost(`/v1/production/designs/${encodeURIComponent(cosmeticId)}/brief`, brief);
+        },
+    },
+    {
+        name: 'set_design_consent',
+        description: 'Opt a design in or out of physical production.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                cosmeticId: { type: 'string', description: 'UUID of the Crossly cosmetic (the digital design) to opt in or out. Must be a design you created.' },
+                optOut: {
+                    type: 'boolean',
+                    description: 'True bars this design from ever graduating to a physical run; false opts it back in.',
+                },
+            },
+            required: ['cosmeticId', 'optOut'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { cosmeticId, optOut } = args;
+            return apiPost(`/v1/production/designs/${encodeURIComponent(cosmeticId)}/consent`, { optOut });
+        },
+    },
+    {
+        name: 'list_production_pos',
+        description: 'OPS ONLY (admin PAT): list purchase orders, optionally for a single candidate.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                candidateId: {
+                    type: 'string',
+                    description: 'Production-candidate (run) UUID to scope to. Omit to list every PO, newest first.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/production/pos', args),
+    },
+    {
+        name: 'reconcile_production_po',
+        description: 'OPS ONLY (admin PAT): reconcile a PO\'s actuals against the original landed-cost estimate.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                poId: { type: 'string', description: 'Purchase-order UUID to reconcile against the estimate it was greenlit on.' },
+            },
+            required: ['poId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { poId } = args;
+            return apiGet(`/v1/production/pos/${encodeURIComponent(poId)}/reconcile`, {});
+        },
+    },
+    {
+        name: 'create_production_po',
+        description: 'OPS ONLY (admin PAT): open a purchase order for a candidate.',
+        inputSchema: { type: 'object', properties: { id: { type: 'string', description: 'Candidate UUID.' } }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            const { id } = args;
+            return apiPost(`/v1/production/candidates/${encodeURIComponent(id)}/po`, {});
+        },
+    },
+    {
+        name: 'update_production_po',
+        description: 'OPS ONLY (admin PAT): update a PO — supplier, freight mode, per-line actuals, QC and status. actualLandedCents recomputes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                poId: { type: 'string', description: 'Purchase-order UUID to patch. Only the fields you send change.' },
+                supplierName: { type: 'string', description: 'Factory or supplier name, up to 200 characters.' },
+                supplierContact: { type: 'string', description: 'How to reach the supplier — person, email, WeChat, phone. Up to 300 characters.' },
+                freightMode: {
+                    type: 'string',
+                    enum: ['sea', 'air', 'express'],
+                    description: 'How the finished goods travel from the factory: `sea` = ocean freight (cheapest, slowest), `air` = air ' +
+                        'cargo, `express` = door-to-door courier such as DHL/FedEx (fastest, dearest).',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['sourcing', 'quoted', 'sampling', 'sample_approved', 'in_production', 'shipped', 'received', 'cancelled'],
+                    description: 'Where the PO sits in the sourcing loop, in order: `sourcing` (looking for a factory) → `quoted` (a price ' +
+                        'is in) → `sampling` (samples being made) → `sample_approved` (sample signed off) → `in_production` (the ' +
+                        'run is being made) → `shipped` (left the factory) → `received` (landed at the 3PL). `cancelled` ends it.',
+                },
+                actualUnitFobCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual GOODS line for the WHOLE run, in US cents — unit FOB already multiplied by the edition, not a ' +
+                        'per-unit figure despite the name. Feeds actualLandedCents.',
+                },
+                actualToolingCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual one-time tooling, patterns, moulds and trims for the run, in US cents. Feeds actualLandedCents.',
+                },
+                actualSamplesCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual total spent across every sample round, in US cents. Feeds actualLandedCents.',
+                },
+                actualFreightCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual freight for the whole run, in US cents. Feeds actualLandedCents.',
+                },
+                actualDutyCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual US import duty paid on the run, in US cents. Feeds actualLandedCents.',
+                },
+                actualQcCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual third-party QC inspection spend for the run, in US cents. Feeds actualLandedCents.',
+                },
+                actualThreeplCents: {
+                    type: 'integer',
+                    minimum: 0,
+                    description: 'Actual 3PL receive plus pick/pack spend for the run, in US cents. Feeds actualLandedCents.',
+                },
+                sampleRounds: { type: 'integer', minimum: 0, description: 'How many sample rounds were actually run. The estimate budgets 3.' },
+                qcStatus: {
+                    type: 'string',
+                    enum: ['pending', 'passed', 'failed'],
+                    description: 'Third-party inspection result: `pending` = not inspected yet, `passed` = cleared to ship, `failed` = ' +
+                        'rejected at inspection (the run does not ship on this result).',
+                },
+                qcNotes: { type: 'string', description: 'Inspection findings and defect notes. Up to 4000 characters.' },
+                trackingCode: { type: 'string', description: 'Carrier tracking number for the freight leg. Up to 120 characters.' },
+                notes: { type: 'string', description: 'Internal ops notes on this PO. Up to 4000 characters.' },
+            },
+            required: ['poId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { poId, ...body } = args;
+            return apiPatch(`/v1/production/pos/${encodeURIComponent(poId)}`, body);
+        },
+    },
+];
+//# sourceMappingURL=production.js.map

package/dist/tools/production.js.map

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

package/dist/tools/reference.d.ts

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

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

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

package/dist/tools/reference.js

@@ -0,0 +1,138 @@
+import { apiGet } from '../api.js';
+export const referenceTools = [
+    {
+        name: 'list_countries',
+        description: 'Every country (ISO 3166-1 alpha-2) with its delivery-address rules: whether a postal code and a ' +
+            'state/province are required, what they are called locally ("Postcode", "Eircode", "Prefecture"), ' +
+            'and the fixed state list where carriers want one (US, CA, AU, MX, BR, IN, JP). Use before building a ' +
+            'shipping address for a buyer abroad — a UK address needs a postcode but no state. `embargoed: true` ' +
+            'marks destinations Crossly cannot deliver to. Response: `{ data: [{ code, name, currency, regions, ' +
+            'postalRequired, postalLabel, stateRequired, stateLabel, subdivisions? }] }`.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/reference/countries'),
+    },
+    {
+        name: 'list_categories',
+        description: "Return Crossly's canonical two-level category tree (main → sub). Use this when crossposting an item " +
+            'to make sure you pick a category value that is valid platform-wide. Response: `{ main: string[], sub: { Tops: ["T-Shirts", ...], ... } }`.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/categories'),
+    },
+    {
+        name: 'search_brands',
+        description: 'Search the Crossly brand index. Returns up to 50 case-insensitive substring matches. Use when the ' +
+            'user types a brand and you want to suggest a canonical spelling, or when categorizing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first 50 brands alphabetically.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/brands', { search: args.search }),
+    },
+    {
+        name: 'search_styles',
+        description: "Search the eBay-sourced \"Style\" item-specific values (Bohemian, Casual, etc.). Use when " +
+            "filling out eBay item-specifics or any other platform that maps onto eBay's style aspect.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first N styles.' },
+                limit: { type: 'integer', description: 'Cap on results. Default 50, max 500.' },
+                platform: { type: 'string', description: "Default 'ebay'. Currently only eBay is sourced." },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/styles', { search: args.search, limit: args.limit, platform: args.platform }),
+    },
+    {
+        name: 'search_patterns',
+        description: "Search the eBay-sourced \"Pattern\" item-specific values (Solid, Striped, Plaid, etc.). Use when " +
+            "filling out eBay item-specifics for clothing/accessories.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first N patterns.' },
+                limit: { type: 'integer', description: 'Cap on results. Default 50, max 500.' },
+                platform: { type: 'string', description: "Default 'ebay'." },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/patterns', { search: args.search, limit: args.limit, platform: args.platform }),
+    },
+    {
+        name: 'search_departments',
+        description: "Search the eBay-sourced \"Department\" item-specific values (Women, Men, Unisex, etc.).",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first N departments.' },
+                limit: { type: 'integer', description: 'Cap on results. Default 50, max 500.' },
+                platform: { type: 'string', description: "Default 'ebay'." },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/departments', { search: args.search, limit: args.limit, platform: args.platform }),
+    },
+    {
+        name: 'search_genders',
+        description: "Search the eBay-sourced \"Gender\" item-specific values (Female, Male, Unisex, etc.).",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first N genders.' },
+                limit: { type: 'integer', description: 'Cap on results. Default 50, max 500.' },
+                platform: { type: 'string', description: "Default 'ebay'." },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/genders', { search: args.search, limit: args.limit, platform: args.platform }),
+    },
+    {
+        name: 'search_types',
+        description: "Search the eBay-sourced \"Type\" item-specific values (T-Shirt, Sneakers, etc.) — the granular " +
+            "item-type field below department/gender.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first N types.' },
+                limit: { type: 'integer', description: 'Cap on results. Default 50, max 500.' },
+                platform: { type: 'string', description: "Default 'ebay'." },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/types', { search: args.search, limit: args.limit, platform: args.platform }),
+    },
+    {
+        name: 'search_size_systems',
+        description: 'Search the Poshmark + Vestiaire size-system union (US, UK, EU, AU, FR, KR). Use when picking the ' +
+            'size_system field on those platforms.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: { type: 'string', description: 'Search query. Empty returns the first N size systems.' },
+                limit: { type: 'integer', description: 'Cap on results. Default 50, max 500.' },
+                platform: { type: 'string', description: "Scope to 'poshmark' or 'vestiaire'. Default is the cross-platform union." },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/size-systems', { search: args.search, limit: args.limit, platform: args.platform }),
+    },
+    {
+        name: 'list_connections',
+        description: 'List the seller\'s OAuth-connected API platforms (eBay, Etsy, Shopify, Amazon, Walmart). Returns ' +
+            "isActive + shopUrl + last-seen timestamp. For COOKIE platforms (Poshmark/Mercari/etc.) use list_platform_accounts instead.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/connections'),
+    },
+    {
+        name: 'get_automation_catalog',
+        description: 'Discover which triggerType / actionType / conditionType values are valid before creating an automation ' +
+            'rule. Each entry includes a description and `configSchema` (the keys you must supply in the rule\'s ' +
+            'triggerConfig / actionConfig). Call this FIRST when the user asks you to set up automation.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/automation/catalog'),
+    },
+];
+//# sourceMappingURL=reference.js.map

package/dist/tools/reference.js.map

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

package/dist/tools/reprice.d.ts

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

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

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