@crossly/mcp 0.0.0-stage → 0.2.0

package/dist/tools/analytics.js

@@ -0,0 +1,193 @@
+import { apiGet } from '../api.js';
+export const analyticsTools = [
+    {
+        name: 'get_analytics_summary',
+        description: 'Headline KPIs over a recent window — total sales count, gross revenue, total platform fees — for the ' +
+            'last N days (default 30, max 365). Use this for "how did I do this month / week / quarter" questions ' +
+            'instead of summing list_sales pages yourself.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 365,
+                    default: 30,
+                    description: 'Rolling window size in days. 7=week, 30=month, 90=quarter, 365=year.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/analytics/summary', { days: args.days }),
+    },
+    {
+        name: 'get_analytics_by_platform',
+        description: 'Sales count, revenue, fees, and net profit grouped by platform for the last N days. Use this to answer ' +
+            '"which platform is making me the most money?" or "where are my fees eating margin?".',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 365,
+                    default: 30,
+                    description: 'Rolling window size in days, counted back from right now (not from midnight): the server groups every ' +
+                        'sale whose detectedAt is within the last `days` x 24h. Default 30, clamped to 365. 7=week, 90=quarter, ' +
+                        '365=year. revenue/fees/netProfit in the response are DOLLARS (decimal), not cents.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/analytics/by-platform', { days: args.days }),
+    },
+    {
+        name: 'get_analytics_timeseries',
+        description: 'Daily sales count + gross revenue for the last N days. Useful for spotting trends or building charts. ' +
+            'Returns one row per day with `day` (YYYY-MM-DD), `sales`, and `revenue`.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 365,
+                    default: 30,
+                    description: 'Rolling window size in days, counted back from right now. Default 30, clamped to 365. Buckets are UTC ' +
+                        'CALENDAR days (`day` is YYYY-MM-DD in UTC), so the first and last bucket are usually partial. Days with ' +
+                        'no sales are OMITTED rather than returned as zero — do not assume `days` rows back. `revenue` is DOLLARS.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/analytics/timeseries', { days: args.days }),
+    },
+    {
+        name: 'get_analytics_dashboard',
+        description: "Composite dashboard payload — 20+ aggregates rolled into one response: revenue/profit/soldCount/avgPrice " +
+            "(current + previous + pctChange), sellThroughRate, avgDaysToSell, salesByPlatform, avgSalePriceByPlatform, " +
+            "revenueByDay, topCategories, topSubcategories, topBrands, top5ItemsByRevenue, recentSales, availableLabels. " +
+            "Use this for the home dashboard view rather than fanning out across 20 separate analytics calls. " +
+            "Range: 7d/30d/90d/1y/custom (with startDate+endDate for custom). Comma-separated `labels` filters by inventory label.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                range: {
+                    type: 'string',
+                    enum: ['7d', '30d', '90d', '1y', 'custom'],
+                    default: '30d',
+                    description: 'Which window the "current" numbers cover. Preset buckets all run from midnight N days ago to now: ' +
+                        '"7d"=last 7 days, "30d"=last 30 (default), "90d"=last 90, "1y"=last 365 days (a rolling year, NOT a ' +
+                        'calendar year — use get_analytics_bookkeeping for that). "custom" uses startDate+endDate instead. ' +
+                        'Whatever the window, the server also computes the equally-long period immediately before it and returns ' +
+                        'it as the `previous`/`pctChange` half of each KPI.',
+                },
+                startDate: {
+                    type: 'string',
+                    description: 'First day of a custom window, YYYY-MM-DD (any Date-parseable string works). INCLUSIVE — snapped down to ' +
+                        '00:00:00 local server time. Only read when range="custom", and BOTH startDate and endDate must be ' +
+                        'present or the server silently falls back to the 30-day window.',
+                },
+                endDate: {
+                    type: 'string',
+                    description: 'Last day of a custom window, YYYY-MM-DD. INCLUSIVE — snapped up to 23:59:59.999 local server time, so ' +
+                        'sales made that day are counted. Only read when range="custom", and requires startDate alongside it.',
+                },
+                labels: {
+                    type: 'string',
+                    description: 'Comma-separated inventory labels (e.g. "thrift,consignment"). Restricts every KPI to sales whose ' +
+                        'inventory item carries AT LEAST ONE of them (OR, not AND). Omit for all sales. The valid values for ' +
+                        'this seller come back as `availableLabels` in the response.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/analytics/dashboard', {
+            range: args.range,
+            startDate: args.startDate,
+            endDate: args.endDate,
+            labels: args.labels,
+        }),
+    },
+    {
+        name: 'get_analytics_today',
+        description: "Today's seller checklist + 14-day activity streak: { checklist: { ordersToShip, unreadMessages, " +
+            "listingsStaleEnoughToRelist, draftsWaiting }, streak: { current, longest, lastActiveDate }, " +
+            "activitySparkline: number[14] }. Drives the 'today view' on web + mobile home screens.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/analytics/today'),
+    },
+    {
+        name: 'get_analytics_items',
+        description: "Per-item P&L for sold inventory — paginated, sortable. Each row carries { saleId, platform, itemTitle, " +
+            "itemBrand, itemSku, salePrice, platformFee, shippingCost, costOfGoods, netProfit, marginPct, daysToSell, " +
+            "detectedAt }. Use this for 'show me my best/worst margin items' or P&L drilldowns.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: {
+                    type: 'integer',
+                    minimum: 1,
+                    default: 1,
+                    description: '1-indexed page number (default 1). Increment to walk the next page; `total` in the response is the full ' +
+                        'row count, so the last page is ceil(total / limit). There is no date filter here — this walks ALL sold ' +
+                        'items ever, newest first by default.',
+                },
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 100,
+                    default: 20,
+                    description: 'Rows per page, 1-100. Default 20 (note: NOT the 25 most other list tools use).',
+                },
+                sortBy: {
+                    type: 'string',
+                    enum: ['salePrice', 'costOfGoods', 'netProfit', 'margin', 'platform', 'daysToSell', 'detectedAt'],
+                    default: 'detectedAt',
+                    description: 'Which column orders the page. "salePrice"=what the buyer paid (DOLLARS); "costOfGoods"=snapshot COGS ' +
+                        'for the item (DOLLARS); "netProfit"=sale − platform fee − shipping − COGS, derived live (DOLLARS); ' +
+                        '"margin"=netProfit as a PERCENT of salePrice, so it ranks small cheap wins alongside big ones; ' +
+                        '"platform"=alphabetical by marketplace; "daysToSell"=days between the inventory item being created and ' +
+                        'the sale being detected; "detectedAt"=when the sale was detected (default — i.e. most recent first).',
+                },
+                sortOrder: {
+                    type: 'string',
+                    enum: ['asc', 'desc'],
+                    default: 'desc',
+                    description: 'Direction for sortBy. "desc" (default) = biggest/newest first — best-margin or most-recent items. ' +
+                        '"asc" = smallest/oldest first, which is how you find the loss-makers and the slowest movers.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/analytics/items', {
+            page: args.page,
+            limit: args.limit,
+            sortBy: args.sortBy,
+            sortOrder: args.sortOrder,
+        }),
+    },
+    {
+        name: 'get_analytics_bookkeeping',
+        description: "Monthly P&L + per-platform breakdown for a calendar year. Returns { year, monthlyPL: [{ month, revenue, " +
+            "cogs, platformFees, shippingCosts, netProfit }] x12, annualTotals: {...}, platformBreakdown: [{ platform, " +
+            "revenue, count, platformFees, netProfit }] }. Designed for tax-time + accounting exports.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                year: { type: 'integer', minimum: 2020, maximum: 2099, description: 'Calendar year. Defaults to current year.' },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/analytics/bookkeeping', { year: args.year }),
+    },
+    {
+        name: 'get_insights_by_platform',
+        description: "Platform velocity + margin insight over the last 90 days. Returns { rows: [{ platform, sales, gross_cents, " +
+            "avg_days_to_sale, avg_sale_cents, net_cents }] }. Different from get_analytics_by_platform — this one is " +
+            "tuned for 'which platform am I selling fastest on and at what margin?' decisions over a fixed 90-day window.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/insights/by-platform'),
+    },
+];
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

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

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

@@ -0,0 +1,10 @@
+import { ToolDef } from '../types.js';
+/**
+ * Workflow chains — one trigger, then an ordered list of steps.
+ *
+ * A chain's triggerId and every action/condition step id come from the same
+ * automation catalog the single-rule tools use (`get_automation_catalog`).
+ * The server rejects an id it does not know, so never invent one.
+ */
+export declare const workflowChains: ToolDef[];
+//# sourceMappingURL=chains.d.ts.map

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

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

package/dist/tools/automation/chains.js

@@ -0,0 +1,180 @@
+import { apiDelete, apiGet, apiPost, apiPut } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+/**
+ * Workflow chains — one trigger, then an ordered list of steps.
+ *
+ * A chain's triggerId and every action/condition step id come from the same
+ * automation catalog the single-rule tools use (`get_automation_catalog`).
+ * The server rejects an id it does not know, so never invent one.
+ */
+export const workflowChains = [
+    {
+        name: 'list_workflow_chains',
+        description: 'List multi-step automation chains. A chain is a triggerId + an ordered list of steps where each step is ' +
+            'an action, a wait, or a condition (branching). Use this to discover existing chains before creating one.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/workflow-chains'),
+    },
+    {
+        name: 'get_workflow_chain',
+        description: 'Get one workflow chain with its full step graph.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Chain UUID from list_workflow_chains. Returns { chain, steps } ordered by position.',
+                },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet(`/v1/workflow-chains/${encodeURIComponent(args.id)}`),
+    },
+    {
+        name: 'create_workflow_chain',
+        description: 'Create a workflow chain. triggerId comes from the automation catalog (e.g. "listing.sold", "order.shipped"). ' +
+            'Each step is { stepType: "action"|"wait"|"condition", actionId?: string, actionConfig?: object, waitMs?: integer }. ' +
+            'Action + condition steps require actionId (catalog id); wait steps require waitMs. Condition steps may include ' +
+            '`actionConfig.skipSteps` — number of steps to skip when false. Up to 50 steps per chain.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    maxLength: 200,
+                    description: 'Human-readable chain name shown in the seller\'s workflow list. 1–200 characters.',
+                },
+                triggerId: { type: 'string', description: 'Catalog triggerId (call get_automation_catalog to discover).' },
+                triggerConfig: { type: 'object', description: 'Trigger config matching the catalog entry.' },
+                steps: {
+                    type: 'array',
+                    description: 'Ordered step list.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            stepType: { type: 'string', enum: ['action', 'wait', 'condition'] },
+                            actionId: { type: 'string' },
+                            actionConfig: { type: 'object' },
+                            waitMs: { type: 'integer', minimum: 0 },
+                        },
+                        required: ['stepType'],
+                    },
+                    minItems: 1,
+                    maxItems: 50,
+                },
+                isActive: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Whether the chain may fire. Defaults to true; pass false to save it paused while the user ' +
+                        'reviews the step list.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['name', 'triggerId', 'steps'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPost('/v1/workflow-chains', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'update_workflow_chain',
+        description: 'Replace a workflow chain wholesale. Same body shape as create_workflow_chain (name/triggerId/triggerConfig/' +
+            'steps/isActive). Steps are reassigned positions 0..N — no diff-merge.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'UUID of the chain to replace, from list_workflow_chains.' },
+                name: { type: 'string', description: 'New chain name, 1–200 characters. Required — this is a full replace.' },
+                triggerId: {
+                    type: 'string',
+                    description: 'Catalog trigger id that starts the chain — e.g. "listing.sold", "order.shipped", ' +
+                        '"inbox.message_received", "inventory.low_stock". Must exist in the catalog or the server 400s.',
+                },
+                triggerConfig: {
+                    type: 'object',
+                    description: 'Config for triggerId, keyed as its catalog configSchema. Defaults to {} (fire on every event). ' +
+                        'Only a few triggers filter on it: { intent: "offer" } for inbox.message_received, ' +
+                        '{ threshold: 1 } for inventory.low_stock, { minDeltaPercent: 5 } for market.competitor_underprice.',
+                },
+                steps: {
+                    type: 'array',
+                    description: 'The complete new ordered step list, 1–50 entries — the old steps are deleted and these are ' +
+                        'reinserted at positions 0..N. Each entry is { stepType: "action"|"wait"|"condition", actionId?, ' +
+                        'actionConfig?, waitMs? }: "action" needs a catalog action id in actionId, "condition" needs a ' +
+                        'catalog condition id in actionId (plus optional actionConfig.skipSteps — how many steps to jump ' +
+                        'when it is false; omitted means skip the rest of the chain), "wait" needs waitMs in MILLISECONDS ' +
+                        '(0 to 7776000000, i.e. 90 days).',
+                },
+                isActive: {
+                    type: 'boolean',
+                    description: 'Whether the chain may fire after the replace. Defaults to true if omitted.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'name', 'triggerId', 'steps'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPut(`/v1/workflow-chains/${encodeURIComponent(id)}`, body, idempotencyKey);
+        },
+    },
+    {
+        name: 'toggle_workflow_chain',
+        description: 'Flip a workflow chain between active and inactive. Pass an idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Chain UUID. The server inverts the chain\'s current isActive and returns the updated row — ' +
+                        'there is no explicit on/off argument.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/workflow-chains/${encodeURIComponent(args.id)}/toggle`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'run_workflow_chain_now',
+        description: 'Enqueue an ad-hoc run of a workflow chain. Returns the chainRunId. Useful for "test this chain" workflows. Pass an ' +
+            'idempotencyKey on retries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Chain UUID to run now. The run starts at step 0 with trigger data { manual: true, firedAt }, ' +
+                        'so steps that read real trigger fields (listing, order, buyer) may find them missing.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost(`/v1/workflow-chains/${encodeURIComponent(args.id)}/run-now`, {}, args.idempotencyKey),
+    },
+    {
+        name: 'delete_workflow_chain',
+        description: 'Delete a workflow chain. Cascades to its steps + run history.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Chain UUID to delete. Irreversible — its steps and run history go with it.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id'],
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete(`/v1/workflow-chains/${encodeURIComponent(args.id)}`, args.idempotencyKey),
+    },
+];
+//# sourceMappingURL=chains.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { ToolDef } from '../types.js';
+/**
+ * Crossly Network — the opt-in reciprocal engagement pool that the
+ * network.share_pool / network.follow_pool / network.like_pool automation
+ * actions draw their candidates from.
+ */
+export declare const networkPool: ToolDef[];
+//# sourceMappingURL=network.d.ts.map

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

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

package/dist/tools/automation/network.js

@@ -0,0 +1,102 @@
+import { apiDelete, apiGet, apiPatch, apiPost } from '../../api.js';
+import { IDEMPOTENCY_PROP } from '../types.js';
+/**
+ * Crossly Network — the opt-in reciprocal engagement pool that the
+ * network.share_pool / network.follow_pool / network.like_pool automation
+ * actions draw their candidates from.
+ */
+export const networkPool = [
+    {
+        name: 'get_network_pool_membership',
+        description: "Read the seller's Crossly Network pool membership row. Includes per-action toggles (shareEnabled / followEnabled / likeEnabled), opted-in platforms, karma counters (engagementsPerformed / engagementsReceived). Returns { member: null } when the seller has not joined.",
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/network/pool'),
+    },
+    {
+        name: 'get_network_pool_size',
+        description: 'Total members in the pool. Use as the "how big is the network" stat.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        handler: () => apiGet('/v1/network/pool/size'),
+    },
+    {
+        name: 'list_network_pool_log',
+        description: 'Recent engagement history. Each row records (engager → target, actionType, platform, performedAt). Both sent + received are surfaced.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 500,
+                    default: 100,
+                    description: 'How many engagement rows to return, newest first by performedAt. 1–500, default 100; the ' +
+                        'server clamps out-of-range values rather than erroring.',
+                },
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => apiGet('/v1/network/pool/log', args),
+    },
+    {
+        name: 'join_network_pool',
+        description: "Opt the seller into the Crossly Network reciprocal engagement pool. Required before the network.share_pool / " +
+            'network.follow_pool / network.like_pool automation actions will fire. Idempotent — joining twice returns ' +
+            'joined:false rather than erroring. The new row starts with all three action toggles ON and platforms empty ' +
+            '(= every connected platform).',
+        inputSchema: {
+            type: 'object',
+            properties: { ...IDEMPOTENCY_PROP },
+            additionalProperties: false,
+        },
+        handler: (args) => apiPost('/v1/network/pool', {}, args.idempotencyKey),
+    },
+    {
+        name: 'update_network_pool_membership',
+        description: 'Patch per-action toggles + opted-in platforms on the pool membership row. Only the fields you send ' +
+            'change; 404s if the seller has not joined the pool yet.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                shareEnabled: {
+                    type: 'boolean',
+                    description: 'Whether the seller participates in sharing — both performing shares for other members and ' +
+                        'being picked as a share target. Defaults to true on join. Omit to leave unchanged.',
+                },
+                followEnabled: {
+                    type: 'boolean',
+                    description: 'Whether the seller participates in reciprocal follows (network.follow_pool). Defaults to true ' +
+                        'on join. Omit to leave unchanged.',
+                },
+                likeEnabled: {
+                    type: 'boolean',
+                    description: 'Whether the seller participates in reciprocal likes (network.like_pool). Defaults to true on ' +
+                        'join. Omit to leave unchanged.',
+                },
+                platforms: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Platform slugs the seller opts into, e.g. ["poshmark","mercari"]. Stored comma-joined; an ' +
+                        'empty array means every platform the seller is connected on. Replaces the stored list rather ' +
+                        'than adding to it. Omit to leave unchanged.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { idempotencyKey, ...body } = args;
+            return apiPatch('/v1/network/pool', body, idempotencyKey);
+        },
+    },
+    {
+        name: 'leave_network_pool',
+        description: "Drop out of the pool. Network.* automation actions stop firing; other members stop engaging with the seller's catalog.",
+        inputSchema: {
+            type: 'object',
+            properties: { ...IDEMPOTENCY_PROP },
+            additionalProperties: false,
+        },
+        handler: (args) => apiDelete('/v1/network/pool', args.idempotencyKey),
+    },
+];
+//# sourceMappingURL=network.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/tools/automation/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAW,MAAM,aAAa,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAc;IACpC;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACT,4QAA4Q;QAC9Q,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE;QAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC;KAC1C;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,sEAAsE;QACnF,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,uBAAuB;QAC7B,WAAW,EACT,uIAAuI;QACzI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;oBACZ,OAAO,EAAE,GAAG;oBACZ,WAAW,EACT,2FAA2F;wBAC3F,yDAAyD;iBAC5D;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE,IAA+B,CAAC;KACnF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,+GAA+G;YAC/G,2GAA2G;YAC3G,6GAA6G;YAC7G,+BAA+B;QACjC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,GAAG,gBAAgB,EAAE;YACnC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,EAAE,IAAI,CAAC,cAAoC,CAAC;KAC9F;IACD;QACE,IAAI,EAAE,gCAAgC;QACtC,WAAW,EACT,qGAAqG;YACrG,yDAAyD;QAC3D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,4FAA4F;wBAC5F,oFAAoF;iBACvF;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,gGAAgG;wBAChG,mCAAmC;iBACtC;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,+FAA+F;wBAC/F,gCAAgC;iBACnC;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EACT,4FAA4F;wBAC5F,+FAA+F;wBAC/F,6CAA6C;iBAChD;gBACD,GAAG,gBAAgB;aACpB;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,IAA6D,CAAC;YAClG,OAAO,QAAQ,CAAC,kBAAkB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC5D,CAAC;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,wHAAwH;QACrI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,GAAG,gBAAgB,EAAE;YACnC,oBAAoB,EAAE,KAAK;SAC5B;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,SAAS,CAAC,kBAAkB,EAAE,IAAI,CAAC,cAAoC,CAAC;KAC3E;CACF,CAAC"}

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

@@ -0,0 +1,8 @@
+import { ToolDef } from '../types.js';
+/**
+ * Outbound notification destinations — the rows that notify.slack /
+ * notify.discord / notify.webhook automation actions point at via
+ * `actionConfig.integrationId`.
+ */
+export declare const notificationIntegrations: ToolDef[];
+//# sourceMappingURL=notifications.d.ts.map

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

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