@invect/core 0.0.1

package/dist/services/triggers/flow-triggers.service.d.cts

@@ -0,0 +1,77 @@
+import { Logger } from "../../types/schemas-fresh/invect-config.cjs";
+import { CreateTriggerInput, FlowTriggerRegistration, UpdateTriggerInput } from "./trigger.types.cjs";
+import { DatabaseService } from "../database/database.service.cjs";
+import { FlowsService } from "../flows/flows.service.cjs";
+import { FlowVersionsService } from "../flow-versions/flow-versions.service.cjs";
+import { FlowOrchestrationService } from "../flow-orchestration.service.cjs";
+
+//#region src/services/triggers/flow-triggers.service.d.ts
+declare class FlowTriggersService {
+  private readonly logger;
+  private readonly databaseService;
+  private readonly flowsService;
+  private readonly flowVersionsService;
+  private readonly orchestrationService;
+  constructor(logger: Logger, databaseService: DatabaseService, flowsService: FlowsService, flowVersionsService: FlowVersionsService, orchestrationService: FlowOrchestrationService);
+  initialize(): Promise<void>;
+  close(): Promise<void>;
+  /**
+   * List all trigger registrations for a flow.
+   */
+  listTriggersForFlow(flowId: string): Promise<FlowTriggerRegistration[]>;
+  /**
+   * Get a single trigger by ID.
+   */
+  getTrigger(triggerId: string): Promise<FlowTriggerRegistration | null>;
+  /**
+   * Create a trigger registration manually.
+   */
+  createTrigger(input: CreateTriggerInput): Promise<FlowTriggerRegistration>;
+  /**
+   * Update a trigger registration.
+   */
+  updateTrigger(triggerId: string, input: UpdateTriggerInput): Promise<FlowTriggerRegistration | null>;
+  /**
+   * Delete a trigger registration.
+   */
+  deleteTrigger(triggerId: string): Promise<void>;
+  /**
+   * Synchronise trigger registrations for a flow based on its latest
+   * published definition.
+   *
+   * For every trigger node in the definition:
+   *  - If a registration already exists for (flowId, nodeId): update type-specific fields
+   *  - Otherwise: create a new registration
+   *
+   * Registrations whose nodeId no longer appears in the definition are deleted.
+   */
+  syncTriggersForFlow(flowId: string, definition: {
+    nodes: Array<{
+      id: string;
+      type: string;
+      params?: Record<string, unknown>;
+    }>;
+  }): Promise<FlowTriggerRegistration[]>;
+  /**
+   * Get all enabled cron triggers (for the cron scheduler to enumerate on startup).
+   */
+  getEnabledCronTriggers(): Promise<FlowTriggerRegistration[]>;
+  /**
+   * Execute a cron trigger (called by the cron scheduler).
+   */
+  executeCronTrigger(triggerId: string): Promise<{
+    flowRunId: string;
+    flowId: string;
+  }>;
+  /**
+   * Execute a flow via a trigger.
+   *
+   * Injects trigger metadata into flowInputs so that the trigger action node
+   * can read it via `context.flowInputs.__triggerData`. Also passes trigger
+   * provenance via options so it's recorded on the FlowRun record.
+   */
+  private executeTrigger;
+}
+//#endregion
+export { FlowTriggersService };
+//# sourceMappingURL=flow-triggers.service.d.cts.map

package/dist/services/triggers/flow-triggers.service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-triggers.service.d.cts","names":[],"sources":["../../../src/services/triggers/flow-triggers.service.ts"],"mappings":";;;;;;;;cAsDa,mBAAA;EAAA,iBAEQ,MAAA;EAAA,iBACA,eAAA;EAAA,iBACA,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,oBAAA;cAJA,MAAA,EAAQ,MAAA,EACR,eAAA,EAAiB,eAAA,EACjB,YAAA,EAAc,YAAA,EACd,mBAAA,EAAqB,mBAAA,EACrB,oBAAA,EAAsB,wBAAA;EAInC,UAAA,CAAA,GAAc,OAAA;EAGd,KAAA,CAAA,GAAS,OAAA;EA6CZ;;;EApCG,mBAAA,CAAoB,MAAA,WAAiB,OAAA,CAAQ,uBAAA;EAkExC;;;EA3DL,UAAA,CAAW,SAAA,WAAoB,OAAA,CAAQ,uBAAA;EAgJA;;;EAzIvC,aAAA,CAAc,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,uBAAA;EAjCrC;;;EAoDb,aAAA,CACJ,SAAA,UACA,KAAA,EAAO,kBAAA,GACN,OAAA,CAAQ,uBAAA;;;;EAQL,aAAA,CAAc,SAAA,WAAoB,OAAA;EA/DrB;;;;;;;;;;EAkFb,mBAAA,CACJ,MAAA,UACA,UAAA;IAAc,KAAA,EAAO,KAAA;MAAQ,EAAA;MAAY,IAAA;MAAc,MAAA,GAAS,MAAA;IAAA;EAAA,IAC/D,OAAA,CAAQ,uBAAA;EA3D0B;;;EAyI/B,sBAAA,CAAA,GAA0B,OAAA,CAAQ,uBAAA;EAlIpB;;;EAyId,kBAAA,CAAmB,SAAA,WAAoB,OAAA;IAAU,SAAA;IAAmB,MAAA;EAAA;EAnHvE;;;;;;;EAAA,QAiLW,cAAA;AAAA"}

package/dist/services/triggers/flow-triggers.service.d.ts

@@ -0,0 +1,77 @@
+import { Logger } from "../../types/schemas-fresh/invect-config.js";
+import { CreateTriggerInput, FlowTriggerRegistration, UpdateTriggerInput } from "./trigger.types.js";
+import { DatabaseService } from "../database/database.service.js";
+import { FlowsService } from "../flows/flows.service.js";
+import { FlowVersionsService } from "../flow-versions/flow-versions.service.js";
+import { FlowOrchestrationService } from "../flow-orchestration.service.js";
+
+//#region src/services/triggers/flow-triggers.service.d.ts
+declare class FlowTriggersService {
+  private readonly logger;
+  private readonly databaseService;
+  private readonly flowsService;
+  private readonly flowVersionsService;
+  private readonly orchestrationService;
+  constructor(logger: Logger, databaseService: DatabaseService, flowsService: FlowsService, flowVersionsService: FlowVersionsService, orchestrationService: FlowOrchestrationService);
+  initialize(): Promise<void>;
+  close(): Promise<void>;
+  /**
+   * List all trigger registrations for a flow.
+   */
+  listTriggersForFlow(flowId: string): Promise<FlowTriggerRegistration[]>;
+  /**
+   * Get a single trigger by ID.
+   */
+  getTrigger(triggerId: string): Promise<FlowTriggerRegistration | null>;
+  /**
+   * Create a trigger registration manually.
+   */
+  createTrigger(input: CreateTriggerInput): Promise<FlowTriggerRegistration>;
+  /**
+   * Update a trigger registration.
+   */
+  updateTrigger(triggerId: string, input: UpdateTriggerInput): Promise<FlowTriggerRegistration | null>;
+  /**
+   * Delete a trigger registration.
+   */
+  deleteTrigger(triggerId: string): Promise<void>;
+  /**
+   * Synchronise trigger registrations for a flow based on its latest
+   * published definition.
+   *
+   * For every trigger node in the definition:
+   *  - If a registration already exists for (flowId, nodeId): update type-specific fields
+   *  - Otherwise: create a new registration
+   *
+   * Registrations whose nodeId no longer appears in the definition are deleted.
+   */
+  syncTriggersForFlow(flowId: string, definition: {
+    nodes: Array<{
+      id: string;
+      type: string;
+      params?: Record<string, unknown>;
+    }>;
+  }): Promise<FlowTriggerRegistration[]>;
+  /**
+   * Get all enabled cron triggers (for the cron scheduler to enumerate on startup).
+   */
+  getEnabledCronTriggers(): Promise<FlowTriggerRegistration[]>;
+  /**
+   * Execute a cron trigger (called by the cron scheduler).
+   */
+  executeCronTrigger(triggerId: string): Promise<{
+    flowRunId: string;
+    flowId: string;
+  }>;
+  /**
+   * Execute a flow via a trigger.
+   *
+   * Injects trigger metadata into flowInputs so that the trigger action node
+   * can read it via `context.flowInputs.__triggerData`. Also passes trigger
+   * provenance via options so it's recorded on the FlowRun record.
+   */
+  private executeTrigger;
+}
+//#endregion
+export { FlowTriggersService };
+//# sourceMappingURL=flow-triggers.service.d.ts.map

package/dist/services/triggers/flow-triggers.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-triggers.service.d.ts","names":[],"sources":["../../../src/services/triggers/flow-triggers.service.ts"],"mappings":";;;;;;;;cAsDa,mBAAA;EAAA,iBAEQ,MAAA;EAAA,iBACA,eAAA;EAAA,iBACA,YAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,oBAAA;cAJA,MAAA,EAAQ,MAAA,EACR,eAAA,EAAiB,eAAA,EACjB,YAAA,EAAc,YAAA,EACd,mBAAA,EAAqB,mBAAA,EACrB,oBAAA,EAAsB,wBAAA;EAInC,UAAA,CAAA,GAAc,OAAA;EAGd,KAAA,CAAA,GAAS,OAAA;EA6CJ;;;EApCL,mBAAA,CAAoB,MAAA,WAAiB,OAAA,CAAQ,uBAAA;EAiE5B;;;EA1DjB,UAAA,CAAW,SAAA,WAAoB,OAAA,CAAQ,uBAAA;EAyIb;;;EAlI1B,aAAA,CAAc,KAAA,EAAO,kBAAA,GAAqB,OAAA,CAAQ,uBAAA;EAlCrC;;;EAqDb,aAAA,CACJ,SAAA,UACA,KAAA,EAAO,kBAAA,GACN,OAAA,CAAQ,uBAAA;EApDQ;;;EA4Db,aAAA,CAAc,SAAA,WAAoB,OAAA;EA/DJ;;;;;;;;;;EAkF9B,mBAAA,CACJ,MAAA,UACA,UAAA;IAAc,KAAA,EAAO,KAAA;MAAQ,EAAA;MAAY,IAAA;MAAc,MAAA,GAAS,MAAA;IAAA;EAAA,IAC/D,OAAA,CAAQ,uBAAA;EA3DM;;;EAyIX,sBAAA,CAAA,GAA0B,OAAA,CAAQ,uBAAA;EAlIb;;;EAyIrB,kBAAA,CAAmB,SAAA,WAAoB,OAAA;IAAU,SAAA;IAAmB,MAAA;EAAA;EApHxE;;;;;;;EAAA,QAkLY,cAAA;AAAA"}

package/dist/services/triggers/flow-triggers.service.js

@@ -0,0 +1,217 @@
+import { DatabaseError, ValidationError } from "../../types/common/errors.types.js";
+import { randomUUID } from "node:crypto";
+//#region src/services/triggers/flow-triggers.service.ts
+/**
+* Flow Triggers Service
+*
+* Business-logic layer for trigger registration and syncing trigger
+* registrations from flow definitions.
+*
+* This service wraps the FlowTriggersModel (CRUD) and adds:
+*  - syncTriggersForFlow(): upserts trigger registrations whenever a flow version is published
+*  - CRUD helpers for API routes
+*
+* Webhook dispatch has been moved to the @invect/webhooks plugin.
+*/
+/** Generate a unique webhook path slug. */
+function generateWebhookPath() {
+	return randomUUID().replace(/-/g, "").slice(0, 24);
+}
+/** Generate a random webhook secret. */
+function generateWebhookSecret() {
+	return randomUUID().replace(/-/g, "");
+}
+/** Return the trigger type from an action id, e.g. "trigger.cron" → "cron". */
+function triggerTypeFromActionId(actionId) {
+	if (!actionId.startsWith("trigger.")) return null;
+	const suffix = actionId.slice(8);
+	if ([
+		"manual",
+		"webhook",
+		"cron"
+	].includes(suffix)) return suffix;
+	return null;
+}
+var FlowTriggersService = class {
+	constructor(logger, databaseService, flowsService, flowVersionsService, orchestrationService) {
+		this.logger = logger;
+		this.databaseService = databaseService;
+		this.flowsService = flowsService;
+		this.flowVersionsService = flowVersionsService;
+		this.orchestrationService = orchestrationService;
+	}
+	async initialize() {}
+	async close() {}
+	/**
+	* List all trigger registrations for a flow.
+	*/
+	async listTriggersForFlow(flowId) {
+		return this.databaseService.flowTriggers.findByFlowId(flowId);
+	}
+	/**
+	* Get a single trigger by ID.
+	*/
+	async getTrigger(triggerId) {
+		return this.databaseService.flowTriggers.findById(triggerId);
+	}
+	/**
+	* Create a trigger registration manually.
+	*/
+	async createTrigger(input) {
+		if (input.type === "webhook") {
+			input.webhookPath = input.webhookPath || generateWebhookPath();
+			input.webhookSecret = input.webhookSecret || generateWebhookSecret();
+		}
+		this.logger.info("Creating trigger registration", {
+			flowId: input.flowId,
+			nodeId: input.nodeId,
+			type: input.type
+		});
+		return this.databaseService.flowTriggers.create(input);
+	}
+	/**
+	* Update a trigger registration.
+	*/
+	async updateTrigger(triggerId, input) {
+		this.logger.debug("Updating trigger", { triggerId });
+		return this.databaseService.flowTriggers.update(triggerId, input);
+	}
+	/**
+	* Delete a trigger registration.
+	*/
+	async deleteTrigger(triggerId) {
+		this.logger.info("Deleting trigger", { triggerId });
+		return this.databaseService.flowTriggers.delete(triggerId);
+	}
+	/**
+	* Synchronise trigger registrations for a flow based on its latest
+	* published definition.
+	*
+	* For every trigger node in the definition:
+	*  - If a registration already exists for (flowId, nodeId): update type-specific fields
+	*  - Otherwise: create a new registration
+	*
+	* Registrations whose nodeId no longer appears in the definition are deleted.
+	*/
+	async syncTriggersForFlow(flowId, definition) {
+		const triggerNodes = definition.nodes.filter((n) => triggerTypeFromActionId(n.type) !== null);
+		const existing = await this.databaseService.flowTriggers.findByFlowId(flowId);
+		const existingByNodeId = new Map(existing.map((t) => [t.nodeId, t]));
+		const results = [];
+		for (const node of triggerNodes) {
+			const type = triggerTypeFromActionId(node.type);
+			if (!type) continue;
+			const prev = existingByNodeId.get(node.id);
+			if (prev) {
+				const update = {};
+				if (type === "cron") {
+					if (node.params?.expression) update.cronExpression = node.params.expression;
+					if (node.params?.timezone) update.cronTimezone = node.params.timezone;
+				}
+				const updated = await this.databaseService.flowTriggers.update(prev.id, update);
+				if (updated) results.push(updated);
+				existingByNodeId.delete(node.id);
+			} else {
+				const input = {
+					flowId,
+					nodeId: node.id,
+					type,
+					isEnabled: true
+				};
+				if (type === "webhook") {
+					input.webhookPath = generateWebhookPath();
+					input.webhookSecret = generateWebhookSecret();
+				}
+				if (type === "cron") {
+					input.cronExpression = node.params?.expression || void 0;
+					input.cronTimezone = node.params?.timezone || "UTC";
+				}
+				const created = await this.databaseService.flowTriggers.create(input);
+				results.push(created);
+			}
+		}
+		for (const orphan of existingByNodeId.values()) {
+			this.logger.info("Removing orphan trigger registration", {
+				triggerId: orphan.id,
+				nodeId: orphan.nodeId
+			});
+			await this.databaseService.flowTriggers.delete(orphan.id);
+		}
+		return results;
+	}
+	/**
+	* Get all enabled cron triggers (for the cron scheduler to enumerate on startup).
+	*/
+	async getEnabledCronTriggers() {
+		return this.databaseService.flowTriggers.findEnabledCronTriggers();
+	}
+	/**
+	* Execute a cron trigger (called by the cron scheduler).
+	*/
+	async executeCronTrigger(triggerId) {
+		const trigger = await this.databaseService.flowTriggers.findById(triggerId);
+		if (!trigger) throw new ValidationError("Cron trigger not found", "triggerId", triggerId);
+		if (!trigger.isEnabled) throw new ValidationError("Cron trigger is disabled", "triggerId", triggerId);
+		if (!(await this.flowsService.getFlowById(trigger.flowId)).isActive) {
+			this.logger.info("Cron trigger skipped — flow is inactive", {
+				triggerId: trigger.id,
+				flowId: trigger.flowId
+			});
+			throw new ValidationError("Flow is inactive", "flowId", trigger.flowId);
+		}
+		this.logger.info("Executing cron trigger", {
+			triggerId: trigger.id,
+			flowId: trigger.flowId,
+			expression: trigger.cronExpression
+		});
+		const triggerData = {
+			scheduledTime: (/* @__PURE__ */ new Date()).toISOString(),
+			expression: trigger.cronExpression,
+			timezone: trigger.cronTimezone ?? "UTC"
+		};
+		const result = await this.executeTrigger({
+			triggerType: "cron",
+			triggerNodeId: trigger.nodeId,
+			triggerId: trigger.id,
+			triggerData
+		}, trigger.flowId);
+		this.databaseService.flowTriggers.update(trigger.id, { lastTriggeredAt: (/* @__PURE__ */ new Date()).toISOString() }).catch((err) => this.logger.error("Failed to update lastTriggeredAt", { error: err }));
+		return result;
+	}
+	/**
+	* Execute a flow via a trigger.
+	*
+	* Injects trigger metadata into flowInputs so that the trigger action node
+	* can read it via `context.flowInputs.__triggerData`. Also passes trigger
+	* provenance via options so it's recorded on the FlowRun record.
+	*/
+	async executeTrigger(options, flowId) {
+		const flowInputs = {
+			__triggerData: options.triggerData,
+			__triggerNodeId: options.triggerNodeId
+		};
+		if (options.triggerId) flowInputs.__triggerId = options.triggerId;
+		try {
+			return {
+				flowRunId: (await this.orchestrationService.executeFlowAsync(flowId, flowInputs, {
+					triggerType: options.triggerType,
+					triggerId: options.triggerId,
+					triggerNodeId: options.triggerNodeId,
+					triggerData: options.triggerData
+				})).flowRunId,
+				flowId
+			};
+		} catch (error) {
+			this.logger.error("Trigger execution failed", {
+				triggerId: options.triggerId,
+				flowId,
+				error
+			});
+			throw new DatabaseError("Failed to execute trigger", { error });
+		}
+	}
+};
+//#endregion
+export { FlowTriggersService };
+
+//# sourceMappingURL=flow-triggers.service.js.map

package/dist/services/triggers/flow-triggers.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-triggers.service.js","names":[],"sources":["../../../src/services/triggers/flow-triggers.service.ts"],"sourcesContent":["/**\n * Flow Triggers Service\n *\n * Business-logic layer for trigger registration and syncing trigger\n * registrations from flow definitions.\n *\n * This service wraps the FlowTriggersModel (CRUD) and adds:\n *  - syncTriggersForFlow(): upserts trigger registrations whenever a flow version is published\n *  - CRUD helpers for API routes\n *\n * Webhook dispatch has been moved to the @invect/webhooks plugin.\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { Logger } from 'src/types/schemas';\nimport { DatabaseError, ValidationError } from 'src/types/common/errors.types';\nimport type { DatabaseService } from '../database/database.service';\nimport type { FlowOrchestrationService } from '../flow-orchestration.service';\nimport type { FlowsService } from '../flows/flows.service';\nimport type { FlowVersionsService } from '../flow-versions/flow-versions.service';\nimport type {\n  TriggerType,\n  FlowTriggerRegistration,\n  CreateTriggerInput,\n  UpdateTriggerInput,\n  TriggerExecutionOptions,\n} from './trigger.types';\n\n// ─── Helpers ────────────────────────────────────────────────────────\n\n/** Generate a unique webhook path slug. */\nfunction generateWebhookPath(): string {\n  return randomUUID().replace(/-/g, '').slice(0, 24);\n}\n\n/** Generate a random webhook secret. */\nfunction generateWebhookSecret(): string {\n  return randomUUID().replace(/-/g, '');\n}\n\n/** Return the trigger type from an action id, e.g. \"trigger.cron\" → \"cron\". */\nfunction triggerTypeFromActionId(actionId: string): TriggerType | null {\n  if (!actionId.startsWith('trigger.')) {\n    return null;\n  }\n  const suffix = actionId.slice('trigger.'.length) as TriggerType;\n  if (['manual', 'webhook', 'cron'].includes(suffix)) {\n    return suffix;\n  }\n  return null;\n}\n\n// ─── Service ────────────────────────────────────────────────────────\n\nexport class FlowTriggersService {\n  constructor(\n    private readonly logger: Logger,\n    private readonly databaseService: DatabaseService,\n    private readonly flowsService: FlowsService,\n    private readonly flowVersionsService: FlowVersionsService,\n    private readonly orchestrationService: FlowOrchestrationService,\n  ) {}\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  async initialize(): Promise<void> {}\n\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  async close(): Promise<void> {}\n\n  // =====================================\n  // CRUD\n  // =====================================\n\n  /**\n   * List all trigger registrations for a flow.\n   */\n  async listTriggersForFlow(flowId: string): Promise<FlowTriggerRegistration[]> {\n    return this.databaseService.flowTriggers.findByFlowId(flowId);\n  }\n\n  /**\n   * Get a single trigger by ID.\n   */\n  async getTrigger(triggerId: string): Promise<FlowTriggerRegistration | null> {\n    return this.databaseService.flowTriggers.findById(triggerId);\n  }\n\n  /**\n   * Create a trigger registration manually.\n   */\n  async createTrigger(input: CreateTriggerInput): Promise<FlowTriggerRegistration> {\n    // Auto-generate webhook path/secret for webhook triggers\n    if (input.type === 'webhook') {\n      input.webhookPath = input.webhookPath || generateWebhookPath();\n      input.webhookSecret = input.webhookSecret || generateWebhookSecret();\n    }\n\n    this.logger.info('Creating trigger registration', {\n      flowId: input.flowId,\n      nodeId: input.nodeId,\n      type: input.type,\n    });\n\n    return this.databaseService.flowTriggers.create(input);\n  }\n\n  /**\n   * Update a trigger registration.\n   */\n  async updateTrigger(\n    triggerId: string,\n    input: UpdateTriggerInput,\n  ): Promise<FlowTriggerRegistration | null> {\n    this.logger.debug('Updating trigger', { triggerId });\n    return this.databaseService.flowTriggers.update(triggerId, input);\n  }\n\n  /**\n   * Delete a trigger registration.\n   */\n  async deleteTrigger(triggerId: string): Promise<void> {\n    this.logger.info('Deleting trigger', { triggerId });\n    return this.databaseService.flowTriggers.delete(triggerId);\n  }\n\n  // =====================================\n  // SYNC (publish flow → upsert triggers)\n  // =====================================\n\n  /**\n   * Synchronise trigger registrations for a flow based on its latest\n   * published definition.\n   *\n   * For every trigger node in the definition:\n   *  - If a registration already exists for (flowId, nodeId): update type-specific fields\n   *  - Otherwise: create a new registration\n   *\n   * Registrations whose nodeId no longer appears in the definition are deleted.\n   */\n  async syncTriggersForFlow(\n    flowId: string,\n    definition: { nodes: Array<{ id: string; type: string; params?: Record<string, unknown> }> },\n  ): Promise<FlowTriggerRegistration[]> {\n    const triggerNodes = definition.nodes.filter((n) => triggerTypeFromActionId(n.type) !== null);\n\n    // Fetch existing registrations\n    const existing = await this.databaseService.flowTriggers.findByFlowId(flowId);\n    const existingByNodeId = new Map(existing.map((t) => [t.nodeId, t]));\n\n    const results: FlowTriggerRegistration[] = [];\n\n    for (const node of triggerNodes) {\n      const type = triggerTypeFromActionId(node.type);\n      if (!type) {\n        continue; // Skip unrecognised trigger action ids\n      }\n      const prev = existingByNodeId.get(node.id);\n\n      if (prev) {\n        // Update\n        const update: UpdateTriggerInput = {};\n\n        if (type === 'cron') {\n          if (node.params?.expression) {\n            update.cronExpression = node.params.expression as string;\n          }\n          if (node.params?.timezone) {\n            update.cronTimezone = node.params.timezone as string;\n          }\n        }\n\n        const updated = await this.databaseService.flowTriggers.update(prev.id, update);\n        if (updated) {\n          results.push(updated);\n        }\n\n        existingByNodeId.delete(node.id);\n      } else {\n        // Create\n        const input: CreateTriggerInput = {\n          flowId,\n          nodeId: node.id,\n          type,\n          isEnabled: true,\n        };\n\n        if (type === 'webhook') {\n          input.webhookPath = generateWebhookPath();\n          input.webhookSecret = generateWebhookSecret();\n        }\n\n        if (type === 'cron') {\n          input.cronExpression = (node.params?.expression as string) || undefined;\n          input.cronTimezone = (node.params?.timezone as string) || 'UTC';\n        }\n\n        const created = await this.databaseService.flowTriggers.create(input);\n        results.push(created);\n      }\n    }\n\n    // Delete orphan registrations (nodeId no longer in definition)\n    for (const orphan of existingByNodeId.values()) {\n      this.logger.info('Removing orphan trigger registration', {\n        triggerId: orphan.id,\n        nodeId: orphan.nodeId,\n      });\n      await this.databaseService.flowTriggers.delete(orphan.id);\n    }\n\n    return results;\n  }\n\n  // =====================================\n  // CRON HELPERS\n  // =====================================\n\n  /**\n   * Get all enabled cron triggers (for the cron scheduler to enumerate on startup).\n   */\n  async getEnabledCronTriggers(): Promise<FlowTriggerRegistration[]> {\n    return this.databaseService.flowTriggers.findEnabledCronTriggers();\n  }\n\n  /**\n   * Execute a cron trigger (called by the cron scheduler).\n   */\n  async executeCronTrigger(triggerId: string): Promise<{ flowRunId: string; flowId: string }> {\n    const trigger = await this.databaseService.flowTriggers.findById(triggerId);\n\n    if (!trigger) {\n      throw new ValidationError('Cron trigger not found', 'triggerId', triggerId);\n    }\n\n    if (!trigger.isEnabled) {\n      throw new ValidationError('Cron trigger is disabled', 'triggerId', triggerId);\n    }\n\n    // Check flow-level active flag — inactive flows skip cron execution\n    const flow = await this.flowsService.getFlowById(trigger.flowId);\n    if (!flow.isActive) {\n      this.logger.info('Cron trigger skipped — flow is inactive', {\n        triggerId: trigger.id,\n        flowId: trigger.flowId,\n      });\n      throw new ValidationError('Flow is inactive', 'flowId', trigger.flowId);\n    }\n\n    this.logger.info('Executing cron trigger', {\n      triggerId: trigger.id,\n      flowId: trigger.flowId,\n      expression: trigger.cronExpression,\n    });\n\n    const triggerData: Record<string, unknown> = {\n      scheduledTime: new Date().toISOString(),\n      expression: trigger.cronExpression,\n      timezone: trigger.cronTimezone ?? 'UTC',\n    };\n\n    const result = await this.executeTrigger(\n      {\n        triggerType: 'cron',\n        triggerNodeId: trigger.nodeId,\n        triggerId: trigger.id,\n        triggerData,\n      },\n      trigger.flowId,\n    );\n\n    // Update last triggered timestamp (fire-and-forget)\n    this.databaseService.flowTriggers\n      .update(trigger.id, { lastTriggeredAt: new Date().toISOString() })\n      .catch((err) => this.logger.error('Failed to update lastTriggeredAt', { error: err }));\n\n    return result;\n  }\n\n  // =====================================\n  // PRIVATE\n  // =====================================\n\n  /**\n   * Execute a flow via a trigger.\n   *\n   * Injects trigger metadata into flowInputs so that the trigger action node\n   * can read it via `context.flowInputs.__triggerData`. Also passes trigger\n   * provenance via options so it's recorded on the FlowRun record.\n   */\n  private async executeTrigger(\n    options: TriggerExecutionOptions,\n    flowId: string,\n  ): Promise<{ flowRunId: string; flowId: string }> {\n    // Inject trigger data into flowInputs for the trigger action to read.\n    // Since FlowRunContext.flowInputs is Record<string, unknown>, objects are fine.\n    const flowInputs: Record<string, unknown> = {\n      __triggerData: options.triggerData,\n      __triggerNodeId: options.triggerNodeId,\n    };\n\n    if (options.triggerId) {\n      flowInputs.__triggerId = options.triggerId;\n    }\n\n    try {\n      const result = await this.orchestrationService.executeFlowAsync(flowId, flowInputs, {\n        triggerType: options.triggerType,\n        triggerId: options.triggerId,\n        triggerNodeId: options.triggerNodeId,\n        triggerData: options.triggerData,\n      });\n\n      return {\n        flowRunId: result.flowRunId,\n        flowId,\n      };\n    } catch (error) {\n      this.logger.error('Trigger execution failed', {\n        triggerId: options.triggerId,\n        flowId,\n        error,\n      });\n      throw new DatabaseError('Failed to execute trigger', { error });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/services/triggers/index.cjs

@@ -0,0 +1,3 @@
+require("./flow-triggers.model.cjs");
+require("./flow-triggers.service.cjs");
+require("./cron-scheduler.service.cjs");

package/dist/services/triggers/index.d.cts

@@ -0,0 +1,4 @@
+import { CreateTriggerInput, FlowTriggerRegistration, TriggerExecutionOptions, TriggerType, UpdateTriggerInput } from "./trigger.types.cjs";
+import { FlowTriggersModel } from "./flow-triggers.model.cjs";
+import { FlowTriggersService } from "./flow-triggers.service.cjs";
+import { CronSchedulerService } from "./cron-scheduler.service.cjs";

package/dist/services/triggers/index.d.ts

@@ -0,0 +1,4 @@
+import { CreateTriggerInput, FlowTriggerRegistration, TriggerExecutionOptions, TriggerType, UpdateTriggerInput } from "./trigger.types.js";
+import { FlowTriggersModel } from "./flow-triggers.model.js";
+import { FlowTriggersService } from "./flow-triggers.service.js";
+import { CronSchedulerService } from "./cron-scheduler.service.js";

package/dist/services/triggers/index.js

@@ -0,0 +1,4 @@
+import "./flow-triggers.model.js";
+import "./flow-triggers.service.js";
+import "./cron-scheduler.service.js";
+export {};

package/dist/services/triggers/trigger.types.d.cts

@@ -0,0 +1,63 @@
+//#region src/services/triggers/trigger.types.d.ts
+/**
+ * Trigger Types
+ *
+ * Shared type definitions for the flow trigger system.
+ */
+/**
+ * Trigger type discriminant — matches the action ID suffix.
+ */
+type TriggerType = 'manual' | 'webhook' | 'cron';
+/**
+ * The flow_triggers registration record as exposed to services.
+ */
+interface FlowTriggerRegistration {
+  id: string;
+  flowId: string;
+  nodeId: string;
+  type: TriggerType;
+  isEnabled: boolean;
+  webhookPath?: string | null;
+  webhookSecret?: string | null;
+  cronExpression?: string | null;
+  cronTimezone?: string | null;
+  lastTriggeredAt?: Date | string | null;
+  createdAt: Date | string;
+  updatedAt: Date | string;
+}
+/**
+ * Input for creating a new trigger registration.
+ */
+interface CreateTriggerInput {
+  flowId: string;
+  nodeId: string;
+  type: TriggerType;
+  isEnabled?: boolean;
+  webhookPath?: string;
+  webhookSecret?: string;
+  cronExpression?: string;
+  cronTimezone?: string;
+}
+/**
+ * Input for updating an existing trigger registration.
+ */
+interface UpdateTriggerInput {
+  isEnabled?: boolean;
+  webhookPath?: string;
+  webhookSecret?: string;
+  cronExpression?: string;
+  cronTimezone?: string;
+  lastTriggeredAt?: Date | string;
+}
+/**
+ * Options for executing a flow via a trigger.
+ */
+interface TriggerExecutionOptions {
+  triggerType: TriggerType;
+  triggerNodeId: string;
+  triggerId?: string;
+  triggerData: Record<string, unknown>;
+}
+//#endregion
+export { CreateTriggerInput, FlowTriggerRegistration, TriggerExecutionOptions, TriggerType, UpdateTriggerInput };
+//# sourceMappingURL=trigger.types.d.cts.map

package/dist/services/triggers/trigger.types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.types.d.cts","names":[],"sources":["../../../src/services/triggers/trigger.types.ts"],"mappings":";;AASA;;;;;AAKA;;KALY,WAAA;;;;UAKK,uBAAA;EACf,EAAA;EACA,MAAA;EACA,MAAA;EACA,IAAA,EAAM,WAAA;EACN,SAAA;EAGA,WAAA;EACA,aAAA;EAGA,cAAA;EACA,YAAA;EAEA,eAAA,GAAkB,IAAA;EAClB,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;;;;UAMI,kBAAA;EACf,MAAA;EACA,MAAA;EACA,IAAA,EAAM,WAAA;EACN,SAAA;EAEA,WAAA;EACA,aAAA;EAEA,cAAA;EACA,YAAA;AAAA;;;;UAMe,kBAAA;EACf,SAAA;EAEA,WAAA;EACA,aAAA;EAEA,cAAA;EACA,YAAA;EAEA,eAAA,GAAkB,IAAA;AAAA;;;;UAMH,uBAAA;EACf,WAAA,EAAa,WAAA;EACb,aAAA;EACA,SAAA;EACA,WAAA,EAAa,MAAA;AAAA"}

package/dist/services/triggers/trigger.types.d.ts

@@ -0,0 +1,63 @@
+//#region src/services/triggers/trigger.types.d.ts
+/**
+ * Trigger Types
+ *
+ * Shared type definitions for the flow trigger system.
+ */
+/**
+ * Trigger type discriminant — matches the action ID suffix.
+ */
+type TriggerType = 'manual' | 'webhook' | 'cron';
+/**
+ * The flow_triggers registration record as exposed to services.
+ */
+interface FlowTriggerRegistration {
+  id: string;
+  flowId: string;
+  nodeId: string;
+  type: TriggerType;
+  isEnabled: boolean;
+  webhookPath?: string | null;
+  webhookSecret?: string | null;
+  cronExpression?: string | null;
+  cronTimezone?: string | null;
+  lastTriggeredAt?: Date | string | null;
+  createdAt: Date | string;
+  updatedAt: Date | string;
+}
+/**
+ * Input for creating a new trigger registration.
+ */
+interface CreateTriggerInput {
+  flowId: string;
+  nodeId: string;
+  type: TriggerType;
+  isEnabled?: boolean;
+  webhookPath?: string;
+  webhookSecret?: string;
+  cronExpression?: string;
+  cronTimezone?: string;
+}
+/**
+ * Input for updating an existing trigger registration.
+ */
+interface UpdateTriggerInput {
+  isEnabled?: boolean;
+  webhookPath?: string;
+  webhookSecret?: string;
+  cronExpression?: string;
+  cronTimezone?: string;
+  lastTriggeredAt?: Date | string;
+}
+/**
+ * Options for executing a flow via a trigger.
+ */
+interface TriggerExecutionOptions {
+  triggerType: TriggerType;
+  triggerNodeId: string;
+  triggerId?: string;
+  triggerData: Record<string, unknown>;
+}
+//#endregion
+export { CreateTriggerInput, FlowTriggerRegistration, TriggerExecutionOptions, TriggerType, UpdateTriggerInput };
+//# sourceMappingURL=trigger.types.d.ts.map

package/dist/services/triggers/trigger.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.types.d.ts","names":[],"sources":["../../../src/services/triggers/trigger.types.ts"],"mappings":";;AASA;;;;;AAKA;;KALY,WAAA;;;;UAKK,uBAAA;EACf,EAAA;EACA,MAAA;EACA,MAAA;EACA,IAAA,EAAM,WAAA;EACN,SAAA;EAGA,WAAA;EACA,aAAA;EAGA,cAAA;EACA,YAAA;EAEA,eAAA,GAAkB,IAAA;EAClB,SAAA,EAAW,IAAA;EACX,SAAA,EAAW,IAAA;AAAA;;;;UAMI,kBAAA;EACf,MAAA;EACA,MAAA;EACA,IAAA,EAAM,WAAA;EACN,SAAA;EAEA,WAAA;EACA,aAAA;EAEA,cAAA;EACA,YAAA;AAAA;;;;UAMe,kBAAA;EACf,SAAA;EAEA,WAAA;EACA,aAAA;EAEA,cAAA;EACA,YAAA;EAEA,eAAA,GAAkB,IAAA;AAAA;;;;UAMH,uBAAA;EACf,WAAA,EAAa,WAAA;EACb,aAAA;EACA,SAAA;EACA,WAAA,EAAa,MAAA;AAAA"}

package/dist/types/agent-tool.types.cjs

@@ -0,0 +1,20 @@
+//#region src/types/agent-tool.types.ts
+/**
+* Default timeout for tool execution (30 seconds)
+*/
+const DEFAULT_TOOL_TIMEOUT_MS = 3e4;
+/**
+* Default max tokens for conversation history (approximate)
+* This is used to estimate when to truncate conversation history
+*/
+const DEFAULT_MAX_CONVERSATION_TOKENS = 1e5;
+/**
+* Approximate tokens per character (for estimation)
+*/
+const APPROX_TOKENS_PER_CHAR = .25;
+//#endregion
+exports.APPROX_TOKENS_PER_CHAR = APPROX_TOKENS_PER_CHAR;
+exports.DEFAULT_MAX_CONVERSATION_TOKENS = DEFAULT_MAX_CONVERSATION_TOKENS;
+exports.DEFAULT_TOOL_TIMEOUT_MS = DEFAULT_TOOL_TIMEOUT_MS;
+
+//# sourceMappingURL=agent-tool.types.cjs.map

package/dist/types/agent-tool.types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool.types.cjs","names":[],"sources":["../../src/types/agent-tool.types.ts"],"sourcesContent":["/**\n * Agent Tool Types\n *\n * Types for defining tools that AI agents can use during execution.\n */\n\nimport { Logger } from './schemas';\nimport { NodeExecutionContext } from 'src/types-fresh';\n\n/**\n * Tool category for organization in UI\n */\nexport type AgentToolCategory = 'data' | 'web' | 'code' | 'utility' | 'custom';\n\n/**\n * Default timeout for tool execution (30 seconds)\n */\nexport const DEFAULT_TOOL_TIMEOUT_MS = 30000;\n\n/**\n * Default max tokens for conversation history (approximate)\n * This is used to estimate when to truncate conversation history\n */\nexport const DEFAULT_MAX_CONVERSATION_TOKENS = 100000;\n\n/**\n * Approximate tokens per character (for estimation)\n */\nexport const APPROX_TOKENS_PER_CHAR = 0.25;\n\n/**\n * Base tool definition that can be registered and used by agents\n */\nexport interface AgentToolDefinition {\n  /** Unique tool identifier (snake_case recommended) */\n  id: string;\n  /** Human-readable name */\n  name: string;\n  /** Description for the LLM to understand when to use this tool */\n  description: string;\n  /** JSON Schema defining the tool's input parameters */\n  inputSchema: Record<string, unknown>;\n  /** Tool category for organization in UI */\n  category: AgentToolCategory;\n  /** Tags for filtering and organization */\n  tags?: string[];\n  /** Whether this tool is enabled by default */\n  enabledByDefault?: boolean;\n  /** Timeout in milliseconds for this tool (defaults to DEFAULT_TOOL_TIMEOUT_MS) */\n  timeoutMs?: number;\n  /**\n   * If this tool is backed by a node executor, this is the node type.\n   * Used to fetch the node definition for configuration UI.\n   */\n  nodeType?: string;\n  /**\n   * Provider information for grouping and branding in the UI.\n   * Populated from the action's provider when the tool is action-based.\n   */\n  provider?: {\n    id: string;\n    name: string;\n    icon: string;\n    /** Raw SVG markup for custom provider branding. Takes precedence over `icon`. */\n    svgIcon?: string;\n  };\n}\n\n/**\n * A configured instance of a tool added to an agent.\n * Multiple instances of the same tool can exist with different configurations.\n *\n * For example, two HTTP Request tools:\n * - \"Fetch Weather\" with URL preset to weather API\n * - \"Post to Slack\" with URL preset to Slack webhook\n */\nexport interface AddedToolInstance {\n  /** Unique instance ID */\n  instanceId: string;\n  /** Reference to the base tool definition ID */\n  toolId: string;\n  /** Custom name for this instance (shown to AI) */\n  name: string;\n  /** Custom description for this instance (shown to AI) */\n  description: string;\n  /**\n   * Tool-specific parameter values.\n   * Contains both static values and `_aiChosenModes` to indicate which params the AI should fill.\n   */\n  params: Record<string, unknown> & {\n    /**\n     * Map of param name to boolean indicating if AI should choose the value.\n     * If true (or not present), AI fills the value at runtime.\n     * If false, the value from `params[fieldName]` is used as a static value.\n     */\n    _aiChosenModes?: Record<string, boolean>;\n  };\n}\n\n/**\n * A tool definition customized for a specific instance.\n * Has filtered inputSchema (only AI-chosen params) and references the instance for static param injection.\n */\nexport interface ConfiguredToolDefinition extends AgentToolDefinition {\n  /** The instance this configured tool is derived from */\n  instanceId: string;\n  /** Static parameter values to merge with AI-provided input */\n  staticParams: Record<string, unknown>;\n  /** Original tool ID (before instance customization) */\n  baseToolId: string;\n}\n\n/**\n * Tool execution context provided to tool handlers\n *\n * Tools are self-contained and should import their own dependencies\n * (e.g., json-logic-js) rather than relying on context functions.\n * The nodeContext provides access to cross-cutting concerns like credentials.\n */\nexport interface AgentToolExecutionContext {\n  logger: Logger;\n  /** Current agent iteration number */\n  iteration: number;\n  /** Maximum allowed iterations */\n  maxIterations: number;\n  /** Node execution context - provides access to credentials and other cross-cutting concerns */\n  nodeContext: NodeExecutionContext /**\n   * Static parameters configured on the tool instance.\n   * These are set by the user when adding the tool to an agent node,\n   * not provided by the AI at runtime.\n   * Example: credentialId for OAuth2 tools like Gmail\n   */;\n  staticParams?: Record<string, unknown>;\n}\n\n/**\n * Result from executing a tool\n */\nexport interface AgentToolResult {\n  success: boolean;\n  output?: unknown;\n  error?: string;\n}\n\n/**\n * Tool executor function type\n */\nexport type AgentToolExecutor = (\n  input: Record<string, unknown>,\n  context: AgentToolExecutionContext,\n) => Promise<AgentToolResult>;\n\n/**\n * Registered agent tool with definition and executor\n */\nexport interface RegisteredAgentTool {\n  definition: AgentToolDefinition;\n  executor: AgentToolExecutor;\n}\n\n/**\n * Tool call from an LLM response\n */\nexport interface AgentToolCall {\n  id: string;\n  toolId: string;\n  input: Record<string, unknown>;\n}\n\n/**\n * Record of a tool execution during an agent run\n */\nexport interface ToolExecutionRecord {\n  toolId: string;\n  toolName: string;\n  input: Record<string, unknown>;\n  output?: unknown;\n  error?: string;\n  success: boolean;\n  iteration: number;\n  executionTimeMs: number;\n}\n\n/**\n * Message in an agent conversation\n */\nexport interface AgentMessage {\n  role: 'user' | 'assistant' | 'tool';\n  content: string;\n  toolCalls?: AgentToolCall[];\n  toolCallId?: string;\n}\n\n/**\n * Agent stop conditions\n */\nexport type AgentStopCondition = 'tool_result' | 'explicit_stop' | 'max_iterations';\n\n/**\n * Agent finish reason\n */\nexport type AgentFinishReason = 'completed' | 'max_iterations' | 'tool_result' | 'error';\n\n/**\n * Result from agent prompt execution\n */\nexport interface AgentPromptResult {\n  type: 'text' | 'tool_use';\n  content: string;\n  /** Tool calls requested by the LLM */\n  toolCalls?: AgentToolCall[];\n}\n\n/**\n * Request to run an agent prompt\n */\nexport interface AgentPromptRequest {\n  model: string;\n  messages: AgentMessage[];\n  tools: AgentToolDefinition[];\n  systemPrompt?: string;\n  temperature?: number;\n  maxTokens?: number;\n  toolChoice?: 'auto' | 'none' | { type: 'tool'; name: string };\n  /** Whether to allow parallel tool calls (defaults to true) */\n  parallelToolCalls?: boolean;\n}\n\n/**\n * Agent execution output structure\n */\nexport interface AgentExecutionOutput {\n  finalResponse: string;\n  toolResults: ToolExecutionRecord[];\n  iterations: number;\n  finishReason: AgentFinishReason;\n  conversationHistory: AgentMessage[];\n  /** Token usage statistics */\n  tokenUsage?: {\n    conversationTokensEstimate: number;\n    truncationOccurred: boolean;\n  };\n}\n\n/**\n * Agent configuration for advanced settings\n */\nexport interface AgentConfig {\n  /** Tool execution timeout in milliseconds (default: 30000) */\n  toolTimeoutMs?: number;\n  /** Maximum tokens for conversation history before truncation (default: 100000) */\n  maxConversationTokens?: number;\n  /** Whether to enable parallel tool execution (default: true) */\n  enableParallelTools?: boolean;\n  /** Maximum number of parallel tool calls per iteration (default: 5) */\n  maxParallelToolCalls?: number;\n}\n"],"mappings":";;;;AAiBA,MAAa,0BAA0B;;;;;AAMvC,MAAa,kCAAkC;;;;AAK/C,MAAa,yBAAyB"}