@lunnoa/client 2.2.0 → 2.3.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;
@@ -2314,6 +2314,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 +2360,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. */
@@ -6605,6 +6642,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,6 +6678,43 @@ 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 {
     /** Action definition (or inline action-shaped object). */
     use: ActionDefinition;
@@ -6654,6 +6729,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 +6761,7 @@ 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;
 declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): WorkflowDefinition;
 declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
 interface EntityTypeDefinition {
@@ -6705,6 +6786,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 {
@@ -7435,11 +7519,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 +7765,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, 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;
@@ -2314,6 +2314,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 +2360,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. */
@@ -6605,6 +6642,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,6 +6678,43 @@ 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 {
     /** Action definition (or inline action-shaped object). */
     use: ActionDefinition;
@@ -6654,6 +6729,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 +6761,7 @@ 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;
 declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): WorkflowDefinition;
 declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
 interface EntityTypeDefinition {
@@ -6705,6 +6786,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 {
@@ -7435,11 +7519,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 +7765,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, resolveActionAppId, resolveActionId, resolveTriggerAppId, resolveTriggerId };

package/dist/index.js

@@ -535,6 +535,7 @@ var DEFINE_KINDS = {
   connection: "connection",
   aiConnection: "aiConnection",
   action: "action",
+  trigger: "trigger",
   workflow: "workflow",
   agent: "agent",
   entityType: "entityType"
@@ -551,6 +552,25 @@ function defineAction(config) {
   }
   return { kind: DEFINE_KINDS.action, ...config };
 }
+function assertTriggerConfig(config) {
+  if (!config.id?.trim()) {
+    throw new Error("defineTrigger requires id (catalogue trigger id)");
+  }
+  for (const field of config.inputs ?? []) {
+    if (!field?.id?.trim()) {
+      throw new Error("defineTrigger inputs require id");
+    }
+  }
+  if (config.inputs?.length && config.id.trim() !== "flow-control_trigger_manual") {
+    throw new Error(
+      "defineTrigger inputs are only valid on flow-control_trigger_manual"
+    );
+  }
+}
+function defineTrigger(config) {
+  assertTriggerConfig(config);
+  return { kind: DEFINE_KINDS.trigger, ...config };
+}
 function defineWorkflow(config) {
   if (!config.slug?.trim()) {
     throw new Error("defineWorkflow requires slug");
@@ -558,6 +578,9 @@ function defineWorkflow(config) {
   if (!config.steps?.length) {
     throw new Error("defineWorkflow requires at least one step");
   }
+  if (config.trigger) {
+    assertTriggerConfig(config.trigger);
+  }
   return { kind: DEFINE_KINDS.workflow, ...config };
 }
 function defineAgent(config) {
@@ -603,6 +626,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();
@@ -2017,6 +2074,17 @@ 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 {
@@ -2037,6 +2105,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)
   };
@@ -2235,6 +2304,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, defineWorkflow, entityTypeDefinitionToUpsert, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, parseSseEvents, parseSseStream, resolveActionAppId, resolveActionId };
+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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map