@invect/core 0.0.1

package/dist/actions/slack/send-message.js

@@ -0,0 +1,155 @@
+import { defineAction } from "../define-action.js";
+import { SLACK_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+//#region src/actions/slack/send-message.ts
+/**
+* slack.send_message — Post a message to a Slack channel
+*
+* Sends a text message to a Slack channel or DM using the Slack Web API.
+* Supports Markdown-like formatting (mrkdwn), thread replies, and unfurling control.
+* Requires a Slack OAuth2 credential with chat:write scope.
+*/
+const SLACK_API_BASE = "https://slack.com/api";
+const slackSendMessageAction = defineAction({
+	id: "slack.send_message",
+	name: "Send Message",
+	description: "Send a message to a Slack channel or DM. Supports Markdown formatting and thread replies.",
+	provider: SLACK_PROVIDER,
+	actionCategory: "write",
+	credential: {
+		required: true,
+		type: "oauth2",
+		oauth2Provider: "slack",
+		description: "Slack OAuth2 credential with chat:write scope"
+	},
+	params: {
+		schema: z.object({
+			credentialId: z.string().min(1, "Slack credential is required"),
+			channel: z.string().min(1, "Channel is required"),
+			text: z.string().min(1, "Message text is required"),
+			threadTs: z.string().optional().default(""),
+			unfurlLinks: z.boolean().optional().default(true),
+			unfurlMedia: z.boolean().optional().default(true)
+		}),
+		fields: [
+			{
+				name: "credentialId",
+				label: "Slack Credential",
+				type: "text",
+				required: true,
+				description: "Slack OAuth2 credential for authentication",
+				aiProvided: false
+			},
+			{
+				name: "channel",
+				label: "Channel",
+				type: "text",
+				required: true,
+				placeholder: "#general or C01ABC23DEF",
+				description: "Channel name (with #) or channel ID. For DMs, use the user's DM channel ID.",
+				aiProvided: true
+			},
+			{
+				name: "text",
+				label: "Message",
+				type: "textarea",
+				required: true,
+				placeholder: "Hello from Invect! :wave:",
+				description: "Message text. Supports Slack mrkdwn formatting (*bold*, _italic_, `code`).",
+				aiProvided: true
+			},
+			{
+				name: "threadTs",
+				label: "Thread Timestamp",
+				type: "text",
+				description: "Reply to a specific thread by providing the parent message's ts value",
+				extended: true,
+				aiProvided: true
+			},
+			{
+				name: "unfurlLinks",
+				label: "Unfurl Links",
+				type: "boolean",
+				defaultValue: true,
+				description: "Enable or disable link previews",
+				extended: true
+			},
+			{
+				name: "unfurlMedia",
+				label: "Unfurl Media",
+				type: "boolean",
+				defaultValue: true,
+				description: "Enable or disable media previews",
+				extended: true
+			}
+		]
+	},
+	tags: [
+		"slack",
+		"messaging",
+		"chat",
+		"communication",
+		"oauth2"
+	],
+	async execute(params, context) {
+		const { credentialId, channel, text, threadTs, unfurlLinks, unfurlMedia } = params;
+		let credential = context.credential;
+		if (!credential && context.functions?.getCredential) credential = await context.functions.getCredential(credentialId);
+		if (!credential) return {
+			success: false,
+			error: `Credential not found: ${credentialId}. Please create a Slack OAuth2 credential.`
+		};
+		const accessToken = credential.config?.accessToken ?? credential.config?.token;
+		if (!accessToken) return {
+			success: false,
+			error: "No valid access token in credential. Please re-authorize the Slack credential."
+		};
+		context.logger.debug("Sending Slack message", {
+			channel,
+			hasThread: !!threadTs
+		});
+		try {
+			const body = {
+				channel,
+				text,
+				unfurl_links: unfurlLinks,
+				unfurl_media: unfurlMedia
+			};
+			if (threadTs) body.thread_ts = threadTs;
+			const data = await (await fetch(`${SLACK_API_BASE}/chat.postMessage`, {
+				method: "POST",
+				headers: {
+					Authorization: `Bearer ${accessToken}`,
+					"Content-Type": "application/json; charset=utf-8"
+				},
+				body: JSON.stringify(body)
+			})).json();
+			if (!data.ok) return {
+				success: false,
+				error: `Slack API error: ${data.error ?? "unknown error"}`
+			};
+			return {
+				success: true,
+				output: {
+					channel: data.channel,
+					ts: data.ts,
+					messageText: data.message?.text
+				},
+				metadata: {
+					channel: data.channel,
+					ts: data.ts,
+					sentAt: (/* @__PURE__ */ new Date()).toISOString()
+				}
+			};
+		} catch (error) {
+			return {
+				success: false,
+				error: `Slack send failed: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+});
+//#endregion
+export { slackSendMessageAction };
+
+//# sourceMappingURL=send-message.js.map

package/dist/actions/slack/send-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.js","names":[],"sources":["../../../src/actions/slack/send-message.ts"],"sourcesContent":["/**\n * slack.send_message — Post a message to a Slack channel\n *\n * Sends a text message to a Slack channel or DM using the Slack Web API.\n * Supports Markdown-like formatting (mrkdwn), thread replies, and unfurling control.\n * Requires a Slack OAuth2 credential with chat:write scope.\n */\n\nimport { defineAction } from '../define-action';\nimport { SLACK_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\nconst SLACK_API_BASE = 'https://slack.com/api';\n\nconst paramsSchema = z.object({\n  credentialId: z.string().min(1, 'Slack credential is required'),\n  channel: z.string().min(1, 'Channel is required'),\n  text: z.string().min(1, 'Message text is required'),\n  threadTs: z.string().optional().default(''),\n  unfurlLinks: z.boolean().optional().default(true),\n  unfurlMedia: z.boolean().optional().default(true),\n});\n\nexport const slackSendMessageAction = defineAction({\n  id: 'slack.send_message',\n  name: 'Send Message',\n  description:\n    'Send a message to a Slack channel or DM. Supports Markdown formatting and thread replies.',\n  provider: SLACK_PROVIDER,\n  actionCategory: 'write',\n\n  credential: {\n    required: true,\n    type: 'oauth2',\n    oauth2Provider: 'slack',\n    description: 'Slack OAuth2 credential with chat:write scope',\n  },\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'credentialId',\n        label: 'Slack Credential',\n        type: 'text',\n        required: true,\n        description: 'Slack OAuth2 credential for authentication',\n        aiProvided: false,\n      },\n      {\n        name: 'channel',\n        label: 'Channel',\n        type: 'text',\n        required: true,\n        placeholder: '#general or C01ABC23DEF',\n        description: \"Channel name (with #) or channel ID. For DMs, use the user's DM channel ID.\",\n        aiProvided: true,\n      },\n      {\n        name: 'text',\n        label: 'Message',\n        type: 'textarea',\n        required: true,\n        placeholder: 'Hello from Invect! :wave:',\n        description: 'Message text. Supports Slack mrkdwn formatting (*bold*, _italic_, `code`).',\n        aiProvided: true,\n      },\n      {\n        name: 'threadTs',\n        label: 'Thread Timestamp',\n        type: 'text',\n        description: \"Reply to a specific thread by providing the parent message's ts value\",\n        extended: true,\n        aiProvided: true,\n      },\n      {\n        name: 'unfurlLinks',\n        label: 'Unfurl Links',\n        type: 'boolean',\n        defaultValue: true,\n        description: 'Enable or disable link previews',\n        extended: true,\n      },\n      {\n        name: 'unfurlMedia',\n        label: 'Unfurl Media',\n        type: 'boolean',\n        defaultValue: true,\n        description: 'Enable or disable media previews',\n        extended: true,\n      },\n    ],\n  },\n\n  tags: ['slack', 'messaging', 'chat', 'communication', 'oauth2'],\n\n  async execute(params, context) {\n    const { credentialId, channel, text, threadTs, unfurlLinks, unfurlMedia } = params;\n\n    // Resolve credential\n    let credential = context.credential;\n    if (!credential && context.functions?.getCredential) {\n      credential = await context.functions.getCredential(credentialId);\n    }\n    if (!credential) {\n      return {\n        success: false,\n        error: `Credential not found: ${credentialId}. Please create a Slack OAuth2 credential.`,\n      };\n    }\n\n    const accessToken =\n      (credential.config?.accessToken as string) ?? (credential.config?.token as string);\n    if (!accessToken) {\n      return {\n        success: false,\n        error: 'No valid access token in credential. Please re-authorize the Slack credential.',\n      };\n    }\n\n    context.logger.debug('Sending Slack message', { channel, hasThread: !!threadTs });\n\n    try {\n      const body: Record<string, unknown> = {\n        channel,\n        text,\n        unfurl_links: unfurlLinks,\n        unfurl_media: unfurlMedia,\n      };\n\n      if (threadTs) {\n        body.thread_ts = threadTs;\n      }\n\n      const response = await fetch(`${SLACK_API_BASE}/chat.postMessage`, {\n        method: 'POST',\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          'Content-Type': 'application/json; charset=utf-8',\n        },\n        body: JSON.stringify(body),\n      });\n\n      const data = (await response.json()) as {\n        ok: boolean;\n        error?: string;\n        channel?: string;\n        ts?: string;\n        message?: { text?: string; ts?: string };\n      };\n\n      if (!data.ok) {\n        return {\n          success: false,\n          error: `Slack API error: ${data.error ?? 'unknown error'}`,\n        };\n      }\n\n      return {\n        success: true,\n        output: {\n          channel: data.channel,\n          ts: data.ts,\n          messageText: data.message?.text,\n        },\n        metadata: {\n          channel: data.channel,\n          ts: data.ts,\n          sentAt: new Date().toISOString(),\n        },\n      };\n    } catch (error) {\n      const msg = error instanceof Error ? error.message : String(error);\n      return { success: false, error: `Slack send failed: ${msg}` };\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,iBAAiB;AAWvB,MAAa,yBAAyB,aAAa;CACjD,IAAI;CACJ,MAAM;CACN,aACE;CACF,UAAU;CACV,gBAAgB;CAEhB,YAAY;EACV,UAAU;EACV,MAAM;EACN,gBAAgB;EAChB,aAAa;EACd;CAED,QAAQ;EACN,QAzBiB,EAAE,OAAO;GAC5B,cAAc,EAAE,QAAQ,CAAC,IAAI,GAAG,+BAA+B;GAC/D,SAAS,EAAE,QAAQ,CAAC,IAAI,GAAG,sBAAsB;GACjD,MAAM,EAAE,QAAQ,CAAC,IAAI,GAAG,2BAA2B;GACnD,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,GAAG;GAC3C,aAAa,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;GACjD,aAAa,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;GAClD,CAAC;EAmBE,QAAQ;GACN;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,aAAa;IACb,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aAAa;IACb,aAAa;IACb,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,UAAU;IACV,YAAY;IACb;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,cAAc;IACd,aAAa;IACb,UAAU;IACX;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,cAAc;IACd,aAAa;IACb,UAAU;IACX;GACF;EACF;CAED,MAAM;EAAC;EAAS;EAAa;EAAQ;EAAiB;EAAS;CAE/D,MAAM,QAAQ,QAAQ,SAAS;EAC7B,MAAM,EAAE,cAAc,SAAS,MAAM,UAAU,aAAa,gBAAgB;EAG5E,IAAI,aAAa,QAAQ;AACzB,MAAI,CAAC,cAAc,QAAQ,WAAW,cACpC,cAAa,MAAM,QAAQ,UAAU,cAAc,aAAa;AAElE,MAAI,CAAC,WACH,QAAO;GACL,SAAS;GACT,OAAO,yBAAyB,aAAa;GAC9C;EAGH,MAAM,cACH,WAAW,QAAQ,eAA2B,WAAW,QAAQ;AACpE,MAAI,CAAC,YACH,QAAO;GACL,SAAS;GACT,OAAO;GACR;AAGH,UAAQ,OAAO,MAAM,yBAAyB;GAAE;GAAS,WAAW,CAAC,CAAC;GAAU,CAAC;AAEjF,MAAI;GACF,MAAM,OAAgC;IACpC;IACA;IACA,cAAc;IACd,cAAc;IACf;AAED,OAAI,SACF,MAAK,YAAY;GAYnB,MAAM,OAAQ,OATG,MAAM,MAAM,GAAG,eAAe,oBAAoB;IACjE,QAAQ;IACR,SAAS;KACP,eAAe,UAAU;KACzB,gBAAgB;KACjB;IACD,MAAM,KAAK,UAAU,KAAK;IAC3B,CAAC,EAE2B,MAAM;AAQnC,OAAI,CAAC,KAAK,GACR,QAAO;IACL,SAAS;IACT,OAAO,oBAAoB,KAAK,SAAS;IAC1C;AAGH,UAAO;IACL,SAAS;IACT,QAAQ;KACN,SAAS,KAAK;KACd,IAAI,KAAK;KACT,aAAa,KAAK,SAAS;KAC5B;IACD,UAAU;KACR,SAAS,KAAK;KACd,IAAI,KAAK;KACT,yBAAQ,IAAI,MAAM,EAAC,aAAa;KACjC;IACF;WACM,OAAO;AAEd,UAAO;IAAE,SAAS;IAAO,OAAO,sBADpB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IACL;;;CAGlE,CAAC"}

package/dist/actions/triggers/cron.cjs

@@ -0,0 +1,95 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_define_action = require("../define-action.cjs");
+const require_providers = require("../providers.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/actions/triggers/cron.ts
+/**
+* trigger.cron — Cron Trigger action
+*
+* Entry-point node for flows triggered on a recurring schedule.
+*
+* At execution time, the cron scheduler injects trigger data via
+* `flowInputs.__triggerData`. The action reads it and returns it as output
+* so downstream nodes can access metadata like `{{ cron_trigger.scheduledTime }}`.
+*/
+const paramsSchema = zod_v4.z.object({
+	expression: zod_v4.z.string().min(1, "Cron expression is required"),
+	timezone: zod_v4.z.string().default("UTC"),
+	staticInputs: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.unknown()).optional()
+});
+const cronTriggerAction = require_define_action.defineAction({
+	id: "trigger.cron",
+	name: "Cron Trigger",
+	description: "Start this flow on a recurring schedule using a cron expression",
+	provider: require_providers.TRIGGERS_PROVIDER,
+	icon: "Clock",
+	noInput: true,
+	maxInstances: 1,
+	tags: [
+		"trigger",
+		"cron",
+		"schedule",
+		"timer",
+		"recurring",
+		"periodic",
+		"interval",
+		"automate"
+	],
+	params: {
+		schema: paramsSchema,
+		fields: [
+			{
+				name: "expression",
+				label: "Cron Expression",
+				type: "text",
+				required: true,
+				description: "Cron schedule (e.g. \"0 * * * *\" for every hour, \"0 9 * * 1-5\" for weekdays at 9am)",
+				placeholder: "0 * * * *"
+			},
+			{
+				name: "timezone",
+				label: "Timezone",
+				type: "text",
+				description: "IANA timezone (e.g. \"America/New_York\", \"Europe/London\"). Defaults to UTC.",
+				defaultValue: "UTC",
+				placeholder: "UTC"
+			},
+			{
+				name: "staticInputs",
+				label: "Static Inputs",
+				type: "json",
+				description: "Optional JSON object of static values to include with every cron trigger",
+				placeholder: "{ \"environment\": \"production\" }",
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const data = context.flowInputs?.__triggerData;
+		if (!data) return {
+			success: true,
+			output: {
+				scheduledTime: (/* @__PURE__ */ new Date()).toISOString(),
+				expression: params.expression,
+				timezone: params.timezone,
+				staticInputs: params.staticInputs ?? {}
+			},
+			metadata: {
+				triggerType: "cron",
+				isTest: true
+			}
+		};
+		return {
+			success: true,
+			output: {
+				...data,
+				staticInputs: params.staticInputs ?? {}
+			},
+			metadata: { triggerType: "cron" }
+		};
+	}
+});
+//#endregion
+exports.cronTriggerAction = cronTriggerAction;
+
+//# sourceMappingURL=cron.cjs.map

package/dist/actions/triggers/cron.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.cjs","names":["z","defineAction","TRIGGERS_PROVIDER"],"sources":["../../../src/actions/triggers/cron.ts"],"sourcesContent":["/**\n * trigger.cron — Cron Trigger action\n *\n * Entry-point node for flows triggered on a recurring schedule.\n *\n * At execution time, the cron scheduler injects trigger data via\n * `flowInputs.__triggerData`. The action reads it and returns it as output\n * so downstream nodes can access metadata like `{{ cron_trigger.scheduledTime }}`.\n */\n\nimport { defineAction } from '../define-action';\nimport { TRIGGERS_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\nconst paramsSchema = z.object({\n  /** Cron expression (standard 5-field or extended 6-field). */\n  expression: z.string().min(1, 'Cron expression is required'),\n  /** IANA timezone name. Defaults to UTC. */\n  timezone: z.string().default('UTC'),\n  /** Optional static inputs to include with every cron trigger. */\n  staticInputs: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const cronTriggerAction = defineAction({\n  id: 'trigger.cron',\n  name: 'Cron Trigger',\n  description: 'Start this flow on a recurring schedule using a cron expression',\n  provider: TRIGGERS_PROVIDER,\n  icon: 'Clock',\n  noInput: true,\n  maxInstances: 1,\n  tags: ['trigger', 'cron', 'schedule', 'timer', 'recurring', 'periodic', 'interval', 'automate'],\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'expression',\n        label: 'Cron Expression',\n        type: 'text',\n        required: true,\n        description:\n          'Cron schedule (e.g. \"0 * * * *\" for every hour, \"0 9 * * 1-5\" for weekdays at 9am)',\n        placeholder: '0 * * * *',\n      },\n      {\n        name: 'timezone',\n        label: 'Timezone',\n        type: 'text',\n        description: 'IANA timezone (e.g. \"America/New_York\", \"Europe/London\"). Defaults to UTC.',\n        defaultValue: 'UTC',\n        placeholder: 'UTC',\n      },\n      {\n        name: 'staticInputs',\n        label: 'Static Inputs',\n        type: 'json',\n        description: 'Optional JSON object of static values to include with every cron trigger',\n        placeholder: '{ \"environment\": \"production\" }',\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    // triggerData is injected via flowInputs.__triggerData (a native object)\n    const data = context.flowInputs?.__triggerData as Record<string, unknown> | undefined;\n    if (!data) {\n      // Testing: return current time\n      return {\n        success: true,\n        output: {\n          scheduledTime: new Date().toISOString(),\n          expression: params.expression,\n          timezone: params.timezone,\n          staticInputs: params.staticInputs ?? {},\n        },\n        metadata: { triggerType: 'cron', isTest: true },\n      };\n    }\n    return {\n      success: true,\n      output: {\n        ...data,\n        staticInputs: params.staticInputs ?? {},\n      },\n      metadata: { triggerType: 'cron' },\n    };\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAM,eAAeA,OAAAA,EAAE,OAAO;CAE5B,YAAYA,OAAAA,EAAE,QAAQ,CAAC,IAAI,GAAG,8BAA8B;CAE5D,UAAUA,OAAAA,EAAE,QAAQ,CAAC,QAAQ,MAAM;CAEnC,cAAcA,OAAAA,EAAE,OAAOA,OAAAA,EAAE,QAAQ,EAAEA,OAAAA,EAAE,SAAS,CAAC,CAAC,UAAU;CAC3D,CAAC;AAEF,MAAa,oBAAoBC,sBAAAA,aAAa;CAC5C,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAUC,kBAAAA;CACV,MAAM;CACN,SAAS;CACT,cAAc;CACd,MAAM;EAAC;EAAW;EAAQ;EAAY;EAAS;EAAa;EAAY;EAAY;EAAW;CAE/F,QAAQ;EACN,QAAQ;EACR,QAAQ;GACN;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aACE;IACF,aAAa;IACd;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,cAAc;IACd,aAAa;IACd;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,aAAa;IACb,UAAU;IACX;GACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAE7B,MAAM,OAAO,QAAQ,YAAY;AACjC,MAAI,CAAC,KAEH,QAAO;GACL,SAAS;GACT,QAAQ;IACN,gCAAe,IAAI,MAAM,EAAC,aAAa;IACvC,YAAY,OAAO;IACnB,UAAU,OAAO;IACjB,cAAc,OAAO,gBAAgB,EAAE;IACxC;GACD,UAAU;IAAE,aAAa;IAAQ,QAAQ;IAAM;GAChD;AAEH,SAAO;GACL,SAAS;GACT,QAAQ;IACN,GAAG;IACH,cAAc,OAAO,gBAAgB,EAAE;IACxC;GACD,UAAU,EAAE,aAAa,QAAQ;GAClC;;CAEJ,CAAC"}

package/dist/actions/triggers/cron.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/actions/triggers/cron.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/actions/triggers/cron.js

@@ -0,0 +1,83 @@
+import { defineAction } from "../define-action.js";
+import { TRIGGERS_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+const cronTriggerAction = defineAction({
+	id: "trigger.cron",
+	name: "Cron Trigger",
+	description: "Start this flow on a recurring schedule using a cron expression",
+	provider: TRIGGERS_PROVIDER,
+	icon: "Clock",
+	noInput: true,
+	maxInstances: 1,
+	tags: [
+		"trigger",
+		"cron",
+		"schedule",
+		"timer",
+		"recurring",
+		"periodic",
+		"interval",
+		"automate"
+	],
+	params: {
+		schema: z.object({
+			expression: z.string().min(1, "Cron expression is required"),
+			timezone: z.string().default("UTC"),
+			staticInputs: z.record(z.string(), z.unknown()).optional()
+		}),
+		fields: [
+			{
+				name: "expression",
+				label: "Cron Expression",
+				type: "text",
+				required: true,
+				description: "Cron schedule (e.g. \"0 * * * *\" for every hour, \"0 9 * * 1-5\" for weekdays at 9am)",
+				placeholder: "0 * * * *"
+			},
+			{
+				name: "timezone",
+				label: "Timezone",
+				type: "text",
+				description: "IANA timezone (e.g. \"America/New_York\", \"Europe/London\"). Defaults to UTC.",
+				defaultValue: "UTC",
+				placeholder: "UTC"
+			},
+			{
+				name: "staticInputs",
+				label: "Static Inputs",
+				type: "json",
+				description: "Optional JSON object of static values to include with every cron trigger",
+				placeholder: "{ \"environment\": \"production\" }",
+				extended: true
+			}
+		]
+	},
+	async execute(params, context) {
+		const data = context.flowInputs?.__triggerData;
+		if (!data) return {
+			success: true,
+			output: {
+				scheduledTime: (/* @__PURE__ */ new Date()).toISOString(),
+				expression: params.expression,
+				timezone: params.timezone,
+				staticInputs: params.staticInputs ?? {}
+			},
+			metadata: {
+				triggerType: "cron",
+				isTest: true
+			}
+		};
+		return {
+			success: true,
+			output: {
+				...data,
+				staticInputs: params.staticInputs ?? {}
+			},
+			metadata: { triggerType: "cron" }
+		};
+	}
+});
+//#endregion
+export { cronTriggerAction };
+
+//# sourceMappingURL=cron.js.map

package/dist/actions/triggers/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","names":[],"sources":["../../../src/actions/triggers/cron.ts"],"sourcesContent":["/**\n * trigger.cron — Cron Trigger action\n *\n * Entry-point node for flows triggered on a recurring schedule.\n *\n * At execution time, the cron scheduler injects trigger data via\n * `flowInputs.__triggerData`. The action reads it and returns it as output\n * so downstream nodes can access metadata like `{{ cron_trigger.scheduledTime }}`.\n */\n\nimport { defineAction } from '../define-action';\nimport { TRIGGERS_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\nconst paramsSchema = z.object({\n  /** Cron expression (standard 5-field or extended 6-field). */\n  expression: z.string().min(1, 'Cron expression is required'),\n  /** IANA timezone name. Defaults to UTC. */\n  timezone: z.string().default('UTC'),\n  /** Optional static inputs to include with every cron trigger. */\n  staticInputs: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const cronTriggerAction = defineAction({\n  id: 'trigger.cron',\n  name: 'Cron Trigger',\n  description: 'Start this flow on a recurring schedule using a cron expression',\n  provider: TRIGGERS_PROVIDER,\n  icon: 'Clock',\n  noInput: true,\n  maxInstances: 1,\n  tags: ['trigger', 'cron', 'schedule', 'timer', 'recurring', 'periodic', 'interval', 'automate'],\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'expression',\n        label: 'Cron Expression',\n        type: 'text',\n        required: true,\n        description:\n          'Cron schedule (e.g. \"0 * * * *\" for every hour, \"0 9 * * 1-5\" for weekdays at 9am)',\n        placeholder: '0 * * * *',\n      },\n      {\n        name: 'timezone',\n        label: 'Timezone',\n        type: 'text',\n        description: 'IANA timezone (e.g. \"America/New_York\", \"Europe/London\"). Defaults to UTC.',\n        defaultValue: 'UTC',\n        placeholder: 'UTC',\n      },\n      {\n        name: 'staticInputs',\n        label: 'Static Inputs',\n        type: 'json',\n        description: 'Optional JSON object of static values to include with every cron trigger',\n        placeholder: '{ \"environment\": \"production\" }',\n        extended: true,\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    // triggerData is injected via flowInputs.__triggerData (a native object)\n    const data = context.flowInputs?.__triggerData as Record<string, unknown> | undefined;\n    if (!data) {\n      // Testing: return current time\n      return {\n        success: true,\n        output: {\n          scheduledTime: new Date().toISOString(),\n          expression: params.expression,\n          timezone: params.timezone,\n          staticInputs: params.staticInputs ?? {},\n        },\n        metadata: { triggerType: 'cron', isTest: true },\n      };\n    }\n    return {\n      success: true,\n      output: {\n        ...data,\n        staticInputs: params.staticInputs ?? {},\n      },\n      metadata: { triggerType: 'cron' },\n    };\n  },\n});\n"],"mappings":";;;AAuBA,MAAa,oBAAoB,aAAa;CAC5C,IAAI;CACJ,MAAM;CACN,aAAa;CACb,UAAU;CACV,MAAM;CACN,SAAS;CACT,cAAc;CACd,MAAM;EAAC;EAAW;EAAQ;EAAY;EAAS;EAAa;EAAY;EAAY;EAAW;CAE/F,QAAQ;EACN,QApBiB,EAAE,OAAO;GAE5B,YAAY,EAAE,QAAQ,CAAC,IAAI,GAAG,8BAA8B;GAE5D,UAAU,EAAE,QAAQ,CAAC,QAAQ,MAAM;GAEnC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU;GAC3D,CAAC;EAcE,QAAQ;GACN;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,aACE;IACF,aAAa;IACd;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,cAAc;IACd,aAAa;IACd;GACD;IACE,MAAM;IACN,OAAO;IACP,MAAM;IACN,aAAa;IACb,aAAa;IACb,UAAU;IACX;GACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAE7B,MAAM,OAAO,QAAQ,YAAY;AACjC,MAAI,CAAC,KAEH,QAAO;GACL,SAAS;GACT,QAAQ;IACN,gCAAe,IAAI,MAAM,EAAC,aAAa;IACvC,YAAY,OAAO;IACnB,UAAU,OAAO;IACjB,cAAc,OAAO,gBAAgB,EAAE;IACxC;GACD,UAAU;IAAE,aAAa;IAAQ,QAAQ;IAAM;GAChD;AAEH,SAAO;GACL,SAAS;GACT,QAAQ;IACN,GAAG;IACH,cAAc,OAAO,gBAAgB,EAAE;IACxC;GACD,UAAU,EAAE,aAAa,QAAQ;GAClC;;CAEJ,CAAC"}

package/dist/actions/triggers/index.cjs

@@ -0,0 +1,9 @@
+const require_manual = require("./manual.cjs");
+const require_cron = require("./cron.cjs");
+//#region src/actions/triggers/index.ts
+/** All trigger actions as an array (for bulk registration). */
+const triggerActions = [require_manual.manualTriggerAction, require_cron.cronTriggerAction];
+//#endregion
+exports.triggerActions = triggerActions;
+
+//# sourceMappingURL=index.cjs.map

package/dist/actions/triggers/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["manualTriggerAction","cronTriggerAction"],"sources":["../../../src/actions/triggers/index.ts"],"sourcesContent":["/**\n * Trigger actions barrel export.\n *\n * Import this module to register all trigger actions in the ActionRegistry.\n */\n\nexport { manualTriggerAction } from './manual';\nexport { cronTriggerAction } from './cron';\n\nimport type { ActionDefinition } from '../types';\nimport { manualTriggerAction } from './manual';\nimport { cronTriggerAction } from './cron';\n\n/** All trigger actions as an array (for bulk registration). */\nexport const triggerActions: ActionDefinition[] = [manualTriggerAction, cronTriggerAction];\n"],"mappings":";;;;AAcA,MAAa,iBAAqC,CAACA,eAAAA,qBAAqBC,aAAAA,kBAAkB"}

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

@@ -0,0 +1 @@
+export { };

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

@@ -0,0 +1 @@
+export { };

package/dist/actions/triggers/index.js

@@ -0,0 +1,9 @@
+import { manualTriggerAction } from "./manual.js";
+import { cronTriggerAction } from "./cron.js";
+//#region src/actions/triggers/index.ts
+/** All trigger actions as an array (for bulk registration). */
+const triggerActions = [manualTriggerAction, cronTriggerAction];
+//#endregion
+export { triggerActions };
+
+//# sourceMappingURL=index.js.map

package/dist/actions/triggers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/actions/triggers/index.ts"],"sourcesContent":["/**\n * Trigger actions barrel export.\n *\n * Import this module to register all trigger actions in the ActionRegistry.\n */\n\nexport { manualTriggerAction } from './manual';\nexport { cronTriggerAction } from './cron';\n\nimport type { ActionDefinition } from '../types';\nimport { manualTriggerAction } from './manual';\nimport { cronTriggerAction } from './cron';\n\n/** All trigger actions as an array (for bulk registration). */\nexport const triggerActions: ActionDefinition[] = [manualTriggerAction, cronTriggerAction];\n"],"mappings":";;;;AAcA,MAAa,iBAAqC,CAAC,qBAAqB,kBAAkB"}

package/dist/actions/triggers/manual.cjs

@@ -0,0 +1,105 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_define_action = require("../define-action.cjs");
+const require_providers = require("../providers.cjs");
+let zod_v4 = require("zod/v4");
+//#region src/actions/triggers/manual.ts
+/**
+* trigger.manual — Manual Trigger action
+*
+* The primary entry-point node for flows.  Every flow should have exactly
+* one Manual Trigger.  It is invoked when the flow is started from the UI
+* "Run" button, the REST API, or programmatically via `startFlowRun()`.
+*
+* Optionally accepts **input definitions** — a JSON array of expected input
+* fields with names and default values.  When input definitions are provided
+* the node validates that each expected variable exists in `flowInputs` and
+* falls back to the configured default.  When no definitions are provided the
+* node simply passes through all `flowInputs` unchanged.
+*
+* Downstream nodes can reference values via
+* `{{ manual_trigger.variableName }}`.
+*/
+/**
+* Schema for a single expected input field.
+*/
+const inputFieldSchema = zod_v4.z.object({
+	name: zod_v4.z.string().min(1),
+	defaultValue: zod_v4.z.union([
+		zod_v4.z.string(),
+		zod_v4.z.number(),
+		zod_v4.z.boolean(),
+		zod_v4.z.null()
+	]).optional()
+});
+const paramsSchema = zod_v4.z.object({ inputDefinitions: zod_v4.z.array(inputFieldSchema).optional() });
+const manualTriggerAction = require_define_action.defineAction({
+	id: "trigger.manual",
+	name: "Manual Trigger",
+	description: "Start this flow manually from the UI or via the API. Optionally define expected input fields with default values.",
+	provider: require_providers.TRIGGERS_PROVIDER,
+	icon: "Play",
+	noInput: true,
+	maxInstances: 1,
+	tags: [
+		"trigger",
+		"manual",
+		"start",
+		"run",
+		"execute",
+		"begin",
+		"launch",
+		"input",
+		"variable",
+		"parameter",
+		"entry"
+	],
+	params: {
+		schema: paramsSchema,
+		fields: [{
+			name: "inputDefinitions",
+			label: "Input Fields",
+			type: "json",
+			description: "Optional list of expected inputs. Each entry should have a \"name\" and an optional \"defaultValue\". When defined, only these variables are extracted from the flow inputs.",
+			placeholder: "[{ \"name\": \"topic\", \"defaultValue\": \"hello world\" }, { \"name\": \"count\" }]"
+		}]
+	},
+	async execute(params, context) {
+		const flowInputs = { ...context.flowInputs ?? {} };
+		delete flowInputs.__triggerData;
+		delete flowInputs.__triggerNodeId;
+		const { inputDefinitions } = params;
+		context.logger.debug("Manual trigger fired", {
+			inputKeys: Object.keys(flowInputs),
+			hasInputDefinitions: !!inputDefinitions?.length
+		});
+		if (!inputDefinitions || inputDefinitions.length === 0) return {
+			success: true,
+			output: flowInputs,
+			metadata: { triggerType: "manual" }
+		};
+		const output = {};
+		const missing = [];
+		for (const field of inputDefinitions) {
+			const value = flowInputs[field.name];
+			if (value !== void 0 && value !== null) output[field.name] = value;
+			else if (field.defaultValue !== void 0 && field.defaultValue !== null) output[field.name] = field.defaultValue;
+			else missing.push(field.name);
+		}
+		if (missing.length > 0) return {
+			success: false,
+			error: `Missing required input(s): ${missing.join(", ")}. Available inputs: ${Object.keys(flowInputs).join(", ") || "(none)"}`
+		};
+		return {
+			success: true,
+			output,
+			metadata: {
+				triggerType: "manual",
+				definedInputs: inputDefinitions.map((d) => d.name)
+			}
+		};
+	}
+});
+//#endregion
+exports.manualTriggerAction = manualTriggerAction;
+
+//# sourceMappingURL=manual.cjs.map

package/dist/actions/triggers/manual.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.cjs","names":["z","defineAction","TRIGGERS_PROVIDER"],"sources":["../../../src/actions/triggers/manual.ts"],"sourcesContent":["/**\n * trigger.manual — Manual Trigger action\n *\n * The primary entry-point node for flows.  Every flow should have exactly\n * one Manual Trigger.  It is invoked when the flow is started from the UI\n * \"Run\" button, the REST API, or programmatically via `startFlowRun()`.\n *\n * Optionally accepts **input definitions** — a JSON array of expected input\n * fields with names and default values.  When input definitions are provided\n * the node validates that each expected variable exists in `flowInputs` and\n * falls back to the configured default.  When no definitions are provided the\n * node simply passes through all `flowInputs` unchanged.\n *\n * Downstream nodes can reference values via\n * `{{ manual_trigger.variableName }}`.\n */\n\nimport { defineAction } from '../define-action';\nimport { TRIGGERS_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\n/**\n * Schema for a single expected input field.\n */\nconst inputFieldSchema = z.object({\n  /** Variable name — must match the key callers pass in `flowInputs`. */\n  name: z.string().min(1),\n  /** Optional default value used when the caller omits this variable. */\n  defaultValue: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),\n});\n\nconst paramsSchema = z.object({\n  /**\n   * Optional list of expected input fields.\n   * When provided the node extracts only these variables (applying defaults),\n   * giving downstream nodes a predictable, documented shape.\n   * When omitted ALL flowInputs are passed through.\n   */\n  inputDefinitions: z.array(inputFieldSchema).optional(),\n});\n\nexport const manualTriggerAction = defineAction({\n  id: 'trigger.manual',\n  name: 'Manual Trigger',\n  description:\n    'Start this flow manually from the UI or via the API. ' +\n    'Optionally define expected input fields with default values.',\n  provider: TRIGGERS_PROVIDER,\n  icon: 'Play',\n  noInput: true,\n  maxInstances: 1,\n  tags: [\n    'trigger',\n    'manual',\n    'start',\n    'run',\n    'execute',\n    'begin',\n    'launch',\n    'input',\n    'variable',\n    'parameter',\n    'entry',\n  ],\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'inputDefinitions',\n        label: 'Input Fields',\n        type: 'json',\n        description:\n          'Optional list of expected inputs. ' +\n          'Each entry should have a \"name\" and an optional \"defaultValue\". ' +\n          'When defined, only these variables are extracted from the flow inputs.',\n        placeholder: '[{ \"name\": \"topic\", \"defaultValue\": \"hello world\" }, { \"name\": \"count\" }]',\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    // Strip internal trigger keys before processing\n    const flowInputs = { ...(context.flowInputs ?? {}) };\n    delete flowInputs.__triggerData;\n    delete flowInputs.__triggerNodeId;\n\n    const { inputDefinitions } = params;\n\n    context.logger.debug('Manual trigger fired', {\n      inputKeys: Object.keys(flowInputs),\n      hasInputDefinitions: !!inputDefinitions?.length,\n    });\n\n    // When no input definitions are configured, pass everything through.\n    if (!inputDefinitions || inputDefinitions.length === 0) {\n      return {\n        success: true,\n        output: flowInputs,\n        metadata: { triggerType: 'manual' },\n      };\n    }\n\n    // Build output from defined inputs, applying defaults for missing values.\n    const output: Record<string, unknown> = {};\n    const missing: string[] = [];\n\n    for (const field of inputDefinitions) {\n      const value = flowInputs[field.name];\n      if (value !== undefined && value !== null) {\n        output[field.name] = value;\n      } else if (field.defaultValue !== undefined && field.defaultValue !== null) {\n        output[field.name] = field.defaultValue;\n      } else {\n        missing.push(field.name);\n      }\n    }\n\n    if (missing.length > 0) {\n      return {\n        success: false,\n        error:\n          `Missing required input(s): ${missing.join(', ')}. ` +\n          `Available inputs: ${Object.keys(flowInputs).join(', ') || '(none)'}`,\n      };\n    }\n\n    return {\n      success: true,\n      output,\n      metadata: {\n        triggerType: 'manual',\n        definedInputs: inputDefinitions.map((d) => d.name),\n      },\n    };\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,mBAAmBA,OAAAA,EAAE,OAAO;CAEhC,MAAMA,OAAAA,EAAE,QAAQ,CAAC,IAAI,EAAE;CAEvB,cAAcA,OAAAA,EAAE,MAAM;EAACA,OAAAA,EAAE,QAAQ;EAAEA,OAAAA,EAAE,QAAQ;EAAEA,OAAAA,EAAE,SAAS;EAAEA,OAAAA,EAAE,MAAM;EAAC,CAAC,CAAC,UAAU;CAClF,CAAC;AAEF,MAAM,eAAeA,OAAAA,EAAE,OAAO,EAO5B,kBAAkBA,OAAAA,EAAE,MAAM,iBAAiB,CAAC,UAAU,EACvD,CAAC;AAEF,MAAa,sBAAsBC,sBAAAA,aAAa;CAC9C,IAAI;CACJ,MAAM;CACN,aACE;CAEF,UAAUC,kBAAAA;CACV,MAAM;CACN,SAAS;CACT,cAAc;CACd,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAED,QAAQ;EACN,QAAQ;EACR,QAAQ,CACN;GACE,MAAM;GACN,OAAO;GACP,MAAM;GACN,aACE;GAGF,aAAa;GACd,CACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAE7B,MAAM,aAAa,EAAE,GAAI,QAAQ,cAAc,EAAE,EAAG;AACpD,SAAO,WAAW;AAClB,SAAO,WAAW;EAElB,MAAM,EAAE,qBAAqB;AAE7B,UAAQ,OAAO,MAAM,wBAAwB;GAC3C,WAAW,OAAO,KAAK,WAAW;GAClC,qBAAqB,CAAC,CAAC,kBAAkB;GAC1C,CAAC;AAGF,MAAI,CAAC,oBAAoB,iBAAiB,WAAW,EACnD,QAAO;GACL,SAAS;GACT,QAAQ;GACR,UAAU,EAAE,aAAa,UAAU;GACpC;EAIH,MAAM,SAAkC,EAAE;EAC1C,MAAM,UAAoB,EAAE;AAE5B,OAAK,MAAM,SAAS,kBAAkB;GACpC,MAAM,QAAQ,WAAW,MAAM;AAC/B,OAAI,UAAU,KAAA,KAAa,UAAU,KACnC,QAAO,MAAM,QAAQ;YACZ,MAAM,iBAAiB,KAAA,KAAa,MAAM,iBAAiB,KACpE,QAAO,MAAM,QAAQ,MAAM;OAE3B,SAAQ,KAAK,MAAM,KAAK;;AAI5B,MAAI,QAAQ,SAAS,EACnB,QAAO;GACL,SAAS;GACT,OACE,8BAA8B,QAAQ,KAAK,KAAK,CAAC,sBAC5B,OAAO,KAAK,WAAW,CAAC,KAAK,KAAK,IAAI;GAC9D;AAGH,SAAO;GACL,SAAS;GACT;GACA,UAAU;IACR,aAAa;IACb,eAAe,iBAAiB,KAAK,MAAM,EAAE,KAAK;IACnD;GACF;;CAEJ,CAAC"}

package/dist/actions/triggers/manual.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/actions/triggers/manual.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/actions/triggers/manual.js

@@ -0,0 +1,103 @@
+import { defineAction } from "../define-action.js";
+import { TRIGGERS_PROVIDER } from "../providers.js";
+import { z } from "zod/v4";
+//#region src/actions/triggers/manual.ts
+/**
+* trigger.manual — Manual Trigger action
+*
+* The primary entry-point node for flows.  Every flow should have exactly
+* one Manual Trigger.  It is invoked when the flow is started from the UI
+* "Run" button, the REST API, or programmatically via `startFlowRun()`.
+*
+* Optionally accepts **input definitions** — a JSON array of expected input
+* fields with names and default values.  When input definitions are provided
+* the node validates that each expected variable exists in `flowInputs` and
+* falls back to the configured default.  When no definitions are provided the
+* node simply passes through all `flowInputs` unchanged.
+*
+* Downstream nodes can reference values via
+* `{{ manual_trigger.variableName }}`.
+*/
+/**
+* Schema for a single expected input field.
+*/
+const inputFieldSchema = z.object({
+	name: z.string().min(1),
+	defaultValue: z.union([
+		z.string(),
+		z.number(),
+		z.boolean(),
+		z.null()
+	]).optional()
+});
+const manualTriggerAction = defineAction({
+	id: "trigger.manual",
+	name: "Manual Trigger",
+	description: "Start this flow manually from the UI or via the API. Optionally define expected input fields with default values.",
+	provider: TRIGGERS_PROVIDER,
+	icon: "Play",
+	noInput: true,
+	maxInstances: 1,
+	tags: [
+		"trigger",
+		"manual",
+		"start",
+		"run",
+		"execute",
+		"begin",
+		"launch",
+		"input",
+		"variable",
+		"parameter",
+		"entry"
+	],
+	params: {
+		schema: z.object({ inputDefinitions: z.array(inputFieldSchema).optional() }),
+		fields: [{
+			name: "inputDefinitions",
+			label: "Input Fields",
+			type: "json",
+			description: "Optional list of expected inputs. Each entry should have a \"name\" and an optional \"defaultValue\". When defined, only these variables are extracted from the flow inputs.",
+			placeholder: "[{ \"name\": \"topic\", \"defaultValue\": \"hello world\" }, { \"name\": \"count\" }]"
+		}]
+	},
+	async execute(params, context) {
+		const flowInputs = { ...context.flowInputs ?? {} };
+		delete flowInputs.__triggerData;
+		delete flowInputs.__triggerNodeId;
+		const { inputDefinitions } = params;
+		context.logger.debug("Manual trigger fired", {
+			inputKeys: Object.keys(flowInputs),
+			hasInputDefinitions: !!inputDefinitions?.length
+		});
+		if (!inputDefinitions || inputDefinitions.length === 0) return {
+			success: true,
+			output: flowInputs,
+			metadata: { triggerType: "manual" }
+		};
+		const output = {};
+		const missing = [];
+		for (const field of inputDefinitions) {
+			const value = flowInputs[field.name];
+			if (value !== void 0 && value !== null) output[field.name] = value;
+			else if (field.defaultValue !== void 0 && field.defaultValue !== null) output[field.name] = field.defaultValue;
+			else missing.push(field.name);
+		}
+		if (missing.length > 0) return {
+			success: false,
+			error: `Missing required input(s): ${missing.join(", ")}. Available inputs: ${Object.keys(flowInputs).join(", ") || "(none)"}`
+		};
+		return {
+			success: true,
+			output,
+			metadata: {
+				triggerType: "manual",
+				definedInputs: inputDefinitions.map((d) => d.name)
+			}
+		};
+	}
+});
+//#endregion
+export { manualTriggerAction };
+
+//# sourceMappingURL=manual.js.map

package/dist/actions/triggers/manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.js","names":[],"sources":["../../../src/actions/triggers/manual.ts"],"sourcesContent":["/**\n * trigger.manual — Manual Trigger action\n *\n * The primary entry-point node for flows.  Every flow should have exactly\n * one Manual Trigger.  It is invoked when the flow is started from the UI\n * \"Run\" button, the REST API, or programmatically via `startFlowRun()`.\n *\n * Optionally accepts **input definitions** — a JSON array of expected input\n * fields with names and default values.  When input definitions are provided\n * the node validates that each expected variable exists in `flowInputs` and\n * falls back to the configured default.  When no definitions are provided the\n * node simply passes through all `flowInputs` unchanged.\n *\n * Downstream nodes can reference values via\n * `{{ manual_trigger.variableName }}`.\n */\n\nimport { defineAction } from '../define-action';\nimport { TRIGGERS_PROVIDER } from '../providers';\nimport { z } from 'zod/v4';\n\n/**\n * Schema for a single expected input field.\n */\nconst inputFieldSchema = z.object({\n  /** Variable name — must match the key callers pass in `flowInputs`. */\n  name: z.string().min(1),\n  /** Optional default value used when the caller omits this variable. */\n  defaultValue: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),\n});\n\nconst paramsSchema = z.object({\n  /**\n   * Optional list of expected input fields.\n   * When provided the node extracts only these variables (applying defaults),\n   * giving downstream nodes a predictable, documented shape.\n   * When omitted ALL flowInputs are passed through.\n   */\n  inputDefinitions: z.array(inputFieldSchema).optional(),\n});\n\nexport const manualTriggerAction = defineAction({\n  id: 'trigger.manual',\n  name: 'Manual Trigger',\n  description:\n    'Start this flow manually from the UI or via the API. ' +\n    'Optionally define expected input fields with default values.',\n  provider: TRIGGERS_PROVIDER,\n  icon: 'Play',\n  noInput: true,\n  maxInstances: 1,\n  tags: [\n    'trigger',\n    'manual',\n    'start',\n    'run',\n    'execute',\n    'begin',\n    'launch',\n    'input',\n    'variable',\n    'parameter',\n    'entry',\n  ],\n\n  params: {\n    schema: paramsSchema,\n    fields: [\n      {\n        name: 'inputDefinitions',\n        label: 'Input Fields',\n        type: 'json',\n        description:\n          'Optional list of expected inputs. ' +\n          'Each entry should have a \"name\" and an optional \"defaultValue\". ' +\n          'When defined, only these variables are extracted from the flow inputs.',\n        placeholder: '[{ \"name\": \"topic\", \"defaultValue\": \"hello world\" }, { \"name\": \"count\" }]',\n      },\n    ],\n  },\n\n  async execute(params, context) {\n    // Strip internal trigger keys before processing\n    const flowInputs = { ...(context.flowInputs ?? {}) };\n    delete flowInputs.__triggerData;\n    delete flowInputs.__triggerNodeId;\n\n    const { inputDefinitions } = params;\n\n    context.logger.debug('Manual trigger fired', {\n      inputKeys: Object.keys(flowInputs),\n      hasInputDefinitions: !!inputDefinitions?.length,\n    });\n\n    // When no input definitions are configured, pass everything through.\n    if (!inputDefinitions || inputDefinitions.length === 0) {\n      return {\n        success: true,\n        output: flowInputs,\n        metadata: { triggerType: 'manual' },\n      };\n    }\n\n    // Build output from defined inputs, applying defaults for missing values.\n    const output: Record<string, unknown> = {};\n    const missing: string[] = [];\n\n    for (const field of inputDefinitions) {\n      const value = flowInputs[field.name];\n      if (value !== undefined && value !== null) {\n        output[field.name] = value;\n      } else if (field.defaultValue !== undefined && field.defaultValue !== null) {\n        output[field.name] = field.defaultValue;\n      } else {\n        missing.push(field.name);\n      }\n    }\n\n    if (missing.length > 0) {\n      return {\n        success: false,\n        error:\n          `Missing required input(s): ${missing.join(', ')}. ` +\n          `Available inputs: ${Object.keys(flowInputs).join(', ') || '(none)'}`,\n      };\n    }\n\n    return {\n      success: true,\n      output,\n      metadata: {\n        triggerType: 'manual',\n        definedInputs: inputDefinitions.map((d) => d.name),\n      },\n    };\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,mBAAmB,EAAE,OAAO;CAEhC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CAEvB,cAAc,EAAE,MAAM;EAAC,EAAE,QAAQ;EAAE,EAAE,QAAQ;EAAE,EAAE,SAAS;EAAE,EAAE,MAAM;EAAC,CAAC,CAAC,UAAU;CAClF,CAAC;AAYF,MAAa,sBAAsB,aAAa;CAC9C,IAAI;CACJ,MAAM;CACN,aACE;CAEF,UAAU;CACV,MAAM;CACN,SAAS;CACT,cAAc;CACd,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAED,QAAQ;EACN,QAnCiB,EAAE,OAAO,EAO5B,kBAAkB,EAAE,MAAM,iBAAiB,CAAC,UAAU,EACvD,CAAC;EA4BE,QAAQ,CACN;GACE,MAAM;GACN,OAAO;GACP,MAAM;GACN,aACE;GAGF,aAAa;GACd,CACF;EACF;CAED,MAAM,QAAQ,QAAQ,SAAS;EAE7B,MAAM,aAAa,EAAE,GAAI,QAAQ,cAAc,EAAE,EAAG;AACpD,SAAO,WAAW;AAClB,SAAO,WAAW;EAElB,MAAM,EAAE,qBAAqB;AAE7B,UAAQ,OAAO,MAAM,wBAAwB;GAC3C,WAAW,OAAO,KAAK,WAAW;GAClC,qBAAqB,CAAC,CAAC,kBAAkB;GAC1C,CAAC;AAGF,MAAI,CAAC,oBAAoB,iBAAiB,WAAW,EACnD,QAAO;GACL,SAAS;GACT,QAAQ;GACR,UAAU,EAAE,aAAa,UAAU;GACpC;EAIH,MAAM,SAAkC,EAAE;EAC1C,MAAM,UAAoB,EAAE;AAE5B,OAAK,MAAM,SAAS,kBAAkB;GACpC,MAAM,QAAQ,WAAW,MAAM;AAC/B,OAAI,UAAU,KAAA,KAAa,UAAU,KACnC,QAAO,MAAM,QAAQ;YACZ,MAAM,iBAAiB,KAAA,KAAa,MAAM,iBAAiB,KACpE,QAAO,MAAM,QAAQ,MAAM;OAE3B,SAAQ,KAAK,MAAM,KAAK;;AAI5B,MAAI,QAAQ,SAAS,EACnB,QAAO;GACL,SAAS;GACT,OACE,8BAA8B,QAAQ,KAAK,KAAK,CAAC,sBAC5B,OAAO,KAAK,WAAW,CAAC,KAAK,KAAK,IAAI;GAC9D;AAGH,SAAO;GACL,SAAS;GACT;GACA,UAAU;IACR,aAAa;IACb,eAAe,iBAAiB,KAAK,MAAM,EAAE,KAAK;IACnD;GACF;;CAEJ,CAAC"}