@frontera-sdk/workflow 1.52.13 → 1.52.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/workflow",
-  "version": "1.52.13",
+  "version": "1.52.15",
   "description": "Typed headless client for starting, inspecting, waiting on and cancelling Frontera workflow runs from a script or backend.",
   "keywords": [
     "frontera",
@@ -38,8 +38,8 @@
     "typecheck": "bunx tsc --noEmit"
   },
   "dependencies": {
-    "@frontera-sdk/core": "1.52.13",
-    "@frontera-sdk/functions": "1.52.13"
+    "@frontera-sdk/core": "1.52.15",
+    "@frontera-sdk/functions": "1.52.15"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",

package/src/definition.ts

@@ -263,6 +263,19 @@ export interface DecideParams {
 }
 export interface ActionParams {
   input: DataInput
+  /**
+   * Keep the step open until the request settles (succeeded, rejected,
+   * expired, cancelled, failed, or closed with an unknown outcome) instead of
+   * returning as soon as it is submitted. Absent or `false`: the step returns
+   * `{ requestId, lifecycle }` at submit, as it always has.
+   */
+  waitForOutcome?: boolean
+  /**
+   * How long a `waitForOutcome` step waits, like `30m` or `4h`. Defaults to
+   * `1h`, at most `24h`. Reaching it is not a failure: the step returns
+   * `timedOut: true` with the lifecycle it last read.
+   */
+  outcomeTimeout?: string
 }
 export interface AgentParams {
   message: DataInput
@@ -300,11 +313,38 @@ export interface ForEachParams {
 export interface ParallelParams {
   branches: Array<{ id: string; nodes: WorkflowNode[] }>
 }
-export interface WaitParams {
-  /** Exactly one of `for` or `until`. */
+/** Wait for a length of time, or until a moment. Exactly one of `for` or `until`. */
+export interface WaitTimeParams {
+  mode?: 'time'
   for?: string
   until?: string
 }
+/**
+ * Wait until one Blueprint record meets a condition, re-reading it until the
+ * condition holds or `timeout` passes. Reaching the timeout is not a failure:
+ * the step returns `{ matched: false, timedOut: true, record }`.
+ */
+export interface WaitRecordParams {
+  mode: 'record'
+  /** The object type to read, by id. */
+  objectTypeId: string
+  /** The record's primary key. */
+  pk: DataInput
+  /** JSONata predicate evaluated with the record as `$`, e.g. `jobState in ['accepted', 'declined']`. */
+  where: string
+  /** How long to wait, like `30m` or `4h`. Defaults to `1h`, at most `7d`. */
+  timeout?: string
+  /** How often to read the record. Defaults to `30s`; widened when the timeout would need too many reads. */
+  pollEvery?: string
+  /**
+   * Never set on a record wait. Declared so code that reads `params.for` or
+   * `params.until` off a `WaitParams` keeps compiling; `mode` still tells the
+   * two apart.
+   */
+  for?: never
+  until?: never
+}
+export type WaitParams = WaitTimeParams | WaitRecordParams
 export interface RespondParams {
   status: number
   headers?: Record<string, DataInput>