@zudello/mcp 1.1.2

package/dist/tools/integration/triggers/create-trigger.d.ts

@@ -0,0 +1,114 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloCreateTrigger: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            script_uuid: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            auth_uuid: {
+                type: string;
+                description: string;
+            };
+            zudello_connection_uuid: {
+                type: string;
+                description: string;
+            };
+            version: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            run_freq: {
+                type: string;
+                description: string;
+            };
+            is_enabled: {
+                type: string;
+                description: string;
+            };
+            connection_uuid: {
+                type: string;
+                description: string;
+            };
+            cooldown_period_minutes: {
+                type: string;
+                description: string;
+            };
+            default_lifetime_ms: {
+                type: string;
+                description: string;
+            };
+            is_lockable: {
+                type: string;
+                description: string;
+            };
+            is_manual_allowed: {
+                type: string;
+                description: string;
+            };
+            show_in_ui: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        script_uuid: string;
+        type: "manual" | "scheduled";
+        auth_uuid: string;
+        zudello_connection_uuid: string;
+        version?: "v1" | "v2";
+        run_freq?: string;
+        is_enabled?: boolean;
+        connection_uuid?: string;
+        cooldown_period_minutes?: number;
+        default_lifetime_ms?: number;
+        is_lockable?: boolean;
+        is_manual_allowed?: boolean;
+        show_in_ui?: boolean;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        error: string;
+        trigger?: undefined;
+        hint?: undefined;
+        approvalMetadata?: undefined;
+    } | {
+        success: boolean;
+        trigger: import("../../../services/zudello/types.js").ZudelloTrigger | undefined;
+        hint: string;
+        approvalMetadata: {
+            requiresApproval: boolean;
+            operation: string;
+            riskLevel: string;
+            reason: string;
+            affectedResources: string[];
+            pendingAction: {
+                script_uuid: string;
+                type: "manual" | "scheduled";
+                auth_uuid: string;
+                zudello_connection_uuid: string;
+                version?: "v1" | "v2";
+                run_freq?: string;
+                is_enabled?: boolean;
+                connection_uuid?: string;
+                cooldown_period_minutes?: number;
+                default_lifetime_ms?: number;
+                is_lockable?: boolean;
+                is_manual_allowed?: boolean;
+                show_in_ui?: boolean;
+            };
+        };
+        error?: undefined;
+    }>;
+};
+//# sourceMappingURL=create-trigger.d.ts.map

package/dist/tools/integration/triggers/create-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-trigger.d.ts","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/create-trigger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsFtB;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,uBAAuB,EAAE,MAAM,CAAC;QAChC,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,eACY,WAAW;;;;;;;;;;;;;;;;;6BAdT,MAAM;sBACb,QAAQ,GAAG,WAAW;2BACjB,MAAM;yCACQ,MAAM;0BACrB,IAAI,GAAG,IAAI;2BACV,MAAM;6BACJ,OAAO;kCACF,MAAM;0CACE,MAAM;sCACV,MAAM;8BACd,OAAO;oCACD,OAAO;6BACd,OAAO;;;;;CAoCzB,CAAC"}

package/dist/tools/integration/triggers/create-trigger.js

@@ -0,0 +1,121 @@
+import { logger } from "../../../utils/logger.js";
+import { createZudelloTrigger } from "../../../services/zudello/automation.js";
+export const zudelloCreateTrigger = {
+    name: "zudelloCreateTrigger",
+    description: `Create a new integration trigger that defines when and how an integration script runs.
+
+Triggers execute scripts on a schedule (cron) or manually. Use \`zudelloListGlobalScripts\` or \`zudelloListScripts\` to find the script_uuid first.
+
+**Important:** Before creating a trigger, use \`zudelloGetScript\` to check if the script has a \`config\` field. The config contains recommended trigger settings (\`config.trigger\`) and required metadata fields (\`config.metadata\`) that should be configured after trigger creation using \`zudelloCreateTriggerMetadata\` or \`zudelloBulkCreateTriggerMetadata\`.
+
+**Required Fields:**
+- \`script_uuid\`: The script to execute
+- \`type\`: "scheduled" or "manual"
+- \`auth_uuid\`: Authentication config UUID (use \`zudelloListConnections\` to find available auth configs)
+- \`zudello_connection_uuid\`: Internal Zudello connection UUID
+
+**Trigger Types:**
+- \`scheduled\`: Runs automatically on a cron schedule (requires run_freq)
+- \`manual\`: Only runs when manually triggered via \`zudelloRunTrigger\`
+
+**Cron Schedule Examples (run_freq):**
+- \`0 */6 * * *\` - Every 6 hours
+- \`0 0 * * *\` - Daily at midnight
+- \`0 8 * * 1-5\` - Weekdays at 8am
+- \`*/15 * * * *\` - Every 15 minutes
+
+**Best Practice:** Create triggers disabled (is_enabled=false), verify the configuration with \`zudelloGetTrigger\`, configure metadata, then enable with \`zudelloSetTriggerEnabled\`.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            script_uuid: {
+                type: "string",
+                description: "UUID of the script to execute. Use zudelloListGlobalScripts to find available scripts.",
+            },
+            type: {
+                type: "string",
+                enum: ["manual", "scheduled"],
+                description: "Trigger type: 'scheduled' for cron-based execution, 'manual' for on-demand only.",
+            },
+            auth_uuid: {
+                type: "string",
+                description: "UUID of the authentication config. Required for script execution.",
+            },
+            zudello_connection_uuid: {
+                type: "string",
+                description: "UUID of the internal Zudello connection. Required for script execution.",
+            },
+            version: {
+                type: "string",
+                enum: ["v1", "v2"],
+                description: "Execution version. Default: 'v2'. Use 'v1' only for legacy scripts.",
+            },
+            run_freq: {
+                type: "string",
+                description: "Cron expression for schedule (required if type='scheduled'). E.g., '0 */6 * * *' for every 6 hours.",
+            },
+            is_enabled: {
+                type: "boolean",
+                description: "Whether the trigger is active. Default: false (recommended - enable after verification).",
+            },
+            connection_uuid: {
+                type: "string",
+                description: "Optional UUID of external system connection (e.g., NetSuite, MYOB) to use.",
+            },
+            cooldown_period_minutes: {
+                type: "number",
+                description: "Minimum minutes between executions to prevent overlapping runs.",
+            },
+            default_lifetime_ms: {
+                type: "number",
+                description: "Default execution timeout in milliseconds. Default: 300000 (5 minutes).",
+            },
+            is_lockable: {
+                type: "boolean",
+                description: "Whether the trigger can be locked during execution to prevent concurrent runs. Default: false.",
+            },
+            is_manual_allowed: {
+                type: "boolean",
+                description: "Whether manual runs are allowed (via zudelloRunTrigger). Default: true.",
+            },
+            show_in_ui: {
+                type: "boolean",
+                description: "Whether to show this trigger in the Zudello UI. Default: true.",
+            },
+        },
+        required: ["script_uuid", "type", "auth_uuid", "zudello_connection_uuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            // Validate: scheduled triggers require run_freq
+            if (input.type === "scheduled" && !input.run_freq) {
+                return {
+                    success: false,
+                    error: "Scheduled triggers require a run_freq cron expression.",
+                };
+            }
+            const response = await createZudelloTrigger(authContext, input);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to create trigger");
+            }
+            return {
+                success: true,
+                trigger: response.data,
+                hint: "Use zudelloGetScript to check if the script has config.metadata fields that need to be configured via zudelloCreateTriggerMetadata.",
+                approvalMetadata: {
+                    requiresApproval: true,
+                    operation: "create_trigger",
+                    riskLevel: "medium",
+                    reason: "Creating integration trigger that will execute scripts",
+                    affectedResources: [input.script_uuid],
+                    pendingAction: input,
+                },
+            };
+        }
+        catch (error) {
+            logger.error("zudelloCreateTrigger error", input, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=create-trigger.js.map

package/dist/tools/integration/triggers/create-trigger.js.map

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

package/dist/tools/integration/triggers/delete-trigger-metadata.d.ts

@@ -0,0 +1,48 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloDeleteTriggerMetadata: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            triggerUuid: {
+                type: string;
+                description: string;
+            };
+            property: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        triggerUuid: string;
+        property: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        deleted: boolean;
+        triggerUuid: string;
+        property: string;
+        approvalMetadata: {
+            requiresApproval: boolean;
+            operation: string;
+            riskLevel: string;
+            reason: string;
+            affectedResources: string[];
+            pendingAction: {
+                triggerUuid: string;
+                property: string;
+            };
+        };
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        deleted?: undefined;
+        triggerUuid?: undefined;
+        property?: undefined;
+        approvalMetadata?: undefined;
+    }>;
+};
+//# sourceMappingURL=delete-trigger-metadata.d.ts.map

package/dist/tools/integration/triggers/delete-trigger-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-trigger-metadata.d.ts","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/delete-trigger-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;qBAyB9B;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,eACnC,WAAW;;;;;;;;;;;;6BADF,MAAM;0BAAY,MAAM;;;;;;;;;;;;CAgCjD,CAAC"}

package/dist/tools/integration/triggers/delete-trigger-metadata.js

@@ -0,0 +1,54 @@
+import { logger } from "../../../utils/logger.js";
+import { deleteZudelloTriggerMetadata } from "../../../services/zudello/automation.js";
+export const zudelloDeleteTriggerMetadata = {
+    name: "zudelloDeleteTriggerMetadata",
+    description: `Delete a metadata entry from a trigger.
+
+Removes a specific metadata property from the trigger. Use this when:
+- A script no longer requires a particular configuration
+- Cleaning up obsolete metadata
+- Resetting a configuration to use script defaults
+
+**Warning:** Deleting required metadata may cause script execution to fail. Check the script's \`config.metadata\` to verify which fields are required.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            triggerUuid: {
+                type: "string",
+                description: "UUID of the trigger to delete metadata from.",
+            },
+            property: {
+                type: "string",
+                description: "The metadata property name to delete.",
+            },
+        },
+        required: ["triggerUuid", "property"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await deleteZudelloTriggerMetadata(authContext, input.triggerUuid, input.property);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to delete trigger metadata");
+            }
+            return {
+                success: true,
+                deleted: true,
+                triggerUuid: input.triggerUuid,
+                property: input.property,
+                approvalMetadata: {
+                    requiresApproval: true,
+                    operation: "delete_trigger_metadata",
+                    riskLevel: "medium",
+                    reason: `Deleting trigger metadata property: ${input.property}`,
+                    affectedResources: [input.triggerUuid],
+                    pendingAction: input,
+                },
+            };
+        }
+        catch (error) {
+            logger.error("zudelloDeleteTriggerMetadata error", input, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=delete-trigger-metadata.js.map

package/dist/tools/integration/triggers/delete-trigger-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-trigger-metadata.js","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/delete-trigger-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAGvF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;wJAOyI;IACtJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC;KACtC;IACD,OAAO,EAAE,KAAK,EACZ,KAAgD,EAChD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CACjD,WAAW,EACX,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,QAAQ,CACf,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,mCAAmC,CAAC,CAAC;YACzE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,gBAAgB,EAAE;oBAChB,gBAAgB,EAAE,IAAI;oBACtB,SAAS,EAAE,yBAAyB;oBACpC,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,uCAAuC,KAAK,CAAC,QAAQ,EAAE;oBAC/D,iBAAiB,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;oBACtC,aAAa,EAAE,KAAK;iBACrB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/integration/triggers/get-trigger-metadata.d.ts

@@ -0,0 +1,31 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloGetTriggerMetadata: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            triggerUuid: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        triggerUuid: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        triggerUuid: string;
+        metadata: import("../../../services/zudello/types.js").ZudelloTriggerMeta[] | undefined;
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        triggerUuid?: undefined;
+        metadata?: undefined;
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-trigger-metadata.d.ts.map

package/dist/tools/integration/triggers/get-trigger-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trigger-metadata.d.ts","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/get-trigger-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;qBAsB3B;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,eACjB,WAAW;;;;;;;;;;;;;CAmB3B,CAAC"}

package/dist/tools/integration/triggers/get-trigger-metadata.js

@@ -0,0 +1,43 @@
+import { logger } from "../../../utils/logger.js";
+import { getZudelloTriggerMetadata } from "../../../services/zudello/automation.js";
+export const zudelloGetTriggerMetadata = {
+    name: "zudelloGetTriggerMetadata",
+    description: `Get all metadata entries for a trigger.
+
+Trigger metadata provides configuration values that scripts use at runtime. Common metadata includes:
+- Entity UUIDs (e.g., supplier_uuid, customer_uuid)
+- Filter criteria (e.g., date ranges, status filters)
+- Feature flags (e.g., enable_detailed_logging)
+- ERP-specific settings
+
+Use \`zudelloGetScript\` to check \`config.metadata\` for the expected metadata fields.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            triggerUuid: {
+                type: "string",
+                description: "UUID of the trigger to get metadata for.",
+            },
+        },
+        required: ["triggerUuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await getZudelloTriggerMetadata(authContext, input.triggerUuid);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get trigger metadata");
+            }
+            return {
+                success: true,
+                triggerUuid: input.triggerUuid,
+                metadata: response.data,
+                count: response.data?.length || 0,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetTriggerMetadata error", input, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=get-trigger-metadata.js.map

package/dist/tools/integration/triggers/get-trigger-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trigger-metadata.js","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/get-trigger-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAGpF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE;;;;;;;;wFAQyE;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,OAAO,EAAE,KAAK,EACZ,KAA8B,EAC9B,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YACjF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,gCAAgC,CAAC,CAAC;YACtE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/integration/triggers/get-trigger.d.ts

@@ -0,0 +1,27 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloGetTrigger: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            triggerUuid: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        triggerUuid: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        trigger: import("../../../services/zudello/types.js").ZudelloTrigger | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        trigger?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-trigger.d.ts.map

package/dist/tools/integration/triggers/get-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trigger.d.ts","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/get-trigger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;qBAUL;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAUzE,CAAC"}

package/dist/tools/integration/triggers/get-trigger.js

@@ -0,0 +1,26 @@
+import { logger } from "../../../utils/logger.js";
+import { getZudelloTrigger } from "../../../services/zudello/automation.js";
+export const zudelloGetTrigger = {
+    name: "zudelloGetTrigger",
+    description: `Get details of a specific integration trigger by UUID.
+
+Triggers define when and how integration scripts run - by schedule, event, or manual invocation.`,
+    inputSchema: {
+        type: "object",
+        properties: { triggerUuid: { type: "string", description: "Trigger UUID" } },
+        required: ["triggerUuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await getZudelloTrigger(authContext, input.triggerUuid);
+            if (!response.success)
+                throw new Error(response.error || "Failed to get trigger");
+            return { success: true, trigger: response.data };
+        }
+        catch (error) {
+            logger.error("zudelloGetTrigger error", input, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=get-trigger.js.map

package/dist/tools/integration/triggers/get-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-trigger.js","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/get-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;iGAEkF;IAC/F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC5E,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;YACzE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/integration/triggers/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Integration Triggers - MCP Tools
+ */
+export { zudelloGetTrigger } from "./get-trigger.js";
+export { zudelloListTriggers } from "./list-triggers.js";
+export { zudelloCreateTrigger } from "./create-trigger.js";
+export { zudelloUpdateTrigger } from "./update-trigger.js";
+export { zudelloSetTriggerEnabled } from "./set-trigger-enabled.js";
+export { zudelloRunTrigger } from "./run-trigger.js";
+export { zudelloGetTriggerMetadata } from "./get-trigger-metadata.js";
+export { zudelloSyncTriggerMetadata } from "./sync-trigger-metadata.js";
+export { zudelloDeleteTriggerMetadata } from "./delete-trigger-metadata.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/integration/triggers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/tools/integration/triggers/index.js

@@ -0,0 +1,14 @@
+/**
+ * Integration Triggers - MCP Tools
+ */
+export { zudelloGetTrigger } from "./get-trigger.js";
+export { zudelloListTriggers } from "./list-triggers.js";
+export { zudelloCreateTrigger } from "./create-trigger.js";
+export { zudelloUpdateTrigger } from "./update-trigger.js";
+export { zudelloSetTriggerEnabled } from "./set-trigger-enabled.js";
+export { zudelloRunTrigger } from "./run-trigger.js";
+// Trigger Metadata (3 tools)
+export { zudelloGetTriggerMetadata } from "./get-trigger-metadata.js";
+export { zudelloSyncTriggerMetadata } from "./sync-trigger-metadata.js";
+export { zudelloDeleteTriggerMetadata } from "./delete-trigger-metadata.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/integration/triggers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,6BAA6B;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/tools/integration/triggers/initiate-sync.d.ts

@@ -0,0 +1,38 @@
+import type { AuthContext } from "../../../context/auth.js";
+export declare const zudelloInitiateSync: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            triggerUuid: {
+                type: string;
+                description: string;
+            };
+            dryRun: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        triggerUuid: string;
+        dryRun?: boolean;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        triggerUuid: string;
+        executionUuid: string | undefined;
+        status: string | undefined;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        triggerUuid?: undefined;
+        executionUuid?: undefined;
+        status?: undefined;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=initiate-sync.d.ts.map

package/dist/tools/integration/triggers/initiate-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiate-sync.d.ts","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/initiate-sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;qBA+BrB;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,eACnC,WAAW;;;;;;;;;;;;;;;CA8B3B,CAAC"}

package/dist/tools/integration/triggers/initiate-sync.js

@@ -0,0 +1,57 @@
+import { logger } from "../../../utils/logger.js";
+import { initiateZudelloSync } from "../../../services/zudello/automation.js";
+export const zudelloInitiateSync = {
+    name: "zudelloInitiateSync",
+    description: `Manually trigger a data sync execution.
+
+This runs an integration trigger immediately rather than waiting for its schedule.
+IMPORTANT: This is an active operation that requires user approval.
+
+Use this when:
+- User wants to perform their first data sync during onboarding
+- User needs data refreshed immediately rather than waiting for schedule
+- Testing that a trigger is working correctly
+
+Always explain to the user BEFORE calling:
+- What data will be synced (inbound or outbound)
+- Estimated duration (if known)
+- Any potential impacts (new records created, existing records updated)`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            triggerUuid: {
+                type: "string",
+                description: "UUID of the trigger to execute",
+            },
+            dryRun: {
+                type: "boolean",
+                description: "Optional: Run in dry-run mode without making changes",
+            },
+        },
+        required: ["triggerUuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloInitiateSync executed", input);
+            const response = await initiateZudelloSync(authContext, input.triggerUuid, { dryRun: input.dryRun });
+            if (!response.success) {
+                throw new Error(response.error || "Failed to initiate sync");
+            }
+            return {
+                success: true,
+                triggerUuid: input.triggerUuid,
+                executionUuid: response.data?.executionUuid,
+                status: response.data?.status,
+                message: input.dryRun ? "Dry run completed" : "Sync initiated successfully",
+            };
+        }
+        catch (error) {
+            logger.error("zudelloInitiateSync error", input, error);
+            return {
+                success: false,
+                error: error.message,
+            };
+        }
+    },
+};
+//# sourceMappingURL=initiate-sync.js.map

package/dist/tools/integration/triggers/initiate-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiate-sync.js","sourceRoot":"","sources":["../../../../src/tools/integration/triggers/initiate-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAG9E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;wEAayD;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gCAAgC;aAC9C;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sDAAsD;aACpE;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,OAAO,EAAE,KAAK,EACZ,KAAgD,EAChD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YAEnD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,WAAW,EACX,KAAK,CAAC,WAAW,EACjB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CACzB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa;gBAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAC7B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,6BAA6B;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}