@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/fulfillment.js

@@ -0,0 +1,71 @@
+import { apiGet, apiPost } from '../api.js';
+/**
+ * Fulfillment: carrier pickups and SCAN forms for labelled orders.
+ *
+ * Tools whose actions use DIFFERENT HTTP methods dispatch through functions
+ * declared above the array, so the v1-parity scanner cannot cross them.
+ */
+const enc = encodeURIComponent;
+function pickup(args) {
+    const a = args;
+    if (a.action === 'ready')
+        return apiGet('/v1/orders/pickup-ready');
+    if (a.action === 'list')
+        return apiGet('/v1/orders/pickups');
+    return apiPost('/api/v1/orders/pickups', {
+        orderIds: a.orderIds, date: a.date, minTime: a.minTime, maxTime: a.maxTime, address: a.address, instructions: a.instructions,
+    }, a.idempotencyKey);
+}
+function scanForms(args) {
+    const a = args;
+    if (a.action === 'create')
+        return apiPost('/api/v1/orders/scan-forms', { orderIds: a.orderIds, shipDate: a.shipDate }, a.idempotencyKey);
+    if (a.action === 'get') {
+        if (!a.id)
+            return Promise.reject(new Error('id is required for get'));
+        return apiGet(`/v1/orders/scan-forms/${enc(a.id)}`);
+    }
+    return apiGet('/v1/orders/scan-forms');
+}
+export const fulfillmentTools = [
+    {
+        name: 'carrier_pickup',
+        description: 'Carrier pickups for orders with a purchased Shippo label. ready: which orders a courier can collect, by carrier. '
+            + 'book: orderIds (one carrier), date YYYY-MM-DD, minTime/maxTime HH:MM (at least an hour, up to 14 days ahead), optional address and '
+            + 'instructions; returns the carrier confirmation number. list: booked pickups. orders:write to book.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['ready', 'book', 'list'], description: 'ready = labelled orders a courier can collect, by carrier; book = schedule a pickup (orderIds, date, minTime, maxTime); list = booked pickups, newest first.' },
+                orderIds: { type: 'array', items: { type: 'string' }, description: 'book: 1-100 order ids (uuid), all on the same carrier.' },
+                date: { type: 'string', description: 'book: pickup date, YYYY-MM-DD, up to 14 days ahead.' },
+                minTime: { type: 'string', description: 'book: window start, HH:MM; the window must be at least an hour.' },
+                maxTime: { type: 'string', description: 'book: window end, HH:MM.' },
+                address: { type: 'object', description: 'book: optional pickup address { street1, city, state, zip, country? (2-letter) }.' },
+                instructions: { type: 'string', description: 'book: optional note for the courier ("side door"), up to 200 characters.' },
+                idempotencyKey: { type: 'string', description: 'book: sent as the Idempotency-Key header. Stable per intent so a retry cannot book twice.' },
+            },
+            required: ['action'],
+        },
+        handler: (args) => pickup(args),
+    },
+    {
+        name: 'scan_forms',
+        description: 'SCAN forms: one barcode the counter scans once, so every parcel gets its acceptance scan. create: optional orderIds (default: every '
+            + 'label not yet on a form) and shipDate; one form per carrier account and ship-from address. Forms build asynchronously, so call get '
+            + 'until status is ready and documentUrl is the printable PDF. list: recent forms. orders:write to create.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['create', 'list', 'get'], description: 'create = build SCAN forms for unscanned labels; list = recent forms, newest first; get = one form, re-read from the carrier until its PDF is ready (id).' },
+                id: { type: 'string', description: 'get: the SCAN form id (uuid).' },
+                orderIds: { type: 'array', items: { type: 'string' }, description: 'create: 1-500 order ids (uuid) to cover; omit for every label not yet on a form.' },
+                shipDate: { type: 'string', description: 'create: optional ship date, YYYY-MM-DD.' },
+                idempotencyKey: { type: 'string', description: 'create: sent as the Idempotency-Key header. Stable per intent so a retry cannot create duplicate forms.' },
+            },
+            required: ['action'],
+        },
+        handler: (args) => scanForms(args),
+    },
+];
+//# sourceMappingURL=fulfillment.js.map

package/dist/tools/fulfillment.js.map

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

package/dist/tools/games.d.ts

@@ -0,0 +1,10 @@
+import { ToolDef } from './types.js';
+/**
+ * Crossly World market games, read-only: Price Guess (guess what a real item
+ * really sold for), scavenger hunts in shops (find every token, unlock the
+ * seller's coupon), pack breaks on a shop's stage, and speed trades at trade
+ * tables. Games are played inside the world; these tools read the record. No
+ * game takes money or pays cash, and a break spot is bought on crossly.net.
+ */
+export declare const gamesTools: ToolDef[];
+//# sourceMappingURL=games.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"games.d.ts","sourceRoot":"","sources":["../../src/tools/games.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,EA2C/B,CAAC"}

package/dist/tools/games.js

@@ -0,0 +1,49 @@
+import { apiGet } from '../api.js';
+/**
+ * Crossly World market games, read-only: Price Guess (guess what a real item
+ * really sold for), scavenger hunts in shops (find every token, unlock the
+ * seller's coupon), pack breaks on a shop's stage, and speed trades at trade
+ * tables. Games are played inside the world; these tools read the record. No
+ * game takes money or pays cash, and a break spot is bought on crossly.net.
+ */
+export const gamesTools = [
+    {
+        name: 'list_my_game_results',
+        description: 'Your Crossly World market-game results, newest first: game (price_guess, price_guess_solo, hunt, speed_trade, ' +
+            'break_host), score, whether you won and any Crossly Bucks prize in cents (0 while prizes are pins only). ' +
+            'meta.unlocks lists hunt coupons you earned (with codes); meta.hits the break hits pulled for spots you bought.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/games/results/mine', {}),
+    },
+    {
+        name: 'list_live_hunts',
+        description: 'Scavenger hunts running now in Crossly World shops: title, shop, how many tokens, what finishing unlocks ' +
+            '("10% off" -- never the code), when it ends and how many people finished. A hunt at a pop-up stall has stall.bookingId '
+            + 'set and its shop slug is the street. Optional place = one shop or street slug.',
+        inputSchema: {
+            type: 'object',
+            properties: { place: { type: 'string', description: 'A shop slug, to list only that shop\'s hunt.' } },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { place } = args;
+            return apiGet('/v1/games/hunts', place ? { place } : {});
+        },
+    },
+    {
+        name: 'list_upcoming_breaks',
+        description: 'Pack breaks staged on shop stages in Crossly World, live first then soonest: the break, its shop, start time, ' +
+            'spots (buyer masked), hits revealed so far, and buyUrl -- the page on crossly.net where spots are bought.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/games/breaks/upcoming', {}),
+    },
+    {
+        name: 'get_game_leaderboards',
+        description: 'Crossly World game leaderboards: top ten per game -- Price Guess (wins, then points), scavenger hunts (finished), ' +
+            'speed trades (won) -- this week (from Monday 00:00 UTC) under week and of all time under all. A name shows only for ' +
+            'somebody who chose to be seen by name in the world; everyone else is "A player" in their place.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/games/leaderboards', {}),
+    },
+];
+//# sourceMappingURL=games.js.map

package/dist/tools/games.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"games.js","sourceRoot":"","sources":["../../src/tools/games.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gHAAgH;YAChH,2GAA2G;YAC3G,gHAAgH;QAClH,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,EAAE,EAAE,CAAC;KACpD;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,2GAA2G;YAC3G,yHAAyH;cACvH,gFAAgF;QACpF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE,EAAE;YACtG,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,KAAK,EAAE,GAAG,IAA0B,CAAC;YAC7C,OAAO,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;KACF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gHAAgH;YAChH,2GAA2G;QAC7G,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,EAAE,CAAC;KACvD;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,oHAAoH;YACpH,sHAAsH;YACtH,iGAAiG;QACnG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,EAAE,EAAE,CAAC;KACpD;CACF,CAAC"}

package/dist/tools/grading.d.ts

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

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

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

package/dist/tools/grading.js

@@ -0,0 +1,184 @@
+import { apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * Crossly Grading — send cards to PSA, CGC, SGC, TAG and others.
+ *
+ * A Grading Run is one bulk submission Crossly sends to a grader at one tier.
+ * Reserving a slot is free; when the run reaches the grader's minimum by its
+ * cutoff it LOCKS and every reserved card is charged on the seller's saved
+ * card. Direct is the seller's own grader account: Crossly tracks the card
+ * and verifies the cert, and takes no money.
+ */
+const MISS_MODE = {
+    type: 'string',
+    enum: ['roll_over', 'release'],
+    description: 'If the run misses its minimum: roll the card into the next open run at this tier (default), or release it.',
+};
+const RETURN_MODE = {
+    type: 'string',
+    enum: ['return', 'vault'],
+    description: 'After grading: ship the slab back to you (default), or keep it in the Crossly vault.',
+};
+export const gradingTools = [
+    {
+        name: 'list_grading_runs',
+        description: 'List Grading Runs taking reservations now, soonest cutoff first: grader, tier, price per card, handling fee, ' +
+            'slots held vs capacity and minimum, cutoff, and what the run saves against sending one card alone. ' +
+            '`meta.open` is false while runs are switched off.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/grading/runs', {}),
+    },
+    {
+        name: 'get_grading_rate_card',
+        description: 'Every grader and tier Crossly can send to, with the per-card price in cents (null = paused at the grader), minimum cards and declared-value cap.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/grading/rate-card', {}),
+    },
+    {
+        name: 'list_grading_submissions',
+        description: 'List your cards out for grading (runs and Direct), newest first, with their status, charges, the inbound ' +
+            'label to mail a card to the hub once its run locks, and the grade once it is back.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                active: { type: 'boolean', description: 'true = only cards still in flight. Omit for every card.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { active } = args;
+            return apiGet('/v1/grading/submissions', active == null ? {} : { active: active ? '1' : '0' });
+        },
+    },
+    {
+        name: 'get_grading_worth',
+        description: 'Is this inventory item worth grading? Its raw market value, what each grade it could come back at is worth at ' +
+            'each grader, the cost, and the lowest grade that breaks even. It never predicts the grade.',
+        inputSchema: {
+            type: 'object',
+            properties: { inventoryItemId: { type: 'string', description: 'Inventory item UUID.' } },
+            required: ['inventoryItemId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { inventoryItemId } = args;
+            return apiGet(`/v1/grading/worth/${encodeURIComponent(inventoryItemId)}`, {});
+        },
+    },
+    {
+        name: 'reserve_grading_slot',
+        description: 'Hold a slot for one card in a Grading Run. Free now; the card is charged on the saved card ONLY if the run ' +
+            'locks. Needs a full-access token and an idempotencyKey (derive it from the card, reuse it on retries).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                runId: { type: 'string', description: 'Grading Run UUID, from list_grading_runs.' },
+                inventoryItemId: { type: 'string', description: 'Inventory item UUID of the card. Omit to name it with `title` instead.' },
+                title: { type: 'string', description: 'The card, when it is not in your inventory. Up to 200 characters.' },
+                declaredValueCents: { type: 'integer', minimum: 0, description: 'What the card is worth, in CENTS (integer). Some tiers cap it.' },
+                prescreen: { type: 'boolean', description: 'A person checks centering and surface before the grader sees it, for a fee.' },
+                missMode: MISS_MODE,
+                returnMode: RETURN_MODE,
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['runId', 'declaredValueCents', 'idempotencyKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { runId, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/grading/runs/${encodeURIComponent(runId)}/reserve`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'cancel_grading_reservation',
+        description: 'Pull a reserved card out of its run. Only while it is still reserved: nothing was charged. Once the run locks it is on its way.',
+        inputSchema: {
+            type: 'object',
+            properties: { submissionId: { type: 'string', description: 'Grading submission UUID.' } },
+            required: ['submissionId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { submissionId } = args;
+            return apiPost(`/v1/grading/submissions/${encodeURIComponent(submissionId)}/cancel`, {});
+        },
+    },
+    {
+        name: 'mark_grading_shipped',
+        description: 'Say you mailed a charged card to the hub (use the inbound label on the submission).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                submissionId: { type: 'string', description: 'Grading submission UUID.' },
+                tracking: { type: 'string', description: 'Optional tracking number for the parcel to the hub.' },
+            },
+            required: ['submissionId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { submissionId, tracking } = args;
+            return apiPost(`/v1/grading/submissions/${encodeURIComponent(submissionId)}/shipped`, { tracking: tracking ?? null });
+        },
+    },
+    {
+        name: 'create_direct_grading',
+        description: 'Track a card you sent on your OWN grader account (Direct). Crossly takes no money; when it comes back, ' +
+            'enter the grade with record_direct_grading_result and the cert is verified.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                graderSlug: { type: 'string', description: 'Grader slug, e.g. psa, cgc_cards, sgc, tag, bgs.' },
+                tierSlug: { type: 'string', description: 'Optional service tier you used at the grader.' },
+                inventoryItemId: { type: 'string', description: 'Inventory item UUID of the card. Omit to name it with `title` instead.' },
+                title: { type: 'string', description: 'The card, when it is not in your inventory. Up to 200 characters.' },
+                declaredValueCents: { type: 'integer', minimum: 0, description: 'What the card is worth, in CENTS (integer).' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['graderSlug', 'declaredValueCents'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/grading/direct', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'record_direct_grading_result',
+        description: 'Direct submissions only: enter the grade that came back. It is written to the inventory item and every ' +
+            'listing of it, and marked verified when the grader\'s cert record agrees.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                submissionId: { type: 'string', description: 'Grading submission UUID (a Direct one).' },
+                grade: { type: 'string', description: "As the grader writes it: '10', '9.8', 'MS-65'. Must be a grade that grader issues." },
+                qualifier: { type: 'string', description: 'Optional label qualifier, e.g. a CGC label tier.' },
+                sealGrade: { type: 'string', description: 'Optional second axis on dual scales (WATA seal grade).' },
+                certNumber: { type: 'string', description: 'Cert number on the slab; used to verify the grade.' },
+            },
+            required: ['submissionId', 'grade'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { submissionId, ...body } = args;
+            return apiPost(`/v1/grading/submissions/${encodeURIComponent(submissionId)}/result`, body);
+        },
+    },
+    {
+        name: 'verify_grading_cert',
+        description: 'Look a cert number up with its grader. Returns found=false when the grader has no record of it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                graderSlug: { type: 'string', description: 'Grader slug, e.g. psa, cgc_cards, sgc, bgs.' },
+                certNumber: { type: 'string', description: 'Cert number on the slab, 4 to 20 characters.' },
+            },
+            required: ['graderSlug', 'certNumber'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { graderSlug, certNumber } = args;
+            return apiPost('/v1/grading/verify-cert', { graderSlug, certNumber });
+        },
+    },
+];
+//# sourceMappingURL=grading.js.map

package/dist/tools/grading.js.map

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

package/dist/tools/homes.d.ts

@@ -0,0 +1,10 @@
+import { ToolDef } from './types.js';
+/**
+ * Homes in Crossly World: every account's own loft, showing what it owns
+ * (inventory, portfolio holdings, graded slabs, furniture bought on Crossly
+ * once delivered). Ownership is re-checked on every read, so sold things are
+ * simply not in the answer. Building and the guestbook happen in
+ * the world.
+ */
+export declare const homesTools: ToolDef[];
+//# sourceMappingURL=homes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"homes.d.ts","sourceRoot":"","sources":["../../src/tools/homes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,EAwD/B,CAAC"}

package/dist/tools/homes.js

@@ -0,0 +1,62 @@
+import { apiGet, apiPut } from '../api.js';
+/**
+ * Homes in Crossly World: every account's own loft, showing what it owns
+ * (inventory, portfolio holdings, graded slabs, furniture bought on Crossly
+ * once delivered). Ownership is re-checked on every read, so sold things are
+ * simply not in the answer. Building and the guestbook happen in
+ * the world.
+ */
+export const homesTools = [
+    {
+        name: 'get_my_home',
+        description: 'Your Crossly World home: address (slug), privacy (open / friends / locked), theme, the room, every placed piece ' +
+            '(props and displays, each display with the item it shows and its live listing slug when listed) and the guestbook. ' +
+            'Made on first read.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/homes/mine', {}),
+    },
+    {
+        name: 'get_home',
+        description: 'A Crossly World home by its address, as you may see it: open homes to anybody, friends-only homes to mutual follows, ' +
+            'locked homes to their owner only. Not found when you may not enter.',
+        inputSchema: {
+            type: 'object',
+            properties: { slug: { type: 'string', description: 'The home\'s address, e.g. dana-loft-3f9a1c.' } },
+            required: ['slug'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { slug } = args;
+            return apiGet(`/v1/homes/${encodeURIComponent(slug)}`, {});
+        },
+    },
+    {
+        name: 'list_home_builders',
+        description: 'The co-builders of your home: friends you let rearrange your Crossly World home (move, turn and take out your things, add free ' +
+            'furniture; never your bought pieces). Each: userId, name, friends (false once the friendship ended).',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/homes/mine/builders', {}),
+    },
+    {
+        name: 'set_home_builders',
+        description: 'Replace the co-builders of your home with these user ids: friends (mutual follows) only, at most 4; an empty list clears them. ' +
+            'Each new co-builder gets a world notice. Needs a token with world:write.',
+        inputSchema: {
+            type: 'object',
+            properties: { userIds: { type: 'array', items: { type: 'string' }, maxItems: 4, description: 'User ids of friends.' } },
+            required: ['userIds'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { userIds } = args;
+            return apiPut('/v1/world/home/builders', { userIds });
+        },
+    },
+    {
+        name: 'list_homes_of_the_week',
+        description: 'Home of the week: open homes ranked by how many different people signed their guestbook in the last 7 days, with how many are inside now.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/homes/of-the-week', {}),
+    },
+];
+//# sourceMappingURL=homes.js.map

package/dist/tools/homes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"homes.js","sourceRoot":"","sources":["../../src/tools/homes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,kHAAkH;YAClH,qHAAqH;YACrH,qBAAqB;QACvB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC;KAC5C;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,uHAAuH;YACvH,qEAAqE;QACvE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE,EAAE;YACpG,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAwB,CAAC;YAC1C,OAAO,MAAM,CAAC,aAAa,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iIAAiI;YACjI,sGAAsG;QACxG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,EAAE,EAAE,CAAC;KACrD;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,iIAAiI;YACjI,0EAA0E;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,EAAE;YACvH,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,OAAO,EAAE,GAAG,IAA6B,CAAC;YAClD,OAAO,MAAM,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,2IAA2I;QACxJ,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,EAAE,CAAC;KACnD;CACF,CAAC"}

package/dist/tools/imports.d.ts

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

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

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

package/dist/tools/imports.js

@@ -0,0 +1,72 @@
+import { apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+export const importsTools = [
+    {
+        name: 'list_imports',
+        description: "List the seller's import jobs (one per 'pull all my Poshmark listings' run, etc.). Use this to check " +
+            'progress of an in-flight import, or to audit what has been imported in the past.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/imports'),
+    },
+    {
+        name: 'get_import',
+        description: 'Get the status + counts of a single import job. Status values: queued | running | completed | ' +
+            'failed | cancelled. `importedCount` / `skippedCount` / `errorCount` track per-listing outcomes.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Import job UUID.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/imports/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'start_import',
+        description: "Kick off an import of the seller's existing listings from a connected platform. Creates inventory " +
+            'items + listing records for every existing listing on that platform, deduping by SKU or platform listing ' +
+            'ID. Best for onboarding flows ("import everything I have on Poshmark"). Returns immediately with a job ' +
+            'id; poll with get_import or list_imports.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform ID — one of poshmark, mercari, depop, grailed, vinted, whatnot, vestiaire, offerup, curtsy, facebook, ebay, etsy, shopify, amazon, walmart.',
+                },
+                marketplaces: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'eBay only: the sites to import, e.g. ["EBAY_GB"]. One eBay account can list each item on several ' +
+                        'sites (ebay.co.uk, ebay.com, ebay.com.au…), each copy its own listing. Call list_import_sites first; ' +
+                        'when it returns more than one site, ask the seller which to import. Omit for every site.',
+                },
+                listOnCrossly: {
+                    type: 'boolean',
+                    description: 'Also list everything the import brings in on the Crossly marketplace, once each item’s details ' +
+                        'have finished coming over. Recommended: an imported listing already has what a listing needs.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/imports', {
+            platform: args.platform,
+            ...(Array.isArray(args.marketplaces) && args.marketplaces.length ? { marketplaces: args.marketplaces } : {}),
+            ...(args.listOnCrossly === true ? { listOnCrossly: true } : {}),
+        }, args.idempotencyKey),
+    },
+    {
+        name: 'list_import_sites',
+        description: "Which sites a connected account's listings are on, with counts (eBay: ebay.co.uk, ebay.com, ebay.com.au… — " +
+            'one item per site, each its own listing). Use before start_import: if more than one site comes back, ask ' +
+            "the seller which to import (often only their home site is the master; the others are copies).",
+        inputSchema: {
+            type: 'object',
+            properties: { platform: { type: 'string', description: 'Platform ID. Default ebay.' } },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/imports/sites', { platform: args.platform ?? 'ebay' }),
+    },
+];
+//# sourceMappingURL=imports.js.map

package/dist/tools/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/tools/imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAW,MAAM,YAAY,CAAC;AAEvD,MAAM,CAAC,MAAM,YAAY,GAAc;IACrC;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,uGAAuG;YACvG,kFAAkF;QACpF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC;KACrC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,gGAAgG;YAChG,iGAAiG;QACnG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE;YACvE,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,kBAAkB,CAAC,IAAI,CAAC,EAAY,CAAC,EAAE,CAAC;KAClF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,oGAAoG;YACpG,2GAA2G;YAC3G,yGAAyG;YACzG,2CAA2C;QAC7C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,sJAAsJ;iBACzJ;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,mGAAmG;wBACnG,uGAAuG;wBACvG,0FAA0F;iBAC7F;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,iGAAiG;wBACjG,+FAA+F;iBAClG;gBACD,GAAG,gBAAgB;aACpB;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,OAAO,CACL,aAAa,EACb;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5G,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,EACD,IAAI,CAAC,cAAoC,CAC1C;KACJ;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,6GAA6G;YAC7G,2GAA2G;YAC3G,+FAA+F;QACjG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE,EAAE;YACvF,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAG,IAAI,CAAC,QAA+B,IAAI,MAAM,EAAE,CAAC;KAC9G;CACF,CAAC"}

package/dist/tools/inbox.d.ts

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

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

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