@mobilerun/sdk 5.4.0 → 5.6.0

package/src/resources/workflows/executions.ts

@@ -1,298 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../core/resource';
-import * as Shared from '../shared';
-import { APIPromise } from '../../core/api-promise';
-import { RequestOptions } from '../../internal/request-options';
-import { path } from '../../internal/utils/path';
-
-export class Executions extends APIResource {
-  /**
-   * Fetch a single flow execution by its ID, including its status, kind, result or
-   * error, and start/finish timestamps. Returns 404 if no execution matches.
-   */
-  retrieve(executionID: string, options?: RequestOptions): APIPromise<ExecutionRetrieveResponse> {
-    return this._client.get(path`/executions/${executionID}`, options);
-  }
-
-  /**
-   * Return a paginated history of flow executions. Supports filtering by `flowId`,
-   * `triggerId`, `status`, and a `from`/`to` time range, plus free-text `search` and
-   * ordering by startedAt, finishedAt, or status.
-   */
-  list(
-    query: ExecutionListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ExecutionListResponse> {
-    return this._client.get('/executions', { query, ...options });
-  }
-
-  /**
-   * Signals the worker to stop the execution between steps and marks it cancelled.
-   * Idempotent-ish: already-terminal executions return 409.
-   */
-  abort(executionID: string, options?: RequestOptions): APIPromise<ExecutionAbortResponse> {
-    return this._client.post(path`/executions/${executionID}/abort`, options);
-  }
-
-  /**
-   * Return aggregate execution metrics — total count, counts by status, average
-   * duration, and the last execution time. Can be scoped by `flowId`, `triggerId`,
-   * and a `from`/`to` time range.
-   */
-  getMetrics(
-    query: ExecutionGetMetricsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ExecutionGetMetricsResponse> {
-    return this._client.get('/executions/metrics', { query, ...options });
-  }
-}
-
-export interface ExecutionRetrieveResponse {
-  data: ExecutionRetrieveResponse.Data;
-}
-
-export namespace ExecutionRetrieveResponse {
-  export interface Data {
-    id: string;
-
-    createdBy: string | null;
-
-    error: string | null;
-
-    eventId: string | null;
-
-    /**
-     * Files produced by files.upload steps, plus files an agent.run step reported on
-     * its terminal response (agent-created output or a workflow upload minted during
-     * the turn); derived server-side at read time.
-     */
-    files: Array<Data.File>;
-
-    finishedAt: string | null;
-
-    flowId: string;
-
-    flowName: string | null;
-
-    kind: 'live' | 'dry_run';
-
-    recordingDeviceId: string | null;
-
-    /**
-     * Device-recording id (devices-api) for this execution, set once the worker starts
-     * a recording. Null when the flow has recording disabled, no device is bound, or
-     * the recording failed to start.
-     */
-    recordingId: string | null;
-
-    startedAt: string | null;
-
-    status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled' | 'skipped' | 'invalid' | null;
-
-    triggerId: string;
-
-    triggerName: string | null;
-
-    /**
-     * Opaque per-step result blob ({ steps: [...] }). Each step additionally carries a
-     * `verdict` field ({ outcome, summary, reason? } | null) when it is an agent.run
-     * step that opted into a verdict — null otherwise. Table-backed steps (current
-     * executions) also carry a `status` string (e.g. success/failed/stopped, see
-     * deriveStepStatus); it is optional and absent on legacy blob-only executions, so
-     * clients must not assume its presence.
-     */
-    result?: unknown;
-  }
-
-  export namespace Data {
-    export interface File {
-      fileId: string;
-
-      filename: string;
-
-      mimeType: string;
-
-      sizeBytes: number;
-    }
-  }
-}
-
-export interface ExecutionListResponse {
-  items: Array<ExecutionListResponse.Item>;
-
-  pagination: Shared.Pagination;
-}
-
-export namespace ExecutionListResponse {
-  export interface Item {
-    id: string;
-
-    createdBy: string | null;
-
-    error: string | null;
-
-    eventId: string | null;
-
-    finishedAt: string | null;
-
-    flowId: string;
-
-    flowName: string | null;
-
-    kind: 'live' | 'dry_run';
-
-    recordingDeviceId: string | null;
-
-    /**
-     * Device-recording id (devices-api) for this execution, set once the worker starts
-     * a recording. Null when the flow has recording disabled, no device is bound, or
-     * the recording failed to start.
-     */
-    recordingId: string | null;
-
-    startedAt: string | null;
-
-    status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled' | 'skipped' | 'invalid' | null;
-
-    triggerId: string;
-
-    triggerName: string | null;
-
-    /**
-     * Opaque per-step result blob ({ steps: [...] }). Each step additionally carries a
-     * `verdict` field ({ outcome, summary, reason? } | null) when it is an agent.run
-     * step that opted into a verdict — null otherwise. Table-backed steps (current
-     * executions) also carry a `status` string (e.g. success/failed/stopped, see
-     * deriveStepStatus); it is optional and absent on legacy blob-only executions, so
-     * clients must not assume its presence.
-     */
-    result?: unknown;
-  }
-}
-
-export interface ExecutionAbortResponse {
-  data: ExecutionAbortResponse.Data;
-}
-
-export namespace ExecutionAbortResponse {
-  export interface Data {
-    id: string;
-
-    error: string | null;
-
-    eventId: string | null;
-
-    finishedAt: string | null;
-
-    flowId: string;
-
-    flowName: string | null;
-
-    kind: 'live' | 'dry_run';
-
-    recordingDeviceId: string | null;
-
-    /**
-     * Device-recording id (devices-api) for this execution, set once the worker starts
-     * a recording. Null when the flow has recording disabled, no device is bound, or
-     * the recording failed to start.
-     */
-    recordingId: string | null;
-
-    startedAt: string | null;
-
-    status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled' | 'skipped' | 'invalid' | null;
-
-    triggerId: string;
-
-    triggerName: string | null;
-
-    /**
-     * Opaque per-step result blob ({ steps: [...] }). Each step additionally carries a
-     * `verdict` field ({ outcome, summary, reason? } | null) when it is an agent.run
-     * step that opted into a verdict — null otherwise. Table-backed steps (current
-     * executions) also carry a `status` string (e.g. success/failed/stopped, see
-     * deriveStepStatus); it is optional and absent on legacy blob-only executions, so
-     * clients must not assume its presence.
-     */
-    result?: unknown;
-  }
-}
-
-export interface ExecutionGetMetricsResponse {
-  data: ExecutionGetMetricsResponse.Data;
-}
-
-export namespace ExecutionGetMetricsResponse {
-  export interface Data {
-    avgDurationMs: number | null;
-
-    byStatus: Data.ByStatus;
-
-    lastExecutionAt: string | null;
-
-    total: number;
-  }
-
-  export namespace Data {
-    export interface ByStatus {
-      cancelled: number;
-
-      failed: number;
-
-      invalid: number;
-
-      pending: number;
-
-      running: number;
-
-      skipped: number;
-
-      success: number;
-    }
-  }
-}
-
-export interface ExecutionListParams {
-  flowId?: string;
-
-  from?: string | null;
-
-  orderBy?: 'startedAt' | 'finishedAt' | 'status';
-
-  orderByDirection?: 'asc' | 'desc';
-
-  page?: number;
-
-  pageSize?: number;
-
-  search?: string;
-
-  status?: 'pending' | 'running' | 'success' | 'failed' | 'cancelled' | 'skipped' | 'invalid';
-
-  to?: string | null;
-
-  triggerId?: string;
-}
-
-export interface ExecutionGetMetricsParams {
-  flowId?: string;
-
-  from?: string | null;
-
-  to?: string | null;
-
-  triggerId?: string;
-}
-
-export declare namespace Executions {
-  export {
-    type ExecutionRetrieveResponse as ExecutionRetrieveResponse,
-    type ExecutionListResponse as ExecutionListResponse,
-    type ExecutionAbortResponse as ExecutionAbortResponse,
-    type ExecutionGetMetricsResponse as ExecutionGetMetricsResponse,
-    type ExecutionListParams as ExecutionListParams,
-    type ExecutionGetMetricsParams as ExecutionGetMetricsParams,
-  };
-}
+export * from './executions/index';

package/src/resources/workflows/flows/actions.ts

@@ -19,6 +19,10 @@ export class Actions extends APIResource {
    * under a `parentFlowActionId` or supplying its own `children`. Supports a
    * `nameOverride`, param `overrides`, and `continueOnError`. Returns 404 if the
    * flow does not exist.
+   *
+   * Supports an optional `Idempotency-Key` header (1-255 printable ASCII
+   * characters). Replays with the same key and an identical body return the original
+   * 201; a changed body under the same key returns 422 `idempotency_key_reused`.
    */
   add(flowID: string, body: ActionAddParams, options?: RequestOptions): APIPromise<ActionAddResponse> {
     return this._client.post(path`/flows/${flowID}/actions`, { body, ...options });
@@ -68,6 +72,8 @@ export namespace ActionListResponse {
 
     flowId: string;
 
+    key: string;
+
     nameOverride: string | null;
 
     overrides: Data.Overrides | null;
@@ -75,6 +81,12 @@ export namespace ActionListResponse {
     parentFlowActionId: string | null;
 
     position: number;
+
+    /**
+     * Selected for per-step recording under the flow's "selected_steps" recording
+     * policy.
+     */
+    recordingEnabled: boolean;
   }
 
   export namespace Data {
@@ -100,6 +112,8 @@ export namespace ActionAddResponse {
 
     flowId: string;
 
+    key: string;
+
     nameOverride: string | null;
 
     overrides: Data.Overrides | null;
@@ -107,6 +121,12 @@ export namespace ActionAddResponse {
     parentFlowActionId: string | null;
 
     position: number;
+
+    /**
+     * Selected for per-step recording under the flow's "selected_steps" recording
+     * policy.
+     */
+    recordingEnabled: boolean;
   }
 
   export namespace Data {
@@ -136,6 +156,8 @@ export namespace ActionReplaceResponse {
 
     flowId: string;
 
+    key: string;
+
     nameOverride: string | null;
 
     overrides: Data.Overrides | null;
@@ -143,6 +165,12 @@ export namespace ActionReplaceResponse {
     parentFlowActionId: string | null;
 
     position: number;
+
+    /**
+     * Selected for per-step recording under the flow's "selected_steps" recording
+     * policy.
+     */
+    recordingEnabled: boolean;
   }
 
   export namespace Data {
@@ -161,11 +189,22 @@ export interface ActionAddParams {
 
   continueOnError?: boolean;
 
+  /**
+   * Stable identifier used by template resolution v2+ to address this step as
+   * {{key.field}}. Omitted keys are derived from the step name whenever a flow is
+   * created. For template resolution v3, replacing an existing flow's full action
+   * tree requires every step to carry an explicit key — a missing key is rejected
+   * there, not derived, so a name change can never silently move a step's key.
+   */
+  key?: string;
+
   nameOverride?: string;
 
   overrides?: ActionAddParams.Overrides | null;
 
   parentFlowActionId?: string | null;
+
+  recordingEnabled?: boolean;
 }
 
 export namespace ActionAddParams {
@@ -176,9 +215,20 @@ export namespace ActionAddParams {
 
     continueOnError?: boolean;
 
+    /**
+     * Stable identifier used by template resolution v2+ to address this step as
+     * {{key.field}}. Omitted keys are derived from the step name whenever a flow is
+     * created. For template resolution v3, replacing an existing flow's full action
+     * tree requires every step to carry an explicit key — a missing key is rejected
+     * there, not derived, so a name change can never silently move a step's key.
+     */
+    key?: string;
+
     nameOverride?: string;
 
     overrides?: Child.Overrides | null;
+
+    recordingEnabled?: boolean;
   }
 
   export namespace Child {
@@ -210,9 +260,20 @@ export namespace ActionReplaceParams {
 
     continueOnError?: boolean;
 
+    /**
+     * Stable identifier used by template resolution v2+ to address this step as
+     * {{key.field}}. Omitted keys are derived from the step name whenever a flow is
+     * created. For template resolution v3, replacing an existing flow's full action
+     * tree requires every step to carry an explicit key — a missing key is rejected
+     * there, not derived, so a name change can never silently move a step's key.
+     */
+    key?: string;
+
     nameOverride?: string;
 
     overrides?: Action.Overrides | null;
+
+    recordingEnabled?: boolean;
   }
 
   export namespace Action {
@@ -223,9 +284,20 @@ export namespace ActionReplaceParams {
 
       continueOnError?: boolean;
 
+      /**
+       * Stable identifier used by template resolution v2+ to address this step as
+       * {{key.field}}. Omitted keys are derived from the step name whenever a flow is
+       * created. For template resolution v3, replacing an existing flow's full action
+       * tree requires every step to carry an explicit key — a missing key is rejected
+       * there, not derived, so a name change can never silently move a step's key.
+       */
+      key?: string;
+
       nameOverride?: string;
 
       overrides?: Child.Overrides | null;
+
+      recordingEnabled?: boolean;
     }
 
     export namespace Child {