@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/orders/fulfillment.js

@@ -0,0 +1,240 @@
+import { apiPatch, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+/** Single-order verbs: patch, dispute, rates/labels, history import. */
+export const orderFulfillment = [
+    {
+        name: 'order_update',
+        description: 
+        // Advertised "cancelled/returned" for a long time. Neither is in
+        // OrderStatusEnum (routes/orders.ts) — the route 400s on both — so an
+        // agent reading this description would pick a value it had just been
+        // told was supported and get a validation error it could not explain.
+        // The list below is that enum, verbatim.
+        'PATCH a single order — set status/notes/trackingNumber. Transitions to shipped/delivered/completed/disputed/refunded ' +
+            'fire the matching webhook and automation triggers. Submitting trackingNumber also dispatches platform-side ' +
+            'submit-tracking when a platformOrderId is present. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. Must " +
+                        'be a real UUID or the call fails with invalid_order_id; a soft-deleted order reads as 404.',
+                },
+                status: {
+                    type: 'string',
+                    // Mirrors OrderStatusEnum. Stated as an enum as well as in prose so
+                    // a wrong value is impossible to construct, not merely documented.
+                    enum: [
+                        'needs_fulfillment',
+                        'label_purchased',
+                        'shipped',
+                        'in_transit',
+                        'delivered',
+                        'completed',
+                        'disputed',
+                        'refunded',
+                    ],
+                    description: 'New fulfillment status. This endpoint accepts exactly: "needs_fulfillment" (in the ship ' +
+                        'queue — the state a new sale lands in), "label_purchased" (label bought, parcel not handed ' +
+                        'over yet), "shipped" (stamps shippedAt, moves the item out of Reserved, and tells the ' +
+                        'marketplace when the order has a platformOrderId), "in_transit", "delivered" (stamps ' +
+                        'deliveredAt), "completed" (closed out), "disputed", "refunded" (also stamps the linked sale ' +
+                        'row so it stops counting as revenue). Any other value is rejected. Omit to leave status alone.',
+                },
+                notes: {
+                    type: 'string',
+                    description: "Internal seller note, max 2000 chars. REPLACES the existing note — it is not appended. " +
+                        'Private: never shown to the buyer or sent to the marketplace.',
+                },
+                trackingNumber: {
+                    type: 'string',
+                    description: 'Carrier tracking number, max 100 chars. Supplying it IMPLIES status=shipped even if status ' +
+                        'is omitted, and dispatches a platform-side submit-tracking job when the order has a ' +
+                        'platformOrderId.',
+                },
+                labelCost: {
+                    type: 'number',
+                    description: 'What the seller paid for postage they bought themselves, in dollars. With trackingNumber it is ' +
+                        'that parcel’s cost; alone, it sets the cost on the order’s existing tracking. Counted against ' +
+                        'the sale’s net profit.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPatch(`/v1/orders/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'order_dispute',
+        description: 'Flag a single order as disputed with a reason and optional platformCaseId. Sets isDisputed=true, status=disputed, ' +
+            'and pushes an ORDER_STATUS_UPDATE. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. " +
+                        'Must be a real UUID or the call fails with invalid_order_id.',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Why the order is disputed — free text, 1-1000 chars (e.g. "buyer opened an item-not-as-' +
+                        'described case"). Stored on the order and fires the order.disputed trigger.',
+                },
+                platformCaseId: {
+                    type: 'string',
+                    description: "The MARKETPLACE's own case/claim identifier (eBay case id, PayPal dispute id, Etsy case " +
+                        'number), max 200 chars — a different id space from both the Crossly order UUID and ' +
+                        'platformOrderId. Omit when the dispute was not raised through a platform case.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'reason'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/dispute`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'order_rates',
+        description: 'EasyPost rate quote for an order. Provide weightOz and (length/width/height in inches), or a presetId. The seller\'s ' +
+            'default ship-from address is used. Returns an array of available rates with carrier/service/price. Pass an ' +
+            'idempotencyKey on retries (rate fetches are cheap but rate-limited).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. The " +
+                        "buyer's address on that order is the ship-to.",
+                },
+                weightOz: {
+                    type: 'number',
+                    description: 'Total packed weight in OUNCES — not pounds, not grams. Greater than 0 and at most 1120 ' +
+                        '(~70 lb). Required: every quoted rate is priced off it.',
+                },
+                lengthIn: {
+                    type: 'number',
+                    description: 'Parcel length in INCHES, greater than 0 and at most 108. Omit all three dimensions and ' +
+                        'Crossly auto-picks the parcel it thinks the item ships in (smallest saved box that fits, ' +
+                        "else the item's own dimensions).",
+                },
+                widthIn: {
+                    type: 'number',
+                    description: 'Parcel width in INCHES, greater than 0 and at most 108. See lengthIn for the omit-all behaviour.',
+                },
+                heightIn: {
+                    type: 'number',
+                    description: 'Parcel height in INCHES, greater than 0 and at most 108. See lengthIn for the omit-all behaviour.',
+                },
+                presetId: {
+                    type: 'string',
+                    description: "UUID of one of the seller's saved package presets to source dimensions from. Must belong " +
+                        'to this seller or the call 404s with preset_not_found. Any dimension passed explicitly ' +
+                        'wins over the preset; the preset only fills the blanks.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'weightOz'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/rates`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'order_label',
+        description: 'Purchase a shipping label via EasyPost using a rateId returned by order_rates. CHARGES the seller — confirm before ' +
+            'calling. Once the label is bought we automatically push the tracking number to the originating platform. Pass an ' +
+            'idempotencyKey to make retries safe.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. Must " +
+                        'be the SAME order the rate was quoted for.',
+                },
+                rateId: {
+                    type: 'string',
+                    description: 'The `id` of the chosen entry in the order_rates response (the carrier\'s rate object id, ' +
+                        'e.g. "rate_..."), NOT a carrier or service name. Buying it charges the seller\'s prepaid ' +
+                        "shipping wallet the rate's price in DOLLARS plus a 5% markup; too small a balance comes " +
+                        'back as an error carrying requiredCents and balanceCents, which are CENTS.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'rateId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/label`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'order_pull_platform_label',
+        description: 'Fetch a pre-paid label from cookie-platforms that ship one with the order (Poshmark, Mercari). Stores the URL on the ' +
+            'order row + pushes an ORDER_STATUS_UPDATE. Refuses with 400/platform_does_not_provide_label for platforms without ' +
+            'pre-paid labels — use order_rates + order_label instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. The " +
+                        'order must already carry a platformOrderId (400 missing_platform_order_id otherwise), ' +
+                        'since that is what the marketplace is asked for the label with.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/pull-platform-label`, {}, idempotencyKey);
+        },
+    },
+    {
+        name: 'import_order_history',
+        description: "Manually (re-)pull a connected platform's order history for a day-window. Independent of the " +
+            'one-time post-connect backfill (set_history_import_window) — safe to call repeatedly, since ' +
+            'sale detection dedupes on (platform, platformOrderId, userId): re-importing an already-known ' +
+            'order is a no-op, only genuinely new or previously-out-of-window ones land. days: null = All ' +
+            'time (no limit), a positive integer = days back. No zero/"None" — this call always means "go ' +
+            'get me something". Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Marketplace slug to re-pull, e.g. "ebay", "etsy", "poshmark", "mercari" — one per call, and ' +
+                        'it must be a platform this seller has actually connected.',
+                },
+                days: {
+                    type: ['integer', 'null'],
+                    description: 'How far back to reach, in DAYS: a positive integer up to 3650 (10 years), or null for all ' +
+                        'time. Required and has no zero/"none" — this call always means "go get me something". ' +
+                        'Anything already known dedupes on (platform, platformOrderId, userId), so a repeat is a no-op.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform', 'days'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/orders/import', body, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=fulfillment.js.map

package/dist/tools/orders/fulfillment.js.map

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

package/dist/tools/orders/read.d.ts

@@ -0,0 +1,4 @@
+import { ToolDef } from '../types.js';
+/** Read-only order lookups: lists, one order, parcels, counts, evidence. */
+export declare const orderReads: ToolDef[];
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/orders/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/tools/orders/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,4EAA4E;AAC5E,eAAO,MAAM,UAAU,EAAE,OAAO,EA+K/B,CAAC"}

package/dist/tools/orders/read.js

@@ -0,0 +1,165 @@
+import { apiGet } from '../../api.js';
+import { PAGINATION_PROPS } from '../types.js';
+/** Read-only order lookups: lists, one order, parcels, counts, evidence. */
+export const orderReads = [
+    {
+        name: 'list_orders',
+        description: 'List the seller\'s orders across all marketplaces. Use to find what\'s pending shipment, what shipped, ' +
+            'or to look up a buyer. Filter by status="pending"|"shipped"|"delivered"|"refunded"|"cancelled" and/or ' +
+            'platform. Returns rows with buyer info, shipping address (when available), and tracking state.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...PAGINATION_PROPS,
+                status: {
+                    type: 'string',
+                    description: 'Exact match on the order\'s stored status string — one value, no partial match. Values the ' +
+                        'system writes: "needs_fulfillment" (the default the moment a sale lands — this is the ship ' +
+                        'queue), "label_purchased", "shipped", "in_transit", "delivered", "completed", "disputed", ' +
+                        '"refunded", "cancelled", "returned". Omit for every status.',
+                },
+                platform: {
+                    type: 'string',
+                    description: 'Marketplace slug the order came from, e.g. "ebay", "poshmark", "mercari". One platform only, ' +
+                        'exact match. Omit for all marketplaces.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/orders', {
+            page: args.page,
+            limit: args.limit,
+            status: args.status,
+            platform: args.platform,
+        }),
+    },
+    {
+        name: 'get_order',
+        description: 'Fetch one order by UUID — full buyer details, line items, shipping address, fees, and tracking. ' +
+            'Always call this before submit_tracking or issue_refund so you can show the user what they\'re acting on.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Order UUID from list_orders.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/orders/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'get_order_shipments',
+        description: 'List the PARCELS an order shipped in. An order is not always one box: eBay allows a second ' +
+            'label, Poshmark sells up to ten additional ones, and a bundle can need two. get_order returns ' +
+            'only the PRIMARY parcel, so call this whenever the question involves tracking, label cost, or ' +
+            '"did this ship in more than one package". Each parcel reports carrier, service, tracking ' +
+            'number, label cost and SOURCE — crossly (we bought it), platform (the marketplace issued it), ' +
+            'email (lifted from a label email), or manual (the seller typed it in). Use ' +
+            'totalLabelCostCents for cost of sale: the order\'s own label cost covers the primary parcel ' +
+            'only, so a two-parcel order understates by a whole label. Voided parcels are included with ' +
+            'voidedAt set — they were paid for and refunded.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Order UUID from list_orders.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/orders/${encodeURIComponent(args.id)}/shipments`),
+    },
+    {
+        name: 'check_cancel_eligibility',
+        description: 'Ask the marketplace whether an order can still be cancelled and WHICH reason codes it will accept. ' +
+            'Read-only — cancels nothing. ALWAYS call this before cancel_order: the accepted reasons vary per order ' +
+            '(an unpaid eBay order offers ORDER_UNPAID, a paid one does not), and a reason the marketplace does not ' +
+            'accept is rejected outright. Returns eligible, eligibleCancelReason[], failureReason[], and source ' +
+            '("ebay" = asked the marketplace live; "capability-map" = we only know whether a wire exists).',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Order UUID from list_orders.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/orders/${encodeURIComponent(args.id)}/cancel-eligibility`),
+    },
+    {
+        name: 'order_print_label',
+        description: "The order's shipping label as a print-ready PDF (binary, content-type:application/pdf): cropped to the label, " +
+            "turned upright and fitted to the paper — whatever sheet the marketplace or carrier issued it on (e.g. Whatnot's " +
+            'sideways label on Letter becomes a full 4x6). 404 when the order has no label yet.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: "Crossly order UUID (OUR id, not the marketplace's)." },
+                size: { type: 'string', enum: ['4x6', 'letter', 'a4', 'native'], description: 'Paper size. Default 4x6.' },
+                flip: { type: 'boolean', description: 'Turn the label a half turn (if it comes out upside down).' },
+                parcelId: { type: 'string', description: "A specific parcel's label (from the order's parcels); default the primary." },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const a = args;
+            return apiGet(`/v1/orders/${encodeURIComponent(a.id)}/label/print`, {
+                ...(a.size ? { size: a.size } : {}),
+                ...(a.flip ? { flip: '1' } : {}),
+                ...(a.parcelId ? { parcelId: a.parcelId } : {}),
+            });
+        },
+    },
+    {
+        name: 'order_packing_slip',
+        description: 'Single-order packing slip as PDF (binary response — surfaced as a content-type:application/pdf body). Useful for ' +
+            'shipping workflows when the seller wants to include a slip in the box.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. Must " +
+                        'be a real UUID (invalid_order_id otherwise) and owned by the caller.',
+                },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/orders/${encodeURIComponent(args.id)}/packing-slip`),
+    },
+    {
+        name: 'orders_counts',
+        description: 'Tab badge counts by status (pending / needs_fulfillment / shipped / delivered / disputed / etc.) + an "all" rollup. ' +
+            'Useful for showing the seller their fulfillment queue size before pulling rows.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/orders/counts'),
+    },
+    {
+        name: 'get_proof_of_delivery',
+        description: "Get proof-of-delivery evidence for an order, for when a buyer claims it never arrived. " +
+            "Built from the CARRIER's own record, not from our order status: the delivery scan with its date and " +
+            "location, the full chain of scans, and a signature where the service captured one. " +
+            "Read the `gaps` array before advising the seller to file - it lists exactly why this document is weak " +
+            "(not yet delivered, no scan history captured, no signature). " +
+            "`postalCodeMatches` is TRI-STATE: true means the carrier delivered to the same postal code as the " +
+            "order's address (the strongest single fact available), false means it delivered somewhere else, and " +
+            "null means one side was missing - never report null as a mismatch. " +
+            "Nothing in the response is inferred; a missing field is reported as missing.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: "Crossly order UUID from list_orders — OUR id, not the marketplace's platformOrderId. The " +
+                        "carrier record is reached through the tracking number stored on that order.",
+                },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id } = args;
+            return apiGet(`/v1/orders/${encodeURIComponent(id)}/proof-of-delivery`, { format: 'json' });
+        },
+    },
+];
+//# sourceMappingURL=read.js.map

package/dist/tools/orders/read.js.map

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

package/dist/tools/orders/whatnot.d.ts

@@ -0,0 +1,7 @@
+import { ToolDef } from '../types.js';
+/**
+ * Whatnot shipping: the buyer paid postage, so a Whatnot label is GENERATED
+ * by Whatnot rather than bought. Mirrors /api/v1/orders/:id/whatnot/*.
+ */
+export declare const orderWhatnot: ToolDef[];
+//# sourceMappingURL=whatnot.d.ts.map

package/dist/tools/orders/whatnot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatnot.d.ts","sourceRoot":"","sources":["../../../src/tools/orders/whatnot.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAcxD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,EAkFjC,CAAC"}

package/dist/tools/orders/whatnot.js

@@ -0,0 +1,96 @@
+import { apiGet, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+const ID_PROP = {
+    type: 'string',
+    description: 'Crossly order UUID of a WHATNOT order (400 for any other platform).',
+};
+const PACKAGE_PROPS = {
+    weightOz: { type: 'number', description: 'Package weight in OUNCES.' },
+    lengthIn: { type: 'number', description: 'Box length in inches (send all three or none).' },
+    widthIn: { type: 'number', description: 'Box width in inches.' },
+    heightIn: { type: 'number', description: 'Box height in inches.' },
+};
+/**
+ * Whatnot shipping: the buyer paid postage, so a Whatnot label is GENERATED
+ * by Whatnot rather than bought. Mirrors /api/v1/orders/:id/whatnot/*.
+ */
+export const orderWhatnot = [
+    {
+        name: 'order_whatnot_shipment',
+        description: "Read a Whatnot order's shipment: status, package (weightOz, dimensionsIn), labelUrl, trackingNumber, carrier, " +
+            'canGenerateLabel. If Whatnot already has a label (e.g. the seller made it in Whatnot) it is recorded on the ' +
+            'Crossly order as a side effect (recorded: true).',
+        inputSchema: { type: 'object', properties: { id: ID_PROP }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            // A plain `${encodeURIComponent(id)}` — the v1-parity scanner reads the route from this template.
+            const id = String(args.id);
+            return apiGet(`/v1/orders/${encodeURIComponent(id)}/whatnot/shipment`);
+        },
+    },
+    {
+        name: 'order_whatnot_quote_package',
+        description: 'Quote what changing a Whatnot shipment package would cost the seller, in CENTS (costCents). Whatnot gives a ' +
+            'free allowance of adjustments, then charges. Read-only.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: ID_PROP, ...PACKAGE_PROPS },
+            required: ['id', 'weightOz'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/whatnot/package/quote`, body);
+        },
+    },
+    {
+        name: 'order_whatnot_update_package',
+        description: 'Save a Whatnot shipment package (weight + box). Refuses a change that costs money unless acceptCostCents >= the ' +
+            'quoted cost — quote first with order_whatnot_quote_package.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: ID_PROP,
+                ...PACKAGE_PROPS,
+                acceptCostCents: { type: 'integer', description: 'CENTS the seller agreed Whatnot may charge. Default 0.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'weightOz'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/whatnot/package`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'order_whatnot_generate_label',
+        description: 'Generate the Whatnot shipping label (Whatnot pays base postage) and record it on the order: parcel + tracking, ' +
+            'label link, status label_purchased. Waits up to ~45s. If Whatnot adds a surcharge it refuses unless ' +
+            'acceptSurchargeCents covers it. Already-labelled shipments return the existing label.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: ID_PROP,
+                acceptSurchargeCents: { type: 'integer', description: 'CENTS of surcharge the seller agreed to. Default 0.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/whatnot/label`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'order_whatnot_packing_slip',
+        description: "A fresh link to Whatnot's own packing slip PDF for this order (signed ~1 week; fetch again rather than store).",
+        inputSchema: { type: 'object', properties: { id: ID_PROP }, required: ['id'], additionalProperties: false },
+        handler: (args) => {
+            // A plain `${encodeURIComponent(id)}` — the v1-parity scanner reads the route from this template.
+            const id = String(args.id);
+            return apiGet(`/v1/orders/${encodeURIComponent(id)}/whatnot/packing-slip`);
+        },
+    },
+];
+//# sourceMappingURL=whatnot.js.map

package/dist/tools/orders/whatnot.js.map

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

package/dist/tools/orders.d.ts

@@ -0,0 +1,25 @@
+import { ToolDef } from './types.js';
+/**
+ * Orders — the fulfillment side of a sale.
+ *
+ * ── TWO ID SPACES, AND THEY ARE NOT INTERCHANGEABLE ───────────────────
+ * Every `id`/`orderIds` argument here is OUR order UUID (what list_orders
+ * returns). The marketplace's own identifier is `platformOrderId` on the
+ * row, and a third one — `platformCaseId` — exists for disputes. Passing
+ * a marketplace id where a Crossly UUID is expected fails validation
+ * with invalid_order_id rather than acting on the wrong order.
+ *
+ * ── AN ORDER'S MONEY LIVES ON `sales` ─────────────────────────────────
+ * `orders` is the fulfillment lifecycle; the sale price, platform fee,
+ * tax and shipping charged all live on the 1:1 `sales` row (see
+ * packages/api/src/services/orders/money.ts). Those columns are DECIMAL
+ * DOLLARS — "45.99" is $45.99 — as are the order's own labelCost and the
+ * refund amount. The exceptions that really are CENTS are named for it:
+ * get_order_shipments' totalLabelCostCents, and the requiredCents /
+ * balanceCents a shipping-wallet shortfall reports.
+ *
+ * Split by section to keep each file under the 650-line limit; this
+ * module stays the single import point.
+ */
+export declare const ordersTools: ToolDef[];
+//# sourceMappingURL=orders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/tools/orders.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,EAMhC,CAAC"}

package/dist/tools/orders.js

@@ -0,0 +1,35 @@
+import { orderActions } from './orders/actions.js';
+import { orderBulk } from './orders/bulk.js';
+import { orderFulfillment } from './orders/fulfillment.js';
+import { orderWhatnot } from './orders/whatnot.js';
+import { orderReads } from './orders/read.js';
+/**
+ * Orders — the fulfillment side of a sale.
+ *
+ * ── TWO ID SPACES, AND THEY ARE NOT INTERCHANGEABLE ───────────────────
+ * Every `id`/`orderIds` argument here is OUR order UUID (what list_orders
+ * returns). The marketplace's own identifier is `platformOrderId` on the
+ * row, and a third one — `platformCaseId` — exists for disputes. Passing
+ * a marketplace id where a Crossly UUID is expected fails validation
+ * with invalid_order_id rather than acting on the wrong order.
+ *
+ * ── AN ORDER'S MONEY LIVES ON `sales` ─────────────────────────────────
+ * `orders` is the fulfillment lifecycle; the sale price, platform fee,
+ * tax and shipping charged all live on the 1:1 `sales` row (see
+ * packages/api/src/services/orders/money.ts). Those columns are DECIMAL
+ * DOLLARS — "45.99" is $45.99 — as are the order's own labelCost and the
+ * refund amount. The exceptions that really are CENTS are named for it:
+ * get_order_shipments' totalLabelCostCents, and the requiredCents /
+ * balanceCents a shipping-wallet shortfall reports.
+ *
+ * Split by section to keep each file under the 650-line limit; this
+ * module stays the single import point.
+ */
+export const ordersTools = [
+    ...orderReads,
+    ...orderActions,
+    ...orderBulk,
+    ...orderFulfillment,
+    ...orderWhatnot,
+];
+//# sourceMappingURL=orders.js.map

package/dist/tools/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../src/tools/orders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAc;IACpC,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,gBAAgB;IACnB,GAAG,YAAY;CAChB,CAAC"}

package/dist/tools/passports.d.ts

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

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

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