@crossly/mcp 0.0.0-stage → 0.1.0

package/dist/tools/automation/notifications.js

@@ -0,0 +1,123 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+/**
+ * Outbound notification destinations — the rows that notify.slack /
+ * notify.discord / notify.webhook automation actions point at via
+ * `actionConfig.integrationId`.
+ */
+export const notificationIntegrations = [
+    {
+        name: 'list_notification_integrations',
+        description: 'List the seller\'s outbound notification destinations. notify.* automation actions reference one of these by ' +
+            'integrationId. Provider is slack / discord / webhook. The webhookUrl is masked in the response.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/notification-integrations'),
+    },
+    {
+        name: 'create_notification_integration',
+        description: 'Add a notification destination. Slack/Discord: config = { webhookUrl }. Generic webhook: ' +
+            'config = { url, headers?: object, hmacSecret?: string }. The seller mints incoming-webhook URLs in Slack/Discord ' +
+            'admin or points the generic webhook at any URL.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['slack', 'discord', 'webhook'],
+                    description: 'Which wire the message goes out on, and therefore what config must contain. "slack" = POST ' +
+                        '{ text } to a Slack incoming webhook (config.webhookUrl); "discord" = POST { content } to a ' +
+                        'Discord channel webhook (config.webhookUrl); "webhook" = POST your own rendered JSON to any ' +
+                        'URL (config.url), optionally HMAC-SHA256 signed. Immutable after create — to change wires, ' +
+                        'create a second destination and repoint the rules.',
+                },
+                name: {
+                    type: 'string',
+                    maxLength: 80,
+                    description: 'Label the seller sees when picking a destination, e.g. "#sales channel". 1–80 characters.',
+                },
+                config: { type: 'object', description: 'Provider-shaped config.' },
+                enabled: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Whether notify.* actions may deliver here. Defaults to true; false parks the destination ' +
+                        'without deleting it.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['provider', 'name', 'config'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/notification-integrations', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'update_notification_integration',
+        description: 'Patch a notification destination (name / enabled / config). Only the fields you send change.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Destination UUID from list_notification_integrations.' },
+                name: { type: 'string', description: 'New display label, 1–80 characters. Omit to leave unchanged.' },
+                enabled: {
+                    type: 'boolean',
+                    description: 'Turn delivery on or off. false leaves the row and its rules intact but stops messages going ' +
+                        'out. Omit to leave unchanged.',
+                },
+                config: {
+                    type: 'object',
+                    description: 'Replacement provider config — it OVERWRITES the stored object rather than merging, so resend ' +
+                        'every key. { webhookUrl } for slack/discord; { url, headers?, hmacSecret? } for webhook, where ' +
+                        'hmacSecret signs the body into X-Crossly-Signature (sha256 hex) with X-Crossly-Timestamp. ' +
+                        'Reads mask hmacSecret, so never round-trip the masked value back. Omit to leave unchanged.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPatch(`/v1/notification-integrations/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'test_notification_integration',
+        description: 'Fire a canned test message to a notification destination (Slack/Discord/Webhook). Useful for "did I configure the ' +
+            'webhook URL correctly?" verification before wiring it into automation rules. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Destination UUID to test. Sends a timestamped "Crossly test notification" to config.webhookUrl ' +
+                        '(or config.url) and returns the destination\'s HTTP status; 400 if the row has no URL at all.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/notification-integrations/${encodeURIComponent(args.id)}/test`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'delete_notification_integration',
+        description: 'Delete a notification destination. Any automation actions pointing at it start failing on next fire.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Destination UUID to delete. Rules whose actionConfig.integrationId still names it will error ' +
+                        'on their next fire — repoint them first.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/notification-integrations/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+];
+//# sourceMappingURL=notifications.js.map

package/dist/tools/automation/notifications.js.map

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

package/dist/tools/automation/recipes.d.ts

@@ -0,0 +1,11 @@
+import { ToolDef } from '../types.js';
+/**
+ * Automation recipes — the portable JSON form of a rule.
+ *
+ * One rule ↔ one recipe: { schemaVersion: 1, name, description?, trigger:
+ * { type, config }, condition?: { type, config }, action: { type, config },
+ * platforms?, metadata? }. A bundle wraps many: { schemaVersion: 1,
+ * exportedAt?, recipes: [...] }. Both import paths accept either shape.
+ */
+export declare const automationRecipes: ToolDef[];
+//# sourceMappingURL=recipes.d.ts.map

package/dist/tools/automation/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../../src/tools/automation/recipes.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,EA6EtC,CAAC"}

package/dist/tools/automation/recipes.js

@@ -0,0 +1,82 @@
+import { apiGet, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+/**
+ * Automation recipes — the portable JSON form of a rule.
+ *
+ * One rule ↔ one recipe: { schemaVersion: 1, name, description?, trigger:
+ * { type, config }, condition?: { type, config }, action: { type, config },
+ * platforms?, metadata? }. A bundle wraps many: { schemaVersion: 1,
+ * exportedAt?, recipes: [...] }. Both import paths accept either shape.
+ */
+export const automationRecipes = [
+    {
+        name: 'export_automation_rules',
+        description: "Export the seller's full automation rule library as a portable recipe bundle (JSON). Suitable for backup, sharing, " +
+            'or migrating between accounts. The response is the bundle body itself — { schemaVersion: 1, exportedAt, recipes: [...] } ' +
+            'with every id, timestamp and user reference stripped.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/automation/rules/export'),
+    },
+    {
+        name: 'export_automation_rule',
+        description: 'Export a single automation rule as a portable recipe JSON object.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Rule UUID from list_automation_rules. Returns one recipe — { schemaVersion: 1, name, trigger, ' +
+                        'condition?, action, platforms? } — safe to share, since ids, timestamps and the owning user are stripped.',
+                },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/automation/rules/${encodeURIComponent(args.id)}/export`),
+    },
+    {
+        name: 'import_automation_recipes',
+        description: 'Import one or more rules from recipe JSON (single recipe or a bundle of recipes). Pass activate=true to leave the ' +
+            'imported rules enabled (default is paused so the seller can review first). The body must match the recipe schema. ' +
+            'Recipes whose trigger/condition/action fails catalog validation are skipped and returned in the response\'s ' +
+            '`errors` array — a partial import is a success, so always read both `created` and `errors`. ' +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                payload: { type: 'object', description: 'Recipe object or { schemaVersion, recipes: [...] } bundle.' },
+                activate: {
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether the imported rules are created enabled. Defaults to false — rules land paused with no ' +
+                        'nextRunAt so the seller reviews them first. true sets isActive and computes nextRunAt, meaning ' +
+                        'a schedule.* recipe can fire within the minute.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['payload'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const idempotencyKey = args.idempotencyKey;
+            const activate = args.activate === true;
+            const path = `/v1/automation/rules/import${activate ? '?activate=true' : ''}`;
+            return apiPost(path, args.payload, idempotencyKey);
+        },
+    },
+    {
+        name: 'validate_automation_recipe',
+        description: 'Dry-run validate one or more recipes against the live catalog WITHOUT importing. Returns per-recipe valid/errors. Use ' +
+            'this before import_automation_recipes to surface issues to the user.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                payload: { type: 'object', description: 'Recipe object or { schemaVersion, recipes: [...] } bundle.' },
+            },
+            required: ['payload'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/automation/rules/validate-recipe', args.payload),
+    },
+];
+//# sourceMappingURL=recipes.js.map

package/dist/tools/automation/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../../src/tools/automation/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAW,MAAM,aAAa,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,qHAAqH;YACrH,2HAA2H;YAC3H,uDAAuD;QACzD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC;KACrD;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,mEAAmE;QAChF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gGAAgG;wBAChG,2GAA2G;iBAC9G;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,MAAM,CAAC,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,EAAY,CAAC,SAAS,CAAC;KACjF;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,oHAAoH;YACpH,oHAAoH;YACpH,8GAA8G;YAC9G,8FAA8F;YAC9F,oCAAoC;QACtC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;gBACtG,QAAQ,EAAE;oBACR,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,KAAK;oBACd,WAAW,EACT,gGAAgG;wBAChG,iGAAiG;wBACjG,iDAAiD;iBACpD;gBACD,GAAG,gBAAgB;aACpB;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,cAAc,GAAG,IAAI,CAAC,cAAoC,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;YACxC,MAAM,IAAI,GAAG,8BAA8B,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9E,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAkC,EAAE,cAAc,CAAC,CAAC;QAChF,CAAC;KACF;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,wHAAwH;YACxH,sEAAsE;QACxE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;aACvG;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,OAAO,CAAC,sCAAsC,EAAE,IAAI,CAAC,OAAkC,CAAC;KAC3F;CACF,CAAC"}

package/dist/tools/automation/rules.d.ts

@@ -0,0 +1,12 @@
+import { ToolDef } from '../types.js';
+/**
+ * Single-rule automation: trigger → (condition) → action.
+ *
+ * triggerType / conditionType / actionType are a CONTROLLED VOCABULARY —
+ * the dotted catalog ids in `lib/automation-catalog/`. Call
+ * `get_automation_catalog` for the live list plus each entry's
+ * configSchema; the ids named in the argument descriptions below are real
+ * but not exhaustive.
+ */
+export declare const automationRules: ToolDef[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/tools/automation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/tools/automation/rules.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,EAuUpC,CAAC"}

package/dist/tools/automation/rules.js

@@ -0,0 +1,296 @@
+import { apiDelete, apiGet, apiPost, apiPut } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+/**
+ * Single-rule automation: trigger → (condition) → action.
+ *
+ * triggerType / conditionType / actionType are a CONTROLLED VOCABULARY —
+ * the dotted catalog ids in `lib/automation-catalog/`. Call
+ * `get_automation_catalog` for the live list plus each entry's
+ * configSchema; the ids named in the argument descriptions below are real
+ * but not exhaustive.
+ */
+export const automationRules = [
+    {
+        name: 'list_automation_rules',
+        description: 'List the seller\'s automation rules (e.g. "every 12h re-share my top 50 Poshmark closet items", ' +
+            '"auto-decline offers below 60% of asking", "send a thank-you message after every sale"). ' +
+            'Each rule has triggerType+triggerConfig, optional conditionType+conditionConfig, actionType+actionConfig, ' +
+            'target platforms, isActive, and the scheduler bookkeeping (nextRunAt / lastRunAt / runCount). ' +
+            'Use this before create_automation_rule to avoid duplicates.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        handler: () => apiGet('/v1/automation/rules'),
+    },
+    {
+        name: 'create_automation_rule',
+        description: 'Create a new automation rule: triggerType decides WHEN it fires, the optional conditionType gates ' +
+            'WHETHER the action runs, actionType decides WHAT happens. All three are dotted catalog ids — call ' +
+            'get_automation_catalog first and read each entry\'s configSchema, because the matching *Config object ' +
+            'is validated against it. NOTE: this create path stores the row without computing nextRunAt, so a ' +
+            'schedule.* rule does not start ticking until it is armed by update_automation_rule, ' +
+            'toggle_automation_rule or run_automation_rule_now. Event-driven triggers (listing.sold, ' +
+            'inbox.offer_received, …) fire from event hooks and need no arming. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    maxLength: 120,
+                    description: 'Human-readable rule name shown in the seller\'s automation list. 1–120 characters.',
+                },
+                triggerType: {
+                    type: 'string',
+                    description: 'Catalog trigger id — when the rule fires. Schedules: "schedule.cron", "schedule.daily", ' +
+                        '"schedule.interval", "schedule.window". Listing events: "listing.created", "listing.sold", ' +
+                        '"listing.liked", "listing.commented", "listing.price_dropped", "listing.age_reached", ' +
+                        '"listing.no_views_after", "listing.metric_threshold". Orders: "order.shipped", ' +
+                        '"order.ship_by_soon", "order.ship_by_overdue", "order.delivered", "order.disputed", ' +
+                        '"order.returned", "order.refunded", "order.cancelled", "order.unshipped_after". Also ' +
+                        '"inbox.offer_received", "inbox.ebay_offer_received", "inbox.message_received", ' +
+                        '"inventory.low_stock", "inventory.zero_qty", "market.competitor_underprice", ' +
+                        '"platform.disconnected". get_automation_catalog returns the authoritative list.',
+                },
+                triggerConfig: {
+                    type: 'object',
+                    description: 'Parameters for the chosen triggerType, keyed exactly as its catalog configSchema. ' +
+                        '{ cron: "0 9 * * *", timezone: "America/New_York" } for schedule.cron; { hourUtc: 9 } (0–23) ' +
+                        'for schedule.daily; { intervalMinutes: 720 } for schedule.interval — MINUTES, and the server ' +
+                        'floors it at 15, rejecting anything smaller; { startsAt, endsAt } ISO-8601 datetimes for ' +
+                        'schedule.window; { ageDays: 30 } for listing.age_reached; { threshold: 1 } for ' +
+                        'inventory.low_stock. Pass {} for triggers that take no config.',
+                },
+                actionType: {
+                    type: 'string',
+                    description: 'Catalog action id — what the rule does. Pricing: "listing.price_drop", "listing.reprice", ' +
+                        '"listing.price_raise", "listing.timed_discount", "listing.sync_price_to_lowest". Engagement: ' +
+                        '"listing.share_closet", "listing.share", "listing.community_share", "listing.like_for_like", ' +
+                        '"listing.share_for_share", "network.share_pool", "network.follow_pool", "network.like_pool". ' +
+                        'Offers/inbox: "listing.send_offer_to_likers", ' +
+                        '"listing.ebay_send_offer_to_interested_buyers", "inbox.send_message", "inbox.send_thank_you", ' +
+                        '"inbox.auto_decline_low_offer", "inbox.counter_offer", "inbox.offer_auto_respond", ' +
+                        '"inbox.archive_scam". Lifecycle: "listing.auto_relist", "listing.delist", ' +
+                        '"listing.archive_stale", "listing.expand_platforms", "listing.update_field", ' +
+                        '"listing.add_tag", "order.cancel", "account.toggle_vacation". Notifications: "notify.slack", ' +
+                        '"notify.discord", "notify.telegram", "notify.webhook", "notify.email_user".',
+                },
+                actionConfig: {
+                    type: 'object',
+                    description: 'Parameters for the chosen actionType, keyed exactly as its catalog configSchema. ' +
+                        '{ mode: "percent", percent: 5, floor: 20 } for listing.price_drop (percent is a PERCENTAGE, ' +
+                        'floor/fixedAmount are USD dollars); { maxItems: 50, delayMs: 3000, order: "newest" } for ' +
+                        'listing.share_closet (delayMs is MILLISECONDS between shares); { strategy: "undercut_lowest", ' +
+                        'undercutByCents: 100, floorCents: 2500 } for listing.reprice (every *Cents field is integer ' +
+                        'CENTS; strategy is undercut_lowest | match_market | scheduled_decay | raise_back | sold_median, and ' +
+                        '{ strategy: "sold_median", percentile: "median", requireApproval: true } with triggerType ' +
+                        'listing.age_reached { ageDays: 30 } drops a still-unsold listing to what the same catalog product sold ' +
+                        'for — down only, holding when the listing has no market SKU or too few sales); { integrationId, template } for notify.slack / notify.discord / notify.webhook, where ' +
+                        'integrationId is a notification_integrations UUID from list_notification_integrations and the ' +
+                        'template supports {{listingTitle}} / {{price}} / {{buyerName}} / {{platform}} / {{saleAmount}}.',
+                },
+                conditionType: {
+                    type: 'string',
+                    description: 'Optional gate — the action only runs when this matches. Catalog condition ids are ' +
+                        '"listing.platform", "listing.price_range", "listing.price_above", "listing.price_below", ' +
+                        '"listing.age_range", "listing.has_tags", "listing.has_label". Omit (or send "none") to run ' +
+                        'the action on every fire.',
+                },
+                conditionConfig: {
+                    type: 'object',
+                    description: 'Parameters for the chosen conditionType. { platforms: ["poshmark"] } for listing.platform; ' +
+                        '{ threshold: 50 } USD dollars for listing.price_above / listing.price_below; ' +
+                        '{ minPrice, maxPrice } USD dollars for listing.price_range; { minDays, maxDays } for ' +
+                        'listing.age_range; { tags: ["vintage"], matchAll: false } for listing.has_tags.',
+                },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional rule-level platform slugs (e.g. ["poshmark","mercari","ebay"]). Only ' +
+                        'listing.timed_discount currently reads this column — every other action takes its own ' +
+                        'platform filter inside actionConfig.platforms, so set that too. Omit for all platforms.',
+                },
+                isActive: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Whether the rule is enabled. Defaults to true; pass false to create it paused so the user can ' +
+                        'review it before it can fire.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['name', 'triggerType', 'triggerConfig', 'actionType', 'actionConfig'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/automation/rules', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'get_automation_rule',
+        description: 'Get a single automation rule by id, with its full trigger / condition / action config.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Rule UUID.' },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/automation/rules/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'update_automation_rule',
+        description: 'Full-replace update of an automation rule (PUT). Body shape mirrors create — pass every field, because ' +
+            'omitted ones are not preserved. Unlike create, this path validates triggerType / conditionType / ' +
+            'actionType against the live catalog (unknown ids are rejected 400), validates each config against the ' +
+            'catalog configSchema, and recomputes nextRunAt for schedule triggers — so it is also how you arm a ' +
+            'schedule rule that create left unscheduled. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'UUID of the rule to replace, from list_automation_rules.' },
+                name: {
+                    type: 'string',
+                    description: 'Rule name. Required by the server on this route; 1–200 characters.',
+                },
+                triggerType: {
+                    type: 'string',
+                    description: 'Catalog trigger id — must be one the catalog knows (e.g. "schedule.interval", ' +
+                        '"listing.sold", "inbox.offer_received", "order.unshipped_after"). An unknown id is a 400.',
+                },
+                triggerConfig: {
+                    type: 'object',
+                    description: 'Config for triggerType, keyed as its catalog configSchema — e.g. { intervalMinutes: 720 } ' +
+                        '(MINUTES, minimum 15) or { hourUtc: 9 } (0–23 UTC). Validated before the row is written, so a ' +
+                        'rule that could not be scheduled cannot be saved.',
+                },
+                actionType: {
+                    type: 'string',
+                    description: 'Catalog action id — e.g. "listing.price_drop", "listing.share_closet", "notify.slack". ' +
+                        'An id outside the catalog is a 400.',
+                },
+                actionConfig: {
+                    type: 'object',
+                    description: 'Config for actionType, keyed as its catalog configSchema. Mind the units: `percent` fields are ' +
+                        'percentages, `*Cents` fields are integer CENTS, plain price/floor fields are USD dollars, and ' +
+                        '`delayMs` / `waitMs` are MILLISECONDS.',
+                },
+                conditionType: {
+                    type: 'string',
+                    description: 'Catalog condition id gating the action ("listing.price_above", "listing.has_tags", …), or ' +
+                        '"none". Defaults to "none" (always run) when omitted.',
+                },
+                conditionConfig: {
+                    type: 'object',
+                    description: 'Config for conditionType — e.g. { threshold: 50 } in USD dollars for listing.price_above. ' +
+                        'Defaults to {} and is ignored when conditionType is "none".',
+                },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Rule-level platform slugs, or omit/null for all. Read today only by listing.timed_discount; ' +
+                        'other actions filter via actionConfig.platforms.',
+                },
+                isActive: {
+                    type: 'boolean',
+                    description: 'Enabled flag. Defaults to true. false also clears nextRunAt, so the scheduler stops ticking ' +
+                        'the rule entirely.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPut(`/v1/automation/rules/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'toggle_automation_rule',
+        description: 'Flip an automation rule between active and inactive. Schedule-trigger rules also get their nextRunAt recomputed when ' +
+            'flipping back to active. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Rule UUID. The server reads the row and inverts its current isActive — there is no on/off ' +
+                        'argument, so read the rule first if you need a specific end state.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/automation/rules/${encodeURIComponent(args.id)}/toggle`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'run_automation_rule_now',
+        description: 'Fire an automation rule immediately, regardless of its trigger. Useful for "test this rule" workflows. Returns the ' +
+            "queued jobId. Updates lastRunAt + runCount on the rule. Pass an idempotencyKey on retries — but note that 'run-now' " +
+            'really does run a fresh execution every time the idempotency cache misses.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Rule UUID to fire now. The run happens even when the rule is inactive, and it also recomputes ' +
+                        'nextRunAt — so this doubles as a way to arm a schedule rule.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/automation/rules/${encodeURIComponent(args.id)}/run-now`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'delete_automation_rule',
+        description: 'Permanently delete an automation rule. Past actions it took remain in the audit log. ' +
+            'If you just want to pause a rule, toggle_automation_rule (or update it to isActive=false) instead. ' +
+            'Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Rule UUID from list_automation_rules.' },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/automation/rules/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+    {
+        name: 'list_automation_runs',
+        description: 'Per-fire log for automation rules and workflow chains. Each row carries status (success / partial / ' +
+            'failure / skipped), actionType, durationMs, errorMessage (when failed), and a summary jsonb. Filter by ' +
+            'ruleId or chainId to debug "is my rule actually firing?" — without filters returns the 100 most recent fires.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ruleId: {
+                    type: 'string',
+                    description: 'Optional rule UUID — return only fires of that single automation rule.',
+                },
+                chainId: {
+                    type: 'string',
+                    description: 'Optional workflow-chain UUID — return only step runs belonging to that chain.',
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                    description: 'How many runs to return, newest first by createdAt. 1–500, default 100; the server clamps ' +
+                        'out-of-range values rather than erroring.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/automation/runs', args),
+    },
+];
+//# sourceMappingURL=rules.js.map

package/dist/tools/automation/rules.js.map

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

package/dist/tools/automation.d.ts

@@ -0,0 +1,31 @@
+import { ToolDef } from './types.js';
+/**
+ * Automation — rules, chains, recipes, notification destinations and the
+ * Crossly Network pool.
+ *
+ * ── THE IDS ARE A CONTROLLED VOCABULARY ───────────────────────────────
+ * triggerType / conditionType / actionType (and a chain's triggerId +
+ * per-step actionId) are dotted catalog ids defined in the api's
+ * `lib/automation-catalog/` — "schedule.interval", "listing.sold",
+ * "listing.price_drop", "notify.slack". They are NOT free text, and an
+ * id the catalog does not know is rejected. `get_automation_catalog`
+ * returns the live list together with each entry's `configSchema`, which
+ * is what the matching triggerConfig / conditionConfig / actionConfig
+ * object is validated against. Read it before composing a rule rather
+ * than guessing a plausible-looking name.
+ *
+ * ── UNITS DIFFER BETWEEN CONFIG KEYS ──────────────────────────────────
+ * Inside these free-form config objects: `*Cents` keys are integer CENTS,
+ * plain price/floor/threshold keys are USD DOLLARS, `percent`/`*Pct` keys
+ * are percentages, `delayMs` / `waitMs` are MILLISECONDS, and
+ * `intervalMinutes` is MINUTES (floored at 15 by the server).
+ *
+ * ── CREATING A SCHEDULED RULE DOES NOT SCHEDULE IT ────────────────────
+ * `create_automation_rule` writes the row without a nextRunAt, and the
+ * scheduler only picks up rules that have one. A schedule.* rule made
+ * this way sits inert until `update_automation_rule`,
+ * `toggle_automation_rule` or `run_automation_rule_now` arms it.
+ * Event-driven triggers fire from hooks and need no arming.
+ */
+export declare const automationTools: ToolDef[];
+//# sourceMappingURL=automation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/tools/automation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,EAMpC,CAAC"}

package/dist/tools/automation.js

@@ -0,0 +1,41 @@
+import { automationRecipes } from './automation/recipes.js';
+import { automationRules } from './automation/rules.js';
+import { networkPool } from './automation/network.js';
+import { notificationIntegrations } from './automation/notifications.js';
+import { workflowChains } from './automation/chains.js';
+/**
+ * Automation — rules, chains, recipes, notification destinations and the
+ * Crossly Network pool.
+ *
+ * ── THE IDS ARE A CONTROLLED VOCABULARY ───────────────────────────────
+ * triggerType / conditionType / actionType (and a chain's triggerId +
+ * per-step actionId) are dotted catalog ids defined in the api's
+ * `lib/automation-catalog/` — "schedule.interval", "listing.sold",
+ * "listing.price_drop", "notify.slack". They are NOT free text, and an
+ * id the catalog does not know is rejected. `get_automation_catalog`
+ * returns the live list together with each entry's `configSchema`, which
+ * is what the matching triggerConfig / conditionConfig / actionConfig
+ * object is validated against. Read it before composing a rule rather
+ * than guessing a plausible-looking name.
+ *
+ * ── UNITS DIFFER BETWEEN CONFIG KEYS ──────────────────────────────────
+ * Inside these free-form config objects: `*Cents` keys are integer CENTS,
+ * plain price/floor/threshold keys are USD DOLLARS, `percent`/`*Pct` keys
+ * are percentages, `delayMs` / `waitMs` are MILLISECONDS, and
+ * `intervalMinutes` is MINUTES (floored at 15 by the server).
+ *
+ * ── CREATING A SCHEDULED RULE DOES NOT SCHEDULE IT ────────────────────
+ * `create_automation_rule` writes the row without a nextRunAt, and the
+ * scheduler only picks up rules that have one. A schedule.* rule made
+ * this way sits inert until `update_automation_rule`,
+ * `toggle_automation_rule` or `run_automation_rule_now` arms it.
+ * Event-driven triggers fire from hooks and need no arming.
+ */
+export const automationTools = [
+    ...automationRules,
+    ...automationRecipes,
+    ...workflowChains,
+    ...notificationIntegrations,
+    ...networkPool,
+];
+//# sourceMappingURL=automation.js.map