@octaviaflow/flow-rules 0.11.0 → 0.12.0

package/dist/catalog/actions/console-log/config.d.ts

@@ -36,6 +36,7 @@ export declare const ConsoleLogConfig: {
         level: {
             type: string;
             required: boolean;
+            options: string[];
             description: string;
         };
         data: {

package/dist/catalog/actions/delay/config.d.ts

@@ -25,6 +25,7 @@ export declare const DelayConfig: {
         unit: {
             type: string;
             required: boolean;
+            options: string[];
             description: string;
         };
     };

package/dist/catalog/actions/http-request/config.d.ts

@@ -72,6 +72,7 @@ export declare const HTTPRequestConfig: {
         apiType: {
             type: string;
             required: boolean;
+            options: string[];
         };
         baseUrl: {
             type: string;
@@ -84,6 +85,7 @@ export declare const HTTPRequestConfig: {
         bodyType: {
             type: string;
             required: boolean;
+            options: string[];
         };
         formData: {
             type: string;
@@ -124,6 +126,7 @@ export declare const HTTPRequestConfig: {
         responseType: {
             type: string;
             required: boolean;
+            options: string[];
         };
         expectedContentTypes: {
             type: string;
@@ -132,6 +135,7 @@ export declare const HTTPRequestConfig: {
         method: {
             type: string;
             required: boolean;
+            options: string[];
             description: string;
         };
         url: {

package/dist/catalog/communication/email-send/config.d.ts

@@ -29,6 +29,8 @@ export declare const EmailConfig: {
         operation: {
             type: string;
             required: boolean;
+            options: string[];
+            description: string;
         };
         to: {
             type: string;

package/dist/catalog/communication/webhook-call/config.d.ts

@@ -17,6 +17,7 @@ export declare const WebhookCallConfig: {
         method: {
             type: string;
             required: boolean;
+            options: string[];
         };
         payload: {
             type: string;

package/dist/catalog/communication/whatsapp-send/config.d.ts

@@ -25,6 +25,7 @@ export declare const WhatsappSendConfig: {
         mode: {
             type: string;
             required: boolean;
+            options: string[];
         };
         templateName: {
             type: string;

package/dist/catalog/general/query/config.d.ts

@@ -48,10 +48,14 @@ export declare const BuildQueryContractSchema: {
     readonly mode: {
         readonly type: "select";
         readonly required: true;
+        readonly options: readonly ["visual", "sql"];
+        readonly description: "visual: the query is built from visualConfig; sql: the query is the text in sqlConfig.sql";
     };
     readonly queryType: {
         readonly type: "select";
         readonly required: true;
+        readonly options: readonly ["select", "insert", "update", "delete", "custom"];
+        readonly description: "Only select is a read; the write types exist for the SQL mode of database connectors";
     };
     readonly visualConfig: {
         readonly type: "object";

package/dist/catalog/general/transform/config.d.ts

@@ -26,6 +26,14 @@ export interface FieldMapping {
     depth?: number;
 }
 export type TransformMode = 'visual' | 'expression';
+/**
+ * The authoring modes. `visual` is the Field Mapper and the only mode the panel
+ * offers; `expression` is the retired JavaScript mode, kept so steps saved in it
+ * still run. Anything else is not a mode: the Engine fails the step with
+ * "Unknown transform mode" at run time, against the customer's live systems —
+ * which is how an agent's guess of `"append"` surfaced (DEV-421).
+ */
+export declare const TRANSFORM_MODES: readonly TransformMode[];
 /** Data operation the user wants to perform */
 export type TransformOperation = 'upsert' | 'insert' | 'update' | 'delete';
 export declare const TRANSFORM_OPERATIONS: {
@@ -82,6 +90,8 @@ export declare const TransformConfig: {
         operation: {
             type: string;
             required: boolean;
+            options: readonly TransformOperation[];
+            description: string;
         };
         connectorId: {
             type: string;
@@ -90,14 +100,19 @@ export declare const TransformConfig: {
         database: {
             type: string;
             required: boolean;
+            description: string;
         };
         objectName: {
             type: string;
             required: boolean;
+            dynamic: boolean;
+            description: string;
         };
         mode: {
             type: string;
             required: boolean;
+            options: readonly TransformMode[];
+            description: string;
         };
         mappings: {
             type: string;

package/dist/catalog/logic/condition/config.d.ts

@@ -32,6 +32,7 @@ export declare const ConditionConfig: {
         mode: {
             type: string;
             required: boolean;
+            options: string[];
         };
         filters: {
             type: string;

package/dist/catalog/logic/for-each/config.d.ts

@@ -68,10 +68,14 @@ export declare const ForEachConfig: {
         arrayPath: {
             type: string;
             required: boolean;
+            dynamic: boolean;
+            description: string;
         };
         iterationMode: {
             type: string;
             required: boolean;
+            options: string[];
+            description: string;
         };
         itemVariable: {
             type: string;

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

@@ -21,6 +21,7 @@ export declare const FileOperationConfig: {
         operation: {
             type: string;
             required: boolean;
+            options: string[];
         };
         sourcePath: {
             type: string;

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

@@ -12,6 +12,7 @@ export declare const FormatConfig: {
         format: {
             type: string;
             required: boolean;
+            options: string[];
         };
     };
     validate: (config: Partial<FormatConfigType>) => {

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

@@ -14,6 +14,7 @@ export declare const ScheduleTriggerConfig: {
         scheduleType: {
             type: string;
             required: boolean;
+            options: string[];
         };
         interval: {
             type: string;
@@ -23,6 +24,7 @@ export declare const ScheduleTriggerConfig: {
         intervalUnit: {
             type: string;
             required: boolean;
+            options: string[];
         };
         cronExpression: {
             type: string;

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

@@ -16,6 +16,7 @@ export declare const WebhookTriggerConfig: {
         method: {
             type: string;
             required: boolean;
+            options: string[];
         };
         requireAuth: {
             type: string;

package/dist/catalog/utility/debug/config.d.ts

@@ -55,6 +55,7 @@ export declare const DebugConfig: {
         mode: {
             type: string;
             required: boolean;
+            options: string[];
         };
         label: {
             type: string;

package/dist/index.cjs

@@ -88,6 +88,7 @@ __export(exports_src, {
   NodeStatus: () => NodeStatus,
   ONEDRIVE_OPERATIONS: () => ONEDRIVE_OPERATIONS,
   OneDriveActionConfig: () => OneDriveActionConfig,
+  PLATFORM_CONFIG_KEYS: () => PLATFORM_CONFIG_KEYS,
   QueryMode: () => QueryMode,
   QueryType: () => QueryType,
   S3ActionConfig: () => S3ActionConfig,
@@ -95,6 +96,7 @@ __export(exports_src, {
   STORAGE_CONNECTOR_IDS: () => STORAGE_CONNECTOR_IDS,
   SortDirection: () => SortDirection,
   StorageActionConfig: () => StorageActionConfig,
+  TRANSFORM_MODES: () => TRANSFORM_MODES,
   TRANSFORM_OPERATIONS: () => TRANSFORM_OPERATIONS,
   TransformConfig: () => TransformConfig,
   USER_FUNCTION_PREFIX: () => USER_FUNCTION_PREFIX,
@@ -136,6 +138,7 @@ __export(exports_src, {
   mappingTransformFunctionName: () => mappingTransformFunctionName,
   migrateDelayConfig: () => migrateDelayConfig,
   queryDefinition: () => queryDefinition,
+  selectsWithoutValues: () => selectsWithoutValues,
   storageConfigKeys: () => storageConfigKeys,
   storageOperations: () => storageOperations,
   summarizeConnectorTriggerEvents: () => summarizeConnectorTriggerEvents,
@@ -1410,8 +1413,18 @@ function isQueryableConnector(connector) {
 }
 var BuildQueryContractSchema = {
   connectorId: { type: "connection", required: true },
-  mode: { type: "select", required: true },
-  queryType: { type: "select", required: true },
+  mode: {
+    type: "select",
+    required: true,
+    options: ["visual", "sql"],
+    description: "visual: the query is built from visualConfig; sql: the query is the text in sqlConfig.sql"
+  },
+  queryType: {
+    type: "select",
+    required: true,
+    options: ["select", "insert", "update", "delete", "custom"],
+    description: "Only select is a read; the write types exist for the SQL mode of database connectors"
+  },
   visualConfig: { type: "object", required: false },
   sqlConfig: { type: "object", required: false },
   timeout: { type: "number", required: false },
@@ -3311,7 +3324,7 @@ var ConditionConfig = {
     condition: ""
   },
   schema: {
-    mode: { type: "select", required: true },
+    mode: { type: "select", required: true, options: ["visual", "expression"] },
     filters: { type: "array", required: false },
     condition: { type: "expression", required: false }
   },
@@ -3381,8 +3394,18 @@ var ForEachConfig = {
     collect: "array"
   },
   schema: {
-    arrayPath: { type: "select", required: false },
-    iterationMode: { type: "select", required: false },
+    arrayPath: {
+      type: "select",
+      required: false,
+      dynamic: true,
+      description: "A path to an array in the upstream step's output (the Query's object name, or a field holding a list) — the values come from that step's data, not from the catalog"
+    },
+    iterationMode: {
+      type: "select",
+      required: false,
+      options: ["records", "fields", "range", "nested", "batch", "cursor", "while", "array"],
+      description: "What one iteration is: records (one per record, the default; array is its legacy alias), fields, range, nested, batch, cursor or while"
+    },
     itemVariable: { type: "string", required: true },
     indexVariable: { type: "string", required: false },
     batchSize: { type: "number", required: false },
@@ -3586,7 +3609,7 @@ function fieldToJsonSchema(f) {
 // src/catalog/utility/debug/config.ts
 var DebugConfig = {
   schema: {
-    mode: { type: "select", required: true },
+    mode: { type: "select", required: true, options: ["log", "snapshot", "watch", "assert", "profile"] },
     label: { type: "string", required: false },
     pinned: { type: "boolean", required: false },
     condition: { type: "expression", required: false },
@@ -3701,7 +3724,12 @@ var EmailConfig = {
   },
   schema: {
     connection: { type: "connection", required: true },
-    operation: { type: "select", required: true },
+    operation: {
+      type: "select",
+      required: true,
+      options: ["send", "read", "search", "delete", "move", "mark_read"],
+      description: "Only send runs today (DEV-349); the other values are kept so older steps still parse, and validate() rejects them"
+    },
     to: { type: "string", required: false },
     cc: { type: "string", required: false },
     bcc: { type: "string", required: false },
@@ -3754,12 +3782,15 @@ var EmailConfig = {
   }
 };
 // src/catalog/general/transform/config.ts
+var TRANSFORM_MODES = ["visual", "expression"];
 var TRANSFORM_OPERATIONS = [
   { id: "upsert", label: "Upsert" },
   { id: "insert", label: "Insert" },
   { id: "update", label: "Update" },
   { id: "delete", label: "Delete" }
 ];
+var TRANSFORM_OPERATION_IDS = TRANSFORM_OPERATIONS.map((o) => o.id);
+var isOneOf = (set, value) => typeof value === "string" && set.includes(value);
 var DATABASE_CONNECTOR_IDS = new Set(["mongodb", "postgresql", "mysql", "sqlite", "google_sheets"]);
 var TransformConfig = {
   defaults: {
@@ -3783,11 +3814,30 @@ var TransformConfig = {
   },
   schema: {
     name: { type: "string", required: false },
-    operation: { type: "select", required: true },
+    operation: {
+      type: "select",
+      required: true,
+      options: TRANSFORM_OPERATION_IDS,
+      description: "What to do with each mapped record at the target: upsert, insert, update or delete"
+    },
     connectorId: { type: "connection", required: true },
-    database: { type: "text", required: false },
-    objectName: { type: "select", required: true },
-    mode: { type: "select", required: true },
+    database: {
+      type: "text",
+      required: false,
+      description: "Database name for MongoDB / PostgreSQL / MySQL / SQLite; the spreadsheet id for Google Sheets"
+    },
+    objectName: {
+      type: "select",
+      required: true,
+      dynamic: true,
+      description: "The table, entity, object or sheet tab to write to — the names come from the connected app (describe_connector_object)"
+    },
+    mode: {
+      type: "select",
+      required: true,
+      options: TRANSFORM_MODES,
+      description: "How the mappings are authored: visual (the Field Mapper — the only mode the editor offers) or expression (legacy JavaScript). This is not the write mode; that is `operation`."
+    },
     mappings: { type: "array", required: false },
     expression: { type: "code", required: false }
   },
@@ -3801,6 +3851,12 @@ var TransformConfig = {
     const errors = [];
     if (!config.operation) {
       errors.push("Operation is required");
+    } else if (!isOneOf(TRANSFORM_OPERATION_IDS, config.operation)) {
+      errors.push(`Operation must be one of: ${TRANSFORM_OPERATION_IDS.join(", ")} (got "${String(config.operation)}")`);
+    }
+    const mode = config.mode;
+    if (mode !== undefined && mode !== null && mode !== "" && !isOneOf(TRANSFORM_MODES, mode)) {
+      errors.push(`Mode must be one of: ${TRANSFORM_MODES.join(", ")} (got "${String(mode)}"). ` + `Mode is how the mappings are authored, not how rows are written — for that, see operation.`);
     }
     if (!config.connectorId) {
       errors.push("Target connector is required");
@@ -5004,6 +5060,7 @@ var ConsoleLogConfig = {
     level: {
       type: "select",
       required: false,
+      options: ["info", "warning", "error", "debug"],
       description: "Log level for the message"
     },
     data: {
@@ -5054,6 +5111,7 @@ var DelayConfig = {
     unit: {
       type: "select",
       required: false,
+      options: ["milliseconds", "seconds", "minutes", "hours"],
       description: "Time unit for the duration"
     }
   },
@@ -5118,10 +5176,10 @@ var HTTPRequestConfig = {
     expectedContentTypes: []
   },
   schema: {
-    apiType: { type: "select", required: false },
+    apiType: { type: "select", required: false, options: ["rest", "graphql"] },
     baseUrl: { type: "string", required: false },
     queryParams: { type: "array", required: false },
-    bodyType: { type: "select", required: false },
+    bodyType: { type: "select", required: false, options: ["none", "json", "raw", "form-data", "xml"] },
     formData: { type: "array", required: false },
     graphqlQuery: { type: "code", required: false },
     graphqlVariables: { type: "json", required: false },
@@ -5131,11 +5189,12 @@ var HTTPRequestConfig = {
     retry: { type: "object", required: false },
     pagination: { type: "object", required: false },
     extract: { type: "object", required: false },
-    responseType: { type: "select", required: false },
+    responseType: { type: "select", required: false, options: ["json", "text", "binary"] },
     expectedContentTypes: { type: "array", required: false },
     method: {
       type: "select",
       required: true,
+      options: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
       description: "HTTP method to use"
     },
     url: {
@@ -5325,7 +5384,7 @@ var WebhookCallConfig = {
   },
   schema: {
     url: { type: "url", required: true },
-    method: { type: "select", required: true },
+    method: { type: "select", required: true, options: ["POST", "PUT", "PATCH", "GET"] },
     payload: { type: "json", required: false },
     headers: { type: "json", required: false }
   },
@@ -5350,7 +5409,7 @@ var WhatsappSendConfig = {
   schema: {
     connection: { type: "connection", required: true },
     to: { type: "string", required: true },
-    mode: { type: "select", required: true },
+    mode: { type: "select", required: true, options: ["template", "text"] },
     templateName: { type: "string", required: false },
     templateLanguage: { type: "string", required: false },
     templateVariables: { type: "array", required: false },
@@ -5397,7 +5456,7 @@ var FileOperationConfig = {
   },
   schema: {
     connection: { type: "connection", required: true },
-    operation: { type: "select", required: true },
+    operation: { type: "select", required: true, options: ["upload", "download", "delete", "list", "copy", "move", "exists"] },
     sourcePath: { type: "string", required: false },
     destinationPath: { type: "string", required: true },
     fileContent: { type: "string", required: false },
@@ -5431,7 +5490,7 @@ var FormatConfig = {
   defaults: { input: "", format: "json" },
   schema: {
     input: { type: "expression", required: true },
-    format: { type: "select", required: true }
+    format: { type: "select", required: true, options: ["json", "csv", "xml", "yaml"] }
   },
   validate: (config) => {
     const errors = [];
@@ -5456,9 +5515,9 @@ var ScheduleTriggerConfig = {
     timezone: "UTC"
   },
   schema: {
-    scheduleType: { type: "select", required: true },
+    scheduleType: { type: "select", required: true, options: ["interval", "cron", "specific"] },
     interval: { type: "number", required: false, min: 1 },
-    intervalUnit: { type: "select", required: false },
+    intervalUnit: { type: "select", required: false, options: ["minutes", "hours", "days", "weeks"] },
     cronExpression: { type: "string", required: false },
     timezone: { type: "string", required: false }
   },
@@ -5496,7 +5555,7 @@ var WebhookTriggerConfig = {
   },
   schema: {
     webhookPath: { type: "string", required: false },
-    method: { type: "select", required: true },
+    method: { type: "select", required: true, options: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
     requireAuth: { type: "boolean", required: false }
   },
   validate: (config) => {
@@ -5630,11 +5689,18 @@ function contractFieldsFor(definition) {
       label: humanise(key),
       type: CONTRACT_TYPE_TO_FIELD_TYPE[field.type] ?? "string" /* String */,
       validation: { required: field.required === true },
+      ...typeof field.description === "string" && field.description ? { description: field.description } : {},
       ...field.options ? { options: field.options.map((v) => ({ label: String(v), value: v })) } : {}
     });
   }
   return [...declared, ...derived];
 }
+function selectsWithoutValues(actionId) {
+  const contract = contractFor(actionId);
+  if (!contract)
+    return [];
+  return Object.entries(contract.schema).filter(([, f]) => f.type === "select" && !(f.options && f.options.length > 0) && f.dynamic !== true).map(([key]) => key);
+}
 function contractDrift(definition) {
   const contract = contractFor(definition.id);
   if (!contract)
@@ -5664,6 +5730,10 @@ function contractDerivedKeys(definition) {
 var MAX_STEP_CONFIG_BYTES = 256 * 1024;
 var FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
 var MAX_DEPTH = 12;
+var PLATFORM_CONFIG_KEYS = {
+  flowId: { key: "flowId", label: "Flow", type: "string" /* String */, validation: { required: false } },
+  outputAs: { key: "outputAs", label: "Output as", type: "string" /* String */, validation: { required: false } }
+};
 function typeMatches(field, value) {
   if (value === null || value === undefined || value === "")
     return true;
@@ -5771,8 +5841,10 @@ function validateStepConfig(step) {
   const declared = new Map(contractFieldsFor(definition).map((f) => [f.key, f]));
   const entries = Object.entries(config);
   for (const [key, value] of entries) {
-    const field = declared.get(key);
+    const field = declared.get(key) ?? PLATFORM_CONFIG_KEYS[key];
     if (!field) {
+      if (isEditorPrivateKey(key))
+        continue;
       issues.push({
         severity: "warning",
         code: "UNDECLARED_FIELD",

package/dist/index.d.ts

@@ -36,7 +36,7 @@ export { EmailConfig, } from "./catalog/communication/email-send/config";
 export { queryDefinition, } from "./catalog/general/query/index";
 export { isQueryableConnector, } from "./catalog/general/query/config";
 export { AggregateFunction, type BuildQueryConfig, type ColumnSchema, type ConnectorSchema, JoinType, LogicalOperator, type QueryExecutionResult, type QueryField, type QueryFilter, type QueryFilterGroup, type QueryJoin, type QuerySort, SortDirection, type VisualQueryConfig, } from "./catalog/general/query/types";
-export { DATABASE_CONNECTOR_IDS, type FieldMapping, TRANSFORM_OPERATIONS, TransformConfig, type TransformConfigType, type TransformOperation, } from "./catalog/general/transform/config";
+export { DATABASE_CONNECTOR_IDS, type FieldMapping, TRANSFORM_MODES, TRANSFORM_OPERATIONS, TransformConfig, type TransformConfigType, type TransformOperation, } from "./catalog/general/transform/config";
 export { STORAGE_CONNECTOR_IDS, type StorageExtraField, type StoragePathField, getStorageProvider, storageConfigKeys, } from "./catalog/storage/storageCapabilities";
 export { ManualTriggerConfig } from "./catalog/triggers/manual-trigger/index";
 export { AiAgentConfig, type AiAgentConfigType, type AiAgentOverrides } from "./catalog/ai/ai-agent/config";
@@ -60,6 +60,6 @@ export { CONNECTOR_EVENT_ENTITIES, EVENT_CAPABLE_CONNECTOR_IDS, getEntitiesForCo
 export * from "./catalog/workflow";
 export { type FlowConnection, type FlowData, type FlowStep, generateConnectionsFromSteps, transformConnectionToEdge, transformFlowToWorkflow, transformStepToNode, validateFlowData, } from "./rules/flowShape";
 export { flattenNestedWorkflow } from "./rules/flattenNestedWorkflow";
-export { configErrors, MAX_STEP_CONFIG_BYTES, validateStepConfig, validateStepConfigs, type ConfigIssue, type ConfigIssueCode, } from "./rules/configSafety";
+export { configErrors, MAX_STEP_CONFIG_BYTES, validateStepConfig, PLATFORM_CONFIG_KEYS, validateStepConfigs, type ConfigIssue, type ConfigIssueCode, } from "./rules/configSafety";
 export { isMappingFunction, MAPPING_FUNCTION_SPECS, MAPPING_FUNCTIONS, mappingTransformFunctionName, USER_FUNCTION_PREFIX, type MappingFunction, type MappingFunctionSpec, } from "./rules/mappingFunctions";
-export { CONFIG_CONTRACTS, contractDerivedKeys, contractDrift, contractFieldsFor, contractVocabularyDrift, contractFor, declaredKeys, isEditorPrivateKey, type ConfigContract, type ContractField, type ContractFieldType, } from "./rules/configContracts";
+export { CONFIG_CONTRACTS, contractDerivedKeys, contractDrift, contractFieldsFor, contractVocabularyDrift, contractFor, declaredKeys, isEditorPrivateKey, selectsWithoutValues, type ConfigContract, type ContractField, type ContractFieldType, } from "./rules/configContracts";

package/dist/index.js

@@ -1256,8 +1256,18 @@ function isQueryableConnector(connector) {
 }
 var BuildQueryContractSchema = {
   connectorId: { type: "connection", required: true },
-  mode: { type: "select", required: true },
-  queryType: { type: "select", required: true },
+  mode: {
+    type: "select",
+    required: true,
+    options: ["visual", "sql"],
+    description: "visual: the query is built from visualConfig; sql: the query is the text in sqlConfig.sql"
+  },
+  queryType: {
+    type: "select",
+    required: true,
+    options: ["select", "insert", "update", "delete", "custom"],
+    description: "Only select is a read; the write types exist for the SQL mode of database connectors"
+  },
   visualConfig: { type: "object", required: false },
   sqlConfig: { type: "object", required: false },
   timeout: { type: "number", required: false },
@@ -3157,7 +3167,7 @@ var ConditionConfig = {
     condition: ""
   },
   schema: {
-    mode: { type: "select", required: true },
+    mode: { type: "select", required: true, options: ["visual", "expression"] },
     filters: { type: "array", required: false },
     condition: { type: "expression", required: false }
   },
@@ -3227,8 +3237,18 @@ var ForEachConfig = {
     collect: "array"
   },
   schema: {
-    arrayPath: { type: "select", required: false },
-    iterationMode: { type: "select", required: false },
+    arrayPath: {
+      type: "select",
+      required: false,
+      dynamic: true,
+      description: "A path to an array in the upstream step's output (the Query's object name, or a field holding a list) — the values come from that step's data, not from the catalog"
+    },
+    iterationMode: {
+      type: "select",
+      required: false,
+      options: ["records", "fields", "range", "nested", "batch", "cursor", "while", "array"],
+      description: "What one iteration is: records (one per record, the default; array is its legacy alias), fields, range, nested, batch, cursor or while"
+    },
     itemVariable: { type: "string", required: true },
     indexVariable: { type: "string", required: false },
     batchSize: { type: "number", required: false },
@@ -3432,7 +3452,7 @@ function fieldToJsonSchema(f) {
 // src/catalog/utility/debug/config.ts
 var DebugConfig = {
   schema: {
-    mode: { type: "select", required: true },
+    mode: { type: "select", required: true, options: ["log", "snapshot", "watch", "assert", "profile"] },
     label: { type: "string", required: false },
     pinned: { type: "boolean", required: false },
     condition: { type: "expression", required: false },
@@ -3547,7 +3567,12 @@ var EmailConfig = {
   },
   schema: {
     connection: { type: "connection", required: true },
-    operation: { type: "select", required: true },
+    operation: {
+      type: "select",
+      required: true,
+      options: ["send", "read", "search", "delete", "move", "mark_read"],
+      description: "Only send runs today (DEV-349); the other values are kept so older steps still parse, and validate() rejects them"
+    },
     to: { type: "string", required: false },
     cc: { type: "string", required: false },
     bcc: { type: "string", required: false },
@@ -3600,12 +3625,15 @@ var EmailConfig = {
   }
 };
 // src/catalog/general/transform/config.ts
+var TRANSFORM_MODES = ["visual", "expression"];
 var TRANSFORM_OPERATIONS = [
   { id: "upsert", label: "Upsert" },
   { id: "insert", label: "Insert" },
   { id: "update", label: "Update" },
   { id: "delete", label: "Delete" }
 ];
+var TRANSFORM_OPERATION_IDS = TRANSFORM_OPERATIONS.map((o) => o.id);
+var isOneOf = (set, value) => typeof value === "string" && set.includes(value);
 var DATABASE_CONNECTOR_IDS = new Set(["mongodb", "postgresql", "mysql", "sqlite", "google_sheets"]);
 var TransformConfig = {
   defaults: {
@@ -3629,11 +3657,30 @@ var TransformConfig = {
   },
   schema: {
     name: { type: "string", required: false },
-    operation: { type: "select", required: true },
+    operation: {
+      type: "select",
+      required: true,
+      options: TRANSFORM_OPERATION_IDS,
+      description: "What to do with each mapped record at the target: upsert, insert, update or delete"
+    },
     connectorId: { type: "connection", required: true },
-    database: { type: "text", required: false },
-    objectName: { type: "select", required: true },
-    mode: { type: "select", required: true },
+    database: {
+      type: "text",
+      required: false,
+      description: "Database name for MongoDB / PostgreSQL / MySQL / SQLite; the spreadsheet id for Google Sheets"
+    },
+    objectName: {
+      type: "select",
+      required: true,
+      dynamic: true,
+      description: "The table, entity, object or sheet tab to write to — the names come from the connected app (describe_connector_object)"
+    },
+    mode: {
+      type: "select",
+      required: true,
+      options: TRANSFORM_MODES,
+      description: "How the mappings are authored: visual (the Field Mapper — the only mode the editor offers) or expression (legacy JavaScript). This is not the write mode; that is `operation`."
+    },
     mappings: { type: "array", required: false },
     expression: { type: "code", required: false }
   },
@@ -3647,6 +3694,12 @@ var TransformConfig = {
     const errors = [];
     if (!config.operation) {
       errors.push("Operation is required");
+    } else if (!isOneOf(TRANSFORM_OPERATION_IDS, config.operation)) {
+      errors.push(`Operation must be one of: ${TRANSFORM_OPERATION_IDS.join(", ")} (got "${String(config.operation)}")`);
+    }
+    const mode = config.mode;
+    if (mode !== undefined && mode !== null && mode !== "" && !isOneOf(TRANSFORM_MODES, mode)) {
+      errors.push(`Mode must be one of: ${TRANSFORM_MODES.join(", ")} (got "${String(mode)}"). ` + `Mode is how the mappings are authored, not how rows are written — for that, see operation.`);
     }
     if (!config.connectorId) {
       errors.push("Target connector is required");
@@ -4850,6 +4903,7 @@ var ConsoleLogConfig = {
     level: {
       type: "select",
       required: false,
+      options: ["info", "warning", "error", "debug"],
       description: "Log level for the message"
     },
     data: {
@@ -4900,6 +4954,7 @@ var DelayConfig = {
     unit: {
       type: "select",
       required: false,
+      options: ["milliseconds", "seconds", "minutes", "hours"],
       description: "Time unit for the duration"
     }
   },
@@ -4964,10 +5019,10 @@ var HTTPRequestConfig = {
     expectedContentTypes: []
   },
   schema: {
-    apiType: { type: "select", required: false },
+    apiType: { type: "select", required: false, options: ["rest", "graphql"] },
     baseUrl: { type: "string", required: false },
     queryParams: { type: "array", required: false },
-    bodyType: { type: "select", required: false },
+    bodyType: { type: "select", required: false, options: ["none", "json", "raw", "form-data", "xml"] },
     formData: { type: "array", required: false },
     graphqlQuery: { type: "code", required: false },
     graphqlVariables: { type: "json", required: false },
@@ -4977,11 +5032,12 @@ var HTTPRequestConfig = {
     retry: { type: "object", required: false },
     pagination: { type: "object", required: false },
     extract: { type: "object", required: false },
-    responseType: { type: "select", required: false },
+    responseType: { type: "select", required: false, options: ["json", "text", "binary"] },
     expectedContentTypes: { type: "array", required: false },
     method: {
       type: "select",
       required: true,
+      options: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
       description: "HTTP method to use"
     },
     url: {
@@ -5171,7 +5227,7 @@ var WebhookCallConfig = {
   },
   schema: {
     url: { type: "url", required: true },
-    method: { type: "select", required: true },
+    method: { type: "select", required: true, options: ["POST", "PUT", "PATCH", "GET"] },
     payload: { type: "json", required: false },
     headers: { type: "json", required: false }
   },
@@ -5196,7 +5252,7 @@ var WhatsappSendConfig = {
   schema: {
     connection: { type: "connection", required: true },
     to: { type: "string", required: true },
-    mode: { type: "select", required: true },
+    mode: { type: "select", required: true, options: ["template", "text"] },
     templateName: { type: "string", required: false },
     templateLanguage: { type: "string", required: false },
     templateVariables: { type: "array", required: false },
@@ -5243,7 +5299,7 @@ var FileOperationConfig = {
   },
   schema: {
     connection: { type: "connection", required: true },
-    operation: { type: "select", required: true },
+    operation: { type: "select", required: true, options: ["upload", "download", "delete", "list", "copy", "move", "exists"] },
     sourcePath: { type: "string", required: false },
     destinationPath: { type: "string", required: true },
     fileContent: { type: "string", required: false },
@@ -5277,7 +5333,7 @@ var FormatConfig = {
   defaults: { input: "", format: "json" },
   schema: {
     input: { type: "expression", required: true },
-    format: { type: "select", required: true }
+    format: { type: "select", required: true, options: ["json", "csv", "xml", "yaml"] }
   },
   validate: (config) => {
     const errors = [];
@@ -5302,9 +5358,9 @@ var ScheduleTriggerConfig = {
     timezone: "UTC"
   },
   schema: {
-    scheduleType: { type: "select", required: true },
+    scheduleType: { type: "select", required: true, options: ["interval", "cron", "specific"] },
     interval: { type: "number", required: false, min: 1 },
-    intervalUnit: { type: "select", required: false },
+    intervalUnit: { type: "select", required: false, options: ["minutes", "hours", "days", "weeks"] },
     cronExpression: { type: "string", required: false },
     timezone: { type: "string", required: false }
   },
@@ -5342,7 +5398,7 @@ var WebhookTriggerConfig = {
   },
   schema: {
     webhookPath: { type: "string", required: false },
-    method: { type: "select", required: true },
+    method: { type: "select", required: true, options: ["GET", "POST", "PUT", "PATCH", "DELETE"] },
     requireAuth: { type: "boolean", required: false }
   },
   validate: (config) => {
@@ -5476,11 +5532,18 @@ function contractFieldsFor(definition) {
       label: humanise(key),
       type: CONTRACT_TYPE_TO_FIELD_TYPE[field.type] ?? "string" /* String */,
       validation: { required: field.required === true },
+      ...typeof field.description === "string" && field.description ? { description: field.description } : {},
       ...field.options ? { options: field.options.map((v) => ({ label: String(v), value: v })) } : {}
     });
   }
   return [...declared, ...derived];
 }
+function selectsWithoutValues(actionId) {
+  const contract = contractFor(actionId);
+  if (!contract)
+    return [];
+  return Object.entries(contract.schema).filter(([, f]) => f.type === "select" && !(f.options && f.options.length > 0) && f.dynamic !== true).map(([key]) => key);
+}
 function contractDrift(definition) {
   const contract = contractFor(definition.id);
   if (!contract)
@@ -5510,6 +5573,10 @@ function contractDerivedKeys(definition) {
 var MAX_STEP_CONFIG_BYTES = 256 * 1024;
 var FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
 var MAX_DEPTH = 12;
+var PLATFORM_CONFIG_KEYS = {
+  flowId: { key: "flowId", label: "Flow", type: "string" /* String */, validation: { required: false } },
+  outputAs: { key: "outputAs", label: "Output as", type: "string" /* String */, validation: { required: false } }
+};
 function typeMatches(field, value) {
   if (value === null || value === undefined || value === "")
     return true;
@@ -5617,8 +5684,10 @@ function validateStepConfig(step) {
   const declared = new Map(contractFieldsFor(definition).map((f) => [f.key, f]));
   const entries = Object.entries(config);
   for (const [key, value] of entries) {
-    const field = declared.get(key);
+    const field = declared.get(key) ?? PLATFORM_CONFIG_KEYS[key];
     if (!field) {
+      if (isEditorPrivateKey(key))
+        continue;
       issues.push({
         severity: "warning",
         code: "UNDECLARED_FIELD",
@@ -5793,6 +5862,7 @@ export {
   NodeStatus,
   ONEDRIVE_OPERATIONS,
   OneDriveActionConfig,
+  PLATFORM_CONFIG_KEYS,
   QueryMode,
   QueryType,
   S3ActionConfig,
@@ -5800,6 +5870,7 @@ export {
   STORAGE_CONNECTOR_IDS,
   SortDirection,
   StorageActionConfig,
+  TRANSFORM_MODES,
   TRANSFORM_OPERATIONS,
   TransformConfig,
   USER_FUNCTION_PREFIX,
@@ -5841,6 +5912,7 @@ export {
   mappingTransformFunctionName,
   migrateDelayConfig,
   queryDefinition,
+  selectsWithoutValues,
   storageConfigKeys,
   storageOperations,
   summarizeConnectorTriggerEvents,

package/dist/rules/configContracts.d.ts

@@ -42,7 +42,23 @@ export type ContractFieldType = "string" | "text" | "select" | "json" | "connect
 export interface ContractField {
     type: string;
     required?: boolean;
+    /**
+     * The values a `select` accepts, when the set is fixed. `describe_action_type`
+     * lists them and the fence warns on a value outside them (`FIELD_BAD_OPTION`).
+     * A select with no `options` must say `dynamic: true` instead — the catalog
+     * test fails on one that says neither, because a select an agent cannot see
+     * the values of is a guess waiting to fail at run time (`mode: "append"` on a
+     * Transform, DEV-421).
+     */
     options?: ReadonlyArray<string | number>;
+    /**
+     * The values come from the customer's own system or from the upstream data
+     * (an object name, a sheet tab, an array path) — not from the catalog. Say
+     * where in `description`; `describe_connector_object` is the usual answer.
+     */
+    dynamic?: boolean;
+    /** Shown by the panel and by `describe_action_type`. */
+    description?: string;
     [extra: string]: unknown;
 }
 export interface ConfigContract {
@@ -80,6 +96,13 @@ export declare function isEditorPrivateKey(key: string): boolean;
  * editor should read.
  */
 export declare function contractFieldsFor(definition: ActionDefinition): FieldConfig[];
+/**
+ * Every `select` in a contract that names neither its `options` nor
+ * `dynamic: true`. A non-empty result is a bug: `describe_action_type` would
+ * show the field as a choice with nothing to choose from, and an agent would
+ * guess. The catalog test fails on any.
+ */
+export declare function selectsWithoutValues(actionId: string): string[];
 /**
  * `inputSchema` keys the contract does NOT know. A non-empty result is a bug:
  * `describe_action_type` is advertising a key the platform does not store under

package/dist/rules/configSafety.d.ts

@@ -33,8 +33,26 @@
  * An enumerated field's options are checked but only WARN, for the same
  * reason — see the note at that check.
  */
+import { type FieldConfig } from "../catalog/types";
 /** Largest config a single step may carry, serialised. */
 export declare const MAX_STEP_CONFIG_BYTES: number;
+/**
+ * Keys that belong to the PLATFORM, not to any action — on nearly every step,
+ * declared by no contract, and rightly so:
+ *
+ *   - `flowId`: NodeConfigPanel seeds every custom panel's config with the flow
+ *     it belongs to, and it is saved with the step;
+ *   - `outputAs`: the Engine reads it for EVERY step type — the step's key in
+ *     the run's data bag.
+ *
+ * Type-checked like a declared field; never reported as undeclared; never
+ * advertised by `contractFieldsFor` (an agent is told the action's own keys).
+ * Before this, every panel-built step raised one to four UNDECLARED_FIELD
+ * warnings for these and the editor's own `_` snapshots, which drowned the
+ * warnings that mean something — `connection` on a storage step, `message` on
+ * a Slack step (DEV-412).
+ */
+export declare const PLATFORM_CONFIG_KEYS: Readonly<Record<string, FieldConfig>>;
 export type ConfigIssueCode = "FORBIDDEN_KEY" | "CONFIG_TOO_LARGE" | "CONFIG_TOO_DEEP" | "FIELD_WRONG_TYPE" | "FIELD_BAD_OPTION" | "UNDECLARED_FIELD";
 export interface ConfigIssue {
     severity: "error" | "warning";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaviaflow/flow-rules",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "The flow action catalog and the rules engine behind Flow Doctor — one definition of what a step accepts and what makes a flow valid, shared by the editor and the server",
   "type": "module",
   "main": "./dist/index.cjs",