@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/integrations/sync/problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.d.ts","sourceRoot":"","sources":["../../../src/integrations/sync/problems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAA;AAEhD,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,GAAE,oBAAyB,GACjC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,GAAE,oBAAyB,GACjC,uBAAuB,CAGzB"}

package/dist/integrations/sync/problems.js

@@ -0,0 +1,40 @@
+/**
+ * The longest {@link problemReport} returns by default. Long enough for a
+ * handful of reasons; past that, the count says how many more there were.
+ */
+export const DEFAULT_PROBLEM_REPORT_LENGTH = 500;
+/**
+ * One line per thing a run left undone, joined into the single string that
+ * `lastError` and an audit `errorMessage` can share. `undefined` when the list
+ * is empty.
+ *
+ * A report longer than `maxLength` is cut at the limit and ends with the total,
+ * e.g. `… (40 problems in all)`, so a long run still says how much went wrong.
+ */
+export function problemReport(problems, options = {}) {
+    if (problems.length === 0)
+        return undefined;
+    const maxLength = options.maxLength ?? DEFAULT_PROBLEM_REPORT_LENGTH;
+    const joined = problems.join(' | ');
+    if (joined.length <= maxLength)
+        return joined;
+    const suffix = ` … (${problems.length} problems in all)`;
+    if (suffix.length >= maxLength)
+        return suffix.trimStart().slice(0, maxLength);
+    return `${joined.slice(0, maxLength - suffix.length).trimEnd()}${suffix}`;
+}
+/**
+ * The `updateStatus` arguments for a run that may have left some records
+ * behind: `success` when `problems` is empty, otherwise `partial` with the
+ * capped {@link problemReport}. The status is derived from the list, so the
+ * two cannot disagree.
+ *
+ * ```ts
+ * await ctx.updateStatus(instance.id, ...statusFromProblems(problems))
+ * ```
+ */
+export function statusFromProblems(problems, options = {}) {
+    const report = problemReport(problems, options);
+    return report === undefined ? ['success'] : ['partial', report];
+}
+//# sourceMappingURL=problems.js.map

package/dist/integrations/sync/problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.js","sourceRoot":"","sources":["../../../src/integrations/sync/problems.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAA;AAOhD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,UAAgC,EAAE;IAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,6BAA6B,CAAA;IAEpE,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,MAAM,CAAA;IAE7C,MAAM,MAAM,GAAG,OAAO,QAAQ,CAAC,MAAM,mBAAmB,CAAA;IACxD,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAC7E,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAA;AAC3E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC/C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AACjE,CAAC"}

package/dist/integrations/sync/status.d.ts

@@ -0,0 +1,15 @@
+import type { Payload } from 'payload';
+import type { IntegrationContext, IntegrationStatusUpdate } from '../types.js';
+/**
+ * The fields one `updateStatus` call writes to an instance.
+ *
+ * `lastError` is cleared only by a success. A partial or failed run replaces it
+ * with its message. A JavaScript caller can still reach here with a non-success
+ * status and no message, which the types refuse; then `lastError` is left alone
+ * rather than blanked, so the admin keeps the last reason it had instead of
+ * showing a partial run with no reason at all.
+ */
+export declare function statusUpdateData(...[status, error]: IntegrationStatusUpdate): Record<string, unknown>;
+/** `IntegrationContext.updateStatus`, writing to `collectionSlug` through `payload`. */
+export declare function createStatusWriter(payload: Pick<Payload, 'update'>, collectionSlug: string): IntegrationContext['updateStatus'];
+//# sourceMappingURL=status.d.ts.map

package/dist/integrations/sync/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/integrations/sync/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAE9E;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,uBAAuB,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAChC,cAAc,EAAE,MAAM,GACrB,kBAAkB,CAAC,cAAc,CAAC,CAQpC"}

package/dist/integrations/sync/status.js

@@ -0,0 +1,31 @@
+/**
+ * The fields one `updateStatus` call writes to an instance.
+ *
+ * `lastError` is cleared only by a success. A partial or failed run replaces it
+ * with its message. A JavaScript caller can still reach here with a non-success
+ * status and no message, which the types refuse; then `lastError` is left alone
+ * rather than blanked, so the admin keeps the last reason it had instead of
+ * showing a partial run with no reason at all.
+ */
+export function statusUpdateData(...[status, error]) {
+    const data = {
+        lastSyncAt: new Date().toISOString(),
+        lastSyncStatus: status,
+    };
+    if (status === 'success')
+        data['lastError'] = null;
+    else if (typeof error === 'string' && error.length > 0)
+        data['lastError'] = error;
+    return data;
+}
+/** `IntegrationContext.updateStatus`, writing to `collectionSlug` through `payload`. */
+export function createStatusWriter(payload, collectionSlug) {
+    return async (instanceId, ...update) => {
+        await payload.update({
+            collection: collectionSlug,
+            id: instanceId,
+            data: statusUpdateData(...update),
+        });
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/integrations/sync/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/integrations/sync/status.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAG,CAAC,MAAM,EAAE,KAAK,CAA0B;IAE3C,MAAM,IAAI,GAA4B;QACpC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,cAAc,EAAE,MAAM;KACvB,CAAA;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;SAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,WAAW,CAAC,GAAG,KAAK,CAAA;IACjF,OAAO,IAAI,CAAA;AACb,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,cAAsB;IAEtB,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,cAAc;YAC1B,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,gBAAgB,CAAC,GAAG,MAAM,CAAC;SAClC,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/integrations/tools/access.d.ts

@@ -0,0 +1,5 @@
+import type { McpToolContext } from '../../plugin-contract/mcp.js';
+export declare function isIntegrationsReader(ctx: McpToolContext): boolean;
+export declare function isIntegrationsAdmin(ctx: McpToolContext): boolean;
+export { deniedEnvelope } from '../../mcp/envelope.js';
+//# sourceMappingURL=access.d.ts.map

package/dist/integrations/tools/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAElE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAIjE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAGhE;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/integrations/tools/access.js

@@ -0,0 +1,14 @@
+export function isIntegrationsReader(ctx) {
+    if (!ctx.user)
+        return false;
+    const roles = ctx.user.roles;
+    return roles.includes('admin') || roles.includes('editor');
+}
+export function isIntegrationsAdmin(ctx) {
+    if (!ctx.user)
+        return false;
+    return ctx.user.roles.includes('admin');
+}
+// `deniedEnvelope` lives in core: three servers had identical copies.
+export { deniedEnvelope } from '../../mcp/envelope.js';
+//# sourceMappingURL=access.js.map

package/dist/integrations/tools/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../../src/integrations/tools/access.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,GAAmB;IACtD,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAA;IAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAmB;IACrD,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzC,CAAC;AAED,sEAAsE;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/integrations/tools/descriptors.d.ts

@@ -0,0 +1,26 @@
+import type { McpToolDescriptor } from '../../mcp/collector.js';
+export declare const INTEGRATIONS_TOOLS: {
+    readonly listIntegrations: {
+        readonly name: "list_integrations";
+        readonly description: "Lists configured integration instances and their last-sync status. Use to answer \"what connections are set up?\" or \"is the webhook to Slack still working?\". Read-only.";
+    };
+    readonly getIntegrationStatus: {
+        readonly name: "get_integration_status";
+        readonly description: "Detailed status for a single integration instance — including its last sync time, last error, and current configuration metadata (config values themselves are admin-only and not returned).";
+    };
+    readonly triggerSync: {
+        readonly name: "trigger_sync";
+        readonly description: "Manually triggers an integration to send a test payload. Useful for verifying connectivity after a config change or after the integration has been failing. Admin-only because triggering an external POST is a write-side action.";
+    };
+    readonly testIntegration: {
+        readonly name: "test_integration";
+        readonly description: "Calls the integration's healthcheck. Use to answer 'is the integration reachable / configured correctly?'. Doesn't fire any system events; the test is local to the integration's healthcheck.";
+    };
+    readonly listIntegrationTypes: {
+        readonly name: "list_integration_types";
+        readonly description: "Lists the integration plugins available in this deployment. Use when answering \"what kinds of integrations are supported here?\" or before suggesting that someone add a new instance.";
+    };
+};
+/** Every tool this server contributes, for the collector. */
+export declare const INTEGRATIONS_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+//# sourceMappingURL=descriptors.d.ts.map

package/dist/integrations/tools/descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAY/D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;CA0BuB,CAAA;AAEtD,6DAA6D;AAC7D,eAAO,MAAM,6BAA6B,EAAE,SAAS,iBAAiB,EACnC,CAAA"}

package/dist/integrations/tools/descriptors.js

@@ -0,0 +1,35 @@
+/*
+This server's tools, by name and description, knowable without a Payload.
+
+`@payloadcms/plugin-mcp` reads exactly these two fields while the host's config
+is being built, to generate one per-key checkbox per tool, and denies any tool it
+has no checkbox for. The handlers close over `payload` and the integration
+registry, so they cannot exist that early — the names never needed to wait.
+
+The factories below spread these, so the two cannot drift.
+*/
+export const INTEGRATIONS_TOOLS = {
+    listIntegrations: {
+        name: 'list_integrations',
+        description: 'Lists configured integration instances and their last-sync status. Use to answer "what connections are set up?" or "is the webhook to Slack still working?". Read-only.',
+    },
+    getIntegrationStatus: {
+        name: 'get_integration_status',
+        description: 'Detailed status for a single integration instance — including its last sync time, last error, and current configuration metadata (config values themselves are admin-only and not returned).',
+    },
+    triggerSync: {
+        name: 'trigger_sync',
+        description: 'Manually triggers an integration to send a test payload. Useful for verifying connectivity after a config change or after the integration has been failing. Admin-only because triggering an external POST is a write-side action.',
+    },
+    testIntegration: {
+        name: 'test_integration',
+        description: "Calls the integration's healthcheck. Use to answer 'is the integration reachable / configured correctly?'. Doesn't fire any system events; the test is local to the integration's healthcheck.",
+    },
+    listIntegrationTypes: {
+        name: 'list_integration_types',
+        description: 'Lists the integration plugins available in this deployment. Use when answering "what kinds of integrations are supported here?" or before suggesting that someone add a new instance.',
+    },
+};
+/** Every tool this server contributes, for the collector. */
+export const INTEGRATIONS_TOOL_DESCRIPTORS = Object.values(INTEGRATIONS_TOOLS);
+//# sourceMappingURL=descriptors.js.map

package/dist/integrations/tools/descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../../src/integrations/tools/descriptors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;EASE;AACF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB,EAAE;QAChB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,yKAAyK;KAC5K;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,8LAA8L;KACjM;IACD,WAAW,EAAE;QACX,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,oOAAoO;KACvO;IACD,eAAe,EAAE;QACf,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,gMAAgM;KACnM;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,uLAAuL;KAC1L;CACmD,CAAA;AAEtD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,6BAA6B,GACxC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA"}

package/dist/integrations/tools/get-integration-status.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+export interface GetIntegrationStatusDeps {
+    payload: Payload;
+    collectionSlug: string;
+}
+declare const inputSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    integrationId: string;
+}, {
+    integrationId: string;
+}>;
+export declare function createGetIntegrationStatusTool(deps: GetIntegrationStatusDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=get-integration-status.d.ts.map

package/dist/integrations/tools/get-integration-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-integration-status.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/get-integration-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAIrE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,QAAA,MAAM,WAAW;;;;;;EAIf,CAAA;AAEF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,wBAAwB,GAC7B,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAgCvC"}

package/dist/integrations/tools/get-integration-status.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { deniedEnvelope, isIntegrationsReader } from './access.js';
+import { INTEGRATIONS_TOOLS } from './descriptors.js';
+const inputSchema = z.object({
+    integrationId: z
+        .string()
+        .describe('The ID of the integration instance (the row id from list_integrations).'),
+});
+export function createGetIntegrationStatusTool(deps) {
+    return {
+        ...INTEGRATIONS_TOOLS.getIntegrationStatus,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!isIntegrationsReader(ctx)) {
+                return deniedEnvelope('Only admins and editors can view integration status.');
+            }
+            let doc;
+            try {
+                doc = (await deps.payload.findByID({
+                    collection: deps.collectionSlug,
+                    id: input.integrationId,
+                }));
+            }
+            catch {
+                doc = null;
+            }
+            if (!doc)
+                return { error: `No integration instance with id "${input.integrationId}".` };
+            return {
+                id: String(doc['id']),
+                name: String(doc['name']),
+                type: String(doc['integrationType']),
+                enabled: doc['enabled'] === true,
+                lastSyncAt: typeof doc['lastSyncAt'] === 'string' ? doc['lastSyncAt'] : null,
+                lastSyncStatus: typeof doc['lastSyncStatus'] === 'string' ? doc['lastSyncStatus'] : 'never-run',
+                lastError: typeof doc['lastError'] === 'string' ? doc['lastError'] : null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=get-integration-status.js.map

package/dist/integrations/tools/get-integration-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-integration-status.js","sourceRoot":"","sources":["../../../src/integrations/tools/get-integration-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAOrD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,yEAAyE,CAAC;CACvF,CAAC,CAAA;AAEF,MAAM,UAAU,8BAA8B,CAC5C,IAA8B;IAE9B,OAAO;QACL,GAAG,kBAAkB,CAAC,oBAAoB;QAC1C,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC,sDAAsD,CAAC,CAAA;YAC/E,CAAC;YAED,IAAI,GAAmC,CAAA;YACvC,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;oBACjC,UAAU,EAAE,IAAI,CAAC,cAAc;oBAC/B,EAAE,EAAE,KAAK,CAAC,aAAa;iBACxB,CAAC,CAAmC,CAAA;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,GAAG,IAAI,CAAA;YACZ,CAAC;YAED,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,KAAK,EAAE,oCAAoC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAA;YAEvF,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACzB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBACpC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI;gBAChC,UAAU,EAAE,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC5E,cAAc,EAAE,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,WAAW;gBAC/F,SAAS,EAAE,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;aAC1E,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/integrations/tools/index.d.ts

@@ -0,0 +1,13 @@
+export { INTEGRATIONS_TOOLS, INTEGRATIONS_TOOL_DESCRIPTORS } from './descriptors.js';
+export { createListIntegrationsTool } from './list-integrations.js';
+export type { ListIntegrationsDeps } from './list-integrations.js';
+export { createGetIntegrationStatusTool } from './get-integration-status.js';
+export type { GetIntegrationStatusDeps } from './get-integration-status.js';
+export { createTriggerSyncTool } from './trigger-sync.js';
+export type { TriggerSyncDeps } from './trigger-sync.js';
+export { createTestIntegrationTool } from './test-integration.js';
+export type { TestIntegrationDeps } from './test-integration.js';
+export { createListIntegrationTypesTool } from './list-integration-types.js';
+export type { ListIntegrationTypesDeps } from './list-integration-types.js';
+export { isIntegrationsReader, isIntegrationsAdmin } from './access.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/integrations/tools/index.js

@@ -0,0 +1,8 @@
+export { INTEGRATIONS_TOOLS, INTEGRATIONS_TOOL_DESCRIPTORS } from './descriptors.js';
+export { createListIntegrationsTool } from './list-integrations.js';
+export { createGetIntegrationStatusTool } from './get-integration-status.js';
+export { createTriggerSyncTool } from './trigger-sync.js';
+export { createTestIntegrationTool } from './test-integration.js';
+export { createListIntegrationTypesTool } from './list-integration-types.js';
+export { isIntegrationsReader, isIntegrationsAdmin } from './access.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAEjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/integrations/tools/list-integration-types.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { IntegrationRegistry } from '../registry.js';
+export interface ListIntegrationTypesDeps {
+    registry: IntegrationRegistry;
+}
+declare const inputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare function createListIntegrationTypesTool(deps: ListIntegrationTypesDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=list-integration-types.d.ts.map

package/dist/integrations/tools/list-integration-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-integration-types.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/list-integration-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAGzD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,mBAAmB,CAAA;CAC9B;AAED,QAAA,MAAM,WAAW,iDAAwB,CAAA;AAEzC,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,wBAAwB,GAC7B,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAiBvC"}

package/dist/integrations/tools/list-integration-types.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { INTEGRATIONS_TOOLS } from './descriptors.js';
+const inputSchema = z.object({}).strict();
+export function createListIntegrationTypesTool(deps) {
+    return {
+        ...INTEGRATIONS_TOOLS.listIntegrationTypes,
+        inputSchema,
+        handler: async () => {
+            return {
+                types: deps.registry.list().map((integration) => ({
+                    id: integration.id,
+                    name: integration.name,
+                    description: integration.description,
+                    category: integration.category,
+                    subscribesTo: integration.subscribes.map((s) => s.event),
+                    hasHealthcheck: typeof integration.healthcheck === 'function',
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=list-integration-types.js.map

package/dist/integrations/tools/list-integration-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-integration-types.js","sourceRoot":"","sources":["../../../src/integrations/tools/list-integration-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAMrD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;AAEzC,MAAM,UAAU,8BAA8B,CAC5C,IAA8B;IAE9B,OAAO;QACL,GAAG,kBAAkB,CAAC,oBAAoB;QAC1C,WAAW;QACX,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBAChD,EAAE,EAAE,WAAW,CAAC,EAAE;oBAClB,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,WAAW,EAAE,WAAW,CAAC,WAAW;oBACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;oBACxD,cAAc,EAAE,OAAO,WAAW,CAAC,WAAW,KAAK,UAAU;iBAC9D,CAAC,CAAC;aACJ,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/integrations/tools/list-integrations.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+export interface ListIntegrationsDeps {
+    payload: Payload;
+    collectionSlug: string;
+}
+declare const inputSchema: z.ZodObject<{
+    integrationType: z.ZodOptional<z.ZodString>;
+    onlyEnabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    integrationType?: string | undefined;
+    onlyEnabled?: boolean | undefined;
+}, {
+    integrationType?: string | undefined;
+    onlyEnabled?: boolean | undefined;
+}>;
+export declare function createListIntegrationsTool(deps: ListIntegrationsDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=list-integrations.d.ts.map

package/dist/integrations/tools/list-integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-integrations.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/list-integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAIrE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,QAAA,MAAM,WAAW;;;;;;;;;EASf,CAAA;AAEF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,oBAAoB,GACzB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAmCvC"}

package/dist/integrations/tools/list-integrations.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { deniedEnvelope, isIntegrationsReader } from './access.js';
+import { INTEGRATIONS_TOOLS } from './descriptors.js';
+const inputSchema = z.object({
+    integrationType: z
+        .string()
+        .optional()
+        .describe('Filter to a specific integration type (e.g. "webhook").'),
+    onlyEnabled: z
+        .boolean()
+        .optional()
+        .describe('If true, exclude disabled instances. Default: false.'),
+});
+export function createListIntegrationsTool(deps) {
+    return {
+        ...INTEGRATIONS_TOOLS.listIntegrations,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!isIntegrationsReader(ctx)) {
+                return deniedEnvelope('Only admins and editors can list integrations.');
+            }
+            const conditions = [];
+            if (input.integrationType)
+                conditions.push({ integrationType: { equals: input.integrationType } });
+            if (input.onlyEnabled)
+                conditions.push({ enabled: { equals: true } });
+            const result = await deps.payload.find({
+                collection: deps.collectionSlug,
+                ...(conditions.length > 0 ? { where: { and: conditions } } : {}),
+                sort: 'name',
+                limit: 100,
+            });
+            const docs = result.docs;
+            return {
+                total: result.totalDocs,
+                integrations: docs.map((doc) => ({
+                    id: String(doc['id']),
+                    name: String(doc['name']),
+                    type: String(doc['integrationType']),
+                    enabled: doc['enabled'] === true,
+                    lastSyncAt: typeof doc['lastSyncAt'] === 'string' ? doc['lastSyncAt'] : null,
+                    lastSyncStatus: typeof doc['lastSyncStatus'] === 'string' ? doc['lastSyncStatus'] : 'never-run',
+                    lastError: typeof doc['lastError'] === 'string' ? doc['lastError'] : undefined,
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=list-integrations.js.map

package/dist/integrations/tools/list-integrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-integrations.js","sourceRoot":"","sources":["../../../src/integrations/tools/list-integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAOrD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC,CAAA;AAEF,MAAM,UAAU,0BAA0B,CACxC,IAA0B;IAE1B,OAAO;QACL,GAAG,kBAAkB,CAAC,gBAAgB;QACtC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC,gDAAgD,CAAC,CAAA;YACzE,CAAC;YAED,MAAM,UAAU,GAAY,EAAE,CAAA;YAC9B,IAAI,KAAK,CAAC,eAAe;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;YAClG,IAAI,KAAK,CAAC,WAAW;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;YAErE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBACrC,UAAU,EAAE,IAAI,CAAC,cAAc;gBAC/B,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,GAAG;aACX,CAAC,CAAA;YAEF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAsC,CAAA;YAC1D,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,SAAS;gBACvB,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC/B,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACrB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACzB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;oBACpC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI;oBAChC,UAAU,EAAE,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;oBAC5E,cAAc,EAAE,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,WAAW;oBAC/F,SAAS,EAAE,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;iBAC/E,CAAC,CAAC;aACJ,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/integrations/tools/test-integration.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+import type { IntegrationRegistry } from '../registry.js';
+export interface TestIntegrationDeps {
+    payload: Payload;
+    collectionSlug: string;
+    registry: IntegrationRegistry;
+}
+declare const inputSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    integrationId: string;
+}, {
+    integrationId: string;
+}>;
+export declare function createTestIntegrationTool(deps: TestIntegrationDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=test-integration.d.ts.map

package/dist/integrations/tools/test-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/test-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAIzD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,mBAAmB,CAAA;CAC9B;AAED,QAAA,MAAM,WAAW;;;;;;EAEf,CAAA;AAEF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,mBAAmB,GACxB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CA+CvC"}

package/dist/integrations/tools/test-integration.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { deniedEnvelope, isIntegrationsReader } from './access.js';
+import { INTEGRATIONS_TOOLS } from './descriptors.js';
+const inputSchema = z.object({
+    integrationId: z.string().describe('The instance ID to test.'),
+});
+export function createTestIntegrationTool(deps) {
+    return {
+        ...INTEGRATIONS_TOOLS.testIntegration,
+        requiredScope: 'integrations.trigger',
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!isIntegrationsReader(ctx)) {
+                return deniedEnvelope('Only admins and editors can test integrations.');
+            }
+            let doc;
+            try {
+                doc = (await deps.payload.findByID({
+                    collection: deps.collectionSlug,
+                    id: input.integrationId,
+                }));
+            }
+            catch {
+                doc = null;
+            }
+            if (!doc)
+                return { error: `No integration instance with id "${input.integrationId}".` };
+            const integrationType = String(doc['integrationType']);
+            const integration = deps.registry.get(integrationType);
+            if (!integration) {
+                return { error: `Unknown integration type "${integrationType}".` };
+            }
+            if (!integration.healthcheck) {
+                return {
+                    ok: null,
+                    message: `${integration.name} does not implement a healthcheck.`,
+                };
+            }
+            const config = (doc['config'] ?? {});
+            const result = await integration.healthcheck(config);
+            return {
+                instanceId: input.integrationId,
+                instanceName: String(doc['name']),
+                type: integrationType,
+                healthy: result.ok,
+                details: result.details ?? null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=test-integration.js.map

package/dist/integrations/tools/test-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-integration.js","sourceRoot":"","sources":["../../../src/integrations/tools/test-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAQrD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC/D,CAAC,CAAA;AAEF,MAAM,UAAU,yBAAyB,CACvC,IAAyB;IAEzB,OAAO;QACL,GAAG,kBAAkB,CAAC,eAAe;QACrC,aAAa,EAAE,sBAAsB;QACrC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC,gDAAgD,CAAC,CAAA;YACzE,CAAC;YAED,IAAI,GAAmC,CAAA;YACvC,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;oBACjC,UAAU,EAAE,IAAI,CAAC,cAAc;oBAC/B,EAAE,EAAE,KAAK,CAAC,aAAa;iBACxB,CAAC,CAAmC,CAAA;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,GAAG,IAAI,CAAA;YACZ,CAAC;YAED,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,KAAK,EAAE,oCAAoC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAA;YAEvF,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAA;YACtD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;YACtD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,6BAA6B,eAAe,IAAI,EAAE,CAAA;YACpE,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;gBAC7B,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,oCAAoC;iBACjE,CAAA;YACH,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAA;YAC/D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;YAEpD,OAAO;gBACL,UAAU,EAAE,KAAK,CAAC,aAAa;gBAC/B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACjC,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,MAAM,CAAC,EAAE;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;aAChC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/integrations/tools/trigger-sync.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { Inngest } from 'inngest';
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '../../plugin-contract/mcp.js';
+export interface TriggerSyncDeps {
+    payload: Payload;
+    collectionSlug: string;
+    inngest?: Inngest;
+    emit?: (event: {
+        name: string;
+        data: unknown;
+    }) => Promise<void>;
+}
+declare const inputSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    integrationId: string;
+    reason?: string | undefined;
+}, {
+    integrationId: string;
+    reason?: string | undefined;
+}>;
+export declare function createTriggerSyncTool(deps: TriggerSyncDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=trigger-sync.d.ts.map

package/dist/integrations/tools/trigger-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-sync.d.ts","sourceRoot":"","sources":["../../../src/integrations/tools/trigger-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAKrE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE;AAED,QAAA,MAAM,WAAW;;;;;;;;;EAQf,CAAA;AAEF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAAC,OAAO,WAAW,CAAC,CA+BvC"}

package/dist/integrations/tools/trigger-sync.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { deniedEnvelope, isIntegrationsAdmin } from './access.js';
+import { INTEGRATIONS_TOOLS } from './descriptors.js';
+import { requestManualSync } from '../sync/manual-sync.js';
+const inputSchema = z.object({
+    integrationId: z
+        .string()
+        .describe('The instance ID to sync. Use list_integrations to find it.'),
+    reason: z
+        .string()
+        .optional()
+        .describe('Why the sync was triggered. Recorded for the audit trail.'),
+});
+export function createTriggerSyncTool(deps) {
+    return {
+        ...INTEGRATIONS_TOOLS.triggerSync,
+        requiredScope: 'integrations.trigger',
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!isIntegrationsAdmin(ctx)) {
+                return deniedEnvelope('Only admins can manually trigger integrations.');
+            }
+            // The rules — instance exists, instance enabled, this event shape — live
+            // in `requestManualSync`, which the admin's Sync now button calls too.
+            const result = await requestManualSync(deps, {
+                instanceId: input.integrationId,
+                triggeredBy: ctx.user?.id ?? null,
+                reason: input.reason ?? null,
+            });
+            if (!result.ok)
+                return { error: result.message };
+            return {
+                ok: true,
+                triggered: {
+                    instanceId: result.instanceId,
+                    instanceName: result.instanceName,
+                    type: result.integrationType,
+                },
+                message: `Triggered manual sync for "${result.instanceName}". Check list_integrations or get_integration_status in a few seconds for the result.`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=trigger-sync.js.map

package/dist/integrations/tools/trigger-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-sync.js","sourceRoot":"","sources":["../../../src/integrations/tools/trigger-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAS1D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,4DAA4D,CAAC;IACzE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAA;AAEF,MAAM,UAAU,qBAAqB,CACnC,IAAqB;IAErB,OAAO;QACL,GAAG,kBAAkB,CAAC,WAAW;QACjC,aAAa,EAAE,sBAAsB;QACrC,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,cAAc,CAAC,gDAAgD,CAAC,CAAA;YACzE,CAAC;YAED,yEAAyE;YACzE,uEAAuE;YACvE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE;gBAC3C,UAAU,EAAE,KAAK,CAAC,aAAa;gBAC/B,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,IAAI;gBACjC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;aAC7B,CAAC,CAAA;YAEF,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;YAEhD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,SAAS,EAAE;oBACT,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,IAAI,EAAE,MAAM,CAAC,eAAe;iBAC7B;gBACD,OAAO,EAAE,8BAA8B,MAAM,CAAC,YAAY,uFAAuF;aAClJ,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}