@lunnoa/client 2.3.0 → 2.4.0

package/dist/index.d.cts

@@ -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;
             };
@@ -3464,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. */
@@ -6716,9 +6723,14 @@ 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;
 }
@@ -6762,6 +6774,17 @@ declare function defineConnection(config?: Omit<ConnectionDefinition, 'kind'>):
 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 {
@@ -7360,6 +7383,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -7512,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;
@@ -7765,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 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, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };
+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

@@ -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;
             };
@@ -3464,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. */
@@ -6716,9 +6723,14 @@ 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;
 }
@@ -6762,6 +6774,17 @@ declare function defineConnection(config?: Omit<ConnectionDefinition, 'kind'>):
 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 {
@@ -7360,6 +7383,8 @@ declare class QueuesResource {
 }
 
 interface StartRunStep {
+    /** Name later steps use with `ref.step(key, ...)`. */
+    key?: string;
     appId: string;
     actionId: string;
     connectionId?: string;
@@ -7512,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;
@@ -7765,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 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, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };
+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.js

@@ -561,7 +561,7 @@ function assertTriggerConfig(config) {
       throw new Error("defineTrigger inputs require id");
     }
   }
-  if (config.inputs?.length && config.id.trim() !== "flow-control_trigger_manual") {
+  if (config.inputs?.length && config.id.trim() !== MANUAL_TRIGGER_ID) {
     throw new Error(
       "defineTrigger inputs are only valid on flow-control_trigger_manual"
     );
@@ -571,6 +571,73 @@ function defineTrigger(config) {
   assertTriggerConfig(config);
   return { kind: DEFINE_KINDS.trigger, ...config };
 }
+var MANUAL_TRIGGER_ID = "flow-control_trigger_manual";
+var TRIGGER_KEY = "trigger";
+var STEP_KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;
+var STEP_REF_PATTERN = /={{step:([^}]*)}}/g;
+function refString(key, path) {
+  const parts = [key, ...path.map(String)];
+  for (const part of parts) {
+    if (!part || /[,{}]/.test(part)) {
+      throw new Error(`ref path parts must be non-empty and contain no , { or }: "${part}"`);
+    }
+  }
+  return `={{step:${parts.join(",")}}}`;
+}
+var ref = {
+  /** A trigger output field, e.g. a Manually Run input id. */
+  trigger: (field, ...path) => refString(TRIGGER_KEY, [field, ...path]),
+  /** An earlier step's output, by its `key`. Array indexes are numbers. */
+  step: (key, ...path) => refString(key, path)
+};
+function collectRefs(value, out) {
+  if (typeof value === "string") {
+    for (const match of value.matchAll(STEP_REF_PATTERN)) {
+      out.push(match[1].split(",").map((part) => part.trim()));
+    }
+  } else if (Array.isArray(value)) {
+    value.forEach((item) => collectRefs(item, out));
+  } else if (value && typeof value === "object") {
+    Object.values(value).forEach((item) => collectRefs(item, out));
+  }
+}
+function assertStepRefs(config) {
+  const triggerId = config.trigger?.id.trim() ?? MANUAL_TRIGGER_ID;
+  const triggerFields = triggerId === MANUAL_TRIGGER_ID ? new Set((config.trigger?.inputs ?? []).map((f) => f.id.trim())) : void 0;
+  const allKeys = /* @__PURE__ */ new Set();
+  for (const step of config.steps) {
+    if (step.key === void 0) continue;
+    if (!STEP_KEY_PATTERN.test(step.key) || step.key === TRIGGER_KEY) {
+      throw new Error(
+        `Step key "${step.key}" must start with a letter, use letters, digits, - or _, and not be "${TRIGGER_KEY}".`
+      );
+    }
+    if (allKeys.has(step.key)) {
+      throw new Error(`Step key "${step.key}" is used twice.`);
+    }
+    allKeys.add(step.key);
+  }
+  const earlier = /* @__PURE__ */ new Set([TRIGGER_KEY]);
+  config.steps.forEach((step, index) => {
+    const refs = [];
+    collectRefs([step.use?.input, step.input], refs);
+    const where = `Step "${step.key ?? step.name ?? index + 1}"`;
+    for (const [key = "", ...path] of refs) {
+      const shown = `={{step:${[key, ...path].join(",")}}}`;
+      if (!earlier.has(key)) {
+        throw new Error(
+          allKeys.has(key) ? `${where}: ${shown} refers to itself or a later step. Use the trigger or an earlier step.` : `${where}: ${shown} names unknown key "${key}". Use "trigger" or an earlier step's key.`
+        );
+      }
+      if (key === TRIGGER_KEY && triggerFields && !triggerFields.has(path[0] ?? "")) {
+        throw new Error(
+          `${where}: ${shown} uses trigger field "${path[0] ?? ""}", which is not declared in trigger inputs.`
+        );
+      }
+    }
+    if (step.key) earlier.add(step.key);
+  });
+}
 function defineWorkflow(config) {
   if (!config.slug?.trim()) {
     throw new Error("defineWorkflow requires slug");
@@ -581,6 +648,7 @@ function defineWorkflow(config) {
   if (config.trigger) {
     assertTriggerConfig(config.trigger);
   }
+  assertStepRefs(config);
   return { kind: DEFINE_KINDS.workflow, ...config };
 }
 function defineAgent(config) {
@@ -1872,7 +1940,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 } : {},
@@ -2088,6 +2158,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,
@@ -2304,6 +2375,6 @@ function createServerClient(options) {
   });
 }
 
-export { API_KEY_PREFIX, ActionsResource, AgentChatClient, AgentChatStream, AgentsResource, AiConnectionsResource, ApprovalsResource, AuthResource, ConnectionsResource, DEFINE_KINDS, DiscoveryResource, EntitiesResource, EntityTypesResource, ExecutionProgressStream, ExecutionTimeoutError, ExecutionsResource, HttpClient, KnowledgeResource, LunnoaApiError, LunnoaClient, QueueItemsResource, QueuesResource, RunsResource, ScorecardsResource, SsoAuthResource, TablesResource, TasksResource, VariablesResource, WorkflowAppsResource, WorkflowsResource, assertApiKeyAllowedInEnvironment, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineTrigger, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, parseSseEvents, parseSseStream, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };
+export { API_KEY_PREFIX, ActionsResource, AgentChatClient, AgentChatStream, AgentsResource, AiConnectionsResource, ApprovalsResource, AuthResource, ConnectionsResource, DEFINE_KINDS, DiscoveryResource, EntitiesResource, EntityTypesResource, ExecutionProgressStream, ExecutionTimeoutError, ExecutionsResource, HttpClient, KnowledgeResource, LunnoaApiError, LunnoaClient, QueueItemsResource, QueuesResource, RunsResource, ScorecardsResource, SsoAuthResource, TablesResource, TasksResource, VariablesResource, WorkflowAppsResource, WorkflowsResource, assertApiKeyAllowedInEnvironment, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineEntityType, defineTrigger, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, parseSseEvents, parseSseStream, ref, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map