@crossly/mcp 0.0.0-stage → 0.1.0

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"}

package/dist/tools/passports.js

@@ -0,0 +1,66 @@
+import { apiGet, apiPost } from '../api.js';
+/**
+ * Product passports (V27): NFC / QR tags on physical items that open their
+ * provenance on Crossly. Seller tool `passports` registers them (SELLER
+ * token, listings scopes); buyer tool `product_passport` reads and claims.
+ *
+ * Tools dispatch through functions declared above the array, so the
+ * v1-parity scanner cannot cross GET and 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 sellerPassports(args) {
+    const a = args;
+    if (a.action === 'register')
+        return apiPost('/v1/passports', { platformListingId: a.platformListingId, ...(a.tagUid ? { tagUid: a.tagUid } : {}) });
+    if (a.action === 'revoke')
+        return apiPost(`/v1/passports/${need(a.id, "id")}/revoke`, {});
+    if (a.action === 'bind_tag')
+        return apiPost(`/v1/passports/${need(a.id, "id")}/tag`, { tagUid: need(a.tagUid, 'tagUid'), ...(a.locked !== undefined ? { locked: a.locked } : {}), written: true });
+    return apiGet('/v1/passports', a.platformListingId ? { platformListingId: a.platformListingId } : {});
+}
+function buyerPassport(args) {
+    const a = args;
+    if (a.action === 'claim')
+        return apiPost(`/v1/buyer/passports/${need(a.code, "code")}/claim`, a.tagUid ? { tagUid: a.tagUid } : {});
+    return apiGet(`/v1/buyer/passports/${need(a.code, "code")}`);
+}
+export const passportTools = [
+    {
+        name: 'passports',
+        description: "Seller: product passports for Crossly listings you sell. register returns a code and the URL to write to an NFC tag (NDEF URI) or print as a QR — optionally binding the tag's UID; list shows them (optionally for one listing); revoke cancels a lost or misprinted tag before the item sells. After a sale the passport follows the item's receipts: it cannot be transferred on its own. Needs listings:read / listings:write.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['list', 'register', 'bind_tag', 'revoke'], description: 'list: your passports. register: issue one for a listing. bind_tag: bind it to the NFC tag you wrote its nfcUrl to. revoke: cancel one before the item sells.' },
+                platformListingId: { type: 'string', description: 'register (required) / list (optional filter): the Crossly platform listing id.' },
+                tagUid: { type: 'string', description: "register: the NFC tag's UID as hex (4, 7 or 10 bytes, colons optional), to bind the passport to that physical tag." },
+                id: { type: 'string', description: 'bind_tag / revoke: the passport id (from list).' },
+                locked: { type: 'boolean', description: 'bind_tag: the tag was made read-only after writing.' },
+            },
+            required: ['action'],
+            additionalProperties: false,
+        },
+        handler: (args) => sellerPassports(args),
+    },
+    {
+        name: 'product_passport',
+        description: "Buyer: what a product passport tag opens — the item, whether it was authenticated, owners on Crossly and since when (never who or for how much), and whether it is in its current owner's hands. claim marks it so, and only works for the item's current owner (the buyer of its latest sale). get needs buyer:catalog:read, claim buyer:activity:write.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['get', 'claim'], description: 'get: read the passport. claim: as the current owner, mark it in your hands.' },
+                code: { type: 'string', description: 'The passport code — the last part of the tag URL /shop/passport/<code>.' },
+                tagUid: { type: 'string', description: "claim: the tag's UID if your reader reports it; checked against the tag the passport was bound to." },
+            },
+            required: ['action', 'code'],
+            additionalProperties: false,
+        },
+        handler: (args) => buyerPassport(args),
+    },
+];
+//# sourceMappingURL=passports.js.map

package/dist/tools/passports.js.map

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

package/dist/tools/pat.d.ts

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

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

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

package/dist/tools/pat.js

@@ -0,0 +1,103 @@
+import { apiDelete, apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+export const patTools = [
+    {
+        name: 'list_pat_scopes',
+        description: 'List the canonical PAT scope catalog — each entry has { id, label, description }. Use this before create_pat to ' +
+            "show the user which scopes are available and what they unlock. Scopes follow the resource:action pattern (e.g. " +
+            "'listings:read', 'orders:write').",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/pat/scopes'),
+    },
+    {
+        name: 'list_pats',
+        description: "List the seller's Personal Access Tokens. Returns the preview only (id, name, prefix, scopes, environment, " +
+            'lastUsedAt, expiresAt, revokedAt, createdAt) — NEVER the full token. Use this to show "active sessions" in a UI.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/pat'),
+    },
+    {
+        name: 'create_pat',
+        description: 'Mint a new PAT. The response includes the FULL token exactly ONCE — surface it to the user with a "copy this now" ' +
+            'warning. Subsequent list_pats calls only return the preview. scopes must be a non-empty subset of the catalog ids ' +
+            '(see list_pat_scopes). environment defaults to "live". expiresAt is optional; null = never expires until revoked. ' +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    maxLength: 80,
+                    description: 'Human label for the token, 1-80 characters — what the seller sees in the token list when deciding ' +
+                        'what to revoke (e.g. "Claude desktop", "nightly repricer"). Not unique and not part of the token string.',
+                },
+                scopes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    description: 'Controlled vocabulary — every entry must be an id from the catalog the API enforces, and one unknown ' +
+                        'string rejects the whole call. At least one is required. Seller scopes: "*" (full access), ' +
+                        '"inventory:read"/"inventory:write", "listings:read"/"listings:write", "orders:read"/"orders:write", ' +
+                        '"inbox:read"/"inbox:write", "sales:read"/"sales:write", "analytics:read", "activity:read", ' +
+                        '"accounts:read"/"accounts:write", "automation:read"/"automation:write", "billing:write" (upgrade only, ' +
+                        'never downgrade/cancel), "payouts:write" (start payout-account onboarding), "webhooks:read"/"webhooks:write", "integrations:read"/"integrations:write", ' +
+                        '"customers:read"/"customers:write", "tax:read"/"tax:write", "catalog:read", ' +
+                        '"policy-presets:read"/"policy-presets:write". Buyer scopes act on a shopper rather than a store and ' +
+                        'are a separate principal: "buyer:profile:read", "buyer:orders:read", "buyer:cart:read"/"buyer:cart:write", ' +
+                        '"buyer:wishlist:read"/"buyer:wishlist:write", "buyer:cashback:read"/"buyer:cashback:write", ' +
+                        '"buyer:offers:read"/"buyer:offers:write", "buyer:auctions:read", "buyer:orders:write", ' +
+                        '"buyer:feedback:write", "buyer:history:write", "buyer:follows:read"/"buyer:follows:write", ' +
+                        '"buyer:activity:read"/"buyer:activity:write", "buyer:catalog:read", ' +
+                        '"buyer:monitors:read"/"buyer:monitors:write", "buyer:checkout:write" (spends money — also gates ' +
+                        'auction bids). Call ' +
+                        'list_pat_scopes for the live catalog rather than trusting this list to stay current, and grant the ' +
+                        'narrowest set that works — a scope cannot be added to a token later, only re-minted.',
+                },
+                environment: {
+                    type: 'string',
+                    enum: ['live', 'test'],
+                    default: 'live',
+                    description: 'A LABEL baked into the token string (crossly_pat_<env>_<prefix>_<secret>), not a sandbox. "live" ' +
+                        '(the default) and "test" both authenticate against the same production account and the same real ' +
+                        'data — "test" exists so a scratch token is recognisable at a glance and easy to revoke, and it ' +
+                        'protects nothing on its own.',
+                },
+                expiresAt: {
+                    type: ['string', 'null'],
+                    description: 'Absolute expiry as an ISO 8601 datetime string (e.g. "2027-01-31T00:00:00Z") — an absolute moment, ' +
+                        'NOT a TTL in seconds or days. null or omitted = never expires until it is revoked. Anything that is ' +
+                        'not a valid ISO 8601 datetime is rejected.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['name', 'scopes'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/pat', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'delete_pat',
+        description: 'Revoke a PAT by id. Sets revokedAt = now() — the token immediately stops working. Cannot be undone (the seller must ' +
+            'mint a fresh one). Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'UUID of the token to revoke, from the `id` field of list_pats — NOT the `prefix` and NOT the token ' +
+                        'secret itself (the secret was only ever shown once, at mint time). Must be one of your own ' +
+                        'not-yet-revoked tokens; anything else 404s. Revoking the token this session is authenticating with ' +
+                        'will lock you out immediately.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/pat/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+];
+//# sourceMappingURL=pat.js.map

package/dist/tools/pat.js.map

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

package/dist/tools/payout.d.ts

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

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

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