@octaviaflow/flow-rules 0.13.0 → 0.13.2

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

@@ -43,6 +43,8 @@ export interface HTTPRequestConfigType {
     method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
     baseUrl?: string;
     url: string;
+    /** An OpenAPI connection: its base URL is joined to a relative `url` at run time. */
+    connectionId?: string;
     queryParams?: ApiKeyValue[];
     headers?: ApiKeyValue[] | Record<string, string>;
     bodyType?: 'none' | 'json' | 'raw' | 'form-data' | 'xml';

package/dist/catalog/ai/ai-agent/config.d.ts

@@ -39,6 +39,12 @@ export interface AiAgentConfigType {
      */
     input?: string;
     overrides?: AiAgentOverrides;
+    /**
+     * Per-row mode only: the most model calls the step may make (one per
+     * upstream row). Default 50, at most 1000 — a run with more rows stops
+     * before any call (DEV-428).
+     */
+    maxRows?: number;
 }
 export declare const AiAgentConfig: {
     defaults: AiAgentConfigType;
@@ -58,6 +64,12 @@ export declare const AiAgentConfig: {
             required: boolean;
             description: string;
         };
+        maxRows: {
+            type: string;
+            required: boolean;
+            min: number;
+            description: string;
+        };
     };
     validate: (config: Partial<AiAgentConfigType>) => {
         valid: boolean;

package/dist/index.cjs

@@ -1537,7 +1537,7 @@ var queryDefinition = {
         key: "visualConfig.limit",
         label: "Limit",
         type: "number" /* Number */,
-        description: "Maximum number of rows to return",
+        description: "Rows the PREVIEW shows. A run never reads it — set visualConfig.maxRows to cap a run.",
         defaultValue: 10,
         validation: { required: false, min: 1, max: 1e4 },
         conditional: [
@@ -1549,6 +1549,22 @@ var queryDefinition = {
           }
         ]
       },
+      {
+        key: "visualConfig.maxRows",
+        label: "Max rows (run)",
+        type: "number" /* Number */,
+        description: "The most rows a run reads (up to 10,000). Unset: 10,000. The Limit above is preview-only.",
+        validation: { required: false, min: 1, max: 1e4 },
+        advanced: true,
+        conditional: [
+          {
+            field: "mode",
+            operator: "==",
+            value: "visual" /* Visual */,
+            action: "show"
+          }
+        ]
+      },
       {
         key: "sqlConfig.sql",
         label: "SQL Query",
@@ -1595,7 +1611,7 @@ var queryDefinition = {
         key: "maxRows",
         label: "Max Rows",
         type: "number" /* Number */,
-        description: "Maximum number of rows to return",
+        description: "Legacy step-level field — NOT read at run. Cap a visual Query with visualConfig.maxRows; in SQL mode write a LIMIT.",
         defaultValue: 1000,
         validation: { required: false, min: 1, max: 1e4 },
         advanced: true
@@ -2712,7 +2728,7 @@ var graphqlQueryDefinition = {
 var 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.",
+  description: "Run a reusable AI agent. Pick a saved agent from /ai/agents; optionally override model, temperature, or instructions per step. " + "When the step before it produces rows (a Query, a Transform), the agent runs ONCE PER ROW with the prompt as the per-row template — " + "reference single fields, never the whole table; put an Aggregate first to call it once. maxRows (default 50) caps the calls.",
   category: "ai" /* AI */,
   type: "ai_agent" /* AIAgent */,
   tags: ["ai", "agent", "chat", "built-in"],
@@ -2732,21 +2748,28 @@ var aiAgentDefinition = {
         key: "input",
         label: "Input",
         type: "string" /* String */,
-        description: "Chat agents: a string (template-supported via {{step.field}}). ETL agents: rows array. When blank, falls back to upstream step output."
+        description: "The prompt. Over a row-shaped upstream it is the per-row template: each data reference resolves to the current row. " + "A reference to the whole upstream table is refused. When blank, the upstream output is the input."
       },
       {
         key: "overrides",
         label: "Overrides",
         type: "json" /* JSON */,
         description: "Optional per-step overrides of the agent’s own settings: model, temperature, maxTokens, topP, instructions and instructionsMode."
+      },
+      {
+        key: "maxRows",
+        label: "Max rows",
+        type: "number" /* Number */,
+        description: "Per-row mode: the most model calls this step may make, one per upstream row (default 50, at most 1000)."
       }
     ]
   },
   outputSchema: {
     type: "object",
     properties: [
-      { key: "text", type: "string" /* String */, description: "Agent response text (chat agents)" },
-      { key: "rows", type: "json" /* JSON */, description: "Output rows (etl agents)" },
+      { key: "text", type: "string" /* String */, description: "Agent response text; in per-row mode, one line per row" },
+      { key: "output", type: "json" /* JSON */, description: "The parsed answer (an object when the agent replies in JSON); in per-row mode, one entry per row" },
+      { key: "rows", type: "json" /* JSON */, description: "Per-row mode: one entry per upstream row" },
       { key: "usage", type: "json" /* JSON */, description: "Token usage + cost: tokensIn, tokensOut, latencyMs, costUsd" },
       { key: "model", type: "string" /* String */, description: "Model that produced the response" },
       { key: "agentVersion", type: "number" /* Number */, description: "Version of the agent definition that ran" }
@@ -4019,7 +4042,7 @@ var AggregateConfig = {
     outputAs: {
       type: "string",
       required: false,
-      description: "The name later steps use for this result, e.g. totals → {{totals[].TotalAmount}}. Defaults to the step name."
+      description: "The name later steps use for this result, e.g. totals → {{totals[].TotalAmount}} in a Transform mapping. " + "A message or AI prompt reads it as {{ods://steps/<this step id>/output/data[0]/TotalAmount}} — the mapping form is not resolved there. " + "Defaults to the step name."
     }
   },
   defaults: {
@@ -4318,7 +4341,18 @@ var STORAGE_PROVIDERS = {
     operations: [
       { value: "list", label: "List files", path: { key: "folderId", label: "Folder", selectMode: "folder" }, fields: [{ key: "query", label: "Search query", type: "string", advanced: true }, { key: "pageSize", label: "Max results", type: "number", defaultValue: 50, advanced: true }] },
       { value: "download", label: "Download file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "folderId", label: "Destination folder", selectMode: "both" }, content: true, fields: [{ key: "fileName", label: "File name", type: "string", required: true }, { key: "mimeType", label: "Content type", type: "string", advanced: true }] },
+      {
+        value: "upload",
+        label: "Upload file",
+        path: { key: "folderId", label: "Destination folder", selectMode: "both" },
+        content: true,
+        fields: [
+          { key: "fileName", label: "File name", type: "string", required: true },
+          { key: "folderName", label: "Folder path", type: "string", advanced: true, placeholder: "Reports/2026", hint: "Folders under My Drive, separated by /. Missing ones are created on the first run. Ignored when a destination folder is picked." },
+          { key: "ifExists", label: "If the file already exists", type: "select", options: [{ label: "Replace it (Drive keeps the versions)", value: "overwrite" }, { label: "Skip it", value: "skip" }, { label: "Keep both (rename)", value: "rename" }], defaultValue: "overwrite", advanced: true },
+          { key: "mimeType", label: "Content type", type: "string", advanced: true }
+        ]
+      },
       { value: "delete", label: "Delete file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
       { value: "move", label: "Move", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both", required: true } },
       { value: "copy", label: "Copy", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both" }, fields: [{ key: "fileName", label: "New name", type: "string" }] },
@@ -4437,7 +4471,13 @@ var AiAgentConfig = {
   schema: {
     agentId: { type: "string", required: true, description: "Public id of a saved agent (agt_…)" },
     input: { type: "text", required: false, description: "The prompt; may reference upstream data with {{ods://…}} tokens. Empty uses the first upstream output." },
-    overrides: { type: "object", required: false, description: "Per-step overrides: model, temperature, topP, maxTokens, reasoningEffort, verbosity, batchSize, instructions, instructionsMode, expectedSchema" }
+    overrides: { type: "object", required: false, description: "Per-step overrides: model, temperature, topP, maxTokens, reasoningEffort, verbosity, batchSize, instructions, instructionsMode, expectedSchema" },
+    maxRows: {
+      type: "number",
+      required: false,
+      min: 1,
+      description: "Per-row mode: the most model calls this step may make, one per upstream row (default 50, at most 1000). More rows stop the step before any call."
+    }
   },
   validate: (config) => {
     const errors = [];
@@ -4446,6 +4486,9 @@ var AiAgentConfig = {
     if (config.overrides !== undefined && (typeof config.overrides !== "object" || config.overrides === null || Array.isArray(config.overrides))) {
       errors.push("overrides must be an object");
     }
+    if (config.maxRows !== undefined && !(Number.isInteger(config.maxRows) && config.maxRows >= 1 && config.maxRows <= 1000)) {
+      errors.push("maxRows must be a whole number from 1 to 1000");
+    }
     return { valid: errors.length === 0, errors };
   },
   merge: (userConfig) => ({ ...AiAgentConfig.defaults, ...userConfig }),
@@ -5510,6 +5553,13 @@ var DelayConfig = {
 };
 
 // src/catalog/actions/http-request/config.ts
+function urlCheckedAtRunTime(url, connectionId) {
+  const u = url.trim();
+  if (u.startsWith("{{"))
+    return true;
+  const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(u);
+  return !!connectionId && !hasScheme;
+}
 var HTTPRequestConfig = {
   defaults: {
     apiType: "rest",
@@ -5587,7 +5637,7 @@ var HTTPRequestConfig = {
     }
     if (!config.url) {
       errors.push("URL is required");
-    } else if (typeof config.url === "string") {
+    } else if (typeof config.url === "string" && !urlCheckedAtRunTime(config.url, config.connectionId)) {
       try {
         new URL(config.url);
       } catch {

package/dist/index.js

@@ -1374,7 +1374,7 @@ var queryDefinition = {
         key: "visualConfig.limit",
         label: "Limit",
         type: "number" /* Number */,
-        description: "Maximum number of rows to return",
+        description: "Rows the PREVIEW shows. A run never reads it — set visualConfig.maxRows to cap a run.",
         defaultValue: 10,
         validation: { required: false, min: 1, max: 1e4 },
         conditional: [
@@ -1386,6 +1386,22 @@ var queryDefinition = {
           }
         ]
       },
+      {
+        key: "visualConfig.maxRows",
+        label: "Max rows (run)",
+        type: "number" /* Number */,
+        description: "The most rows a run reads (up to 10,000). Unset: 10,000. The Limit above is preview-only.",
+        validation: { required: false, min: 1, max: 1e4 },
+        advanced: true,
+        conditional: [
+          {
+            field: "mode",
+            operator: "==",
+            value: "visual" /* Visual */,
+            action: "show"
+          }
+        ]
+      },
       {
         key: "sqlConfig.sql",
         label: "SQL Query",
@@ -1432,7 +1448,7 @@ var queryDefinition = {
         key: "maxRows",
         label: "Max Rows",
         type: "number" /* Number */,
-        description: "Maximum number of rows to return",
+        description: "Legacy step-level field — NOT read at run. Cap a visual Query with visualConfig.maxRows; in SQL mode write a LIMIT.",
         defaultValue: 1000,
         validation: { required: false, min: 1, max: 1e4 },
         advanced: true
@@ -2549,7 +2565,7 @@ var graphqlQueryDefinition = {
 var 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.",
+  description: "Run a reusable AI agent. Pick a saved agent from /ai/agents; optionally override model, temperature, or instructions per step. " + "When the step before it produces rows (a Query, a Transform), the agent runs ONCE PER ROW with the prompt as the per-row template — " + "reference single fields, never the whole table; put an Aggregate first to call it once. maxRows (default 50) caps the calls.",
   category: "ai" /* AI */,
   type: "ai_agent" /* AIAgent */,
   tags: ["ai", "agent", "chat", "built-in"],
@@ -2569,21 +2585,28 @@ var aiAgentDefinition = {
         key: "input",
         label: "Input",
         type: "string" /* String */,
-        description: "Chat agents: a string (template-supported via {{step.field}}). ETL agents: rows array. When blank, falls back to upstream step output."
+        description: "The prompt. Over a row-shaped upstream it is the per-row template: each data reference resolves to the current row. " + "A reference to the whole upstream table is refused. When blank, the upstream output is the input."
       },
       {
         key: "overrides",
         label: "Overrides",
         type: "json" /* JSON */,
         description: "Optional per-step overrides of the agent’s own settings: model, temperature, maxTokens, topP, instructions and instructionsMode."
+      },
+      {
+        key: "maxRows",
+        label: "Max rows",
+        type: "number" /* Number */,
+        description: "Per-row mode: the most model calls this step may make, one per upstream row (default 50, at most 1000)."
       }
     ]
   },
   outputSchema: {
     type: "object",
     properties: [
-      { key: "text", type: "string" /* String */, description: "Agent response text (chat agents)" },
-      { key: "rows", type: "json" /* JSON */, description: "Output rows (etl agents)" },
+      { key: "text", type: "string" /* String */, description: "Agent response text; in per-row mode, one line per row" },
+      { key: "output", type: "json" /* JSON */, description: "The parsed answer (an object when the agent replies in JSON); in per-row mode, one entry per row" },
+      { key: "rows", type: "json" /* JSON */, description: "Per-row mode: one entry per upstream row" },
       { key: "usage", type: "json" /* JSON */, description: "Token usage + cost: tokensIn, tokensOut, latencyMs, costUsd" },
       { key: "model", type: "string" /* String */, description: "Model that produced the response" },
       { key: "agentVersion", type: "number" /* Number */, description: "Version of the agent definition that ran" }
@@ -3856,7 +3879,7 @@ var AggregateConfig = {
     outputAs: {
       type: "string",
       required: false,
-      description: "The name later steps use for this result, e.g. totals → {{totals[].TotalAmount}}. Defaults to the step name."
+      description: "The name later steps use for this result, e.g. totals → {{totals[].TotalAmount}} in a Transform mapping. " + "A message or AI prompt reads it as {{ods://steps/<this step id>/output/data[0]/TotalAmount}} — the mapping form is not resolved there. " + "Defaults to the step name."
     }
   },
   defaults: {
@@ -4155,7 +4178,18 @@ var STORAGE_PROVIDERS = {
     operations: [
       { value: "list", label: "List files", path: { key: "folderId", label: "Folder", selectMode: "folder" }, fields: [{ key: "query", label: "Search query", type: "string", advanced: true }, { key: "pageSize", label: "Max results", type: "number", defaultValue: 50, advanced: true }] },
       { value: "download", label: "Download file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
-      { value: "upload", label: "Upload file", path: { key: "folderId", label: "Destination folder", selectMode: "both" }, content: true, fields: [{ key: "fileName", label: "File name", type: "string", required: true }, { key: "mimeType", label: "Content type", type: "string", advanced: true }] },
+      {
+        value: "upload",
+        label: "Upload file",
+        path: { key: "folderId", label: "Destination folder", selectMode: "both" },
+        content: true,
+        fields: [
+          { key: "fileName", label: "File name", type: "string", required: true },
+          { key: "folderName", label: "Folder path", type: "string", advanced: true, placeholder: "Reports/2026", hint: "Folders under My Drive, separated by /. Missing ones are created on the first run. Ignored when a destination folder is picked." },
+          { key: "ifExists", label: "If the file already exists", type: "select", options: [{ label: "Replace it (Drive keeps the versions)", value: "overwrite" }, { label: "Skip it", value: "skip" }, { label: "Keep both (rename)", value: "rename" }], defaultValue: "overwrite", advanced: true },
+          { key: "mimeType", label: "Content type", type: "string", advanced: true }
+        ]
+      },
       { value: "delete", label: "Delete file", path: { key: "fileId", label: "File", selectMode: "both", required: true } },
       { value: "move", label: "Move", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both", required: true } },
       { value: "copy", label: "Copy", path: { key: "fileId", label: "File", selectMode: "both", required: true }, dest: { key: "destFolderId", label: "Destination folder", selectMode: "both" }, fields: [{ key: "fileName", label: "New name", type: "string" }] },
@@ -4274,7 +4308,13 @@ var AiAgentConfig = {
   schema: {
     agentId: { type: "string", required: true, description: "Public id of a saved agent (agt_…)" },
     input: { type: "text", required: false, description: "The prompt; may reference upstream data with {{ods://…}} tokens. Empty uses the first upstream output." },
-    overrides: { type: "object", required: false, description: "Per-step overrides: model, temperature, topP, maxTokens, reasoningEffort, verbosity, batchSize, instructions, instructionsMode, expectedSchema" }
+    overrides: { type: "object", required: false, description: "Per-step overrides: model, temperature, topP, maxTokens, reasoningEffort, verbosity, batchSize, instructions, instructionsMode, expectedSchema" },
+    maxRows: {
+      type: "number",
+      required: false,
+      min: 1,
+      description: "Per-row mode: the most model calls this step may make, one per upstream row (default 50, at most 1000). More rows stop the step before any call."
+    }
   },
   validate: (config) => {
     const errors = [];
@@ -4283,6 +4323,9 @@ var AiAgentConfig = {
     if (config.overrides !== undefined && (typeof config.overrides !== "object" || config.overrides === null || Array.isArray(config.overrides))) {
       errors.push("overrides must be an object");
     }
+    if (config.maxRows !== undefined && !(Number.isInteger(config.maxRows) && config.maxRows >= 1 && config.maxRows <= 1000)) {
+      errors.push("maxRows must be a whole number from 1 to 1000");
+    }
     return { valid: errors.length === 0, errors };
   },
   merge: (userConfig) => ({ ...AiAgentConfig.defaults, ...userConfig }),
@@ -5347,6 +5390,13 @@ var DelayConfig = {
 };
 
 // src/catalog/actions/http-request/config.ts
+function urlCheckedAtRunTime(url, connectionId) {
+  const u = url.trim();
+  if (u.startsWith("{{"))
+    return true;
+  const hasScheme = /^[a-z][a-z0-9+.-]*:/i.test(u);
+  return !!connectionId && !hasScheme;
+}
 var HTTPRequestConfig = {
   defaults: {
     apiType: "rest",
@@ -5424,7 +5474,7 @@ var HTTPRequestConfig = {
     }
     if (!config.url) {
       errors.push("URL is required");
-    } else if (typeof config.url === "string") {
+    } else if (typeof config.url === "string" && !urlCheckedAtRunTime(config.url, config.connectionId)) {
       try {
         new URL(config.url);
       } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octaviaflow/flow-rules",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "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",