@lunnoa/client 2.3.0 → 2.5.0

package/dist/react.d.cts

@@ -810,13 +810,18 @@ interface components {
             requestedCount: number;
         };
         UpsertWorkflowStepDto: {
+            /**
+             * @description Name later steps use in ={{step:<key>,path}}. Keyed steps keep their node id across deploys. "trigger" is reserved.
+             * @example loadCase
+             */
+            key?: string;
             /** @description Workflow app id (catalogue slug). */
             appId: string;
             /** @description Catalogue action id. */
             actionId: string;
             /** @description Connection instance UUID for this step. */
             connectionId?: string;
-            /** @description Action input / config fields. */
+            /** @description Action input / config fields. String values may use ={{step:trigger,field}} or ={{step:<key>,path,to,value}}. */
             input?: {
                 [key: string]: unknown;
             };
@@ -824,6 +829,24 @@ interface components {
             name?: string;
             /** @description Step description. */
             description?: string;
+            /** @description Branches after this step. Only on flow-control_action_conditional-paths, flow-control_action_manually-decide-paths, or flow-control_action_request-approval (approved path first, then rejected), and only on the last step of a list. */
+            paths?: components["schemas"]["UpsertWorkflowPathDto"][];
+        };
+        UpsertWorkflowPathConditionDto: {
+            /** @description One step reference, e.g. ={{step:load,amount}}. */
+            field: string;
+            /** @description contains, does_not_contain, equals, does_not_equal, exists, does_not_exist, starts_with, ends_with, is_empty, is_not_empty, comes_before, comes_after, is_in_the_past, is_in_the_future, is_true, is_false, is_truthy, is_falsey, is_greater_than, is_less_than, is_greater_than_or_equal_to, is_less_than_or_equal_to, matches_regex, does_not_match_regex. */
+            condition: string;
+            /** @description Value to compare with. */
+            value?: string;
+        };
+        UpsertWorkflowPathDto: {
+            /** @description Path label, unique on its step. */
+            label: string;
+            /** @description Conditional Paths only. Groups are OR-ed, conditions inside a group AND-ed. Omit to always take this path. */
+            when?: components["schemas"]["UpsertWorkflowPathConditionDto"][][];
+            /** @description Steps on this path. */
+            steps: components["schemas"]["UpsertWorkflowStepDto"][];
         };
         UpsertWorkflowTriggerInputFieldDto: {
             /** @description Field id. Callers pass this key to workflows.execute. */
@@ -873,7 +896,7 @@ interface components {
             isActive?: boolean;
             /** @description Catalogue trigger. Omit for a Manually Run trigger with no input fields. */
             trigger?: components["schemas"]["UpsertWorkflowTriggerDto"];
-            /** @description Linear catalogue-action steps (v1; no branches). */
+            /** @description Catalogue-action steps in order. The last step may branch with `paths`. */
             steps: components["schemas"]["UpsertWorkflowStepDto"][];
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
             managedByCode?: boolean;
@@ -1975,6 +1998,8 @@ interface components {
             executionPath?: components["schemas"]["ExecutionPathStepDto"][];
         };
         RunStepDto: {
+            /** @description Name later steps use in ={{step:<key>,path}}. Ad-hoc runs have no trigger. */
+            key?: string;
             /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
             appId: string;
             /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps. */
@@ -2761,11 +2786,42 @@ interface TriggerDefinition {
     description?: string;
 }
 interface WorkflowStepDefinition {
+    /**
+     * Name later steps use with `ref.step(key, ...)`. Keyed steps keep their
+     * node id across deploys. `trigger` is reserved.
+     */
+    key?: string;
     /** Action definition (or inline action-shaped object). */
     use: ActionDefinition;
-    /** Per-step input overrides. */
+    /** Per-step input overrides. Values may contain `ref.trigger` / `ref.step`. */
     input?: Record<string, unknown>;
     name?: string;
+    /**
+     * Branches after this step. Only on Conditional Paths, Manually Decide Path,
+     * or Request Approval (approved path first, then rejected), and only on the
+     * last step of a list. Put later steps inside each path.
+     */
+    paths?: WorkflowPathDefinition[];
+}
+/** Conditions Conditional Paths evaluates (same list as the builder). */
+declare const PATH_CONDITIONS: readonly ["contains", "does_not_contain", "equals", "does_not_equal", "exists", "does_not_exist", "starts_with", "ends_with", "is_empty", "is_not_empty", "comes_before", "comes_after", "is_in_the_past", "is_in_the_future", "is_true", "is_false", "is_truthy", "is_falsey", "is_greater_than", "is_less_than", "is_greater_than_or_equal_to", "is_less_than_or_equal_to", "matches_regex", "does_not_match_regex"];
+type PathConditionType = (typeof PATH_CONDITIONS)[number];
+interface PathCondition {
+    /** One reference: `ref.trigger(...)` or `ref.step(...)`. */
+    field: string;
+    condition: PathConditionType;
+    /** Compared as text. Omit for exists / is_empty / is_true and similar. */
+    value?: string;
+}
+interface WorkflowPathDefinition {
+    /** Unique on its step. On Request Approval use `Approved` / `Rejected`. */
+    label: string;
+    /**
+     * Conditional Paths only. Groups are OR-ed, conditions in a group AND-ed.
+     * Omit to always take this path.
+     */
+    when?: PathCondition[][];
+    steps: WorkflowStepDefinition[];
 }
 interface WorkflowDefinition {
     kind: typeof DEFINE_KINDS.workflow;
@@ -2779,7 +2835,7 @@ interface WorkflowDefinition {
      * `runs.start` ignores this and runs the steps only.
      */
     trigger?: TriggerDefinition;
-    /** Linear steps (v1; no branches). */
+    /** Steps in order. The last step may branch with `paths`. */
     steps: WorkflowStepDefinition[];
 }
 type AgentToolDefinition = ActionDefinition | WorkflowDefinition | {
@@ -3390,6 +3446,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -3542,12 +3600,21 @@ declare class VariablesResource {
 }
 
 interface UpsertWorkflowStepInput {
+    /** Name later steps use in `={{step:<key>,path}}`. Keeps the node id stable. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
     input?: Record<string, unknown>;
     name?: string;
     description?: string;
+    /** Branches after this step (last step of a list only). */
+    paths?: UpsertWorkflowPathInput[];
+}
+interface UpsertWorkflowPathInput {
+    label: string;
+    when?: WorkflowPathDefinition['when'];
+    steps: UpsertWorkflowStepInput[];
 }
 interface UpsertWorkflowTriggerInput {
     triggerId: string;

package/dist/react.d.ts

@@ -810,13 +810,18 @@ interface components {
             requestedCount: number;
         };
         UpsertWorkflowStepDto: {
+            /**
+             * @description Name later steps use in ={{step:<key>,path}}. Keyed steps keep their node id across deploys. "trigger" is reserved.
+             * @example loadCase
+             */
+            key?: string;
             /** @description Workflow app id (catalogue slug). */
             appId: string;
             /** @description Catalogue action id. */
             actionId: string;
             /** @description Connection instance UUID for this step. */
             connectionId?: string;
-            /** @description Action input / config fields. */
+            /** @description Action input / config fields. String values may use ={{step:trigger,field}} or ={{step:<key>,path,to,value}}. */
             input?: {
                 [key: string]: unknown;
             };
@@ -824,6 +829,24 @@ interface components {
             name?: string;
             /** @description Step description. */
             description?: string;
+            /** @description Branches after this step. Only on flow-control_action_conditional-paths, flow-control_action_manually-decide-paths, or flow-control_action_request-approval (approved path first, then rejected), and only on the last step of a list. */
+            paths?: components["schemas"]["UpsertWorkflowPathDto"][];
+        };
+        UpsertWorkflowPathConditionDto: {
+            /** @description One step reference, e.g. ={{step:load,amount}}. */
+            field: string;
+            /** @description contains, does_not_contain, equals, does_not_equal, exists, does_not_exist, starts_with, ends_with, is_empty, is_not_empty, comes_before, comes_after, is_in_the_past, is_in_the_future, is_true, is_false, is_truthy, is_falsey, is_greater_than, is_less_than, is_greater_than_or_equal_to, is_less_than_or_equal_to, matches_regex, does_not_match_regex. */
+            condition: string;
+            /** @description Value to compare with. */
+            value?: string;
+        };
+        UpsertWorkflowPathDto: {
+            /** @description Path label, unique on its step. */
+            label: string;
+            /** @description Conditional Paths only. Groups are OR-ed, conditions inside a group AND-ed. Omit to always take this path. */
+            when?: components["schemas"]["UpsertWorkflowPathConditionDto"][][];
+            /** @description Steps on this path. */
+            steps: components["schemas"]["UpsertWorkflowStepDto"][];
         };
         UpsertWorkflowTriggerInputFieldDto: {
             /** @description Field id. Callers pass this key to workflows.execute. */
@@ -873,7 +896,7 @@ interface components {
             isActive?: boolean;
             /** @description Catalogue trigger. Omit for a Manually Run trigger with no input fields. */
             trigger?: components["schemas"]["UpsertWorkflowTriggerDto"];
-            /** @description Linear catalogue-action steps (v1; no branches). */
+            /** @description Catalogue-action steps in order. The last step may branch with `paths`. */
             steps: components["schemas"]["UpsertWorkflowStepDto"][];
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
             managedByCode?: boolean;
@@ -1975,6 +1998,8 @@ interface components {
             executionPath?: components["schemas"]["ExecutionPathStepDto"][];
         };
         RunStepDto: {
+            /** @description Name later steps use in ={{step:<key>,path}}. Ad-hoc runs have no trigger. */
+            key?: string;
             /** @description Workflow app id (catalogue slug), e.g. `http`, `gmail`. */
             appId: string;
             /** @description Action id within the app, e.g. `http_action_send-request`. Discover via GET /workflow-apps. */
@@ -2761,11 +2786,42 @@ interface TriggerDefinition {
     description?: string;
 }
 interface WorkflowStepDefinition {
+    /**
+     * Name later steps use with `ref.step(key, ...)`. Keyed steps keep their
+     * node id across deploys. `trigger` is reserved.
+     */
+    key?: string;
     /** Action definition (or inline action-shaped object). */
     use: ActionDefinition;
-    /** Per-step input overrides. */
+    /** Per-step input overrides. Values may contain `ref.trigger` / `ref.step`. */
     input?: Record<string, unknown>;
     name?: string;
+    /**
+     * Branches after this step. Only on Conditional Paths, Manually Decide Path,
+     * or Request Approval (approved path first, then rejected), and only on the
+     * last step of a list. Put later steps inside each path.
+     */
+    paths?: WorkflowPathDefinition[];
+}
+/** Conditions Conditional Paths evaluates (same list as the builder). */
+declare const PATH_CONDITIONS: readonly ["contains", "does_not_contain", "equals", "does_not_equal", "exists", "does_not_exist", "starts_with", "ends_with", "is_empty", "is_not_empty", "comes_before", "comes_after", "is_in_the_past", "is_in_the_future", "is_true", "is_false", "is_truthy", "is_falsey", "is_greater_than", "is_less_than", "is_greater_than_or_equal_to", "is_less_than_or_equal_to", "matches_regex", "does_not_match_regex"];
+type PathConditionType = (typeof PATH_CONDITIONS)[number];
+interface PathCondition {
+    /** One reference: `ref.trigger(...)` or `ref.step(...)`. */
+    field: string;
+    condition: PathConditionType;
+    /** Compared as text. Omit for exists / is_empty / is_true and similar. */
+    value?: string;
+}
+interface WorkflowPathDefinition {
+    /** Unique on its step. On Request Approval use `Approved` / `Rejected`. */
+    label: string;
+    /**
+     * Conditional Paths only. Groups are OR-ed, conditions in a group AND-ed.
+     * Omit to always take this path.
+     */
+    when?: PathCondition[][];
+    steps: WorkflowStepDefinition[];
 }
 interface WorkflowDefinition {
     kind: typeof DEFINE_KINDS.workflow;
@@ -2779,7 +2835,7 @@ interface WorkflowDefinition {
      * `runs.start` ignores this and runs the steps only.
      */
     trigger?: TriggerDefinition;
-    /** Linear steps (v1; no branches). */
+    /** Steps in order. The last step may branch with `paths`. */
     steps: WorkflowStepDefinition[];
 }
 type AgentToolDefinition = ActionDefinition | WorkflowDefinition | {
@@ -3390,6 +3446,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -3542,12 +3600,21 @@ declare class VariablesResource {
 }
 
 interface UpsertWorkflowStepInput {
+    /** Name later steps use in `={{step:<key>,path}}`. Keeps the node id stable. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
     input?: Record<string, unknown>;
     name?: string;
     description?: string;
+    /** Branches after this step (last step of a list only). */
+    paths?: UpsertWorkflowPathInput[];
+}
+interface UpsertWorkflowPathInput {
+    label: string;
+    when?: WorkflowPathDefinition['when'];
+    steps: UpsertWorkflowStepInput[];
 }
 interface UpsertWorkflowTriggerInput {
     triggerId: string;

package/dist/react.js

@@ -584,6 +584,33 @@ var ActionsResource = class {
 var DEFINE_KINDS = {
   action: "action",
   workflow: "workflow"};
+var PATH_CONDITIONS = [
+  "contains",
+  "does_not_contain",
+  "equals",
+  "does_not_equal",
+  "exists",
+  "does_not_exist",
+  "starts_with",
+  "ends_with",
+  "is_empty",
+  "is_not_empty",
+  "comes_before",
+  "comes_after",
+  "is_in_the_past",
+  "is_in_the_future",
+  "is_true",
+  "is_false",
+  "is_truthy",
+  "is_falsey",
+  "is_greater_than",
+  "is_less_than",
+  "is_greater_than_or_equal_to",
+  "is_less_than_or_equal_to",
+  "matches_regex",
+  "does_not_match_regex"
+];
+new Set(PATH_CONDITIONS);
 function resolveActionAppId(action) {
   if (action.appId?.trim()) {
     return action.appId.trim();
@@ -1843,12 +1870,19 @@ function stepFromDefinition(step) {
       ...step.name ? { name: step.name } : {}
     };
   }
+  if (step.paths?.length) {
+    throw new Error(
+      "runs.start runs straight lines only. Deploy workflows with paths, then execute them."
+    );
+  }
   const use = step.use;
   const input = {
     ...use.input ?? {},
     ...step.input ?? {}
   };
+  const key = step.key;
   return {
+    ...key ? { key } : {},
     appId: resolveActionAppId(use),
     actionId: resolveActionId(use),
     ...use.connection?.id ? { connectionId: use.connection.id } : {},
@@ -2064,6 +2098,7 @@ function triggerToUpsertInput(trigger) {
 function stepToUpsertInput(step) {
   const use = step.use;
   return {
+    ...step.key ? { key: step.key } : {},
     appId: resolveActionAppId(use),
     actionId: resolveActionId(use),
     connectionId: use.connection?.id,
@@ -2072,7 +2107,14 @@ function stepToUpsertInput(step) {
       ...step.input ?? {}
     },
     name: step.name ?? use.name,
-    description: use.description
+    description: use.description,
+    ...step.paths?.length ? {
+      paths: step.paths.map((path) => ({
+        label: path.label,
+        ...path.when ? { when: path.when } : {},
+        steps: path.steps.map(stepToUpsertInput)
+      }))
+    } : {}
   };
 }
 function workflowDefinitionToUpsert(def) {