@octaviaflow/flow-rules 0.1.0 → 0.2.0

package/dist/catalog/communication/email-send/index.js

@@ -1,152 +0,0 @@
-/**
- * Email Action
- *
- * Sends an email through a connected email service. Send is the only
- * operation the Engine implements; the Read / Search / Delete / Move /
- * Mark-as-read options were withdrawn from the catalogue until they run
- * (DEV-349) — a step saved with one of them fails validation instead of
- * silently succeeding.
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const emailDefinition = {
-    id: 'email',
-    name: 'Email',
-    description: 'Send an email through any connected email service provider',
-    category: ActionCategory.Communication,
-    type: ActionType.EmailSend,
-    tags: ['communication', 'email', 'smtp', 'sendgrid', 'ses', 'imap', 'pop3', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Email',
-    color: '#0043ce',
-    inputSchema: {
-        fields: [
-            {
-                key: 'connection',
-                label: 'Email Service',
-                type: FieldType.Connection,
-                description: 'Email service connection (SMTP, IMAP, SendGrid, AWS SES, etc.)',
-                validation: { required: true },
-            },
-            {
-                key: 'operation',
-                label: 'Operation',
-                type: FieldType.Select,
-                description: 'Email operation — Send is the only operation available today',
-                options: [
-                    { label: 'Send', value: 'send' },
-                ],
-                defaultValue: 'send',
-                validation: { required: true },
-            },
-            {
-                key: 'to',
-                label: 'To',
-                type: FieldType.String,
-                description: 'Recipient email address(es), comma-separated (for send operation)',
-                validation: { required: false },
-            },
-            {
-                key: 'cc',
-                label: 'CC',
-                type: FieldType.String,
-                description: 'CC email address(es), comma-separated (for send operation)',
-                validation: { required: false },
-            },
-            {
-                key: 'bcc',
-                label: 'BCC',
-                type: FieldType.String,
-                description: 'BCC email address(es), comma-separated (for send operation)',
-                validation: { required: false },
-            },
-            {
-                key: 'subject',
-                label: 'Subject',
-                type: FieldType.String,
-                description: 'Email subject (for send operation)',
-                validation: { required: false },
-            },
-            {
-                key: 'body',
-                label: 'Body',
-                type: FieldType.String,
-                description: 'Email body content (for send operation)',
-                validation: { required: false },
-            },
-            {
-                key: 'isHtml',
-                label: 'Is HTML',
-                type: FieldType.Boolean,
-                description: 'Whether body is HTML content',
-                defaultValue: false,
-                validation: { required: false },
-            },
-            {
-                key: 'attachments',
-                label: 'Attachments',
-                type: FieldType.Array,
-                description: 'File attachments (URLs or file paths)',
-                validation: { required: false },
-            },
-            {
-                key: 'folder',
-                label: 'Folder',
-                type: FieldType.String,
-                description: 'Email folder (Inbox, Sent, Drafts, etc.)',
-                validation: { required: false },
-            },
-            {
-                key: 'query',
-                label: 'Search Query',
-                type: FieldType.String,
-                description: 'Search criteria (for search/read operations)',
-                validation: { required: false },
-            },
-            {
-                key: 'limit',
-                label: 'Limit',
-                type: FieldType.Number,
-                description: 'Maximum number of emails to retrieve',
-                defaultValue: 10,
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'success',
-                type: FieldType.Boolean,
-                description: 'Whether operation was successful',
-            },
-            {
-                key: 'data',
-                type: FieldType.JSON,
-                description: 'Operation result data (emails, message ID, etc.)',
-            },
-            {
-                key: 'count',
-                type: FieldType.Number,
-                description: 'Number of emails affected/returned',
-            },
-            {
-                key: 'messageId',
-                type: FieldType.String,
-                description: 'Email message ID (for send operation)',
-            },
-        ],
-        sampleOutput: {
-            success: true,
-            data: [{ id: 'email_123', from: 'sender@example.com', subject: 'Test' }],
-            count: 1,
-            messageId: 'msg_123456',
-        },
-    },
-    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/communication/google-chat/config.js

@@ -1,28 +0,0 @@
-/**
- * Google Chat Configuration
- */
-export const GoogleChatConfig = {
-    defaults: { connection: '', space: '', spaceName: '', text: '', threadKey: '' },
-    schema: {
-        connection: { type: 'connection', required: true },
-        space: { type: 'string', required: true },
-        text: { type: 'string', required: false },
-        threadKey: { type: 'string', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.connection)
-            errors.push('Connect a Google Chat account');
-        if (!config.space)
-            errors.push('Pick a space');
-        // Text-only over OAuth (cards require app auth — see GoogleChatConfigPanel note).
-        if (!config.text && !config.message)
-            errors.push('Add a message');
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => ({
-        ...GoogleChatConfig.defaults,
-        ...userConfig,
-    }),
-    getLabel: () => 'Google Chat',
-};

package/dist/catalog/communication/google-chat/index.js

@@ -1,36 +0,0 @@
-/**
- * Google Chat Action
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const googleChatDefinition = {
-    id: 'google_chat',
-    name: 'Google Chat',
-    description: 'Post a message to a Google Chat space (OAuth 2.0 — pick any space you belong to)',
-    category: ActionCategory.Communication,
-    type: ActionType.GoogleChat,
-    tags: ['communication', 'google', 'chat', 'webhook', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'brand:google_chat',
-    color: '#00AC47',
-    inputSchema: {
-        fields: [
-            { key: 'connection', label: 'Google Chat Space', type: FieldType.Connection, validation: { required: true } },
-            { key: 'text', label: 'Message', type: FieldType.String, validation: { required: true } },
-            { key: 'threadKey', label: 'Thread Key', type: FieldType.String, validation: { required: false } },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'ok', type: FieldType.Boolean, description: 'Whether the message was sent' },
-            { key: 'name', type: FieldType.String, description: 'Created message resource name' },
-        ],
-        sampleOutput: { ok: true, name: 'spaces/AAAA/messages/BBBB' },
-    },
-    version: '1.0.0',
-    createdAt: '2026-06-18T00:00:00Z',
-    updatedAt: '2026-06-18T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: true,
-};

package/dist/catalog/communication/slack-message/config.js

@@ -1,36 +0,0 @@
-/**
- * Slack Message Configuration
- */
-export const SlackMessageConfig = {
-    defaults: { connection: '', messageType: 'channel', channel: '', channelName: '', text: '', blocks: undefined },
-    schema: {
-        connection: { type: 'connection', required: true },
-        messageType: { type: 'string', required: false },
-        channel: { type: 'string', required: true },
-        text: { type: 'string', required: false },
-        blocks: { type: 'json', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.connection)
-            errors.push('Slack workspace connection is required');
-        if (!config.channel)
-            errors.push(config.messageType === 'user' ? 'A user is required' : 'A channel is required');
-        const hasText = Boolean(config.text || config.message);
-        const hasBlocks = Array.isArray(config.blocks) && config.blocks.length > 0;
-        if (!hasText && !hasBlocks)
-            errors.push('Add a message or at least one block');
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...SlackMessageConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        const prefix = config.messageType === 'user' ? '@' : '#';
-        return config.channelName
-            ? `Slack: ${prefix}${config.channelName}`
-            : config.channel
-                ? `Slack: ${config.channel}`
-                : 'Slack';
-    },
-};

package/dist/catalog/communication/slack-message/index.js

@@ -1,37 +0,0 @@
-/**
- * Slack Message Action
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const slackMessageDefinition = {
-    id: 'slack_message',
-    name: 'Slack',
-    description: 'Send messages to Slack channels or users',
-    category: ActionCategory.Communication,
-    type: ActionType.SlackMessage,
-    tags: ['communication', 'slack', 'chat', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'brand:slack',
-    color: '#4A154B',
-    inputSchema: {
-        fields: [
-            { key: 'connection', label: 'Slack Workspace', type: FieldType.Connection, validation: { required: true } },
-            { key: 'channel', label: 'Channel/User', type: FieldType.String, validation: { required: true } },
-            { key: 'message', label: 'Message', type: FieldType.String, validation: { required: true } },
-            { key: 'blocks', label: 'Blocks (JSON)', type: FieldType.JSON, validation: { required: false } },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'success', type: FieldType.Boolean, description: 'Whether message was sent' },
-            { key: 'timestamp', type: FieldType.String, description: 'Message timestamp' },
-        ],
-        sampleOutput: { success: true, timestamp: '1234567890.123456' },
-    },
-    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/communication/teams-message/config.js

@@ -1,29 +0,0 @@
-/**
- * Teams Message Configuration
- */
-export const TeamsMessageConfig = {
-    defaults: { connection: '', teamId: '', teamName: '', channelId: '', channelName: '', title: '', message: '' },
-    schema: {
-        connection: { type: 'connection', required: true },
-        teamId: { type: 'string', required: true },
-        channelId: { type: 'string', required: true },
-        title: { type: 'string', required: false },
-        message: { type: 'string', required: true },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.connection)
-            errors.push('Connect a Microsoft Teams account');
-        if (!config.teamId)
-            errors.push('Pick a team');
-        if (!config.channelId)
-            errors.push('Pick a channel');
-        if (!config.message)
-            errors.push('Add a message');
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...TeamsMessageConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => (config.channelName ? `Teams: #${config.channelName}` : 'Teams'),
-};

package/dist/catalog/communication/teams-message/index.js

@@ -1,39 +0,0 @@
-/**
- * Teams Message Action
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const teamsMessageDefinition = {
-    id: 'teams_message',
-    name: 'Teams',
-    description: 'Post messages to Microsoft Teams channels via OAuth 2.0',
-    category: ActionCategory.Communication,
-    type: ActionType.TeamsMessage,
-    tags: ['communication', 'teams', 'microsoft', 'chat', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'brand:teams',
-    color: '#4B53BC',
-    inputSchema: {
-        fields: [
-            { key: 'connection', label: 'Teams Account', type: FieldType.Connection, validation: { required: true } },
-            { key: 'teamId', label: 'Team', type: FieldType.String, validation: { required: true } },
-            { key: 'channelId', label: 'Channel', type: FieldType.String, validation: { required: true } },
-            { key: 'title', label: 'Subject', type: FieldType.String, validation: { required: false } },
-            { key: 'message', label: 'Message', type: FieldType.String, validation: { required: true } },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'ok', type: FieldType.Boolean, description: 'Whether the message was sent' },
-            { key: 'id', type: FieldType.String, description: 'Sent message id' },
-            { key: 'webUrl', type: FieldType.String, description: 'Deep link to the message' },
-        ],
-        sampleOutput: { ok: true, id: '1700000000000', webUrl: 'https://teams.microsoft.com/l/message/...' },
-    },
-    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/communication/webhook-call/config.js

@@ -1,31 +0,0 @@
-/**
- * Webhook Call Configuration
- */
-export const WebhookCallConfig = {
-    defaults: {
-        url: '',
-        method: 'POST',
-        payload: {},
-        headers: {},
-    },
-    schema: {
-        url: { type: 'url', required: true },
-        method: { type: 'select', required: true },
-        payload: { type: 'json', required: false },
-        headers: { type: 'json', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.url)
-            errors.push('Webhook URL is required');
-        if (!config.method)
-            errors.push('HTTP method is required');
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...WebhookCallConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        return `${config.method}: ${config.url.substring(0, 40)}...`;
-    },
-};

package/dist/catalog/communication/webhook-call/index.js

@@ -1,43 +0,0 @@
-/**
- * Webhook Call Action
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const webhookCallDefinition = {
-    id: 'webhook_call',
-    name: 'Webhook Call',
-    description: 'Call external webhooks with custom payloads',
-    category: ActionCategory.Communication,
-    type: ActionType.WebhookCall,
-    tags: ['communication', 'webhook', 'http', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Webhook',
-    color: '#0043ce',
-    inputSchema: {
-        fields: [
-            { key: 'url', label: 'Webhook URL', type: FieldType.URL, validation: { required: true } },
-            { key: 'method', label: 'Method', type: FieldType.Select, options: [
-                    { label: 'POST', value: 'POST' },
-                    { label: 'PUT', value: 'PUT' },
-                    { label: 'PATCH', value: 'PATCH' },
-                    { label: 'GET', value: 'GET' },
-                ], defaultValue: 'POST', validation: { required: true } },
-            { key: 'payload', label: 'Payload', type: FieldType.JSON, validation: { required: false } },
-            { key: 'headers', label: 'Headers', type: FieldType.JSON, validation: { required: false } },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'statusCode', type: FieldType.Number, description: 'HTTP status code' },
-            { key: 'response', type: FieldType.JSON, description: 'Response body' },
-            { key: 'success', type: FieldType.Boolean, description: 'Whether call succeeded' },
-        ],
-        sampleOutput: { statusCode: 200, response: {}, success: true },
-    },
-    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/communication/whatsapp-send/config.js

@@ -1,36 +0,0 @@
-/**
- * WhatsApp Send — config contract (DEV-285)
- */
-export const WhatsappSendConfig = {
-    // Template is the default because it is the mode that always delivers;
-    // freeform silently depends on a 24-hour window the author can't see.
-    defaults: {
-        connection: '',
-        to: '',
-        mode: 'template',
-        templateLanguage: 'en_US',
-        templateVariables: [],
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.connection)
-            errors.push('Select a WhatsApp connection');
-        if (!config.to?.trim())
-            errors.push('Recipient phone number is required');
-        if (config.mode === 'text') {
-            if (!config.text?.trim())
-                errors.push('Message text is required');
-        }
-        else {
-            if (!config.templateName?.trim())
-                errors.push('Choose an approved template');
-        }
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...WhatsappSendConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => config.mode === 'text'
-        ? `WhatsApp to ${config.to || '—'}`
-        : `WhatsApp template "${config.templateName || '—'}" to ${config.to || '—'}`,
-};

package/dist/catalog/communication/whatsapp-send/index.js

@@ -1,57 +0,0 @@
-/**
- * WhatsApp Send Action (DEV-285)
- *
- * Two modes, because WhatsApp has two genuinely different sends:
- *   template — the ONLY thing that delivers outside the 24-hour
- *              customer-service window. Meta charges by the template's
- *              CATEGORY (Marketing costs ~6× Utility), so the picker shows it.
- *   text     — freeform; delivers only within 24 hours of the contact's last
- *              inbound message.
- *
- * A single "message" box would look like it works in testing and then fail
- * the next day — which is why mode is an explicit, required choice.
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const whatsappSendDefinition = {
-    id: 'whatsapp_send',
-    name: 'WhatsApp',
-    description: 'Send a WhatsApp message — an approved template, or freeform text inside the 24-hour reply window',
-    category: ActionCategory.Communication,
-    type: ActionType.WhatsappSend,
-    tags: ['communication', 'whatsapp', 'messaging', 'template', 'built-in'],
-    status: ActionStatus.Beta,
-    icon: 'brand:whatsapp',
-    color: '#25D366',
-    inputSchema: {
-        fields: [
-            { key: 'connection', label: 'WhatsApp Connection', type: FieldType.Connection, validation: { required: true } },
-            { key: 'to', label: 'To (phone number)', type: FieldType.String, validation: { required: true } },
-            { key: 'mode', label: 'Message Type', type: FieldType.Select, validation: { required: true } },
-            { key: 'templateName', label: 'Template', type: FieldType.String, validation: { required: false } },
-            { key: 'templateLanguage', label: 'Template Language', type: FieldType.String, validation: { required: false } },
-            { key: 'templateVariables', label: 'Template Variables', type: FieldType.JSON, validation: { required: false } },
-            { key: 'text', label: 'Message', type: FieldType.String, validation: { required: false } },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'ok', type: FieldType.Boolean, description: 'Whether WhatsApp accepted the message' },
-            { key: 'messageId', type: FieldType.String, description: 'WhatsApp message ID (wamid…)' },
-            { key: 'waId', type: FieldType.String, description: "Recipient's resolved WhatsApp ID" },
-            { key: 'mode', type: FieldType.String, description: 'template | text' },
-        ],
-        sampleOutput: {
-            ok: true,
-            messageId: 'wamid.HBgMOTE4ODAyODg1MTQ1FQIAERgSN0YxN0E5RkQ5MEQ4RkE5QzFEAA==',
-            waId: '919876543210',
-            mode: 'template',
-        },
-    },
-    version: '1.0.0',
-    createdAt: '2026-07-30T00:00:00Z',
-    updatedAt: '2026-07-30T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: true,
-};