@octaviaflow/flow-rules 0.1.0

package/dist/catalog/storage/storageCapabilities.js

@@ -0,0 +1,207 @@
+// ============================================
+// Storage capability registry
+// ============================================
+// Single source of truth for the unified `storage_action` config panel. Per
+// storage connector (provider), declares which operations are available and,
+// for each operation, which config fields to render — including the
+// provider-native key each FilePicker path is stored under.
+//
+// The Engine's storageExecutor reads these native keys (cfg.key / cfg.remotePath
+// / cfg.path / cfg.fileId / cfg.folderId ...), so the panel writes them directly
+// here — no Engine-side path mapping needed.
+// ============================================
+// ── shared field fragments ──────────────────────────────────────────────────
+const contentTypeField = {
+    key: 'contentType',
+    label: 'Content type',
+    type: 'string',
+    placeholder: 'application/octet-stream',
+    advanced: true,
+    hint: 'MIME type for the uploaded file.',
+};
+// ── providers ───────────────────────────────────────────────────────────────
+export const STORAGE_PROVIDERS = {
+    aws_s3: {
+        connectorId: 'aws_s3',
+        label: 'Amazon S3',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'prefix', label: 'Folder', selectMode: 'folder' }, fields: [{ key: 'maxKeys', label: 'Max results', type: 'number', defaultValue: 100, advanced: true }] },
+            { value: 'download', label: 'Download file', path: { key: 'key', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'key', label: 'Destination key', selectMode: 'both', required: true }, content: true, fields: [contentTypeField] },
+            { value: 'delete', label: 'Delete file', path: { key: 'key', label: 'File', selectMode: 'both', required: true } },
+            { value: 'copy', label: 'Copy file', path: { key: 'key', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destKey', label: 'Destination key', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move / rename', path: { key: 'key', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destKey', label: 'Destination key', selectMode: 'both', required: true } },
+            { value: 'presign', label: 'Get signed URL', path: { key: 'key', label: 'File', selectMode: 'both', required: true }, fields: [{ key: 'expiresIn', label: 'Expiry (seconds)', type: 'number', defaultValue: 3600, advanced: true }] },
+        ],
+    },
+    ftp_sftp: {
+        connectorId: 'ftp_sftp',
+        label: 'FTP / SFTP',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'remotePath', label: 'Folder', selectMode: 'folder' } },
+            { value: 'download', label: 'Download file', path: { key: 'remotePath', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'remotePath', label: 'Destination path', selectMode: 'both', required: true }, content: true },
+            { value: 'delete', label: 'Delete file', path: { key: 'remotePath', label: 'File', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move / rename', path: { key: 'remotePath', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destPath', label: 'Destination path', selectMode: 'both', required: true } },
+        ],
+    },
+    dropbox: {
+        connectorId: 'dropbox',
+        label: 'Dropbox',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'path', label: 'Folder', selectMode: 'folder' } },
+            { value: 'download', label: 'Download file', path: { key: 'path', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'path', label: 'Destination path', selectMode: 'both', required: true }, content: true, fields: [{ key: 'mode', label: 'Write mode', type: 'select', options: [{ label: 'Overwrite', value: 'overwrite' }, { label: 'Add (keep both)', value: 'add' }], defaultValue: 'overwrite', advanced: true }] },
+            { value: 'delete', label: 'Delete file', path: { key: 'path', label: 'File', selectMode: 'both', required: true } },
+            { value: 'copy', label: 'Copy file', path: { key: 'path', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destPath', label: 'Destination path', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move / rename', path: { key: 'path', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destPath', label: 'Destination path', selectMode: 'both', required: true } },
+        ],
+    },
+    onedrive: {
+        connectorId: 'onedrive',
+        label: 'OneDrive',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'path', label: 'Folder', selectMode: 'folder' } },
+            { value: 'download', label: 'Download file', path: { key: 'path', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'path', label: 'Destination path', selectMode: 'both', required: true }, content: true, fields: [contentTypeField] },
+            { value: 'delete', label: 'Delete file', path: { key: 'path', label: 'File', selectMode: 'both', required: true } },
+            { value: 'copy', label: 'Copy file', path: { key: 'path', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destPath', label: 'Destination path', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move / rename', path: { key: 'path', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destPath', label: 'Destination path', selectMode: 'both', required: true } },
+        ],
+    },
+    // Google Drive uses opaque folderIds (not hierarchical paths); the FilePicker
+    // navigates by folderId and writes the picked id to fileId / folderId.
+    google_drive: {
+        connectorId: 'google_drive',
+        label: 'Google Drive',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'folderId', label: 'Folder', selectMode: 'folder' }, fields: [{ key: 'query', label: 'Search query', type: 'string', advanced: true }, { key: 'pageSize', label: 'Max results', type: 'number', defaultValue: 50, advanced: true }] },
+            { value: 'download', label: 'Download file', path: { key: 'fileId', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'folderId', label: 'Destination folder', selectMode: 'both' }, content: true, fields: [{ key: 'fileName', label: 'File name', type: 'string', required: true }, { key: 'mimeType', label: 'Content type', type: 'string', advanced: true }] },
+            { value: 'delete', label: 'Delete file', path: { key: 'fileId', label: 'File', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move', path: { key: 'fileId', label: 'File', selectMode: 'both', required: true }, dest: { key: 'destFolderId', label: 'Destination folder', selectMode: 'both', required: true } },
+            { value: 'copy', label: 'Copy', path: { key: 'fileId', label: 'File', selectMode: 'both', required: true }, dest: { key: 'destFolderId', label: 'Destination folder', selectMode: 'both' }, fields: [{ key: 'fileName', label: 'New name', type: 'string' }] },
+            { value: 'share', label: 'Share', path: { key: 'fileId', label: 'File', selectMode: 'both', required: true }, fields: [{ key: 'shareEmail', label: 'Share with (email)', type: 'string', required: true }, { key: 'shareRole', label: 'Role', type: 'select', options: [{ label: 'Viewer', value: 'reader' }, { label: 'Editor', value: 'writer' }], defaultValue: 'reader' }] },
+            { value: 'create_folder', label: 'Create folder', path: { key: 'folderId', label: 'Parent folder', selectMode: 'both' }, fields: [{ key: 'fileName', label: 'Folder name', type: 'string', required: true }] },
+        ],
+    },
+    // GCS is an S3-like flat object store — paths are object keys written to `key`.
+    gcs: {
+        connectorId: 'gcs',
+        label: 'Google Cloud Storage',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'prefix', label: 'Folder', selectMode: 'folder' }, fields: [{ key: 'maxKeys', label: 'Max results', type: 'number', defaultValue: 100, advanced: true }] },
+            { value: 'download', label: 'Download file', path: { key: 'key', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'key', label: 'Destination key', selectMode: 'both', required: true }, content: true, fields: [contentTypeField] },
+            { value: 'delete', label: 'Delete file', path: { key: 'key', label: 'File', selectMode: 'both', required: true } },
+            { value: 'copy', label: 'Copy file', path: { key: 'key', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destKey', label: 'Destination key', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move / rename', path: { key: 'key', label: 'Source file', selectMode: 'both', required: true }, dest: { key: 'destKey', label: 'Destination key', selectMode: 'both', required: true } },
+            { value: 'presign', label: 'Get signed URL', path: { key: 'key', label: 'File', selectMode: 'both', required: true }, fields: [{ key: 'expiresIn', label: 'Expiry (seconds)', type: 'number', defaultValue: 3600, advanced: true }] },
+        ],
+    },
+    // Azure Blob is a flat blob store — paths are blob names written to `blob`.
+    azure_blob: {
+        connectorId: 'azure_blob',
+        label: 'Azure Blob Storage',
+        browse: true,
+        operations: [
+            { value: 'list', label: 'List files', path: { key: 'prefix', label: 'Folder', selectMode: 'folder' }, fields: [{ key: 'maxKeys', label: 'Max results', type: 'number', defaultValue: 100, advanced: true }] },
+            { value: 'download', label: 'Download file', path: { key: 'blob', label: 'File', selectMode: 'both', required: true } },
+            { value: 'upload', label: 'Upload file', path: { key: 'blob', label: 'Destination blob', selectMode: 'both', required: true }, content: true, fields: [contentTypeField] },
+            { value: 'delete', label: 'Delete file', path: { key: 'blob', label: 'File', selectMode: 'both', required: true } },
+            { value: 'copy', label: 'Copy file', path: { key: 'blob', label: 'Source blob', selectMode: 'both', required: true }, dest: { key: 'destBlob', label: 'Destination blob', selectMode: 'both', required: true } },
+            { value: 'move', label: 'Move / rename', path: { key: 'blob', label: 'Source blob', selectMode: 'both', required: true }, dest: { key: 'destBlob', label: 'Destination blob', selectMode: 'both', required: true } },
+            { value: 'presign', label: 'Get signed URL', path: { key: 'blob', label: 'File', selectMode: 'both', required: true }, fields: [{ key: 'expiresIn', label: 'Expiry (seconds)', type: 'number', defaultValue: 3600, advanced: true }] },
+        ],
+    },
+};
+// Google Sheets connectors share Drive access (same token + endpoints).
+STORAGE_PROVIDERS.google_sheets = { ...STORAGE_PROVIDERS.google_drive, connectorId: 'google_sheets' };
+// Cross-connector Transfer — available on every provider as the SOURCE; the
+// destination is a second connector chosen in the panel. Rendered specially by
+// StorageConfigPanel (source FilePicker + destination connector + dest path).
+const transferOp = {
+    value: 'transfer',
+    label: 'Transfer to another connector',
+    path: { key: 'path', label: 'Source file or folder', selectMode: 'both', required: true },
+};
+for (const id of ['aws_s3', 'ftp_sftp', 'dropbox', 'onedrive', 'google_drive', 'gcs', 'azure_blob']) {
+    STORAGE_PROVIDERS[id].operations.push(transferOp);
+}
+// Folder SYNC — recursive folder→folder copy to another connector that runs
+// reliably as the BODY of a `cursor`-mode ForEach: each pass is bounded and the
+// engine threads the BFS cursor across passes, so an arbitrarily deep tree never
+// hits the per-step deadline. Rendered specially by StorageConfigPanel.
+const syncOp = {
+    value: 'sync',
+    label: 'Sync folder to another connector',
+    path: { key: 'path', label: 'Source folder', selectMode: 'both', required: true },
+    fields: [
+        {
+            key: 'ifExists',
+            label: 'If a file already exists',
+            type: 'select',
+            options: [
+                { label: 'Overwrite', value: 'overwrite' },
+                { label: 'Skip it', value: 'skip' },
+                { label: 'Keep both (rename)', value: 'rename' },
+            ],
+            defaultValue: 'overwrite',
+            hint: 'What to do when the destination already has the file.',
+        },
+        {
+            key: 'onError',
+            label: 'On file error',
+            type: 'select',
+            options: [
+                { label: 'Stop the sync', value: 'abort' },
+                { label: 'Skip the file & continue', value: 'skip' },
+            ],
+            defaultValue: 'abort',
+            hint: 'A bad file (timeout, lock, permission) stops the whole sync, or is skipped.',
+        },
+    ],
+};
+for (const id of ['aws_s3', 'ftp_sftp', 'dropbox', 'onedrive', 'google_drive', 'gcs', 'azure_blob']) {
+    STORAGE_PROVIDERS[id].operations.push(syncOp);
+}
+/** Connector ids the unified storage action's connector picker offers.
+ *  Google Sheets shares Drive access (kept in STORAGE_PROVIDERS for browse
+ *  compat) but it's a spreadsheet/data connector — not a file store — so it's
+ *  excluded from the picker (a "Google Sheets" app under Storage confuses
+ *  users). Use the Google Drive connector for file operations. */
+export const STORAGE_CONNECTOR_IDS = Object.keys(STORAGE_PROVIDERS).filter((id) => id !== 'google_sheets');
+export function getStorageProvider(connectorId) {
+    if (!connectorId)
+        return undefined;
+    // Accept legacy hyphenated ids (e.g. 'aws-s3') as their canonical underscore
+    // form ('aws_s3') so connector instances created before the id was canonicalised
+    // still resolve to their provider spec.
+    return STORAGE_PROVIDERS[connectorId] ?? STORAGE_PROVIDERS[connectorId.replace(/-/g, '_')];
+}
+/** All config keys any operation might write — used to clear stale fields when the operation/provider changes. */
+export function storageConfigKeys() {
+    const keys = new Set([
+        'operation', 'connector', 'content', 'outputAs',
+        // cross-connector Transfer + folder Sync fields
+        'path', 'destPath', 'destConnector', 'sourceIsDirectory',
+        'cursor', 'fileBudget', 'timeBudgetMs',
+    ]);
+    for (const provider of Object.values(STORAGE_PROVIDERS)) {
+        for (const op of provider.operations) {
+            if (op.path)
+                keys.add(op.path.key);
+            if (op.dest)
+                keys.add(op.dest.key);
+            for (const f of op.fields ?? [])
+                keys.add(f.key);
+        }
+    }
+    return [...keys];
+}

package/dist/catalog/storage/xml-action/index.d.ts

@@ -0,0 +1,2 @@
+import { ActionDefinition } from '../../types';
+export declare const xmlActionDefinition: ActionDefinition;

package/dist/catalog/storage/xml-action/index.js

@@ -0,0 +1,31 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const xmlActionDefinition = {
+    id: 'xml_action',
+    name: 'XML',
+    description: 'Parse XML files into structured records or generate XML from workflow data',
+    category: ActionCategory.Storage,
+    type: ActionType.XmlAction,
+    tags: ['xml', 'parse', 'generate', 'file', 'format', 'built-in'],
+    status: ActionStatus.Beta,
+    icon: 'Code',
+    color: '#e65100',
+    inputSchema: {
+        fields: [
+            { key: 'operation', label: 'Operation', type: FieldType.Select, options: [{ label: 'Parse (XML → Records)', value: 'parse' }, { label: 'Generate (Records → XML)', value: 'generate' }], defaultValue: 'parse', validation: { required: true } },
+            { key: 'content', label: 'XML Content', type: FieldType.String, description: 'Paste XML or use FX token' },
+            { key: 'rootElement', label: 'Root Element', type: FieldType.String, description: 'Root XML element name (for generate)', defaultValue: 'data' },
+            { key: 'rowElement', label: 'Row Element', type: FieldType.String, description: 'Element name per record (for generate)', defaultValue: 'row' },
+            { key: 'fileName', label: 'Output File Name', type: FieldType.String, defaultValue: 'export.xml' },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'data', type: FieldType.Array, description: 'Parsed records (parse mode) — loop these with a ForEach. Generated XML string in generate mode.' },
+            { key: 'columns', type: FieldType.JSON, description: 'Field names' },
+            { key: 'rowCount', type: FieldType.Number, description: 'Number of records' },
+        ],
+        sampleOutput: { data: [{ id: 1, name: 'Widget' }], columns: ['id', 'name'], rowCount: 1 },
+    },
+    version: '1.0.0', createdAt: '2026-03-28T00:00:00Z', updatedAt: '2026-03-28T00:00:00Z', createdBy: 'system', isOfficial: true, testable: false,
+};

package/dist/catalog/transforms/format/config.d.ts

@@ -0,0 +1,23 @@
+export interface FormatConfigType {
+    input: string;
+    format: 'json' | 'csv' | 'xml' | 'yaml';
+}
+export declare const FormatConfig: {
+    defaults: FormatConfigType;
+    schema: {
+        input: {
+            type: string;
+            required: boolean;
+        };
+        format: {
+            type: string;
+            required: boolean;
+        };
+    };
+    validate: (config: Partial<FormatConfigType>) => {
+        valid: boolean;
+        errors: string[];
+    };
+    merge: (userConfig: Partial<FormatConfigType>) => FormatConfigType;
+    getLabel: (config: FormatConfigType) => string;
+};

package/dist/catalog/transforms/format/config.js

@@ -0,0 +1,19 @@
+export const FormatConfig = {
+    defaults: { input: '', format: 'json' },
+    schema: {
+        input: { type: 'expression', required: true },
+        format: { type: 'select', required: true },
+    },
+    validate: (config) => {
+        const errors = [];
+        if (!config.input)
+            errors.push('Input required');
+        if (!config.format)
+            errors.push('Format required');
+        return { valid: errors.length === 0, errors };
+    },
+    merge: (userConfig) => {
+        return { ...FormatConfig.defaults, ...userConfig };
+    },
+    getLabel: (config) => `Format as ${config.format.toUpperCase()}`,
+};

package/dist/catalog/transforms/format/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Format Transform Action
+ */
+import { ActionDefinition } from '../../types';
+export declare const formatDefinition: ActionDefinition;

package/dist/catalog/transforms/format/index.js

@@ -0,0 +1,39 @@
+/**
+ * Format Transform Action
+ */
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const formatDefinition = {
+    id: 'format',
+    name: 'Format',
+    description: 'Format data (JSON, CSV, XML, etc.)',
+    category: ActionCategory.Transform,
+    type: ActionType.Format,
+    tags: ['transform', 'format', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'TextFormatting',
+    color: '#24a148',
+    inputSchema: {
+        fields: [
+            { key: 'input', label: 'Input', type: FieldType.Expression, validation: { required: true } },
+            { key: 'format', label: 'Format', type: FieldType.Select, options: [
+                    { label: 'JSON', value: 'json' },
+                    { label: 'CSV', value: 'csv' },
+                    { label: 'XML', value: 'xml' },
+                    { label: 'YAML', value: 'yaml' },
+                ], validation: { required: true } },
+        ],
+    },
+    outputSchema: {
+        type: 'string',
+        properties: [
+            { key: 'result', type: FieldType.String, description: 'Formatted output' },
+        ],
+        sampleOutput: { result: '' },
+    },
+    version: '1.0.0',
+    createdAt: '2025-01-01T00:00:00Z',
+    updatedAt: '2025-12-15T00:00:00Z',
+    createdBy: 'system',
+    isOfficial: true,
+    testable: true,
+};

package/dist/catalog/triggers/connector-trigger/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Connector Trigger Action
+ *
+ * Trigger workflows via connector platform events (e.g. QuickBooks Online webhooks)
+ */
+import { ActionDefinition } from '../../types';
+export declare const connectorTriggerDefinition: ActionDefinition;

package/dist/catalog/triggers/connector-trigger/index.js

@@ -0,0 +1,72 @@
+/**
+ * Connector Trigger Action
+ *
+ * Trigger workflows via connector platform events (e.g. QuickBooks Online webhooks)
+ */
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const connectorTriggerDefinition = {
+    id: 'connector_trigger',
+    name: 'Connector Trigger',
+    description: 'Trigger workflow when a connector platform event occurs',
+    category: ActionCategory.Trigger,
+    type: ActionType.Event,
+    tags: ['trigger', 'connector', 'event', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'Connect',
+    color: '#6929c4',
+    inputSchema: {
+        fields: [
+            {
+                key: 'connectorInstanceId',
+                label: 'Connector Instance',
+                type: FieldType.String,
+                description: 'The connected app instance to listen to',
+                validation: { required: true },
+            },
+            {
+                key: 'events',
+                label: 'Events',
+                type: FieldType.JSON,
+                description: 'Entity/operation pairs to subscribe to',
+                validation: { required: true },
+            },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            {
+                key: 'eventType',
+                type: FieldType.String,
+                description: 'The type of event that occurred',
+            },
+            {
+                key: 'entity',
+                type: FieldType.String,
+                description: 'The entity that changed (e.g. Invoice)',
+            },
+            {
+                key: 'operation',
+                type: FieldType.String,
+                description: 'The operation performed (e.g. Create)',
+            },
+            {
+                key: 'payload',
+                type: FieldType.JSON,
+                description: 'The event payload from the connector',
+            },
+        ],
+        sampleOutput: {
+            eventType: 'connector.event',
+            entity: 'Invoice',
+            operation: 'Create',
+            payload: { id: '123', amount: 500 },
+        },
+    },
+    version: '1.0.0',
+    createdAt: '2025-01-01T00:00:00Z',
+    updatedAt: '2025-12-15T00:00:00Z',
+    createdBy: 'system',
+    isOfficial: true,
+    testable: false,
+};

package/dist/catalog/triggers/manual-trigger/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Manual Trigger Configuration
+ *
+ * Defines the configuration structure and default values for the Manual Trigger action
+ */
+export interface ManualTriggerConfigType {
+    description?: string;
+}
+export declare const ManualTriggerConfig: {
+    /**
+     * Default configuration for Manual Trigger
+     */
+    defaults: ManualTriggerConfigType;
+    /**
+     * Configuration schema for validation
+     */
+    schema: {
+        description: {
+            type: string;
+            maxLength: number;
+            required: boolean;
+            description: string;
+        };
+    };
+    /**
+     * Validate configuration
+     */
+    validate: (config: Partial<ManualTriggerConfigType>) => {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Merge user config with defaults
+     */
+    merge: (userConfig: Partial<ManualTriggerConfigType>) => ManualTriggerConfigType;
+    /**
+     * Get display label for configuration
+     */
+    getLabel: (config: ManualTriggerConfigType) => string;
+};

package/dist/catalog/triggers/manual-trigger/config.js

@@ -0,0 +1,60 @@
+/**
+ * Manual Trigger Configuration
+ *
+ * Defines the configuration structure and default values for the Manual Trigger action
+ */
+export const ManualTriggerConfig = {
+    /**
+     * Default configuration for Manual Trigger
+     */
+    defaults: {
+        description: '',
+    },
+    /**
+     * Configuration schema for validation
+     */
+    schema: {
+        description: {
+            type: 'string',
+            maxLength: 500,
+            required: false,
+            description: 'Optional description for this trigger (shown on node)',
+        },
+    },
+    /**
+     * Validate configuration
+     */
+    validate: (config) => {
+        const errors = [];
+        if (config.description !== undefined) {
+            if (typeof config.description !== 'string') {
+                errors.push('Description must be a string');
+            }
+            if (config.description.length > 500) {
+                errors.push('Description must not exceed 500 characters');
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    },
+    /**
+     * Merge user config with defaults
+     */
+    merge: (userConfig) => {
+        return {
+            ...ManualTriggerConfig.defaults,
+            ...userConfig,
+        };
+    },
+    /**
+     * Get display label for configuration
+     */
+    getLabel: (config) => {
+        if (config.description) {
+            return `Manual Trigger: ${config.description}`;
+        }
+        return 'Manual Trigger';
+    },
+};

package/dist/catalog/triggers/manual-trigger/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Manual Trigger Action
+ *
+ * A built-in trigger action that allows manual workflow execution with optional configuration
+ */
+import { ActionDefinition } from '../../types';
+import { ManualTriggerConfig } from './config';
+export declare const manualTriggerDefinition: ActionDefinition;
+export { ManualTriggerConfig };
+export type { ManualTriggerConfigType } from './config';

package/dist/catalog/triggers/manual-trigger/index.js

@@ -0,0 +1,74 @@
+/**
+ * Manual Trigger Action
+ *
+ * A built-in trigger action that allows manual workflow execution with optional configuration
+ */
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+import { randomSuffix } from '../../../ids';
+import { ManualTriggerConfig } from './config';
+export const manualTriggerDefinition = {
+    id: 'manual_trigger',
+    name: 'Manual Trigger',
+    description: 'Manually trigger workflow with optional description',
+    category: ActionCategory.Trigger,
+    type: ActionType.Manual,
+    tags: ['trigger', 'manual', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'PlayOutline',
+    color: '#0f62fe',
+    inputSchema: {
+        fields: [
+            {
+                key: 'description',
+                label: 'Description',
+                type: FieldType.String,
+                description: 'Optional description for this trigger (shown on node)',
+                placeholder: 'e.g., Manual data sync, Testing workflow, etc.',
+                validation: {
+                    required: false,
+                    maxLength: 500,
+                },
+            },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            {
+                key: 'triggeredAt',
+                type: FieldType.DateTime,
+                description: 'Timestamp when workflow was triggered',
+            },
+            // `triggeredBy` was declared here but never produced, so the picker
+            // offered a token that always resolved to nothing. The Engine DOES have
+            // it — `metadata.triggeredBy` / `.triggeredByEmail` exist on the run —
+            // but they are not threaded into `executeStep`, which is where the
+            // trigger envelope is built. Removed rather than left as a dead token;
+            // re-add it together with that threading.
+            {
+                key: 'executionId',
+                type: FieldType.String,
+                description: 'Unique execution ID for this workflow run',
+            },
+            {
+                key: 'description',
+                type: FieldType.String,
+                description: 'The description provided by the user (if any)',
+            },
+        ],
+        sampleOutput: {
+            triggeredAt: new Date().toISOString(),
+            executionId: `exec_${Date.now()}_${randomSuffix(9)}`,
+            description: 'Manual data sync',
+        },
+    },
+    version: '1.0.0',
+    createdAt: '2025-01-01T00:00:00Z',
+    updatedAt: '2025-12-15T00:00:00Z',
+    createdBy: 'system',
+    isOfficial: true,
+    testable: true,
+};
+// The config PANEL stays in octaviaflow-ui: this package is data and rules,
+// and a React component here would make it unusable from Backend.
+export { ManualTriggerConfig };

package/dist/catalog/triggers/schedule-trigger/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Schedule Trigger Configuration
+ */
+export interface ScheduleTriggerConfigType {
+    scheduleType: 'interval' | 'cron' | 'specific';
+    interval?: number;
+    intervalUnit?: 'minutes' | 'hours' | 'days' | 'weeks';
+    cronExpression?: string;
+    timezone?: string;
+}
+export declare const ScheduleTriggerConfig: {
+    defaults: ScheduleTriggerConfigType;
+    schema: {
+        scheduleType: {
+            type: string;
+            required: boolean;
+        };
+        interval: {
+            type: string;
+            required: boolean;
+            min: number;
+        };
+        intervalUnit: {
+            type: string;
+            required: boolean;
+        };
+        cronExpression: {
+            type: string;
+            required: boolean;
+        };
+        timezone: {
+            type: string;
+            required: boolean;
+        };
+    };
+    validate: (config: Partial<ScheduleTriggerConfigType>) => {
+        valid: boolean;
+        errors: string[];
+    };
+    merge: (userConfig: Partial<ScheduleTriggerConfigType>) => ScheduleTriggerConfigType;
+    getLabel: (config: ScheduleTriggerConfigType) => string;
+};