@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/stalls.js

@@ -0,0 +1,145 @@
+import { apiGet, apiPatch, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * Pop-up stalls in Crossly World — a seller rents a curb spot on a street for a
+ * day, or a spot at a Night Market (Fridays 19:00-23:00 New York) / Swap Meet
+ * (Sundays 13:00-17:00), showing up to 6 of their live listings. Paid up front
+ * on the saved card, Crossly Bucks or CBX (a privately owned spot takes CBX
+ * only). Cancel before it opens for a full refund; final once open.
+ */
+const RAIL = { type: 'string', enum: ['card', 'bucks', 'cbx'], description: 'How to pay: card (your saved card), bucks (Crossly Bucks) or cbx.' };
+export const stallsTools = [
+    {
+        name: 'list_street_stalls',
+        description: 'Today\'s pop-up stalls on a street (e.g. main-street): each stall\'s seller, awning, sign and live listings, plus ' +
+            'meta.free — the spots still free today (and for tonight\'s Night Market or Sunday\'s Swap Meet) with their price in cents.',
+        inputSchema: {
+            type: 'object',
+            properties: { street: { type: 'string', description: 'Street slug, e.g. main-street.' } },
+            required: ['street'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { street } = args;
+            return apiGet(`/v1/streets/${encodeURIComponent(street)}/stalls`, {});
+        },
+    },
+    {
+        name: 'list_street_events',
+        description: 'Current and upcoming Night Markets and Swap Meets on a street, soonest first, with their ids (for booking an event stall).',
+        inputSchema: {
+            type: 'object',
+            properties: { street: { type: 'string', description: 'Street slug.' } },
+            required: ['street'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { street } = args;
+            return apiGet(`/v1/streets/${encodeURIComponent(street)}/events`, {});
+        },
+    },
+    {
+        name: 'quote_stall',
+        description: 'Quote a stall: line items in cents, the rails the spot accepts, and whether it is bookable. Either unit=day with ' +
+            'start (YYYY-MM-DD, street time New York) and days, or unit=event with eventIds from list_street_events.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                street: { type: 'string', description: 'Street slug, e.g. main-street.' },
+                spot: { type: 'integer', description: 'Spot index from list_street_stalls meta.free.' },
+                unit: { type: 'string', enum: ['day', 'event'], description: 'day = whole days (08:00-18:00 street time); event = Night Market / Swap Meet occurrences.' },
+                start: { type: 'string', description: 'YYYY-MM-DD (unit=day).' },
+                days: { type: 'integer', minimum: 1, description: 'Days (unit=day).' },
+                eventIds: { type: 'array', items: { type: 'string' }, description: 'Street event ids (unit=event).' },
+            },
+            required: ['street', 'spot'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const a = args;
+            const query = { street: a.street, spot: a.spot, unit: a.unit ?? 'day' };
+            if (a.unit === 'event')
+                query.events = (a.eventIds ?? []).join(',');
+            else {
+                if (a.start)
+                    query.start = a.start;
+                if (a.days != null)
+                    query.days = a.days;
+            }
+            return apiGet('/v1/stalls/quote', query);
+        },
+    },
+    {
+        name: 'list_my_stalls',
+        description: 'Your stall bookings, newest first, with status, what you paid and were refunded, and visits / offers / sales while the stall was up.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/stalls/mine', {}),
+    },
+    {
+        name: 'book_stall',
+        description: 'Book AND PAY for a pop-up stall (quote_stall first). Charged now on the chosen rail. Needs a full-access token and ' +
+            'an idempotencyKey (derive it from street + spot + dates; reuse it on retries).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                street: { type: 'string', description: 'Street slug, e.g. main-street.' },
+                spotIndex: { type: 'integer', description: 'Spot index from list_street_stalls meta.free.' },
+                rail: RAIL,
+                unit: { type: 'string', enum: ['day', 'event'], description: 'day = whole days (needs startDate + days); event = street events (needs eventIds).' },
+                startDate: { type: 'string', description: 'YYYY-MM-DD (unit=day).' },
+                days: { type: 'integer', minimum: 1, description: 'unit=day.' },
+                eventIds: { type: 'array', items: { type: 'string' }, description: 'unit=event.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['street', 'spotIndex', 'rail', 'unit', 'idempotencyKey'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/stalls/book', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'update_stall',
+        description: 'Change a booked stall before or while it is up: listingIds (up to 6 of your live listings), awning { colour, pattern }, sign text, attendant on/off.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                bookingId: { type: 'string', description: 'Stall booking id (list_my_stalls).' },
+                listingIds: { type: 'array', items: { type: 'string' }, maxItems: 6, description: 'Up to 6 of your live listing ids, shown in this order; sold ones are swapped for your next live listing automatically.' },
+                awning: {
+                    type: 'object',
+                    description: 'Awning colour and pattern.',
+                    properties: {
+                        colour: { type: 'string', enum: ['red', 'orange', 'yellow', 'green', 'teal', 'blue', 'purple', 'pink', 'cream', 'charcoal'] },
+                        pattern: { type: 'string', enum: ['solid', 'stripe', 'scallop', 'check'] },
+                    },
+                    required: ['colour', 'pattern'],
+                },
+                sign: { type: ['string', 'null'], description: 'Up to 32 printable ASCII characters.' },
+                attendant: { type: 'boolean', description: 'true = an AI attendant answers questions at the stall.' },
+            },
+            required: ['bookingId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { bookingId, ...body } = args;
+            return apiPatch(`/v1/stalls/bookings/${encodeURIComponent(bookingId)}`, body);
+        },
+    },
+    {
+        name: 'cancel_stall',
+        description: 'Cancel a stall before it opens: a full refund on the rail it was paid on. Refused once it has opened.',
+        inputSchema: {
+            type: 'object',
+            properties: { bookingId: { type: 'string', description: 'Stall booking id (list_my_stalls).' }, ...IDEMPOTENCY_PROP },
+            required: ['bookingId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { bookingId, idempotencyKey } = args;
+            return apiPost(`/v1/stalls/bookings/${encodeURIComponent(bookingId)}/cancel`, {}, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=stalls.js.map

package/dist/tools/stalls.js.map

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

package/dist/tools/storefront-shipping.d.ts

@@ -0,0 +1,7 @@
+import { ToolDef } from './types.js';
+/**
+ * Where the seller ships from and to on Crossly, and per-listing customs.
+ * Backed by GET/PUT /v1/storefront/shipping and PUT /v1/listings/:id/customs.
+ */
+export declare const storefrontShippingTools: ToolDef[];
+//# sourceMappingURL=storefront-shipping.d.ts.map

package/dist/tools/storefront-shipping.d.ts.map

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

package/dist/tools/storefront-shipping.js

@@ -0,0 +1,94 @@
+import { apiGet, apiPut } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+/**
+ * Where the seller ships from and to on Crossly, and per-listing customs.
+ * Backed by GET/PUT /v1/storefront/shipping and PUT /v1/listings/:id/customs.
+ */
+export const storefrontShippingTools = [
+    {
+        name: 'get_storefront_shipping',
+        description: "Read the seller's Crossly shipping setup: the storefront shipping policy (handling time, domestic and " +
+            'international services, and the international scope — enabled, shipsTo, excludes) and the default ship-from ' +
+            "address. The ship-from country decides what counts as domestic. shippingPolicy is null when never set (Crossly's " +
+            '$5-per-item default applies); shipFrom is null when the seller has no default address.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/storefront/shipping'),
+    },
+    {
+        name: 'update_storefront_shipping',
+        description: "Set the seller's Crossly shipping policy and/or default ship-from address (send either or both). Ship-to " +
+            'scope lives in shippingPolicy.international: domestic only = { enabled: false }; selected countries = ' +
+            "{ enabled: true, shipsTo: ['GB','CA'] }; worldwide except = { enabled: true, shipsTo: 'worldwide', excludes: " +
+            "['RU'] }. Codes are ISO 3166-1 alpha-2; unknown codes are dropped and embargoed destinations (CU, IR, KP, SY) " +
+            'are removed from a ship-to list. A ship-from address is checked per country (400 with the failing fields) and ' +
+            'refused with 422 when the origin is under sanctions. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                shippingPolicy: {
+                    type: ['object', 'null'],
+                    description: 'The WHOLE storefront shipping policy — it replaces the stored one, so read it first with ' +
+                        'get_storefront_shipping and send every key you want to keep; null clears it. Shape: { handlingTimeDays ' +
+                        "1-30, domestic { costType 'flat'|'calculated'|'free', flatRateCents, additionalItemCents, carriers " +
+                        "['USPS'|'UPS'|'FedEx'|'DHL'] (min 1), services[] }, international { costType 'flat'|'calculated'|'free'|" +
+                        "'not_offered', enabled, shipsTo 'worldwide'|string[], excludes string[], services[], importChargesNote }, " +
+                        'localPickup boolean, packageInfo { weightOz, lengthIn, widthIn, heightIn } }. A service is { id, name, ' +
+                        "costType, flatRateCents, additionalItemCents, minDays, maxDays, speed 'standard'|'expedited'|'overnight' }. " +
+                        'Every *Cents value is integer CENTS (2500 = $25.00). Omit to leave the policy unchanged.',
+                },
+                shipFrom: {
+                    type: 'object',
+                    description: "Replaces the seller's default ship-from address: { fullName, company?, street1, street2?, city, state?, " +
+                        "zip?, country?, phone? }. country is ISO alpha-2 and defaults to 'US'. Whether state and zip are required " +
+                        'depends on the country: US needs a state and a 5-digit or ZIP+4 code, GB a postcode but no county, Hong ' +
+                        'Kong neither. Postal codes come back in canonical form (sw1a1aa → SW1A 1AA). Omit to leave it unchanged.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPut('/v1/storefront/shipping', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'set_listing_customs',
+        description: "Set a listing's customs data: HS tariff code, country of origin, and countries this item must not ship to on " +
+            'Crossly (a buyer there cannot check it out, even when the storefront ships to that country). Only the fields ' +
+            'you send change; null clears hsCode / countryOfOrigin and [] clears restrictedCountries. restrictedCountries ' +
+            'needs the listing to be on Crossly already (409 otherwise). Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingId: {
+                    type: 'string',
+                    description: 'UUID of the Crossly listing (the master listing id from list_listings), owned by the caller; 404 otherwise.',
+                },
+                hsCode: {
+                    type: ['string', 'null'],
+                    description: 'Harmonized System tariff code, 6 to 10 digits; dots and spaces are allowed and stripped ("6109.10.00" → ' +
+                        '"61091000"). Printed on customs forms for international labels. null clears it.',
+                },
+                countryOfOrigin: {
+                    type: ['string', 'null'],
+                    description: "Where the item was made, ISO 3166-1 alpha-2 (e.g. 'CN', 'IT'). null clears it.",
+                },
+                restrictedCountries: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: "ISO alpha-2 codes this one item must not ship to (e.g. ['AU'] for an item Australian customs bans). " +
+                        'Replaces the whole list; unknown codes are dropped; [] clears it.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['listingId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { listingId, idempotencyKey, ...body } = args;
+            return apiPut(`/v1/listings/${encodeURIComponent(listingId)}/customs`, body, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=storefront-shipping.js.map

package/dist/tools/storefront-shipping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-shipping.js","sourceRoot":"","sources":["../../src/tools/storefront-shipping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAW,MAAM,YAAY,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAc;IAChD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,wGAAwG;YACxG,8GAA8G;YAC9G,mHAAmH;YACnH,wFAAwF;QAC1F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC;KACjD;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,2GAA2G;YAC3G,wGAAwG;YACxG,+GAA+G;YAC/G,gHAAgH;YAChH,gHAAgH;YAChH,yFAAyF;QAC3F,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,cAAc,EAAE;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACxB,WAAW,EACT,2FAA2F;wBAC3F,yGAAyG;wBACzG,qGAAqG;wBACrG,0GAA0G;wBAC1G,4GAA4G;wBAC5G,yGAAyG;wBACzG,8GAA8G;wBAC9G,0FAA0F;iBAC7F;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,0GAA0G;wBAC1G,4GAA4G;wBAC5G,0GAA0G;wBAC1G,0GAA0G;iBAC7G;gBACD,GAAG,gBAAgB;aACpB;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,IAA6D,CAAC;YAClG,OAAO,MAAM,CAAC,yBAAyB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACjE,CAAC;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,+GAA+G;YAC/G,+GAA+G;YAC/G,+GAA+G;YAC/G,gGAAgG;QAClG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6GAA6G;iBAC3H;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACxB,WAAW,EACT,0GAA0G;wBAC1G,iFAAiF;iBACpF;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACxB,WAAW,EAAE,gFAAgF;iBAC9F;gBACD,mBAAmB,EAAE;oBACnB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,sGAAsG;wBACtG,mEAAmE;iBACtE;gBACD,GAAG,gBAAgB;aACpB;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,IAG9C,CAAC;YACF,OAAO,MAAM,CAAC,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/F,CAAC;KACF;CACF,CAAC"}

package/dist/tools/tax.d.ts

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

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

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

package/dist/tools/tax.js

@@ -0,0 +1,194 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+export const taxTools = [
+    {
+        name: 'list_mileage',
+        description: "List the seller's mileage entries (sourcing trips, store runs, etc.). Use this for tax-prep " +
+            'questions or to audit a year of driving.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                year: {
+                    type: 'integer',
+                    description: 'Calendar tax year to scope to, as a 4-digit integer (e.g. 2025) — NOT a date string. ' +
+                        'Caveat: /v1/mileage accepts this but does not currently filter on it; entries come back ' +
+                        'newest-first across all years, so filter on each row\'s `date` yourself, or call ' +
+                        'get_mileage_summary for a per-year total.',
+                },
+                page: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: 1,
+                    description: '1-indexed page number (offset = (page-1)*limit). Increment to walk older entries; ' +
+                        'rows are ordered by trip date, newest first. Default 1.',
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 200,
+                    default: 100,
+                    description: 'Mileage entries per page. Default 100; the server hard-caps it at 200 (a larger value ' +
+                        'is silently clamped, not rejected).',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/mileage', { year: args.year, page: args.page, limit: args.limit }),
+    },
+    {
+        name: 'get_mileage_summary',
+        description: 'Annual mileage summary: total miles + the IRS standard-mileage deduction in USD. Use for "how much ' +
+            'can I deduct for driving this year?" Returns `{ year, ratePerMile, totalMiles, deduction, entryCount }`.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                year: {
+                    type: 'integer',
+                    description: 'US calendar tax year as a 4-digit integer (e.g. 2025) — NOT a date string. Selects the ' +
+                        'Jan 1 - Dec 31 window the trips are summed over AND the IRS standard business-mileage ' +
+                        'rate applied (2024: $0.67/mi, 2025 and 2026: $0.70/mi; unknown years fall back to the ' +
+                        'last known $0.70/mi). Defaults to the current calendar year. The returned `deduction` ' +
+                        'is USD dollars, not cents.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/mileage/summary', { year: args.year }),
+    },
+    {
+        name: 'get_schedule_c',
+        description: "Generate a Schedule C summary for the seller's reselling business for a tax year. Returns the JSON " +
+            'shape that maps 1:1 to IRS Form Schedule C: gross receipts, returns + allowances, net sales, all 5 ' +
+            'expense lines (platform fees, shipping, COGS, mileage), and net profit (Line 31). Use when the user ' +
+            'asks "how much did I net in 2024" or for end-of-year prep. PDF / CSV downloads are only on the web ' +
+            'app, not the API surface — flag that to the user if asked.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                year: {
+                    type: 'integer',
+                    description: 'US calendar tax year as a 4-digit integer (e.g. 2024) — NOT a date string. Selects the ' +
+                        'Jan 1 - Dec 31 window every Schedule C line is computed over (IRS Form 1040 Schedule C, ' +
+                        'US sole-proprietor scheme). Defaults to the PREVIOUS calendar year, since that is the ' +
+                        'one being filed. All money in the response is USD dollars, not cents.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/tax/schedule-c', { year: args.year }),
+    },
+    {
+        name: 'log_mileage',
+        description: "Log a business mileage trip — a sourcing run, a post-office drop, a thrift haul. The deduction is " +
+            "computed from the year's IRS rate at read time, so do NOT pass a dollar amount; miles and a purpose " +
+            "are what matter. Ask the user for the purpose in their own words: it is what substantiates the " +
+            "deduction if they are ever asked to.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                date: {
+                    type: 'string',
+                    description: 'Trip date as an ISO calendar date, exactly YYYY-MM-DD (e.g. "2025-03-14"). A timestamp ' +
+                        'or any other format is rejected by the server regex. This date alone decides which tax ' +
+                        'year the trip lands in for get_mileage_summary / get_schedule_c.',
+                },
+                miles: {
+                    type: 'number',
+                    description: 'Distance driven, in MILES (not kilometres, and never a dollar figure — the deduction is ' +
+                        'derived from the year\'s IRS rate at read time). Must be > 0 and <= 10000; decimals are ' +
+                        'fine (e.g. 12.4).',
+                },
+                purpose: {
+                    type: 'string',
+                    description: "Why the trip was made, in the seller's own words, e.g. 'sourcing at Goodwill' — this is " +
+                        'the substantiation if the deduction is ever questioned. Required, 1-200 characters.',
+                },
+                startLocation: {
+                    type: 'string',
+                    description: 'Optional free-text origin of the trip (e.g. "Home" or "123 Main St, Austin TX"). Max 200 ' +
+                        'characters. Not geocoded and not used to compute miles — purely a record for the audit trail.',
+                },
+                endLocation: {
+                    type: 'string',
+                    description: 'Optional free-text destination of the trip (e.g. "Goodwill on Burnet"). Max 200 characters. ' +
+                        'Not geocoded and not used to compute miles.',
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Optional free-text memo kept with the entry (context, receipts, who was along). Max 2000 ' +
+                        'characters. Does not affect the deduction.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['date', 'miles', 'purpose'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/mileage', args),
+    },
+    {
+        name: 'update_mileage',
+        description: "Amend a logged trip. Only the fields you pass change. Use list_mileage first to get the id — and " +
+            "show the user the current values before editing a tax record.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Mileage entry UUID from list_mileage.' },
+                date: {
+                    type: 'string',
+                    description: 'New trip date, exactly YYYY-MM-DD (e.g. "2025-03-14"). Omit to leave unchanged. Changing ' +
+                        'it can move the trip into a different tax year, which restates that year\'s deduction.',
+                },
+                miles: {
+                    type: 'number',
+                    description: 'New distance in MILES (not kilometres, never dollars); > 0 and <= 10000, decimals allowed. ' +
+                        'Omit to leave unchanged. Replaces the old value — it is not added to it.',
+                },
+                purpose: {
+                    type: 'string',
+                    description: 'New business purpose, 1-200 characters. Omit to leave unchanged. This is the text that ' +
+                        'substantiates the deduction, so prefer the seller\'s own wording.',
+                },
+                startLocation: {
+                    type: 'string',
+                    description: 'New free-text trip origin, max 200 characters. Omit to leave unchanged.',
+                },
+                endLocation: {
+                    type: 'string',
+                    description: 'New free-text trip destination, max 200 characters. Omit to leave unchanged.',
+                },
+                notes: {
+                    type: 'string',
+                    description: 'New free-text memo, max 2000 characters. Omit to leave unchanged.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, ...body } = args;
+            return apiPatch(`/v1/mileage/${encodeURIComponent(id)}`, body);
+        },
+    },
+    {
+        name: 'delete_mileage',
+        description: "Delete a logged trip. IRREVERSIBLE, and it is a tax record rather than a draft — confirm with the " +
+            "user, quoting the date/miles/purpose, before calling this.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'UUID of the mileage entry to delete, from list_mileage. Must belong to the calling ' +
+                        'seller — another user\'s id 404s. Deleting removes the trip from every later ' +
+                        'get_mileage_summary and get_schedule_c for that tax year.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/mileage/${encodeURIComponent(args.id)}`),
+    },
+];
+//# sourceMappingURL=tax.js.map

package/dist/tools/tax.js.map

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

package/dist/tools/taxonomy.d.ts

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

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

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

package/dist/tools/taxonomy.js

@@ -0,0 +1,131 @@
+import { apiGet } from '../api.js';
+export const taxonomyTools = [
+    {
+        name: 'list_platform_categories',
+        description: 'Top-level categories for a marketplace. eBay + Etsy return live taxonomy from the platform; cookie platforms ' +
+            '(Poshmark, Mercari, Depop, Grailed, Vinted, Whatnot, Vestiaire, OfferUp, Facebook, Curtsy) return the static ' +
+            'enum the recipe layer uses. Use this as the first step of a programmatic listing flow — pick a category, ' +
+            'walk children if not a leaf, then get_platform_category_aspects on the leaf.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: "Platform slug: ebay / etsy / poshmark / mercari / depop / grailed / vinted / whatnot / vestiaire / offerup / facebook / curtsy.",
+                },
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/taxonomy/${encodeURIComponent(args.platform)}/categories`),
+    },
+    {
+        name: 'list_platform_category_children',
+        description: 'One level of children under a category node. Walks deeper into the platform taxonomy. eBay nodes are string ' +
+            'ids; Etsy nodes are numeric ids; cookie platforms typically return [] (no real tree).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform slug the category id belongs to: ebay / etsy / poshmark / mercari / depop / grailed / ' +
+                        'vinted / whatnot / vestiaire / offerup / facebook / curtsy. Anything else is rejected with ' +
+                        '400 unsupported_platform.',
+                },
+                categoryId: {
+                    type: 'string',
+                    description: "A node id in THAT platform's own id space — never reuse an id across platforms. eBay: the " +
+                        'categoryId string from eBay\'s Taxonomy API (e.g. "15709"). Etsy: the numeric taxonomy-node id ' +
+                        'as a string (the server parses it with Number(), so a non-numeric value yields NaN and an ' +
+                        'empty result). Cookie platforms: the `id` exactly as returned by list_platform_categories for ' +
+                        'that platform. Only platforms whose categories are a flat parent-linked list (e.g. Mercari, ' +
+                        'Depop) return children; structurally top-only ones (Poshmark departments, Grailed depts) ' +
+                        'return [].',
+                },
+            },
+            required: ['platform', 'categoryId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/taxonomy/${encodeURIComponent(args.platform)}/categories/${encodeURIComponent(args.categoryId)}/children`),
+    },
+    {
+        name: 'get_platform_category_aspects',
+        description: 'Item-specific aspects (eBay) / properties (Etsy) / hard-coded enums (cookie platforms) for a category. Each ' +
+            'aspect carries: name, required, dataType, hasEnumValues, enumValues (when constrained), cardinality. The ' +
+            'required ones MUST be filled in the listing body for the platform to accept it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform slug whose aspect schema you want: ebay / etsy / poshmark / mercari / depop / grailed / ' +
+                        'vinted / whatnot / vestiaire / offerup / facebook / curtsy. Anything else is rejected with ' +
+                        '400 unsupported_platform.',
+                },
+                categoryId: {
+                    type: 'string',
+                    description: "The LEAF category id in that platform's own id space — aspects are per-leaf, so a branch node " +
+                        'usually returns few or none. eBay: the Taxonomy API categoryId string; Etsy: the numeric ' +
+                        'taxonomy-node id as a string (parsed with Number()); cookie platforms: the `id` returned by ' +
+                        'list_platform_categories for that same platform. Ids are NOT interchangeable between platforms.',
+                },
+            },
+            required: ['platform', 'categoryId'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/taxonomy/${encodeURIComponent(args.platform)}/categories/${encodeURIComponent(args.categoryId)}/aspects`),
+    },
+    {
+        name: 'suggest_platform_categories',
+        description: 'Reverse lookup — suggest categories for a search phrase (a listing title works). eBay uses its Taxonomy API; ' +
+            'Poshmark, Mercari, Depop, Grailed, Vinted, Whatnot, Vestiaire, OfferUp, Facebook and Curtsy search Crossly\'s ' +
+            'harvested copy of their category tree, scored by the phrase\'s words in each category and its parents, each hit ' +
+            'with a root-first breadcrumb and whether it is a leaf. Etsy returns an empty list: browse its tree instead.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform slug to search within: ebay / etsy / poshmark / mercari / depop / grailed / vinted / ' +
+                        'whatnot / vestiaire / offerup / facebook / curtsy (400 unsupported_platform otherwise). Every one ' +
+                        'but etsy returns suggestions. Suggested ids come back in the chosen platform\'s id space.',
+                },
+                q: { type: 'string', description: 'Free-text search phrase (e.g. "vintage levi denim jacket"). Omitting it or passing an empty string short-circuits to an empty result list without calling the platform.' },
+            },
+            required: ['platform', 'q'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/taxonomy/${encodeURIComponent(args.platform)}/suggest`, { q: args.q }),
+    },
+    {
+        name: 'get_platform_required_fields',
+        description: 'Normalized listing schema for a platform — the union of master fields (title/description/price/condition/' +
+            'images/brand/size/color) and platform-specific overrides (e.g. Poshmark department, Mercari shipping class). ' +
+            'Pass categoryId to inline the aspect list as `inlineAspects`. This is the recommended one-shot call before ' +
+            'building a listing payload — it tells the agent everything that needs to be on the body.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform slug whose listing schema you want: ebay / etsy / poshmark / mercari / depop / grailed / ' +
+                        'vinted / whatnot / vestiaire / offerup / facebook / curtsy (400 unsupported_platform otherwise). ' +
+                        'Drives both the `requiredFields` union and the id space `categoryId` is read in.',
+                },
+                categoryId: {
+                    type: 'string',
+                    description: "Optional leaf category id in THIS platform's own id space (eBay Taxonomy categoryId string, Etsy " +
+                        'numeric taxonomy-node id as a string, or the cookie-platform id from list_platform_categories). ' +
+                        'When set, that category\'s aspects are returned inline as `inlineAspects`; when omitted, ' +
+                        '`inlineAspects` is [] and only the platform-level field union comes back.',
+                },
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/taxonomy/${encodeURIComponent(args.platform)}/required-fields`, {
+            categoryId: args.categoryId,
+        }),
+    },
+];
+//# sourceMappingURL=taxonomy.js.map

package/dist/tools/taxonomy.js.map

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

package/dist/tools/team.d.ts

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