@lunnoa/client 2.2.0 → 2.4.0

package/dist/index.d.cts

@@ -715,7 +715,7 @@ interface paths {
         put?: never;
         /**
          * Upsert a workflow by slug from a linear step list
-         * @description Creates or updates a workflow identified by workspace-scoped `slug`. Builds a minimal valid graph (manual trigger → linear catalogue-action steps). Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client workflows deploy`) over calling this from application code.
+         * @description Creates or updates a workflow identified by workspace-scoped `slug`. Builds a minimal valid graph (one catalogue trigger, Manually Run when omitted, then linear catalogue-action steps). Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client workflows deploy`) over calling this from application code.
          */
         post: operations["WorkflowsController_upsertBySlug"];
         delete?: never;
@@ -2299,13 +2299,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;
             };
@@ -2314,6 +2319,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.
@@ -2325,6 +2365,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. */
@@ -3427,6 +3469,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. */
@@ -6605,6 +6649,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";
@@ -6640,10 +6685,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;
 }
@@ -6654,6 +6741,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[];
 }
@@ -6681,6 +6773,18 @@ interface AgentDefinition {
 declare function defineConnection(config?: Omit<ConnectionDefinition, 'kind'>): ConnectionDefinition;
 declare function defineAiConnection(config?: Omit<AiConnectionDefinition, 'kind'>): AiConnectionDefinition;
 declare function defineAction(config: Omit<ActionDefinition, 'kind'>): ActionDefinition;
+declare function defineTrigger(config: Omit<TriggerDefinition, 'kind'>): TriggerDefinition;
+/**
+ * References for step inputs. The server swaps them for the real node ids on
+ * deploy, and the builder shows them as mapped fields from earlier nodes.
+ * They are plain strings, so they also work inside text and nested objects.
+ */
+declare const ref: {
+    /** A trigger output field, e.g. a Manually Run input id. */
+    trigger: (field: string, ...path: Array<string | number>) => string;
+    /** An earlier step's output, by its `key`. Array indexes are numbers. */
+    step: (key: string, ...path: Array<string | number>) => string;
+};
 declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): WorkflowDefinition;
 declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
 interface EntityTypeDefinition {
@@ -6705,6 +6809,9 @@ interface EntityTypeDefinition {
 declare function defineEntityType(config: Omit<EntityTypeDefinition, 'kind'>): EntityTypeDefinition;
 /** Infer appId from catalogue action ids like `http_action_send-request`. */
 declare function resolveActionAppId(action: ActionDefinition): string;
+/** Infer appId from catalogue trigger ids like `flow-control_trigger_manual`. */
+declare function resolveTriggerAppId(trigger: TriggerDefinition): string;
+declare function resolveTriggerId(trigger: TriggerDefinition): string;
 declare function resolveActionId(action: ActionDefinition): string;
 
 interface UpsertAgentToolInput {
@@ -7276,6 +7383,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -7428,6 +7537,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;
@@ -7435,11 +7546,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;
 }
@@ -7668,4 +7792,4 @@ interface CreateServerClientOptions {
  */
 declare function createServerClient(options: CreateServerClientOptions): LunnoaClient;
 
-export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type AddQueueItemErrorInput, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnection, type AiConnectionDefinition, type AiConnectionModel, AiConnectionsResource, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeDefinition, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, type QueueItemStatus, QueueItemsResource, type QueueStats, QueuesResource, type RecordMeasureValueInput, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type Scorecard, type ScorecardMeasure, type ScorecardMeasureStatus, type ScorecardMeasureValue, type ScorecardObjective, type ScorecardSummary, ScorecardsResource, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Table, TablesResource, type Task, type TaskListItem, TasksResource, type TokenStore, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertEntityTypeBySlugInput, type UpsertTableBySlugInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, resolveActionAppId, resolveActionId };
+export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type AddQueueItemErrorInput, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnection, type AiConnectionDefinition, type AiConnectionModel, AiConnectionsResource, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeDefinition, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, type QueueItemStatus, QueueItemsResource, type QueueStats, QueuesResource, type RecordMeasureValueInput, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type Scorecard, type ScorecardMeasure, type ScorecardMeasureStatus, type ScorecardMeasureValue, type ScorecardObjective, type ScorecardSummary, ScorecardsResource, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Table, TablesResource, type Task, type TaskListItem, TasksResource, type TokenStore, type TriggerDefinition, type TriggerInputFieldDefinition, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertEntityTypeBySlugInput, type UpsertTableBySlugInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type UpsertWorkflowTriggerInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineTrigger, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, ref, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };

package/dist/index.d.ts

@@ -715,7 +715,7 @@ interface paths {
         put?: never;
         /**
          * Upsert a workflow by slug from a linear step list
-         * @description Creates or updates a workflow identified by workspace-scoped `slug`. Builds a minimal valid graph (manual trigger → linear catalogue-action steps). Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client workflows deploy`) over calling this from application code.
+         * @description Creates or updates a workflow identified by workspace-scoped `slug`. Builds a minimal valid graph (one catalogue trigger, Manually Run when omitted, then linear catalogue-action steps). Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client workflows deploy`) over calling this from application code.
          */
         post: operations["WorkflowsController_upsertBySlug"];
         delete?: never;
@@ -2299,13 +2299,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;
             };
@@ -2314,6 +2319,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.
@@ -2325,6 +2365,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. */
@@ -3427,6 +3469,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. */
@@ -6605,6 +6649,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";
@@ -6640,10 +6685,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;
 }
@@ -6654,6 +6741,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[];
 }
@@ -6681,6 +6773,18 @@ interface AgentDefinition {
 declare function defineConnection(config?: Omit<ConnectionDefinition, 'kind'>): ConnectionDefinition;
 declare function defineAiConnection(config?: Omit<AiConnectionDefinition, 'kind'>): AiConnectionDefinition;
 declare function defineAction(config: Omit<ActionDefinition, 'kind'>): ActionDefinition;
+declare function defineTrigger(config: Omit<TriggerDefinition, 'kind'>): TriggerDefinition;
+/**
+ * References for step inputs. The server swaps them for the real node ids on
+ * deploy, and the builder shows them as mapped fields from earlier nodes.
+ * They are plain strings, so they also work inside text and nested objects.
+ */
+declare const ref: {
+    /** A trigger output field, e.g. a Manually Run input id. */
+    trigger: (field: string, ...path: Array<string | number>) => string;
+    /** An earlier step's output, by its `key`. Array indexes are numbers. */
+    step: (key: string, ...path: Array<string | number>) => string;
+};
 declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): WorkflowDefinition;
 declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
 interface EntityTypeDefinition {
@@ -6705,6 +6809,9 @@ interface EntityTypeDefinition {
 declare function defineEntityType(config: Omit<EntityTypeDefinition, 'kind'>): EntityTypeDefinition;
 /** Infer appId from catalogue action ids like `http_action_send-request`. */
 declare function resolveActionAppId(action: ActionDefinition): string;
+/** Infer appId from catalogue trigger ids like `flow-control_trigger_manual`. */
+declare function resolveTriggerAppId(trigger: TriggerDefinition): string;
+declare function resolveTriggerId(trigger: TriggerDefinition): string;
 declare function resolveActionId(action: ActionDefinition): string;
 
 interface UpsertAgentToolInput {
@@ -7276,6 +7383,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -7428,6 +7537,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;
@@ -7435,11 +7546,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;
 }
@@ -7668,4 +7792,4 @@ interface CreateServerClientOptions {
  */
 declare function createServerClient(options: CreateServerClientOptions): LunnoaClient;
 
-export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type AddQueueItemErrorInput, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnection, type AiConnectionDefinition, type AiConnectionModel, AiConnectionsResource, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeDefinition, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, type QueueItemStatus, QueueItemsResource, type QueueStats, QueuesResource, type RecordMeasureValueInput, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type Scorecard, type ScorecardMeasure, type ScorecardMeasureStatus, type ScorecardMeasureValue, type ScorecardObjective, type ScorecardSummary, ScorecardsResource, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Table, TablesResource, type Task, type TaskListItem, TasksResource, type TokenStore, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertEntityTypeBySlugInput, type UpsertTableBySlugInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, resolveActionAppId, resolveActionId };
+export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type AddQueueItemErrorInput, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnection, type AiConnectionDefinition, type AiConnectionModel, AiConnectionsResource, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeDefinition, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, type QueueItemStatus, QueueItemsResource, type QueueStats, QueuesResource, type RecordMeasureValueInput, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type Scorecard, type ScorecardMeasure, type ScorecardMeasureStatus, type ScorecardMeasureValue, type ScorecardObjective, type ScorecardSummary, ScorecardsResource, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Table, TablesResource, type Task, type TaskListItem, TasksResource, type TokenStore, type TriggerDefinition, type TriggerInputFieldDefinition, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertEntityTypeBySlugInput, type UpsertTableBySlugInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type UpsertWorkflowTriggerInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineTrigger, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, ref, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };