@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/accounts.js

@@ -0,0 +1,471 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../api.js';
+import { IDEMPOTENCY_PROP } from './types.js';
+export const accountsTools = [
+    {
+        name: 'list_platform_accounts',
+        description: 'List the seller\'s connected marketplace accounts (one row per slot — sellers can have multiple eBay/ ' +
+            'Poshmark accounts e.g. for a side-hustle vs primary store). Each row has platform, label, username, ' +
+            'connection status ("connected" / "needs_reauth" / "expired"), and lastSyncedAt. Check this before ' +
+            'attempting crosspost_listing — if a platform isn\'t connected, the job will fail.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        handler: () => apiGet('/v1/accounts'),
+    },
+    {
+        name: 'add_platform_account',
+        description: 'Add a new platform account slot. This does NOT perform OAuth — for API platforms (eBay/Etsy/Shopify) ' +
+            'the user must complete OAuth in the web UI; for cookie platforms (Poshmark/Mercari/etc.) they must log ' +
+            'in via the browser extension. This tool just creates the slot record. ' +
+            'NOTE: extra slots beyond the user\'s plan limit may incur overage billing — set acceptOverage=true to ' +
+            'acknowledge that explicitly. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform slug, e.g. "poshmark", "mercari", "ebay", "etsy", "shopify", "depop", "grailed", "vinted", "whatnot", "vestiaire", "facebook", "offerup".',
+                },
+                label: {
+                    type: 'string',
+                    maxLength: 60,
+                    description: 'Optional human-friendly label, e.g. "Main store" or "Vintage hustle".',
+                },
+                acceptOverage: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'Set true to opt in to overage billing when adding beyond plan limit. The endpoint refuses otherwise.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/accounts', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'remove_platform_account',
+        description: 'Disconnect a platform account slot. For API platforms this also revokes the stored OAuth token. ' +
+            'Active listings on that account remain published on the marketplace itself (we can no longer manage them). ' +
+            'CONFIRM with the user — they\'ll need to re-OAuth or re-extension-login to reconnect. ' +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Account slot UUID from list_platform_accounts.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/accounts/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+    // ── Presence + per-platform limits ─────────────────────────────────────
+    {
+        name: 'extension_online',
+        description: "Check whether the browser extension is currently online. Returns { online: boolean }. Cookie-platform jobs only " +
+            "drain while the extension is online — use this to decide whether to crosspost now or queue. The extension writes a " +
+            "60s-TTL heartbeat key, so a 'true' result means it pinged in the last minute.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/connections/extension-online'),
+    },
+    {
+        name: 'list_email_connections',
+        description: 'List IMAP + email-OAuth connections (Gmail / Outlook / IMAP). Used by the IMAP sale-fallback scanner and the inbox ' +
+            'triage system.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/connections/email'),
+    },
+    {
+        name: 'get_platform_limits',
+        description: 'Per-platform listing-limit summary — eBay free-tier usage + Etsy month-to-date fees. Pass connection_id to scope to ' +
+            'one connection (matches the per-account settings dialog).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                connection_id: { type: 'string', description: 'Optional eBay/Etsy platformConnections row id.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/platforms/limits', {
+            connection_id: args.connection_id,
+        }),
+    },
+    // ── Connection lifecycle (cookie + OAuth) ──────────────────────────────
+    {
+        name: 'connect_platform',
+        description: 'Revive or initiate a connection for a cookie platform. If an active row already exists, returns status=already_active. ' +
+            'If an archived row exists, it gets revived. Otherwise returns status=no_row_yet (the extension must finish first ' +
+            'sync). Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Cookie-track platform id — one of "poshmark", "mercari", "facebook", "depop", "grailed", "vinted", ' +
+                        '"whatnot", "vestiaire", "offerup", "curtsy" (the integrationType:"cookie" entries in shared PLATFORMS). ' +
+                        'OAuth/API-track ids (ebay, etsy, shopify, amazon, …) are not connected this way — use oauth_init_url. ' +
+                        'The server revives the first archived/needs_reauth row on this platform and validates it with one real ' +
+                        'authed call; it never creates a row, so a platform the extension has never synced returns status=no_row_yet.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const platform = args.platform;
+            return apiPost(`/v1/platform-accounts/${encodeURIComponent(platform)}/connect`, {}, args.idempotencyKey);
+        },
+    },
+    {
+        name: 'disconnect_platform',
+        description: "Archive every active account row for a platform. Releases the proxy reservation, decrements overage billing, fires " +
+            "the platform.disconnected automation trigger. Pass an idempotencyKey on retries.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform id whose ACTIVE account rows should all be archived — any id in shared PLATFORMS, but in ' +
+                        'practice a cookie-track one ("poshmark", "mercari", "facebook", "depop", "grailed", "vinted", ' +
+                        '"whatnot", "vestiaire", "offerup", "curtsy"). This archives EVERY slot on that platform; to drop one ' +
+                        'OAuth connection when the seller has several, use disconnect_oauth_connection instead. Returns ' +
+                        '{ archived: <row count> }, and { archived: 0 } when nothing was active.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const platform = args.platform;
+            return apiPost(`/v1/platform-accounts/${encodeURIComponent(platform)}/disconnect`, {}, args.idempotencyKey);
+        },
+    },
+    {
+        name: 'disconnect_oauth_connection',
+        description: 'Disconnect a specific OAuth connection row by its connection id (NOT the by-platform path). Use when a seller ' +
+            'has multiple connections on the same platform — list_oauth_connections first to find the id. Sets is_active=false ' +
+            'and nulls out the stored tokens. Returns { success: true }. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    format: 'uuid',
+                    description: 'UUID of the OAuth connection row (platform_connections) as returned by list_oauth_connections. This is ' +
+                        'NOT a platform id and NOT the cookie account-slot id from list_platform_accounts — passing either 404s.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/connections/by-id/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+    {
+        name: 'request_platform_access',
+        description: 'Express interest in a "request_only" platform (the ones where access is gated by partner approval — Walmart, ' +
+            'Bonanza, Newegg, etc.). Records the user\'s intent so the team can batch-request approvals. Returns ' +
+            '{ requested: true }. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform id whose `availability` in shared PLATFORMS is "request_only" — today "etsy", "stockx", ' +
+                        '"tiktok_shop", "instagram_shop", "wix", "tcgplayer", "amazon", "walmart". The route accepts any string ' +
+                        'and only emails ops the interest, so an already-live id (ebay, shopify, …) silently does nothing useful.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const platform = args.platform;
+            return apiPost(`/v1/connections/${encodeURIComponent(platform)}/request`, {}, args.idempotencyKey);
+        },
+    },
+    {
+        name: 'set_history_import_window',
+        description: 'Set how far back to backfill order history + active listings for a platform, and run it now. Call this once ' +
+            "a platform connects (list_platform_accounts / list_oauth_connections shows initialLedgerAt/listingsImportedAt " +
+            'null for a pending row) — it both saves the choice and immediately fires the backfill for any pending accounts ' +
+            'on that platform. days: null = All time (no limit), 0 = None (skip entirely), a positive integer = days back. ' +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform id to backfill — any id in shared PLATFORMS, API-track (ebay, etsy, shopify, …) or ' +
+                        'cookie-track (poshmark, mercari, depop, …). An unknown id is rejected with 400 unknown_platform. ' +
+                        'The chosen window is saved on the user either way, but only cookie-track platforms and the ' +
+                        'API-track platforms that have a backfill implementation actually fire an import right now.',
+                },
+                days: {
+                    type: ['integer', 'null'],
+                    description: 'How far back to import, in DAYS (not months). null = all time, no limit; 0 = none, skip the backfill ' +
+                        'entirely; a positive integer = that many days back, capped at 3650 (10 years). Required — the server ' +
+                        'has no default and rejects a missing value. Saved as the user\'s settings.historyImportDays.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform', 'days'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const platform = args.platform;
+            return apiPost(`/v1/platform-accounts/${encodeURIComponent(platform)}/history-import`, { days: args.days }, args.idempotencyKey);
+        },
+    },
+    {
+        name: 'refresh_account_status',
+        description: 'Run on-demand healthchecks across every cookie account. Each one calls the platform\'s getMe equivalent — a 200 marks ' +
+            'the account active; a 401/403 marks it needs_reauth and pushes a WebSocket event. Returns one row per checked ' +
+            "account. Pass an idempotencyKey on retries.",
+        inputSchema: {
+            type: 'object',
+            properties: { ...IDEMPOTENCY_PROP },
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/platform-accounts/refresh-status', {}, args.idempotencyKey),
+    },
+    {
+        name: 'oauth_init_url',
+        description: 'Get the OAuth authorize URL for an API-track platform (eBay / Shopify / Amazon / Reverb / Squarespace / StockX / ' +
+            "TikTok Shop / Wix / Instagram Shop / BigCommerce). Hand this URL to the user to complete OAuth in their browser. " +
+            'Shopify requires a `shop` parameter (mystore.myshopify.com). Amazon accepts a `region` parameter (na/eu/fe). Returns ' +
+            '400 for platforms that need browser-session OAuth (Etsy, Bonanza, WooCommerce).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'API-track (OAuth) platform id. The builder knows: "ebay", "etsy", "shopify", "amazon", "bigcommerce", ' +
+                        '"reverb", "squarespace", "stockx", "tiktok_shop", "wix", "instagram_shop", "bonanza", "woocommerce", ' +
+                        '"walmart". Anything else — including every cookie-track id (poshmark, mercari, depop, …) — returns 400 ' +
+                        'unsupported_platform. Per-platform quirks: "shopify" also needs `shop`; "etsy" additionally returns a ' +
+                        'correlationId (PKCE); "bonanza" returns oneShot:true and the URL is single-use; "woocommerce" needs a ' +
+                        'siteUrl this tool does not expose, so it returns 400 missing_site_url; "walmart" returns ' +
+                        '{ status: "request_only", requestUrl, message } instead of a URL.',
+                },
+                shop: {
+                    type: 'string',
+                    description: 'Shopify ONLY, and required there: the seller\'s myshopify host, e.g. "mystore.myshopify.com" (no ' +
+                        'scheme, no trailing slash). Omitting it on shopify returns 400 missing_shop. Ignored by every other platform.',
+                },
+                region: {
+                    type: 'string',
+                    description: 'Amazon ONLY, optional: which Seller Central consent host to send the seller to — "na" (default, ' +
+                        'sellercentral.amazon.com), "eu" (sellercentral-europe) or "fe" (sellercentral-japan). Ignored by every ' +
+                        'other platform.',
+                },
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const platform = args.platform;
+            const query = {};
+            if (args.shop)
+                query.shop = args.shop;
+            if (args.region)
+                query.region = args.region;
+            return apiGet(`/v1/oauth/${encodeURIComponent(platform)}/init`, query);
+        },
+    },
+    // ── IMAP CRUD ──────────────────────────────────────────────────────────
+    {
+        name: 'imap_create',
+        description: 'Add an IMAP mailbox connection. Password is encrypted at rest with the JWT_SECRET-derived key. Used by the IMAP ' +
+            "sale-fallback scanner. Pass an idempotencyKey on retries.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                host: {
+                    type: 'string',
+                    description: 'IMAP server hostname, e.g. "imap.gmail.com" or "outlook.office365.com". Hostname only — no scheme, ' +
+                        'no port, no trailing slash. Required and must be non-empty.',
+                },
+                port: {
+                    type: 'integer',
+                    description: 'IMAP port number — normally 993, the implicit-TLS port. The server always connects with TLS on ' +
+                        '(secure: true), so the plaintext/STARTTLS port 143 will fail to connect. Positive integer, required.',
+                },
+                username: {
+                    type: 'string',
+                    description: 'IMAP login, normally the full email address. Also stored as the connection\'s emailAddress, which is ' +
+                        'what the sale-fallback scanner shows and matches on. Required and must be non-empty.',
+                },
+                password: {
+                    type: 'string',
+                    description: 'IMAP password. For Gmail/Outlook this must be an APP-SPECIFIC password, not the account password ' +
+                        '(both providers reject plain-password IMAP logins). Stored encrypted at rest with the ' +
+                        'JWT_SECRET-derived key and never returned by any read tool. Required and must be non-empty.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['host', 'port', 'username', 'password'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/connections/email/imap', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'imap_update',
+        description: 'Edit an IMAP mailbox connection. Any field may be PATCHed (host/port/username/password/isActive). Pass an ' +
+            'idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'UUID of the IMAP connection row to edit, from list_email_connections. Scoped to your own user — an ' +
+                        'id you do not own 404s.',
+                },
+                host: {
+                    type: 'string',
+                    description: 'New IMAP server hostname (e.g. "imap.gmail.com"), hostname only. Omit to leave the stored host unchanged.',
+                },
+                port: {
+                    type: 'integer',
+                    description: 'New IMAP port — normally 993 (implicit TLS); the connection is always made with TLS on, so 143 will ' +
+                        'fail. Positive integer. Omit to leave the stored port unchanged.',
+                },
+                username: {
+                    type: 'string',
+                    description: 'New IMAP login, normally the full email address. Updating this also rewrites the connection\'s ' +
+                        'emailAddress. Omit to leave unchanged.',
+                },
+                password: {
+                    type: 'string',
+                    description: 'New IMAP password (an app-specific password for Gmail/Outlook), re-encrypted at rest on save. Omit — ' +
+                        'or send an empty string — to keep the stored password; there is no way to read the existing one back.',
+                },
+                isActive: {
+                    type: 'boolean',
+                    description: 'Whether the sale-fallback scanner should keep polling this mailbox. false pauses it without deleting ' +
+                        'the row (imap_delete is the destructive option). Omit to leave unchanged.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPatch(`/v1/connections/email/imap/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'imap_delete',
+        description: 'Remove an IMAP mailbox connection by id. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'UUID of the IMAP connection row to delete, from list_email_connections. Hard delete (the row is gone, ' +
+                        'not archived) and scoped to your own user — an id you do not own 404s. To pause a mailbox instead, ' +
+                        'call imap_update with isActive=false.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/connections/email/imap/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+    {
+        name: 'imap_test',
+        description: 'Validate IMAP credentials by attempting a connect+logout WITHOUT persisting them. Returns success/422. Use this ' +
+            'before imap_create to avoid storing bad creds.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                host: {
+                    type: 'string',
+                    description: 'IMAP server hostname to dial, e.g. "imap.gmail.com". Hostname only — no scheme or port. Required.',
+                },
+                port: {
+                    type: 'integer',
+                    description: 'IMAP port to dial — normally 993. The test always connects with TLS on, so 143 will fail even when ' +
+                        'the credentials are good. Positive integer, required.',
+                },
+                username: {
+                    type: 'string',
+                    description: 'IMAP login to test, normally the full email address. Required and must be non-empty.',
+                },
+                password: {
+                    type: 'string',
+                    description: 'IMAP password to test — an app-specific password for Gmail/Outlook. NOT persisted by this call: the ' +
+                        'server connects, logs out and discards it. A bad credential comes back as 422 imap_connection_failed ' +
+                        'with the server\'s own message.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['host', 'port', 'username', 'password'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/connections/email/imap/test', body, idempotencyKey);
+        },
+    },
+    // ── Per-platform preferences ───────────────────────────────────────────
+    {
+        name: 'update_platform_preferences',
+        description: 'Update per-platform connection preferences. Currently supported fields: freeListingTier (nullable int), ' +
+            "respectFreeQuota (bool). Pass connectionId to scope to a single eBay/Etsy connection when the seller has multiple. " +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    description: 'Platform id whose connection preferences to patch. Both supported fields are quota settings, so in ' +
+                        'practice this is "ebay" (Etsy tracks month-to-date fees rather than a quota). 404s with ' +
+                        'connection_not_found if you have no connection row on that platform.',
+                },
+                connectionId: {
+                    type: 'string',
+                    description: 'Optional UUID of ONE OAuth connection row (from list_oauth_connections) to scope the update to. Omit ' +
+                        'and every connection you hold on that platform is updated — pass it when the seller has more than one ' +
+                        'eBay/Etsy connection and only one should change.',
+                },
+                freeListingTier: {
+                    type: ['integer', 'null'],
+                    description: 'eBay zero-insertion-fee allowance as a COUNT OF LISTINGS per calendar month — the store-subscription ' +
+                        'tiers are 250, 1000, 10000, 25000, 100000. Must be a positive integer, or null to clear the manual ' +
+                        'override (the next limits read then auto-detects it from the seller\'s eBay Store subscription and ' +
+                        're-persists it). Omit to leave unchanged.',
+                },
+                respectFreeQuota: {
+                    type: 'boolean',
+                    description: 'When true, a crosspost that would push the seller past freeListingTier for the month is refused with ' +
+                        '402 and has to be explicitly confirmed; when false (the column default) crossposting is never blocked ' +
+                        'by the quota. Omit to leave unchanged.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['platform'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { platform, connectionId, idempotencyKey, ...body } = args;
+            const path = `/v1/platforms/${encodeURIComponent(platform)}/preferences${connectionId ? `?connection_id=${encodeURIComponent(connectionId)}` : ''}`;
+            return apiPatch(path, body, idempotencyKey);
+        },
+    },
+];
+//# sourceMappingURL=accounts.js.map

package/dist/tools/accounts.js.map

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

package/dist/tools/action_log.d.ts

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

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

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

package/dist/tools/action_log.js

@@ -0,0 +1,81 @@
+import { apiGet } from '../api.js';
+export const actionLogTools = [
+    {
+        name: 'list_action_log',
+        description: 'List the action log — the durable, queryable record of every action the seller or the system took across ' +
+            'marketplaces (list / delist / update / crosspost / connect / cookie-sync / send-message / send-offer / ' +
+            'submit-tracking / check-status / …). Answers "what happened": who, which item, which platform, ' +
+            'success or failure, how long it took. Use this to debug a failed crosspost, audit recent activity, or find ' +
+            'the event id you need before pulling its wire calls with get_action_log_calls. Filter by platform, action, ' +
+            'category (listing|connection|session|offer|order|inventory|auth|account|…), status ' +
+            '(pending|success|failure|partial|skipped), source, target, and a since/until created_at window. Newest first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                platform: { type: 'string', description: 'Restrict to one marketplace, e.g. "poshmark".' },
+                action: { type: 'string', description: 'Verb slug, e.g. "list", "delist", "crosspost", "cookie_sync".' },
+                category: { type: 'string', description: 'Coarse bucket, e.g. "listing", "connection", "offer", "order".' },
+                status: {
+                    type: 'string',
+                    description: 'One of pending | success | failure | partial | skipped. Use "failure" to find what broke.',
+                },
+                source: { type: 'string', description: 'Where it originated: web | mobile | api | sdk | mcp | worker | …' },
+                targetType: { type: 'string', description: 'What it operated on: listing | inventory_item | order | …' },
+                targetId: { type: 'string', description: 'Restrict to one target id.' },
+                since: { type: 'string', description: 'ISO timestamp — only events at/after this (inclusive).' },
+                until: { type: 'string', description: 'ISO timestamp — only events before this (exclusive).' },
+                limit: { type: 'integer', minimum: 1, maximum: 200, default: 50, description: 'Rows to return (1-200).' },
+                offset: { type: 'integer', minimum: 0, default: 0, description: 'Rows to skip (for paging).' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/action-log', {
+            platform: args.platform,
+            action: args.action,
+            category: args.category,
+            status: args.status,
+            source: args.source,
+            targetType: args.targetType,
+            targetId: args.targetId,
+            since: args.since,
+            until: args.until,
+            limit: args.limit,
+            offset: args.offset,
+        }),
+    },
+    {
+        name: 'action_log_facets',
+        description: 'Distinct platforms / actions / categories present in the seller\'s action log over the last 90 days. Call ' +
+            'this first to discover valid filter values before querying list_action_log.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/action-log/facets'),
+    },
+    {
+        name: 'get_action_log_event',
+        description: 'Fetch one action-log event by UUID — the full semantic record: request/result summaries, status, http status, ' +
+            'error class/message, latency, target, and metadata. Use before get_action_log_calls to see the high-level ' +
+            'outcome of an action.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Event UUID from list_action_log.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/action-log/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'get_action_log_calls',
+        description: 'Fetch the outbound platform HTTP calls under one action-log event (oldest first). Answers "what was sent / ' +
+            'what went wrong": url, method, status code, latency, redacted request + response body excerpts, error ' +
+            'class/message, and the proxy + recipe/hash used. This is the wire-level detail for debugging a failed ' +
+            'marketplace action — pass the event id from list_action_log.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Event UUID from list_action_log.' } },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/action-log/${encodeURIComponent(args.id)}/calls`),
+    },
+];
+//# sourceMappingURL=action_log.js.map

package/dist/tools/action_log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action_log.js","sourceRoot":"","sources":["../../src/tools/action_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,2GAA2G;YAC3G,yGAAyG;YACzG,iGAAiG;YACjG,6GAA6G;YAC7G,6GAA6G;YAC7G,qFAAqF;YACrF,+GAA+G;QACjH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;gBAC1F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;gBACxG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;gBAC3G,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2FAA2F;iBACzG;gBACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;gBAC3G,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBACxG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;gBACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;gBAChG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;gBAC9F,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE;gBACzG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE;aAC/F;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,MAAM,CAAC,gBAAgB,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;KACL;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,4GAA4G;YAC5G,6EAA6E;QAC/E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;KAC/C;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gHAAgH;YAChH,4GAA4G;YAC5G,uBAAuB;QACzB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,EAAE;YACvF,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,EAAY,CAAC,EAAE,CAAC;KACrF;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,6GAA6G;YAC7G,wGAAwG;YACxG,wGAAwG;YACxG,8DAA8D;QAChE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE,EAAE;YACvF,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,EAAY,CAAC,QAAQ,CAAC;KAC3F;CACF,CAAC"}

package/dist/tools/ads.d.ts

@@ -0,0 +1,45 @@
+import { ToolDef } from './types.js';
+/**
+ * Offsite ads — promoting a merchant's items on external ad networks.
+ *
+ * Separate from the CBX tools because it is a separate product: the
+ * budget is denominated in CBX and managed by the `*_cbx_ad_credit`
+ * tools, while these cover networks, creative, attribution and policy.
+ *
+ * ── WHAT AN AGENT MUST NOT MISREPRESENT ───────────────────────────────
+ * This feature asks a merchant to hand over discretion over their money
+ * to a party whose interests only partly overlap with theirs. Three
+ * things are true and must be stated accurately if a merchant asks:
+ *
+ *   OPT-IN ONLY. Off unless the merchant turns it on, and nothing
+ *   enables it on their behalf. Never describe it as default or
+ *   automatic.
+ *
+ *   MEDIA IS PASS-THROUGH AT COST, with a separate disclosed management
+ *   fee. `mediaCostCents` versus `managementFeeCents` in the report
+ *   answers "how much of my budget reached the auction", and that is a
+ *   question the merchant is entitled to a straight answer to.
+ *
+ *   THE RETURN FLOOR IS A STOP, NOT A GUARANTEE. Below it, spend
+ *   auto-pauses. Do NOT present `minReturnBps` as a promised return —
+ *   nobody can honestly promise ad performance.
+ *
+ * ── SPILLOVER IS REPORTED, NOT PAID FOR ───────────────────────────────
+ * When a click a merchant funded converts on somebody ELSE's item it is
+ * recorded as spillover and shown in their report. If a merchant asks
+ * why their conversion count is lower than their click volume suggests,
+ * spillover is usually the answer.
+ *
+ * It is NOT credited back, and saying otherwise is the specific error
+ * this section exists to prevent. Every ad market sells clicks — Etsy
+ * Offsite Ads actually CHARGES 12-15% on attributed sales — and a
+ * credit-back would be farmable with a decoy listing: advertise a cheap
+ * obscure item, drive broad traffic, and collect a share of Crossly's
+ * fee on every other seller's sale.
+ *
+ * What a merchant should do with a high spillover rate is turn offsite
+ * ads off. That is the remedy, and the return floor is the automatic
+ * version of it.
+ */
+export declare const adsTools: ToolDef[];
+//# sourceMappingURL=ads.d.ts.map

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

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