@octaviaflow/flow-rules 0.1.0

package/dist/catalog/storage/file-operation/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * File Operation Configuration
+ *
+ * Configuration for file operations across any storage platform
+ */
+export interface FileOperationConfigType {
+    connection: string;
+    operation: 'upload' | 'download' | 'delete' | 'list' | 'copy' | 'move' | 'exists';
+    sourcePath?: string;
+    destinationPath: string;
+    fileContent?: string;
+    options?: Record<string, unknown>;
+}
+export declare const FileOperationConfig: {
+    defaults: FileOperationConfigType;
+    schema: {
+        connection: {
+            type: string;
+            required: boolean;
+        };
+        operation: {
+            type: string;
+            required: boolean;
+        };
+        sourcePath: {
+            type: string;
+            required: boolean;
+        };
+        destinationPath: {
+            type: string;
+            required: boolean;
+        };
+        fileContent: {
+            type: string;
+            required: boolean;
+        };
+        options: {
+            type: string;
+            required: boolean;
+        };
+    };
+    validate: (config: Partial<FileOperationConfigType>) => {
+        valid: boolean;
+        errors: string[];
+    };
+    merge: (userConfig: Partial<FileOperationConfigType>) => FileOperationConfigType;
+    getLabel: (config: FileOperationConfigType) => string;
+};

package/dist/catalog/storage/file-operation/config.js

@@ -0,0 +1,45 @@
+/**
+ * File Operation Configuration
+ *
+ * Configuration for file operations across any storage platform
+ */
+export const FileOperationConfig = {
+    defaults: {
+        connection: '',
+        operation: 'upload',
+        sourcePath: '',
+        destinationPath: '',
+        fileContent: '',
+        options: {},
+    },
+    schema: {
+        connection: { type: 'connection', required: true },
+        operation: { type: 'select', required: true },
+        sourcePath: { type: 'string', required: false },
+        destinationPath: { type: 'string', required: true },
+        fileContent: { type: 'string', required: false },
+        options: { type: 'json', required: false },
+    },
+    validate: (config) => {
+        const errors = [];
+        if (!config.connection)
+            errors.push('Storage connection is required');
+        if (!config.operation)
+            errors.push('Operation is required');
+        if (!config.destinationPath)
+            errors.push('Destination path is required');
+        // Validate operation-specific requirements
+        if (config.operation === 'upload' || config.operation === 'copy' || config.operation === 'move') {
+            if (!config.sourcePath) {
+                errors.push('Source path is required for upload/copy/move operations');
+            }
+        }
+        return { valid: errors.length === 0, errors };
+    },
+    merge: (userConfig) => {
+        return { ...FileOperationConfig.defaults, ...userConfig };
+    },
+    getLabel: (config) => {
+        return `${config.operation.toUpperCase()}: ${config.destinationPath}`;
+    },
+};

package/dist/catalog/storage/file-operation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * File Operation Action
+ *
+ * General action for file operations across any storage platform
+ * Supports FTP, SFTP, S3, Azure Blob Storage, Google Cloud Storage, etc.
+ */
+import { ActionDefinition } from '../../types';
+export declare const fileOperationDefinition: ActionDefinition;

package/dist/catalog/storage/file-operation/index.js

@@ -0,0 +1,111 @@
+/**
+ * File Operation Action
+ *
+ * General action for file operations across any storage platform
+ * Supports FTP, SFTP, S3, Azure Blob Storage, Google Cloud Storage, etc.
+ */
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const fileOperationDefinition = {
+    id: 'file_operation',
+    name: 'File Operation',
+    description: 'Perform file operations (upload, download, delete, list) across any storage platform',
+    category: ActionCategory.Storage,
+    type: ActionType.FileOperation,
+    tags: ['storage', 'file', 'ftp', 's3', 'azure', 'gcs', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'DocumentExport',
+    color: '#0043ce',
+    inputSchema: {
+        fields: [
+            {
+                key: 'connection',
+                label: 'Storage Connection',
+                type: FieldType.Connection,
+                description: 'Connection to storage platform (FTP, SFTP, S3, Azure Blob, GCS, etc.)',
+                validation: { required: true },
+            },
+            {
+                key: 'operation',
+                label: 'Operation',
+                type: FieldType.Select,
+                description: 'Type of file operation',
+                options: [
+                    { label: 'Upload', value: 'upload' },
+                    { label: 'Download', value: 'download' },
+                    { label: 'Delete', value: 'delete' },
+                    { label: 'List', value: 'list' },
+                    { label: 'Copy', value: 'copy' },
+                    { label: 'Move', value: 'move' },
+                    { label: 'Exists', value: 'exists' },
+                ],
+                defaultValue: 'upload',
+                validation: { required: true },
+            },
+            {
+                key: 'sourcePath',
+                label: 'Source Path',
+                type: FieldType.String,
+                description: 'Source file path or directory (for upload/copy/move)',
+                validation: { required: false },
+            },
+            {
+                key: 'destinationPath',
+                label: 'Destination Path',
+                type: FieldType.String,
+                description: 'Destination file path or directory',
+                validation: { required: true },
+            },
+            {
+                key: 'fileContent',
+                label: 'File Content',
+                type: FieldType.String,
+                description: 'File content to upload (for text files)',
+                validation: { required: false },
+            },
+            {
+                key: 'options',
+                label: 'Options',
+                type: FieldType.JSON,
+                description: 'Additional options (overwrite, recursive, etc.)',
+                validation: { required: false },
+            },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            {
+                key: 'success',
+                type: FieldType.Boolean,
+                description: 'Whether operation succeeded',
+            },
+            {
+                key: 'data',
+                type: FieldType.JSON,
+                description: 'Operation result data (file list, metadata, etc.)',
+            },
+            {
+                key: 'fileCount',
+                type: FieldType.Number,
+                description: 'Number of files affected',
+            },
+            {
+                key: 'message',
+                type: FieldType.String,
+                description: 'Operation status message',
+            },
+        ],
+        sampleOutput: {
+            success: true,
+            data: { files: ['file1.txt', 'file2.txt'] },
+            fileCount: 2,
+            message: 'Operation completed successfully',
+        },
+    },
+    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/storage/ftp-action/index.d.ts

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

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

@@ -0,0 +1,33 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const ftpActionDefinition = {
+    id: 'ftp_action',
+    name: 'FTP / SFTP',
+    description: 'Upload, download, list, delete, or move files on FTP/SFTP servers. Select a configured FTP connector, then pick files from the remote file explorer.',
+    category: ActionCategory.Storage,
+    type: ActionType.FtpAction,
+    tags: ['ftp', 'sftp', 'ftps', 'file', 'transfer', 'server', 'built-in'],
+    status: ActionStatus.Beta,
+    icon: 'DataBackup',
+    color: '#005d5d',
+    inputSchema: {
+        fields: [
+            { key: 'connector', label: 'FTP / SFTP Connection', type: FieldType.Connection, description: 'Select a configured FTP/SFTP connector from Integrations', validation: { required: true } },
+            { key: 'operation', label: 'Operation', type: FieldType.Select, options: [{ label: 'Download File', value: 'download' }, { label: 'Upload File', value: 'upload' }, { label: 'List Files', value: 'list' }, { label: 'Delete File', value: 'delete' }, { label: 'Move / Rename', value: 'move' }], defaultValue: 'download', validation: { required: true } },
+            { key: 'remotePath', label: 'Remote Path', type: FieldType.String, description: 'File or folder path on the server (use file explorer to browse)' },
+            { key: 'content', label: 'File Content (Upload)', type: FieldType.String, description: 'Content to upload — use FX token from upstream step' },
+            { key: 'fileName', label: 'File Name (Upload)', type: FieldType.String, description: 'Name for the uploaded file' },
+            { key: 'destPath', label: 'Destination Path (Move)', type: FieldType.String, description: 'New path for moved/renamed file' },
+            { key: 'ifExists', label: 'If File Exists', type: FieldType.Select, options: [{ label: 'Overwrite', value: 'overwrite' }, { label: 'Skip', value: 'skip' }], defaultValue: 'overwrite' },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'data', type: FieldType.JSON, description: 'Downloaded content, file list, or result' },
+            { key: 'files', type: FieldType.JSON, description: 'List of files (for list op)' },
+            { key: 'success', type: FieldType.Boolean, description: 'Whether operation succeeded' },
+        ],
+        sampleOutput: { success: true, data: 'file content here' },
+    },
+    version: '1.0.0', createdAt: '2026-03-29T00:00:00Z', updatedAt: '2026-03-29T00:00:00Z', createdBy: 'system', isOfficial: true, testable: false,
+};

package/dist/catalog/storage/google-drive-action/index.d.ts

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

package/dist/catalog/storage/google-drive-action/index.js

@@ -0,0 +1,38 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const googleDriveActionDefinition = {
+    id: 'google_drive_action',
+    name: 'Google Drive',
+    description: 'Upload, download, list, delete, move, copy, or share files in Google Drive',
+    category: ActionCategory.Storage,
+    type: ActionType.GoogleDriveAction,
+    tags: ['google', 'drive', 'cloud', 'storage', 'upload', 'download', 'built-in'],
+    status: ActionStatus.Beta,
+    icon: 'CloudUpload',
+    color: '#4285F4',
+    inputSchema: {
+        fields: [
+            { key: 'connector', label: 'Google Account', type: FieldType.Connection, description: 'Select a connected Google Sheets connector (shares Drive access)', validation: { required: true } },
+            { key: 'operation', label: 'Operation', type: FieldType.Select, options: [{ label: 'Upload File', value: 'upload' }, { label: 'Download File', value: 'download' }, { label: 'List Files', value: 'list' }, { label: 'Delete File', value: 'delete' }, { label: 'Move File', value: 'move' }, { label: 'Copy File', value: 'copy' }, { label: 'Share File', value: 'share' }, { label: 'Create Folder', value: 'create_folder' }], defaultValue: 'upload', validation: { required: true } },
+            { key: 'fileId', label: 'File ID / Path', type: FieldType.String, description: 'Google Drive file ID (use file explorer to browse)' },
+            { key: 'folderId', label: 'Folder ID', type: FieldType.String, description: 'Target folder (root if empty)' },
+            { key: 'fileName', label: 'File Name', type: FieldType.String },
+            { key: 'content', label: 'File Content (Upload)', type: FieldType.String, description: 'Content to upload — use FX token from upstream' },
+            { key: 'mimeType', label: 'MIME Type', type: FieldType.String, defaultValue: 'application/octet-stream' },
+            { key: 'destFolderId', label: 'Destination Folder (Move/Copy)', type: FieldType.String },
+            { key: 'shareEmail', label: 'Share With Email', type: FieldType.String },
+            { key: 'shareRole', label: 'Permission', type: FieldType.Select, options: [{ label: 'Viewer', value: 'reader' }, { label: 'Editor', value: 'writer' }], defaultValue: 'reader' },
+            { key: 'query', label: 'Search Query (List)', type: FieldType.String, description: "e.g. name contains 'report'" },
+            { key: 'pageSize', label: 'Max Results', type: FieldType.Number, defaultValue: 50 },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'data', type: FieldType.JSON, description: 'File content, file list, or operation result' },
+            { key: 'fileId', type: FieldType.String, description: 'Google Drive file ID' },
+            { key: 'webViewLink', type: FieldType.String, description: 'Link to view file in browser' },
+        ],
+        sampleOutput: { fileId: '1abc...', webViewLink: 'https://drive.google.com/file/d/1abc.../view' },
+    },
+    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/storage/json-action/index.d.ts

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

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

@@ -0,0 +1,31 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const jsonActionDefinition = {
+    id: 'json_action',
+    name: 'JSON',
+    description: 'Parse JSON/JSONL files into structured records or generate JSON from workflow data',
+    category: ActionCategory.Storage,
+    type: ActionType.JsonAction,
+    tags: ['json', 'jsonl', 'parse', 'generate', 'file', 'format', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'DataStructured',
+    color: '#f1c21b',
+    inputSchema: {
+        fields: [
+            { key: 'operation', label: 'Operation', type: FieldType.Select, options: [{ label: 'Parse (JSON → Records)', value: 'parse' }, { label: 'Generate (Records → JSON)', value: 'generate' }], defaultValue: 'parse', validation: { required: true } },
+            { key: 'format', label: 'Format', type: FieldType.Select, options: [{ label: 'JSON (array)', value: 'json' }, { label: 'JSONL (one object per line)', value: 'jsonl' }], defaultValue: 'json' },
+            { key: 'content', label: 'JSON Content', type: FieldType.String, description: 'Paste JSON content or use FX token from upstream step' },
+            { key: 'prettyPrint', label: 'Pretty Print', type: FieldType.Boolean, description: 'Format output with indentation', defaultValue: true },
+            { key: 'fileName', label: 'Output File Name', type: FieldType.String, defaultValue: 'export.json' },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'data', type: FieldType.Array, description: 'Parsed records (parse mode) — loop these with a ForEach. Generated JSON 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/storage/onedrive-action/index.d.ts

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

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

@@ -0,0 +1,33 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const onedriveActionDefinition = {
+    id: 'onedrive_action',
+    name: 'OneDrive',
+    description: 'Upload, download, list, delete, move, or copy files in Microsoft OneDrive',
+    category: ActionCategory.Storage,
+    type: ActionType.OneDriveAction,
+    tags: ['onedrive', 'microsoft', 'cloud', 'storage', 'built-in'],
+    status: ActionStatus.Beta,
+    icon: 'CloudUpload',
+    color: '#0078D4',
+    inputSchema: {
+        fields: [
+            { key: 'connector', label: 'Microsoft Account', type: FieldType.Connection, description: 'Select a connected Microsoft/OneDrive account', validation: { required: true } },
+            { key: 'operation', label: 'Operation', type: FieldType.Select, options: [{ label: 'Download File', value: 'download' }, { label: 'Upload File', value: 'upload' }, { label: 'List Files', value: 'list' }, { label: 'Delete', value: 'delete' }, { label: 'Move', value: 'move' }, { label: 'Copy', value: 'copy' }], defaultValue: 'download', validation: { required: true } },
+            { key: 'path', label: 'File / Folder Path', type: FieldType.String, description: 'Path on OneDrive (use file explorer to browse)' },
+            { key: 'itemId', label: 'Item ID', type: FieldType.String, description: 'OneDrive item ID (alternative to path)' },
+            { key: 'content', label: 'File Content (Upload)', type: FieldType.String, description: 'Content to upload — use FX token from upstream' },
+            { key: 'fileName', label: 'File Name (Upload)', type: FieldType.String },
+            { key: 'destPath', label: 'Destination Path (Move/Copy)', type: FieldType.String },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'data', type: FieldType.JSON, description: 'File content, list, or metadata' },
+            { key: 'itemId', type: FieldType.String, description: 'OneDrive item ID' },
+            { key: 'webUrl', type: FieldType.String, description: 'Browser URL' },
+        ],
+        sampleOutput: { itemId: 'abc123', webUrl: 'https://onedrive.live.com/...' },
+    },
+    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/storage/s3-action/index.d.ts

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

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

@@ -0,0 +1,36 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+export const s3ActionDefinition = {
+    id: 's3_action',
+    name: 'AWS S3',
+    description: 'Upload, download, list, delete, or copy files in Amazon S3 buckets',
+    category: ActionCategory.Storage,
+    type: ActionType.S3Action,
+    tags: ['s3', 'aws', 'storage', 'cloud', 'bucket', 'upload', 'download', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'CloudUpload',
+    color: '#569A31',
+    inputSchema: {
+        fields: [
+            { key: 'operation', label: 'Operation', type: FieldType.Select, options: [{ label: 'List Files', value: 'list' }, { label: 'Upload File', value: 'upload' }, { label: 'Download File', value: 'download' }, { label: 'Delete File', value: 'delete' }, { label: 'Copy File', value: 'copy' }, { label: 'Move / Rename', value: 'move' }, { label: 'Get Signed URL', value: 'presign' }], defaultValue: 'download', validation: { required: true } },
+            { key: 'bucket', label: 'Bucket Name', type: FieldType.String, description: 'S3 bucket name (defaults to the connector’s bucket)' },
+            { key: 'key', label: 'Object Key (Path)', type: FieldType.String, description: 'S3 object key, e.g. data/reports/monthly.csv' },
+            { key: 'prefix', label: 'Prefix (for List)', type: FieldType.String, description: 'Filter objects by prefix (folder path)' },
+            { key: 'content', label: 'File Content (for Upload)', type: FieldType.String, description: 'Content to upload — use FX token from upstream step' },
+            { key: 'contentType', label: 'Content Type', type: FieldType.String, description: 'MIME type (e.g. text/csv, application/json)', defaultValue: 'application/octet-stream' },
+            { key: 'destBucket', label: 'Destination Bucket (for Copy)', type: FieldType.String },
+            { key: 'destKey', label: 'Destination Key (for Copy)', type: FieldType.String },
+            { key: 'expiresIn', label: 'URL Expiry (seconds)', type: FieldType.Number, description: 'Presigned URL expiry time', defaultValue: 3600 },
+            { key: 'maxKeys', label: 'Max Results (for List)', type: FieldType.Number, defaultValue: 100 },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'data', type: FieldType.JSON, description: 'Downloaded content, file list, or operation result' },
+            { key: 'key', type: FieldType.String, description: 'S3 object key' },
+            { key: 'url', type: FieldType.String, description: 'Presigned URL (for presign operation)' },
+        ],
+        sampleOutput: { data: 'file content here', key: 'data/reports/monthly.csv' },
+    },
+    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/storage/storage-action/index.d.ts

@@ -0,0 +1,13 @@
+import { ActionDefinition } from '../../types';
+/**
+ * Unified Cloud Storage action. One catalog entry for every storage connector
+ * (Amazon S3, Dropbox, OneDrive, Google Drive, FTP/SFTP). The provider is the
+ * connector you pick; the custom `StorageConfigPanel` adapts the operations +
+ * fields to that provider (driven by `storageCapabilities.ts`) and uses the DS
+ * FilePicker to browse the connector's real files. Replaces the per-provider
+ * actions; existing per-provider nodes still execute (back-compat).
+ *
+ * The `inputSchema` below is a minimal fallback for generic rendering — the
+ * real config UI is the custom panel.
+ */
+export declare const storageActionDefinition: ActionDefinition;

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

@@ -0,0 +1,72 @@
+import { ActionCategory, ActionType, ActionStatus, FieldType } from '../../types';
+/**
+ * Unified Cloud Storage action. One catalog entry for every storage connector
+ * (Amazon S3, Dropbox, OneDrive, Google Drive, FTP/SFTP). The provider is the
+ * connector you pick; the custom `StorageConfigPanel` adapts the operations +
+ * fields to that provider (driven by `storageCapabilities.ts`) and uses the DS
+ * FilePicker to browse the connector's real files. Replaces the per-provider
+ * actions; existing per-provider nodes still execute (back-compat).
+ *
+ * The `inputSchema` below is a minimal fallback for generic rendering — the
+ * real config UI is the custom panel.
+ */
+export const storageActionDefinition = {
+    id: 'storage_action',
+    name: 'Storage',
+    description: 'Browse, transfer, and manage files on any connected storage — cloud (Amazon S3, Google Drive, OneDrive, Dropbox, GCS, Azure Blob) or FTP/SFTP.',
+    category: ActionCategory.Storage,
+    type: ActionType.StorageAction,
+    tags: ['storage', 'files', 's3', 'dropbox', 'onedrive', 'google drive', 'ftp', 'sftp', 'upload', 'download', 'cloud', 'built-in'],
+    status: ActionStatus.Stable,
+    icon: 'CloudUpload',
+    color: '#4F46E5',
+    inputSchema: {
+        fields: [
+            { key: 'connector', label: 'Storage connector', type: FieldType.Connection, description: 'Pick a connected storage connector — its provider drives the available operations.', validation: { required: true } },
+            {
+                key: 'operation', label: 'Operation', type: FieldType.Select,
+                options: [
+                    { label: 'List files', value: 'list' },
+                    { label: 'Download file', value: 'download' },
+                    { label: 'Upload file', value: 'upload' },
+                    { label: 'Delete file', value: 'delete' },
+                    { label: 'Copy file', value: 'copy' },
+                    { label: 'Move / rename', value: 'move' },
+                    { label: 'Get signed URL', value: 'presign' },
+                    { label: 'Share', value: 'share' },
+                    { label: 'Create folder', value: 'create_folder' },
+                    { label: 'Transfer to another connector', value: 'transfer' },
+                ],
+                defaultValue: 'download', validation: { required: true },
+            },
+            { key: 'path', label: 'Path', type: FieldType.String, description: 'File or folder path — use the file browser in the panel.' },
+            { key: 'destPath', label: 'Destination path', type: FieldType.String, description: 'Target for copy / move.' },
+            { key: 'content', label: 'File content (for Upload)', type: FieldType.String, description: 'Content to upload — bind an FX token from an upstream step.' },
+        ],
+    },
+    outputSchema: {
+        type: 'object',
+        properties: [
+            { key: 'operation', type: FieldType.String, description: 'The operation that ran' },
+            { key: 'data', type: FieldType.JSON, description: 'Operation result or downloaded content' },
+            { key: 'files', type: FieldType.JSON, description: 'Listing (for the List operation)' },
+            { key: 'path', type: FieldType.String, description: 'Affected file/folder path' },
+            { key: 'url', type: FieldType.String, description: 'Signed URL (for the Get signed URL operation)' },
+        ],
+        // Listings are normalized across providers (DEV-187): each entry carries a
+        // parsed `ext` + best-effort `mimeType` so a ForEach → Condition can filter
+        // "only the .csv files" without string-munging the name.
+        sampleOutput: {
+            operation: 'list',
+            files: [
+                { name: 'report.csv', path: '/reports/report.csv', ext: 'csv', mimeType: 'text/csv', type: 'file', size: 2048, modifiedAt: '2026-06-18T10:00:00Z' },
+            ],
+        },
+    },
+    version: '1.0.0',
+    createdAt: '2026-06-05T00:00:00Z',
+    updatedAt: '2026-06-05T00:00:00Z',
+    createdBy: 'system',
+    isOfficial: true,
+    testable: false,
+};

package/dist/catalog/storage/storageCapabilities.d.ts

@@ -0,0 +1,57 @@
+export type StorageOperation = 'list' | 'download' | 'upload' | 'delete' | 'copy' | 'move' | 'presign' | 'share' | 'create_folder' | 'transfer' | 'sync';
+export type StorageFieldType = 'string' | 'number' | 'select' | 'boolean';
+/** A path field rendered via the DS FilePicker (browses the connector). */
+export interface StoragePathField {
+    /** Provider-native config key this path is written to. */
+    key: string;
+    label: string;
+    /** What the FilePicker lets the user pick. */
+    selectMode: 'file' | 'folder' | 'both';
+    required?: boolean;
+    hint?: string;
+}
+/** A non-path field rendered as a normal input. */
+export interface StorageExtraField {
+    key: string;
+    label: string;
+    type: StorageFieldType;
+    options?: {
+        label: string;
+        value: string;
+    }[];
+    defaultValue?: string | number | boolean;
+    required?: boolean;
+    /** Tuck behind the "Advanced options" disclosure. */
+    advanced?: boolean;
+    hint?: string;
+    placeholder?: string;
+}
+export interface StorageOpSpec {
+    value: StorageOperation;
+    label: string;
+    /** Primary target (rendered via FilePicker). */
+    path?: StoragePathField;
+    /** Destination target for move/copy (rendered via FilePicker). */
+    dest?: StoragePathField;
+    /** Shows the multiline content field (uploads). */
+    content?: boolean;
+    /** Extra inputs (some advanced). */
+    fields?: StorageExtraField[];
+}
+export interface StorageProviderSpec {
+    connectorId: string;
+    label: string;
+    /** Whether the connector supports the unified /browse endpoint (FilePicker). */
+    browse: boolean;
+    operations: StorageOpSpec[];
+}
+export declare const STORAGE_PROVIDERS: Record<string, StorageProviderSpec>;
+/** 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 declare const STORAGE_CONNECTOR_IDS: string[];
+export declare function getStorageProvider(connectorId?: string): StorageProviderSpec | undefined;
+/** All config keys any operation might write — used to clear stale fields when the operation/provider changes. */
+export declare function storageConfigKeys(): string[];