@octaviaflow/flow-rules 0.1.0 → 0.2.0

package/dist/catalog/actions/http-request/index.js

@@ -1,223 +0,0 @@
-/**
- * HTTP Request Action
- *
- * Make HTTP requests to external APIs and services
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const httpRequestDefinition = {
-    id: 'http_request',
-    name: 'HTTP Request',
-    description: 'Make HTTP requests to external APIs and services',
-    category: ActionCategory.API,
-    type: ActionType.HTTPRequest,
-    tags: ['api', 'http', 'request', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'CloudUpload',
-    color: '#0043ce',
-    inputSchema: {
-        fields: [
-            {
-                key: 'apiType',
-                label: 'API Type',
-                type: FieldType.Select,
-                description: 'Type of API request to make',
-                defaultValue: 'rest',
-                options: [
-                    { label: 'REST', value: 'rest' },
-                    { label: 'GraphQL', value: 'graphql' },
-                ],
-                validation: { required: true },
-            },
-            {
-                key: 'method',
-                label: 'Method',
-                type: FieldType.Select,
-                description: 'HTTP method to use (REST only)',
-                defaultValue: 'GET',
-                options: [
-                    { label: 'GET', value: 'GET' },
-                    { label: 'POST', value: 'POST' },
-                    { label: 'PUT', value: 'PUT' },
-                    { label: 'PATCH', value: 'PATCH' },
-                    { label: 'DELETE', value: 'DELETE' },
-                    { label: 'HEAD', value: 'HEAD' },
-                    { label: 'OPTIONS', value: 'OPTIONS' },
-                ],
-                validation: { required: false },
-            },
-            {
-                key: 'url',
-                label: 'URL',
-                type: FieldType.URL,
-                description: 'The URL to send the request to. Supports {{variable}} interpolation.',
-                placeholder: 'https://api.example.com/endpoint',
-                validation: { required: true },
-            },
-            {
-                key: 'headers',
-                label: 'Headers',
-                type: FieldType.JSON,
-                description: 'HTTP headers (JSON object or key-value array). Supports {{variable}} interpolation.',
-                defaultValue: {},
-                validation: { required: false },
-            },
-            {
-                key: 'body',
-                label: 'Request Body',
-                type: FieldType.JSON,
-                description: 'Request body for POST/PUT/PATCH. Supports {{variable}} interpolation.',
-                validation: { required: false },
-            },
-            {
-                key: 'graphqlQuery',
-                label: 'GraphQL Query',
-                type: FieldType.String,
-                description: 'GraphQL query or mutation string (GraphQL only)',
-                validation: { required: false },
-            },
-            {
-                key: 'graphqlVariables',
-                label: 'GraphQL Variables',
-                type: FieldType.JSON,
-                description: 'GraphQL variables object. Supports {{variable}} interpolation.',
-                defaultValue: {},
-                validation: { required: false },
-            },
-            {
-                key: 'auth',
-                label: 'Authentication',
-                type: FieldType.JSON,
-                description: 'Authentication config: { type: "none"|"basic"|"bearer"|"apikey", token?, username?, password?, apiKeyName?, apiKeyValue?, apiKeyLocation? }',
-                defaultValue: { type: 'none' },
-                validation: { required: false },
-            },
-            {
-                key: 'timeout',
-                label: 'Timeout (ms)',
-                type: FieldType.Number,
-                description: 'Request timeout in milliseconds',
-                defaultValue: 30000,
-                validation: { required: false, min: 1000 },
-            },
-            {
-                key: 'failOnError',
-                label: 'Fail on non-2xx',
-                type: FieldType.Boolean,
-                description: 'If true, step fails when response status is not 2xx. Default: true.',
-                defaultValue: true,
-                validation: { required: false },
-            },
-            {
-                key: 'responseType',
-                label: 'Response Type',
-                type: FieldType.Select,
-                description: 'How to parse the response body. JSON tries to parse as JSON; Text returns raw text; Binary returns Uint8Array bytes plus fileName/contentType/size.',
-                defaultValue: 'json',
-                options: [
-                    { label: 'JSON', value: 'json' },
-                    { label: 'Text', value: 'text' },
-                    { label: 'Binary', value: 'binary' },
-                ],
-                validation: { required: false },
-            },
-            {
-                key: 'expectedContentTypes',
-                label: 'Expected Content-Types',
-                type: FieldType.JSON,
-                description: 'Optional array of content-type prefixes (e.g. ["application/pdf"]). Logs a warning if the response content-type does not start with any of these.',
-                defaultValue: [],
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'status',
-                type: FieldType.Number,
-                description: 'HTTP status code',
-            },
-            {
-                key: 'statusText',
-                type: FieldType.String,
-                description: 'HTTP status text',
-            },
-            {
-                key: 'ok',
-                type: FieldType.Boolean,
-                description: 'True if status is 2xx',
-            },
-            {
-                key: 'headers',
-                type: FieldType.Object,
-                description: 'Response headers',
-            },
-            {
-                key: 'body',
-                type: FieldType.JSON,
-                description: 'Response body (parsed JSON or raw string)',
-            },
-            {
-                key: 'duration',
-                type: FieldType.Number,
-                description: 'Request duration in milliseconds',
-            },
-            {
-                key: 'graphqlErrors',
-                type: FieldType.JSON,
-                description: 'GraphQL errors array (GraphQL only, present when errors returned)',
-            },
-            {
-                key: 'pages',
-                type: FieldType.Number,
-                description: 'Number of pages fetched (pagination only)',
-            },
-            {
-                key: 'attempts',
-                type: FieldType.Number,
-                description: 'Total fetch attempts made (includes retries)',
-            },
-            {
-                key: 'extracted',
-                type: FieldType.Object,
-                description: 'Named fields extracted from response body via dot-notation paths',
-            },
-            {
-                key: 'fileName',
-                type: FieldType.String,
-                description: 'Derived file name (only present when Response Type is Binary). Sourced from Content-Disposition header or URL pathname.',
-            },
-            {
-                key: 'contentType',
-                type: FieldType.String,
-                description: 'Response content-type (only present when Response Type is Binary). Defaults to application/octet-stream when missing.',
-            },
-            {
-                key: 'size',
-                type: FieldType.Number,
-                description: 'Response body size in bytes (only present when Response Type is Binary).',
-            },
-        ],
-        sampleOutput: {
-            status: 200,
-            statusText: 'OK',
-            ok: true,
-            headers: { 'content-type': 'application/json' },
-            body: { success: true, data: {} },
-            duration: 245,
-            attempts: 1,
-            extracted: {},
-        },
-    },
-    execution: {
-        timeout: 30000,
-        retryable: 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/ai/ai-agent/index.js

@@ -1,72 +0,0 @@
-/**
- * AI Agent Workflow Action — definition (DEV-92, epic DEV-85).
- *
- * Picks a saved Agent (chat or etl) and runs it as a workflow step.
- * Config: { agentId, input?, overrides? }.
- *
- * The actual configuration UI lives in `components/AIAgentActionPanel.tsx`.
- *
- * See:
- */
-import { ActionCategory, ActionStatus, ActionType, FieldType, } from '../../types';
-export const aiAgentDefinition = {
-    id: 'ai_agent',
-    name: 'AI Agent',
-    description: 'Run a reusable AI agent. Pick a saved agent from /ai/agents; optionally override model, temperature, or instructions per step.',
-    category: ActionCategory.AI,
-    type: ActionType.AIAgent,
-    tags: ['ai', 'agent', 'chat', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'Bot',
-    color: '#7c3aed',
-    // The configuration UI is a custom panel (see components/AIAgentActionPanel.tsx).
-    // Fields below are the storage shape — the panel reads/writes them via
-    // setConfig but does NOT auto-render from this schema. This list keeps
-    // the action introspectable for downstream tooling (workflow validators,
-    // versioning) without duplicating the panel.
-    inputSchema: {
-        fields: [
-            {
-                key: 'agentId',
-                label: 'Agent',
-                type: FieldType.String,
-                description: 'Saved Agent public id (e.g. agt_xxx).',
-                validation: { required: true },
-            },
-            {
-                key: 'input',
-                label: 'Input',
-                type: FieldType.String,
-                description: 'Chat agents: a string (template-supported via {{step.field}}). ETL agents: rows array. When blank, falls back to upstream step output.',
-            },
-            {
-                key: 'overrides',
-                label: 'Overrides',
-                type: FieldType.JSON,
-                description: 'Optional per-step overrides of the agent\u2019s own settings: model, temperature, maxTokens, topP, instructions and instructionsMode.',
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'text', type: FieldType.String, description: 'Agent response text (chat agents)' },
-            { key: 'rows', type: FieldType.JSON, description: 'Output rows (etl agents)' },
-            { key: 'usage', type: FieldType.JSON, description: 'Token usage + cost: tokensIn, tokensOut, latencyMs, costUsd' },
-            { key: 'model', type: FieldType.String, description: 'Model that produced the response' },
-            { key: 'agentVersion', type: FieldType.Number, description: 'Version of the agent definition that ran' },
-        ],
-        sampleOutput: {
-            text: 'Sure — happy to help. What would you like to know?',
-            usage: { tokensIn: 42, tokensOut: 18, latencyMs: 612, costUsd: 0.000041 },
-            model: 'gpt-4o-mini',
-            agentVersion: 3,
-        },
-    },
-    version: '1.0.0',
-    createdAt: '2026-05-27T00:00:00Z',
-    updatedAt: '2026-05-27T00:00:00Z',
-    createdBy: 'system',
-    isOfficial: true,
-    testable: true,
-};

package/dist/catalog/ai/idp-extract/index.js

@@ -1,90 +0,0 @@
-/**
- * IDP — Extract action.
- *
- * Workflow primitive that runs Intelligent Document Processing on files
- * received from an upstream step (HTTP download, FTP get, query result,
- * data stream from any connector that produces files).
- *
- * Engine resolves the configured LLM connector at execution time —
- * same pattern as `_resolvedConnection` for HTTP steps — and calls
- * the document-extraction service once per file. Results emit as one
- * row per source file: { fileName, data, confidence, audit, error? }.
- *
- * The action does NOT take file uploads of its own. Wire an upstream
- * step that emits files with `{ fileName, body | s3Key, contentType }`
- * (HTTP binary response, FTP/Storage download, etc.) into this step.
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const idpExtractDefinition = {
-    id: 'idp_extract',
-    name: 'IDP',
-    description: 'Extract structured data from documents received from an upstream step. Configure the model provider, model, and the JSON Schema to extract.',
-    category: ActionCategory.AI,
-    type: ActionType.IdpExtract,
-    tags: ['ai', 'idp', 'document', 'extract', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'DocumentImport',
-    color: '#0F62FE',
-    inputSchema: {
-        fields: [
-            {
-                key: 'llmConnectorId',
-                label: 'Model provider (connector)',
-                type: FieldType.Select,
-                description: 'Connected AI provider (OpenAI, Anthropic, Gemini, …). Resolved at execution time.',
-                validation: { required: true },
-            },
-            {
-                key: 'model',
-                label: 'Model',
-                type: FieldType.Select,
-                description: 'LLM available on the selected provider (e.g. gpt-4o, claude-3.5-sonnet, gemini-2.0-flash). Vision-capable models recommended.',
-                validation: { required: true },
-            },
-            {
-                key: 'expectedSchema',
-                label: 'Output schema',
-                type: FieldType.JSON,
-                description: 'JSON Schema describing the fields to extract. The LLM is forced to emit JSON matching this shape.',
-                // NOT required (DEV-220 rules parity, PO decision 2026-07-16): the
-                // schema is either LLM-generated at run time or user-supplied — an
-                // empty value is a valid "let the LLM infer it" configuration, so
-                // the rules engine must not flag it.
-                validation: { required: false },
-            },
-            {
-                key: 'systemPromptOverride',
-                label: 'System prompt override',
-                type: FieldType.String,
-                description: 'Optional extra instructions appended to the extraction prompt.',
-            },
-            {
-                key: 'strategy',
-                label: 'Strategy',
-                type: FieldType.Select,
-                description: 'vision-direct sends the file as an image to a vision LLM. auto picks based on PDF text content.',
-                defaultValue: 'vision-direct',
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            { key: 'state', type: FieldType.String, description: 'Aggregate state — completed | partial-success | failed.' },
-            {
-                key: 'pages',
-                type: FieldType.Array,
-                description: 'One row per file received from upstream: { fileName, data, confidence, audit, error? }',
-            },
-            {
-                key: 'totals',
-                type: FieldType.Object,
-                description: 'Summary { pages, completed, failed }',
-            },
-        ],
-    },
-    version: '2.0.0',
-    createdAt: '2026-05-06T00:00:00Z',
-    updatedAt: '2026-05-10T00:00:00Z',
-    createdBy: 'system',
-};

package/dist/catalog/api/graphql-query/config.js

@@ -1,31 +0,0 @@
-/**
- * GraphQL Query Configuration
- */
-export const GraphQLQueryConfig = {
-    defaults: {
-        endpoint: '',
-        query: '',
-        variables: {},
-        headers: {},
-    },
-    schema: {
-        endpoint: { type: 'url', required: true },
-        query: { type: 'code', required: true },
-        variables: { type: 'json', required: false },
-        headers: { type: 'json', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.endpoint)
-            errors.push('Endpoint is required');
-        if (!config.query)
-            errors.push('Query is required');
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...GraphQLQueryConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        return `GraphQL: ${config.endpoint}`;
-    },
-};

package/dist/catalog/api/graphql-query/index.js

@@ -1,75 +0,0 @@
-/**
- * GraphQL Query Action
- *
- * Execute GraphQL queries against GraphQL endpoints
- */
-import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
-export const graphqlQueryDefinition = {
-    id: 'graphql_query',
-    name: 'GraphQL Query',
-    description: 'Execute GraphQL queries against GraphQL endpoints',
-    category: ActionCategory.API,
-    type: ActionType.GraphQLQuery,
-    tags: ['api', 'graphql', 'query', 'built-in'],
-    status: ActionStatus.Stable,
-    icon: 'GraphQL',
-    color: '#0043ce',
-    inputSchema: {
-        fields: [
-            {
-                key: 'endpoint',
-                label: 'GraphQL Endpoint',
-                type: FieldType.URL,
-                description: 'GraphQL endpoint URL',
-                validation: { required: true },
-            },
-            {
-                key: 'query',
-                label: 'Query',
-                type: FieldType.Code,
-                description: 'GraphQL query',
-                language: 'json',
-                validation: { required: true },
-            },
-            {
-                key: 'variables',
-                label: 'Variables',
-                type: FieldType.JSON,
-                description: 'Query variables',
-                validation: { required: false },
-            },
-            {
-                key: 'headers',
-                label: 'Headers',
-                type: FieldType.JSON,
-                description: 'HTTP headers',
-                validation: { required: false },
-            },
-        ],
-    },
-    outputSchema: {
-        type: 'object',
-        properties: [
-            {
-                key: 'data',
-                type: FieldType.JSON,
-                description: 'Query result data',
-            },
-            {
-                key: 'errors',
-                type: FieldType.Array,
-                description: 'GraphQL errors',
-            },
-        ],
-        sampleOutput: {
-            data: { user: { id: '1', name: 'John' } },
-            errors: [],
-        },
-    },
-    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/email-send/config.js

@@ -1,80 +0,0 @@
-/**
- * Email Configuration
- *
- * Only `send` runs today. The other operation values stay in the type so a
- * step saved before DEV-349 still parses — but `validate` rejects them, so the
- * editor shows an error instead of the Engine skipping the step silently.
- */
-export const EmailConfig = {
-    defaults: {
-        connection: '',
-        operation: 'send',
-        to: '',
-        cc: '',
-        bcc: '',
-        subject: '',
-        body: '',
-        isHtml: false,
-        attachments: [],
-        folder: 'Inbox',
-        query: '',
-        limit: 10,
-    },
-    schema: {
-        connection: { type: 'connection', required: true },
-        operation: { type: 'select', required: true },
-        to: { type: 'string', required: false },
-        cc: { type: 'string', required: false },
-        bcc: { type: 'string', required: false },
-        subject: { type: 'string', required: false },
-        body: { type: 'string', required: false },
-        isHtml: { type: 'boolean', required: false },
-        attachments: { type: 'array', required: false },
-        folder: { type: 'string', required: false },
-        query: { type: 'string', required: false },
-        limit: { type: 'number', required: false },
-    },
-    validate: (config) => {
-        const errors = [];
-        if (!config.connection)
-            errors.push('Email service connection is required');
-        if (!config.operation)
-            errors.push('Operation is required');
-        // Validate operation-specific requirements
-        if (config.operation === 'send') {
-            if (!config.to)
-                errors.push('Recipient email is required for send operation');
-            if (!config.subject)
-                errors.push('Subject is required for send operation');
-            if (!config.body)
-                errors.push('Body is required for send operation');
-        }
-        else if (config.operation) {
-            // Read / Search / Delete / Move / Mark-as-read are not implemented by
-            // the Engine (DEV-349). Fail here so the step cannot be saved as valid.
-            errors.push('Only Send is available for the Email action right now');
-        }
-        return { valid: errors.length === 0, errors };
-    },
-    merge: (userConfig) => {
-        return { ...EmailConfig.defaults, ...userConfig };
-    },
-    getLabel: (config) => {
-        switch (config.operation) {
-            case 'send':
-                return `Email: Send to ${config.to}`;
-            case 'read':
-                return `Email: Read from ${config.folder}`;
-            case 'search':
-                return `Email: Search "${config.query}"`;
-            case 'delete':
-                return `Email: Delete from ${config.folder}`;
-            case 'move':
-                return `Email: Move to ${config.folder}`;
-            case 'mark_read':
-                return `Email: Mark as read`;
-            default:
-                return `Email: ${config.operation}`;
-        }
-    },
-};