@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/scan.d.ts

@@ -0,0 +1,14 @@
+import { ToolDef } from './types.js';
+/**
+ * 3D scan tools.
+ *
+ * Read only. Frames come from a camera a person is holding, so an agent cannot
+ * produce a capture — and letting one START a capture would spend generation
+ * budget with nobody present.
+ *
+ * The descriptions lean hard on one fact, because a model will otherwise report
+ * it as a bug: a capture can be `ready` with NO mesh, and that is the normal,
+ * cheap, intended outcome for most items.
+ */
+export declare const scanTools: ToolDef[];
+//# sourceMappingURL=scan.d.ts.map

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

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

package/dist/tools/scan.js

@@ -0,0 +1,85 @@
+import { apiGet } from '../api.js';
+/**
+ * 3D scan tools.
+ *
+ * Read only. Frames come from a camera a person is holding, so an agent cannot
+ * produce a capture — and letting one START a capture would spend generation
+ * budget with nobody present.
+ *
+ * The descriptions lean hard on one fact, because a model will otherwise report
+ * it as a bug: a capture can be `ready` with NO mesh, and that is the normal,
+ * cheap, intended outcome for most items.
+ */
+export const scanTools = [
+    {
+        name: 'list_scan_captures',
+        description: 'List the seller\'s 3D capture sessions, newest first. `status` is capturing, uploaded, '
+            + 'processing, ready, failed or rejected, and `rejectReason` explains a refusal in the '
+            + 'words the seller saw. IMPORTANT: a capture with status "ready" and no mesh is NORMAL '
+            + 'and not an error — most items are textured onto a shape their category already fixes, '
+            + 'which costs nothing and looks the same. Only report a problem for "failed" or '
+            + '"rejected". When an item that WOULD have had geometry generated did not, '
+            + '`generationSkipped` says why, in the words the seller saw — out of the monthly '
+            + 'allowance, too few genuinely different angles to reconstruct from, or they had '
+            + 'already had a model built from this same object. That is still a SUCCESSFUL '
+            + 'capture: photos and a textured model exist. Suggest the fix it names rather than '
+            + 'describing it as a failure. Requires the listings:read scope.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    description: 'Filter to one status, e.g. "rejected" to see what needs redoing.',
+                },
+                limit: { type: 'integer', minimum: 1, maximum: 100, default: 25, description: 'Rows to return.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/scan/captures', args),
+    },
+    {
+        name: 'check_scan_models',
+        description: 'Return the items that ALREADY have a 3D model. Ask by catalogue variant '
+            + '(variantIds), by the inventory rows the seller owns (inventoryItemIds), or '
+            + 'both; at least one is required. Use it before suggesting a seller scan '
+            + 'anything — ids that come back ABSENT are the ones worth capturing. '
+            + 'The two are different kinds of answer. A catalogue model belongs to the PRODUCT '
+            + 'and is shared, so a hit means their listing gets it immediately with nothing to '
+            + 'capture because somebody else already paid to generate it. An inventory model '
+            + 'belongs to ONE of their rows, because an object with no catalogue identity — a '
+            + 'lamp, a one-off — is not a product anyone else can claim. '
+            + '`longestEdgeMm` is set only when a capture MEASURED the item against something '
+            + 'of known size; null means the mesh has correct proportions but no real-world '
+            + 'scale, which is normal and not a defect. Max 200 ids of each per call. '
+            + 'Requires catalog:read.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                variantIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    maxItems: 200,
+                    description: 'Catalogue variant ids to check.',
+                },
+                inventoryItemIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    maxItems: 200,
+                    description: "The seller's own inventory item ids to check.",
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { variantIds, inventoryItemIds } = args;
+            const query = {};
+            if (variantIds?.length)
+                query.variantIds = variantIds.slice(0, 200).join(',');
+            if (inventoryItemIds?.length) {
+                query.inventoryItemIds = inventoryItemIds.slice(0, 200).join(',');
+            }
+            return apiGet('/v1/scan/models', query);
+        },
+    },
+];
+//# sourceMappingURL=scan.js.map

package/dist/tools/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/tools/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,yFAAyF;cACvF,sFAAsF;cACtF,uFAAuF;cACvF,wFAAwF;cACxF,gFAAgF;cAChF,2EAA2E;cAC3E,iFAAiF;cACjF,iFAAiF;cACjF,8EAA8E;cAC9E,mFAAmF;cACnF,+DAA+D;QACnE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kEAAkE;iBAChF;gBACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE;aAClG;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAA+B,CAAC;KAChF;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,0EAA0E;cACxE,6EAA6E;cAC7E,yEAAyE;cACzE,qEAAqE;cACrE,kFAAkF;cAClF,kFAAkF;cAClF,gFAAgF;cAChF,iFAAiF;cACjF,4DAA4D;cAC5D,iFAAiF;cACjF,+EAA+E;cAC/E,yEAAyE;cACzE,wBAAwB;QAC5B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,QAAQ,EAAE,GAAG;oBACb,WAAW,EAAE,iCAAiC;iBAC/C;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,QAAQ,EAAE,GAAG;oBACb,WAAW,EAAE,+CAA+C;iBAC7D;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAExC,CAAC;YACF,MAAM,KAAK,GAA4B,EAAE,CAAC;YAC1C,IAAI,UAAU,EAAE,MAAM;gBAAE,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9E,IAAI,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBAC7B,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;KACF;CACF,CAAC"}

package/dist/tools/seller-ops.d.ts

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

package/dist/tools/seller-ops.d.ts.map

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

package/dist/tools/seller-ops.js

@@ -0,0 +1,83 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../api.js';
+/**
+ * Seller ops: building and publishing variation / purchase-rule groups, and
+ * the forward-looking inventory reads (aging, cohort sell-through, portfolio
+ * value over time).
+ *
+ * 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 manageGroup(args) {
+    const a = args;
+    if (a.action === 'create')
+        return apiPost('/api/v1/variation-groups', { kind: a.kind, title: a.title, axisName: a.axisName, rule: a.rule, members: a.members }, a.idempotencyKey);
+    if (a.action === 'generate')
+        return apiPost('/api/v1/variation-groups/generate', { sourceListingId: a.sourceListingId, axisName: a.axisName, sourceValue: a.sourceValue, options: a.options }, a.idempotencyKey);
+    if (!a.groupId)
+        return Promise.reject(new Error('groupId is required for this action'));
+    const id = enc(a.groupId);
+    if (a.action === 'update')
+        return apiPatch(`/api/v1/variation-groups/${id}`, { title: a.title, axisName: a.axisName, rule: a.rule });
+    if (a.action === 'publish')
+        return apiPost(`/api/v1/variation-groups/${id}/publish`, { platforms: a.platforms ?? [] }, a.idempotencyKey);
+    return apiDelete(`/api/v1/variation-groups/${id}`);
+}
+function insights(args) {
+    const a = args;
+    if (a.what === 'aging')
+        return apiGet('/v1/inventory/aging');
+    if (a.what === 'sell_through')
+        return apiGet('/v1/inventory/sell-through', { start: a.start, end: a.end });
+    return apiGet('/v1/inventory/value-history', { days: a.days });
+}
+export const sellerOpsTools = [
+    {
+        name: 'manage_variation_group',
+        description: 'Build and publish grouped listings. create: group existing listings (kind variation with axisName + members[].axisValue, '
+            + 'or kind group with a purchase rule {minQty|minSpendCents|note|allowPairWithAnyItem} written into every member\'s description and enforced '
+            + 'at Crossly checkout). generate: turn ONE listing into a variation group — sourceListingId, axisName ("Size"), sourceValue (its own value), '
+            + 'options[{value, price?, quantity?, sku?}] each become a new listing with its own stock. update: title / axisName / rule. publish: per '
+            + 'platform (one listing with a picker on eBay, Shopify and Etsy; one per option elsewhere) — call get_variation_publish_plan first. '
+            + 'dissolve: members stay listings. listings:write.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['create', 'generate', 'update', 'publish', 'dissolve'], description: 'create = group existing listings; generate = split one listing into a variation per option; update = retitle / rename axis / change rule (groupId); publish = push to platforms (groupId, platforms); dissolve = break up the group, members stay listings (groupId).' },
+                groupId: { type: 'string', description: 'update / publish / dissolve: the group id.' },
+                kind: { type: 'string', enum: ['variation', 'group'], description: 'create: variation = one product across an axis such as Size (needs axisName + members[].axisValue); group = a purchase-rule bundle ("buy any 3", needs rule). Default variation.' },
+                title: { type: 'string', description: 'create / update: the group title, 1-200 characters.' },
+                axisName: { type: 'string', description: 'create / generate / update: the variation axis ("Size", "Condition", "Pressing"), 1-40 characters.' },
+                rule: { type: 'object', description: "create / update, kind group: { minQty (2-100), minSpendCents (integer CENTS, e.g. 5000 = $50.00), note (up to 280 chars), allowPairWithAnyItem }; written into every member's description and enforced at checkout." },
+                members: { type: 'array', items: { type: 'object' }, description: 'create: 2-250 existing listings as [{ listingId, axisValue? }]; axisValue is the value of that listing on the axis (e.g. "M").' },
+                sourceListingId: { type: 'string', description: 'generate: the listing to turn into a variation group.' },
+                sourceValue: { type: 'string', description: 'generate: the own value of the source listing on the axis (e.g. "M"), 1-60 characters.' },
+                options: { type: 'array', items: { type: 'object' }, description: "generate: 1-249 new values as [{ value, price?, quantity?, sku? }]; price is DOLLARS (e.g. 19.99), blank = the source listing's price; each becomes its own listing." },
+                platforms: { type: 'array', items: { type: 'string' }, description: 'publish: platform keys to publish to (e.g. ebay, shopify, etsy), 1-20.' },
+                idempotencyKey: { type: 'string', description: 'Sent as the Idempotency-Key header on create/generate/publish.' },
+            },
+            required: ['action'],
+            additionalProperties: false,
+        },
+        handler: (args) => manageGroup(args),
+    },
+    {
+        name: 'inventory_insights',
+        description: 'Forward-looking inventory. aging: unsold stock by age (0-7, 7-30, 30-90, 90+ days, unlisted) with a recommendation per bucket. '
+            + 'sell_through: of what came in during a window (default the 30 days ending 30 days ago), how much sold — against the previous window. '
+            + 'value_history: portfolio value of unsold stock over time (days, default 90). analytics:read.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                what: { type: 'string', enum: ['aging', 'sell_through', 'value_history'], description: "aging = unsold stock by age bucket with recommendations; sell_through = share of a window's intake that sold, vs the previous window (start, end); value_history = unsold stock value over time (days)." },
+                start: { type: 'string', description: 'sell_through window start (ISO date).' },
+                end: { type: 'string', description: 'sell_through window end (ISO date).' },
+                days: { type: 'number', description: 'value_history span, 1-730.' },
+            },
+            required: ['what'],
+            additionalProperties: false,
+        },
+        handler: (args) => insights(args),
+    },
+];
+//# sourceMappingURL=seller-ops.js.map

package/dist/tools/seller-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-ops.js","sourceRoot":"","sources":["../../src/tools/seller-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGjE;;;;;;;GAOG;AAEH,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAE/B,SAAS,WAAW,CAAC,IAA6B;IAChD,MAAM,CAAC,GAAG,IAKT,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IAClL,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,mCAAmC,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IACjN,IAAI,CAAC,CAAC,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;IACxF,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,4BAA4B,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrI,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,4BAA4B,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IACzI,OAAO,SAAS,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,IAA6B;IAC7C,MAAM,CAAC,GAAG,IAAyG,CAAC;IACpH,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,MAAM,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3G,OAAO,MAAM,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,2HAA2H;cACzH,4IAA4I;cAC5I,6IAA6I;cAC7I,wIAAwI;cACxI,oIAAoI;cACpI,kDAAkD;QACtD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,uQAAuQ,EAAE;gBAC/W,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;gBACtF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,kLAAkL,EAAE;gBACvP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;gBAC7F,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oGAAoG,EAAE;gBAC/I,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qNAAqN,EAAE;gBAC5P,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,gIAAgI,EAAE;gBACpM,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;gBACzG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wFAAwF,EAAE;gBACtI,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,sKAAsK,EAAE;gBAC1O,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,wEAAwE,EAAE;gBAC9I,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;aAClH;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;KACrC;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iIAAiI;cAC/H,uIAAuI;cACvI,8FAA8F;QAClG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE,WAAW,EAAE,yMAAyM,EAAE;gBAClS,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;gBAC/E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;gBAC3E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;aACpE;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;YAClB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;KAClC;CACF,CAAC"}

package/dist/tools/seller-xmarket.d.ts

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

package/dist/tools/seller-xmarket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-xmarket.d.ts","sourceRoot":"","sources":["../../src/tools/seller-xmarket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAuCrC,eAAO,MAAM,kBAAkB,EAAE,OAAO,EA+EvC,CAAC"}

package/dist/tools/seller-xmarket.js

@@ -0,0 +1,120 @@
+import { apiGet, apiPost } from '../api.js';
+/**
+ * Seller side of the cross-marketplace features: card breaks, group buys, and
+ * the returns Crossly buyers open under your return policy or try at home.
+ *
+ * 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 breaks(args) {
+    const a = args;
+    if (a.action === 'list')
+        return apiGet('/v1/breaks');
+    if (a.action === 'create') {
+        const body = { listingSlug: a.listingSlug, title: a.title, format: a.format, spots: a.spots, product: a.product };
+        return apiPost('/v1/breaks', body, a.idempotencyKey);
+    }
+    if (!a.id)
+        return Promise.reject(new Error('id is required for this action'));
+    const id = enc(a.id);
+    if (a.action === 'get')
+        return apiGet(`/v1/breaks/${id}`);
+    if (a.action === 'draw')
+        return apiPost(`/v1/breaks/${id}/draw`, {});
+    if (a.action === 'opened')
+        return apiPost(`/v1/breaks/${id}/opened`, {});
+    if (a.action === 'cancel')
+        return apiPost(`/v1/breaks/${id}/cancel`, {});
+    if (!a.spotId)
+        return Promise.reject(new Error('spotId is required to record hits'));
+    return apiPost(`/v1/breaks/${id}/spots/${enc(a.spotId)}/hits`, { hits: a.hits ?? '' });
+}
+function policyReturns(args) {
+    const a = args;
+    if (a.action === 'list')
+        return apiGet('/v1/policy-returns', { orderId: a.orderId });
+    if (!a.id)
+        return Promise.reject(new Error('id is required to mark a return received'));
+    return apiPost(`/v1/policy-returns/${enc(a.id)}/received`, {}, a.idempotencyKey);
+}
+export const sellerXmarketTools = [
+    {
+        name: 'card_breaks_seller',
+        description: 'Run card breaks on your listings: list; get (board); create (listingSlug, title, format pick | random, spots = names or one per line; '
+            + 'the seed is committed now and revealed at the draw); draw (a sold-out random break); hits (record what a spot pulled); opened; cancel '
+            + '(only before any spot is paid for). listings:read / listings:write.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['list', 'get', 'create', 'draw', 'hits', 'opened', 'cancel'], description: 'list = your breaks; get = one board (id); create = start a break; draw = assign spots in a sold-out random break and reveal the seed (id); hits = record what a spot pulled (id, spotId, hits); opened = mark the product opened on stream (id); cancel = cancel before any spot is paid for (id).' },
+                id: { type: 'string', description: 'The break id (every action except list and create).' },
+                spotId: { type: 'string', description: 'hits: the spot id from the board.' },
+                hits: { type: 'string', description: 'hits: what the spot pulled, free text up to 1000 characters.' },
+                listingSlug: { type: 'string', description: 'create: the slug of your listing the break sells spots on.' },
+                title: { type: 'string', description: 'create: the break title, 3-120 characters.' },
+                format: { type: 'string', enum: ['pick', 'random'], description: 'create: pick = buyers choose their spot; random = spots are drawn from the committed seed once sold out.' },
+                spots: { description: 'Array of spot names, or one per line.' },
+                product: { type: 'string', description: 'create: the product being opened (e.g. "2024 Topps Chrome hobby box"), up to 300 characters.' },
+                idempotencyKey: { type: 'string', description: 'create: sent as the Idempotency-Key header. Stable per intent so a retry cannot create two breaks.' },
+            },
+            required: ['action'],
+            additionalProperties: false,
+        },
+        handler: (args) => breaks(args),
+    },
+    {
+        name: 'start_group_buy',
+        description: 'Start a group buy on a listing with stock: tiers [{ minBuyers, priceCents }], a minimum, 1-6 days. Buyers hold at the listing price and pay the tier reached; below the minimum nobody pays. listings:write.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                listingSlug: { type: 'string', description: 'The slug of your listing (must have stock).' },
+                tiers: { type: 'array', items: { type: 'object', properties: { minBuyers: { type: 'number', description: 'Buyers needed to reach this tier.' }, priceCents: { type: 'number', description: 'Price per buyer at this tier, integer CENTS (e.g. 1999 = $19.99).' } }, required: ['minBuyers', 'priceCents'] }, description: '1-5 price tiers [{ minBuyers, priceCents }]; priceCents is integer CENTS (e.g. 1999 = $19.99). Buyers pay the tier the group reaches.' },
+                minBuyers: { type: 'number', description: 'Minimum buyers for the group buy to happen (at least 1); below it nobody pays.' },
+                days: { type: 'number', minimum: 1, maximum: 6, description: 'How long the group buy runs, 1-6 days.' },
+                idempotencyKey: { type: 'string', description: 'Sent as the Idempotency-Key header. Stable per intent so a retry cannot start two group buys.' },
+            },
+            required: ['listingSlug', 'tiers', 'minBuyers', 'days'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/group-buys', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'buy_pickup_point_label',
+        description: 'Buy the carrier label for a Crossly order the buyer collects from a UPS / FedEx pickup point (it normally buys itself at payment; use this after topping up the shipping wallet). Debits the wallet; 402 when short. orders:write.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                orderId: { type: 'string', description: 'The Crossly order id going to a pickup point.' },
+                idempotencyKey: { type: 'string', description: 'Sent as the Idempotency-Key header. Stable per intent so a retry cannot buy two labels.' },
+            },
+            required: ['orderId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { orderId, idempotencyKey } = args;
+            return apiPost(`/v1/orders/${enc(orderId)}/pickup-label`, {}, idempotencyKey);
+        },
+    },
+    {
+        name: 'policy_returns',
+        description: 'Returns Crossly buyers opened under your return policy or try at home: list (optionally for one orderId); received (id) refunds the buyer less the restocking or try fee you keep. orders:read / orders:write.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: { type: 'string', enum: ['list', 'received'], description: 'list = returns opened against you (optionally one orderId); received = you got the item back, refund the buyer less your restocking / try fee (id).' },
+                id: { type: 'string', description: 'received: the return id (from list).' },
+                orderId: { type: 'string', description: 'list: only returns for this order id (uuid).' },
+                idempotencyKey: { type: 'string', description: 'received: sent as the Idempotency-Key header. Stable per intent so a retry cannot refund twice.' },
+            },
+            required: ['action'],
+            additionalProperties: false,
+        },
+        handler: (args) => policyReturns(args),
+    },
+];
+//# sourceMappingURL=seller-xmarket.js.map

package/dist/tools/seller-xmarket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-xmarket.js","sourceRoot":"","sources":["../../src/tools/seller-xmarket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG5C;;;;;;GAMG;AAEH,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAE/B,SAAS,MAAM,CAAC,IAA6B;IAC3C,MAAM,CAAC,GAAG,IAGT,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAClH,OAAO,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CAAC;IAC9E,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrB,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;IACrF,OAAO,OAAO,CAAC,cAAc,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,aAAa,CAAC,IAA6B;IAClD,MAAM,CAAC,GAAG,IAA+F,CAAC;IAC1G,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC;IACxF,OAAO,OAAO,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,wIAAwI;cACtI,wIAAwI;cACxI,qEAAqE;QACzE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,oSAAoS,EAAE;gBAClZ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;gBAC1F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAC5E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;gBACrG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;gBAC1G,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;gBACpF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,0GAA0G,EAAE;gBAC7K,KAAK,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE;gBAC/D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8FAA8F,EAAE;gBACxI,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oGAAoG,EAAE;aACtJ;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;KAChC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,8MAA8M;QAC3N,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;gBAC3F,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mEAAmE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,uIAAuI,EAAE;gBACnc,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gFAAgF,EAAE;gBAC5H,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,wCAAwC,EAAE;gBACvG,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+FAA+F,EAAE;aACjJ;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC;YACvD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,IAA6D,CAAC;YAClG,OAAO,OAAO,CAAC,gBAAgB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACzD,CAAC;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,oOAAoO;QACjP,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;gBACzF,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yFAAyF,EAAE;aAC3I;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,IAAoD,CAAC;YACzF,OAAO,OAAO,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC;QAChF,CAAC;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,gNAAgN;QAC7N,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,qJAAqJ,EAAE;gBAC1N,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;gBAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;gBACxF,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iGAAiG,EAAE;aACnJ;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC;KACvC;CACF,CAAC"}

package/dist/tools/sourcing.d.ts

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

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

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

package/dist/tools/sourcing.js

@@ -0,0 +1,160 @@
+import { apiGet, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+export const sourcingTools = [
+    {
+        name: 'list_sourcing_receipts',
+        description: "List parsed sourcing receipts in this user's ledger (newest first, capped at 200 entries). Each row carries " +
+            "{ vendor, dateIso, items: [{ description, priceCents }], sourceImageUrl, loggedAt }. Used by COGS/tax flows " +
+            "to reconcile inventory cost basis against vendor purchases.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/sourcing/receipts'),
+    },
+    {
+        name: 'log_sourcing_receipt',
+        description: "Append a parsed receipt to the sourcing ledger. Typically called after AI receipt extraction (see ai_extract_receipt). " +
+            "Vendor, dateIso, and sourceImageUrl may be null; items is required (even if empty). The ledger is capped at " +
+            "200 entries — the oldest fall off the end. Pass an idempotencyKey on retries.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                vendor: {
+                    type: ['string', 'null'],
+                    maxLength: 120,
+                    description: "Who the goods were bought FROM, as printed on the receipt (max 120 chars) — e.g. 'Goodwill Outlet 12th " +
+                        "St' or 'Liquidation.com'. Free text: this is the only supplier identifier the ledger carries, there is " +
+                        'no supplier table or supplier id to reference, so spell a repeat source the same way every time if you ' +
+                        'want the entries to group. Pass null when the receipt has no legible vendor.',
+                },
+                dateIso: { type: ['string', 'null'], description: 'ISO 8601 date string, or null if not parsed.' },
+                items: {
+                    type: 'array',
+                    description: 'The purchased line items on this receipt — one entry per thing in the lot, and the cost basis half of ' +
+                        'the record. Required, but may be an empty array for a receipt whose lines could not be parsed; the ' +
+                        'response echoes { ok, count } where count is this array\'s length. All money here is integer CENTS.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            description: {
+                                type: 'string',
+                                maxLength: 200,
+                                description: "The line's text as printed on the receipt, max 200 chars (e.g. 'MENS DENIM JACKET XL'). Stored " +
+                                    'verbatim and never matched against inventory — nothing links a line to an inventory item.',
+                            },
+                            priceCents: {
+                                type: 'integer',
+                                minimum: 0,
+                                description: 'What was paid for this line, in integer CENTS (495 means $4.95) — never dollars. Must be >= 0. ' +
+                                    'The server coerces a numeric string but will not rescale a dollar figure, so 4.95 is stored as 4 ' +
+                                    'cents, a 100x understatement of the cost basis.',
+                            },
+                        },
+                        required: ['description', 'priceCents'],
+                        additionalProperties: false,
+                    },
+                },
+                sourceImageUrl: {
+                    type: ['string', 'null'],
+                    format: 'uri',
+                    description: 'Absolute URL of the receipt photo this entry was parsed from (must parse as a URL — the server rejects ' +
+                        'a bare filename). Kept so a COGS or tax figure can be traced back to the paper it came from. Pass null ' +
+                        'when no image was stored.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['vendor', 'dateIso', 'items', 'sourceImageUrl'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/sourcing/receipts', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'get_my_demand_matches',
+        description: 'Unmet buyer demand for items THIS seller is holding or has sold before. ' +
+            "relation='in_stock' means it is in their inventory right now — money already on " +
+            "the shelf. relation='sold_before' means they have sold one, so they know where to " +
+            'get another. Prefer this over get_unmet_demand when advising one seller. ' +
+            'Requires analytics:read.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 365,
+                    description: 'Look-back window in days over buyer observations, 1-365. Default 60 — long enough that a slow-moving ' +
+                        'category still registers. A shorter window reports only what is being hunted right now.',
+                },
+                minLookers: {
+                    type: 'integer',
+                    minimum: 1,
+                    description: 'Minimum number of DISTINCT shoppers who looked for the item inside the window before it is reported ' +
+                        '(>= 1, default 2) — distinct people, not total page views, so one person checking the same barcode all ' +
+                        'afternoon never reads as demand. Raise it to see only what several buyers independently wanted.',
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 100,
+                    description: 'Max rows to return, 1-100. Default 25. One row per matched barcode (GTIN), with in_stock preferred over ' +
+                        'sold_before when the seller has both for the same item.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const q = new URLSearchParams();
+            for (const key of ['days', 'minLookers', 'limit']) {
+                if (args[key] != null)
+                    q.set(key, String(args[key]));
+            }
+            const query = q.toString();
+            return apiGet(`/v1/sourcing/demand/mine${query ? `?${query}` : ''}`);
+        },
+    },
+    {
+        name: 'get_unmet_demand',
+        description: 'Items buyers looked for on OTHER sites that Crossly did not have, ranked by how ' +
+            'often we came up empty. Use this to answer "what should I go source". ' +
+            'medianPageCents is what the retailers were charging. Aggregate and anonymous — ' +
+            'there is no per-buyer view. Requires analytics:read.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 365,
+                    description: 'Look-back window in days over Scout observations, 1-365. Default 30. Widen it for seasonal or ' +
+                        'slow-turning categories; narrow it to see what is being searched for this month.',
+                },
+                minLooks: {
+                    type: 'integer',
+                    minimum: 1,
+                    description: 'Minimum TOTAL looks (every observation, not distinct shoppers) an item needs in the window before it is ' +
+                        'reported (>= 1, default 3) — one person checking one obscure barcode is not a market. An item is only ' +
+                        'listed at all if at least one of those looks was a miss.',
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 200,
+                    description: 'Max rows to return, 1-200. Default 50. Rows are ranked by MISSES first (times a buyer looked and ' +
+                        'Crossly had nothing) then by total looks, so a small limit still returns the most actionable gaps.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const q = new URLSearchParams();
+            for (const key of ['days', 'minLooks', 'limit']) {
+                if (args[key] != null)
+                    q.set(key, String(args[key]));
+            }
+            const query = q.toString();
+            return apiGet(`/v1/sourcing/demand${query ? `?${query}` : ''}`);
+        },
+    },
+];
+//# sourceMappingURL=sourcing.js.map

package/dist/tools/sourcing.js.map

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

package/dist/tools/spatial-auction.d.ts

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

package/dist/tools/spatial-auction.d.ts.map

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