@lunnoa/client 2.2.0 → 2.4.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;
             };
@@ -825,6 +830,41 @@ interface components {
             /** @description Step description. */
             description?: string;
         };
+        UpsertWorkflowTriggerInputFieldDto: {
+            /** @description Field id. Callers pass this key to workflows.execute. */
+            id: string;
+            /** @description Label shown on the Manually Run form. */
+            label?: string;
+            description?: string;
+            /** @description text, number, date, or select. Defaults to text. */
+            inputType?: string;
+            /** @description true, or { missingMessage, missingStatus }. */
+            required?: boolean | {
+                [key: string]: unknown;
+            };
+            /** @description Used when the caller omits the field. */
+            defaultValue?: unknown;
+            selectOptions?: {
+                [key: string]: unknown;
+            }[];
+        };
+        UpsertWorkflowTriggerDto: {
+            /** @description Catalogue trigger id, for example flow-control_trigger_manual. */
+            triggerId: string;
+            /** @description Workflow app id. Inferred from triggerId when it contains _trigger_. */
+            appId?: string;
+            /** @description Connection instance UUID for this trigger. */
+            connectionId?: string;
+            /** @description Trigger config fields from the catalogue inputConfig. */
+            input?: {
+                [key: string]: unknown;
+            };
+            /** @description Manual-trigger fields. Stored on the trigger as customInputConfig. */
+            inputs?: components["schemas"]["UpsertWorkflowTriggerInputFieldDto"][];
+            /** @description Display name for the trigger node. */
+            name?: string;
+            description?: string;
+        };
         UpsertWorkflowBySlugDto: {
             /**
              * @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
@@ -836,6 +876,8 @@ interface components {
             description?: string;
             /** @description Whether the workflow is active. */
             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). */
             steps: components["schemas"]["UpsertWorkflowStepDto"][];
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
@@ -1938,6 +1980,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. */
@@ -2651,6 +2695,7 @@ declare const DEFINE_KINDS: {
     readonly connection: "connection";
     readonly aiConnection: "aiConnection";
     readonly action: "action";
+    readonly trigger: "trigger";
     readonly workflow: "workflow";
     readonly agent: "agent";
     readonly entityType: "entityType";
@@ -2685,10 +2730,52 @@ interface ActionDefinition {
     name?: string;
     description?: string;
 }
+/** One field on a Manually Run trigger. Stored as `customInputConfig`. */
+interface TriggerInputFieldDefinition {
+    /** Field id. Callers pass this key to `workflows.execute`. */
+    id: string;
+    label?: string;
+    description?: string;
+    /** `text`, `number`, `date`, or `select`. Defaults to `text` on deploy. */
+    inputType?: string;
+    required?: boolean | {
+        missingMessage?: string;
+        missingStatus?: string;
+    };
+    defaultValue?: unknown;
+    selectOptions?: Array<{
+        label?: string;
+        value?: string;
+    }>;
+}
+/** Ref to a catalogue trigger. Credentials stay on the connection, when one is set. */
+interface TriggerDefinition {
+    kind: typeof DEFINE_KINDS.trigger;
+    /**
+     * Catalogue trigger id, e.g. `flow-control_trigger_manual`.
+     * Discover with `apps get <appId> --json` (`triggers[].triggerId`).
+     */
+    id: string;
+    /** Workflow app id. Inferred from `id` when it matches `{app}_trigger_…`. */
+    appId?: string;
+    /** Optional Connection ref. Omit to let the platform resolve. */
+    connection?: ConnectionDefinition;
+    /** Catalogue trigger config (webhook method, schedule, app trigger fields). */
+    input?: Record<string, unknown>;
+    /** Manual-trigger fields. Stored as `customInputConfig`. */
+    inputs?: TriggerInputFieldDefinition[];
+    name?: string;
+    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;
 }
@@ -2699,6 +2786,11 @@ interface WorkflowDefinition {
     name?: string;
     description?: string;
     isActive?: boolean;
+    /**
+     * Catalogue trigger. Omit for Manually Run with no input fields.
+     * `runs.start` ignores this and runs the steps only.
+     */
+    trigger?: TriggerDefinition;
     /** Linear steps (v1; no branches). */
     steps: WorkflowStepDefinition[];
 }
@@ -3310,6 +3402,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -3462,6 +3556,8 @@ 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;
@@ -3469,11 +3565,24 @@ interface UpsertWorkflowStepInput {
     name?: string;
     description?: string;
 }
+interface UpsertWorkflowTriggerInput {
+    triggerId: string;
+    appId?: string;
+    connectionId?: string;
+    /** Catalogue trigger config. */
+    input?: Record<string, unknown>;
+    /** Manual-trigger fields. Stored as `customInputConfig`. */
+    inputs?: TriggerDefinition['inputs'];
+    name?: string;
+    description?: string;
+}
 interface UpsertWorkflowBySlugInput {
     slug: string;
     name?: string;
     description?: string;
     isActive?: boolean;
+    /** Omit for Manually Run with no input fields. */
+    trigger?: UpsertWorkflowTriggerInput;
     steps: UpsertWorkflowStepInput[];
     managedByCode?: boolean;
 }

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;
             };
@@ -825,6 +830,41 @@ interface components {
             /** @description Step description. */
             description?: string;
         };
+        UpsertWorkflowTriggerInputFieldDto: {
+            /** @description Field id. Callers pass this key to workflows.execute. */
+            id: string;
+            /** @description Label shown on the Manually Run form. */
+            label?: string;
+            description?: string;
+            /** @description text, number, date, or select. Defaults to text. */
+            inputType?: string;
+            /** @description true, or { missingMessage, missingStatus }. */
+            required?: boolean | {
+                [key: string]: unknown;
+            };
+            /** @description Used when the caller omits the field. */
+            defaultValue?: unknown;
+            selectOptions?: {
+                [key: string]: unknown;
+            }[];
+        };
+        UpsertWorkflowTriggerDto: {
+            /** @description Catalogue trigger id, for example flow-control_trigger_manual. */
+            triggerId: string;
+            /** @description Workflow app id. Inferred from triggerId when it contains _trigger_. */
+            appId?: string;
+            /** @description Connection instance UUID for this trigger. */
+            connectionId?: string;
+            /** @description Trigger config fields from the catalogue inputConfig. */
+            input?: {
+                [key: string]: unknown;
+            };
+            /** @description Manual-trigger fields. Stored on the trigger as customInputConfig. */
+            inputs?: components["schemas"]["UpsertWorkflowTriggerInputFieldDto"][];
+            /** @description Display name for the trigger node. */
+            name?: string;
+            description?: string;
+        };
         UpsertWorkflowBySlugDto: {
             /**
              * @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
@@ -836,6 +876,8 @@ interface components {
             description?: string;
             /** @description Whether the workflow is active. */
             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). */
             steps: components["schemas"]["UpsertWorkflowStepDto"][];
             /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
@@ -1938,6 +1980,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. */
@@ -2651,6 +2695,7 @@ declare const DEFINE_KINDS: {
     readonly connection: "connection";
     readonly aiConnection: "aiConnection";
     readonly action: "action";
+    readonly trigger: "trigger";
     readonly workflow: "workflow";
     readonly agent: "agent";
     readonly entityType: "entityType";
@@ -2685,10 +2730,52 @@ interface ActionDefinition {
     name?: string;
     description?: string;
 }
+/** One field on a Manually Run trigger. Stored as `customInputConfig`. */
+interface TriggerInputFieldDefinition {
+    /** Field id. Callers pass this key to `workflows.execute`. */
+    id: string;
+    label?: string;
+    description?: string;
+    /** `text`, `number`, `date`, or `select`. Defaults to `text` on deploy. */
+    inputType?: string;
+    required?: boolean | {
+        missingMessage?: string;
+        missingStatus?: string;
+    };
+    defaultValue?: unknown;
+    selectOptions?: Array<{
+        label?: string;
+        value?: string;
+    }>;
+}
+/** Ref to a catalogue trigger. Credentials stay on the connection, when one is set. */
+interface TriggerDefinition {
+    kind: typeof DEFINE_KINDS.trigger;
+    /**
+     * Catalogue trigger id, e.g. `flow-control_trigger_manual`.
+     * Discover with `apps get <appId> --json` (`triggers[].triggerId`).
+     */
+    id: string;
+    /** Workflow app id. Inferred from `id` when it matches `{app}_trigger_…`. */
+    appId?: string;
+    /** Optional Connection ref. Omit to let the platform resolve. */
+    connection?: ConnectionDefinition;
+    /** Catalogue trigger config (webhook method, schedule, app trigger fields). */
+    input?: Record<string, unknown>;
+    /** Manual-trigger fields. Stored as `customInputConfig`. */
+    inputs?: TriggerInputFieldDefinition[];
+    name?: string;
+    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;
 }
@@ -2699,6 +2786,11 @@ interface WorkflowDefinition {
     name?: string;
     description?: string;
     isActive?: boolean;
+    /**
+     * Catalogue trigger. Omit for Manually Run with no input fields.
+     * `runs.start` ignores this and runs the steps only.
+     */
+    trigger?: TriggerDefinition;
     /** Linear steps (v1; no branches). */
     steps: WorkflowStepDefinition[];
 }
@@ -3310,6 +3402,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -3462,6 +3556,8 @@ 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;
@@ -3469,11 +3565,24 @@ interface UpsertWorkflowStepInput {
     name?: string;
     description?: string;
 }
+interface UpsertWorkflowTriggerInput {
+    triggerId: string;
+    appId?: string;
+    connectionId?: string;
+    /** Catalogue trigger config. */
+    input?: Record<string, unknown>;
+    /** Manual-trigger fields. Stored as `customInputConfig`. */
+    inputs?: TriggerDefinition['inputs'];
+    name?: string;
+    description?: string;
+}
 interface UpsertWorkflowBySlugInput {
     slug: string;
     name?: string;
     description?: string;
     isActive?: boolean;
+    /** Omit for Manually Run with no input fields. */
+    trigger?: UpsertWorkflowTriggerInput;
     steps: UpsertWorkflowStepInput[];
     managedByCode?: boolean;
 }

package/dist/react.js

@@ -602,6 +602,40 @@ function resolveActionAppId(action) {
     `Cannot infer appId for action "${id}". Pass appId explicitly.`
   );
 }
+function resolveTriggerAppId(trigger) {
+  if (trigger.appId?.trim()) {
+    return trigger.appId.trim();
+  }
+  const id = trigger.id.trim();
+  const marker = "_trigger_";
+  const markerIndex = id.indexOf(marker);
+  if (markerIndex > 0) {
+    return id.slice(0, markerIndex);
+  }
+  const dot = id.indexOf(".");
+  if (dot > 0) {
+    return id.slice(0, dot);
+  }
+  throw new Error(
+    `Cannot infer appId for trigger "${id}". Pass appId explicitly.`
+  );
+}
+function resolveTriggerId(trigger) {
+  const id = trigger.id.trim();
+  const appId = trigger.appId?.trim();
+  if (appId && id.startsWith(`${appId}.`)) {
+    return id.slice(appId.length + 1);
+  }
+  const marker = "_trigger_";
+  if (id.includes(marker)) {
+    return id;
+  }
+  const dot = id.indexOf(".");
+  if (dot > 0) {
+    return id.slice(dot + 1);
+  }
+  return id;
+}
 function resolveActionId(action) {
   const id = action.id.trim();
   const appId = action.appId?.trim();
@@ -1814,7 +1848,9 @@ function stepFromDefinition(step) {
     ...use.input ?? {},
     ...step.input ?? {}
   };
+  const key = step.key;
   return {
+    ...key ? { key } : {},
     appId: resolveActionAppId(use),
     actionId: resolveActionId(use),
     ...use.connection?.id ? { connectionId: use.connection.id } : {},
@@ -2016,9 +2052,21 @@ var WorkflowAppsResource = class {
 };
 
 // src/resources/workflows.ts
+function triggerToUpsertInput(trigger) {
+  return {
+    triggerId: resolveTriggerId(trigger),
+    appId: resolveTriggerAppId(trigger),
+    ...trigger.connection?.id ? { connectionId: trigger.connection.id } : {},
+    ...trigger.input ? { input: trigger.input } : {},
+    ...trigger.inputs?.length ? { inputs: trigger.inputs } : {},
+    ...trigger.name ? { name: trigger.name } : {},
+    ...trigger.description ? { description: trigger.description } : {}
+  };
+}
 function stepToUpsertInput(step) {
   const use = step.use;
   return {
+    ...step.key ? { key: step.key } : {},
     appId: resolveActionAppId(use),
     actionId: resolveActionId(use),
     connectionId: use.connection?.id,
@@ -2036,6 +2084,7 @@ function workflowDefinitionToUpsert(def) {
     name: def.name,
     description: def.description,
     isActive: def.isActive,
+    ...def.trigger ? { trigger: triggerToUpsertInput(def.trigger) } : {},
     managedByCode: true,
     steps: def.steps.map(stepToUpsertInput)
   };