@mobilerun/sdk 5.2.0 → 5.3.0

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

@@ -1,9 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
-import * as FlowsAPI from './flows';
 import * as Shared from '../../shared';
-import * as WorkflowsAPI from '../workflows';
 import * as ActionsAPI from './actions';
 import {
   ActionAddParams,
@@ -14,7 +12,6 @@ import {
   ActionReplaceParams,
   ActionReplaceResponse,
   Actions,
-  FlowAction,
 } from './actions';
 import { APIPromise } from '../../../core/api-promise';
 import { RequestOptions } from '../../../internal/request-options';
@@ -88,6 +85,37 @@ export class Flows extends APIResource {
     return this._client.post(path`/flows/${flowID}/clone`, { body, ...options });
   }
 
+  /**
+   * Simulate this flow firing without storing events, enqueuing jobs, or consuming
+   * cooldown/rate-limit slots.
+   *
+   * Works for every trigger activation type:
+   *
+   * - `event`: validates the payload against the event catalog schema and evaluates
+   *   the trigger conditions.
+   * - `custom`: validates the payload against the custom payload schema (conditions
+   *   do not apply).
+   * - `schedule`: ignores the payload and reports the next fire time.
+   *
+   * The response reports `wouldFire` — whether the flow would actually run right now
+   * — alongside the gates that decide it (enabled, device attached, blocked,
+   * cooldown). `rateLimited` is informational and is not folded into `wouldFire`.
+   */
+  dryRun(
+    flowID: string,
+    body: FlowDryRunParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FlowDryRunResponse> {
+    return this._client.post(path`/flows/${flowID}/dry-run`, { body, ...options });
+  }
+
+  /**
+   * List self-healing repair episodes
+   */
+  listRepairs(flowID: string, options?: RequestOptions): APIPromise<FlowListRepairsResponse> {
+    return this._client.get(path`/flows/${flowID}/repairs`, options);
+  }
+
   /**
    * Clear a flow's blocked status after fixing the underlying issue. Idempotent —
    * safe to call on already-healthy flows.
@@ -97,50 +125,604 @@ export class Flows extends APIResource {
   }
 }
 
-export interface FlowActionOverrides {
-  params?: { [key: string]: unknown };
+export interface FlowCreateResponse {
+  data: FlowCreateResponse.Data;
 }
 
-export interface FlowChildActionInput {
-  actionId: string;
+export namespace FlowCreateResponse {
+  export interface Data {
+    id: string;
 
-  position: number;
+    blockedAt: string | null;
 
-  continueOnError?: boolean;
+    consecutiveFailures: number;
 
-  nameOverride?: string;
+    cooldownScope: 'flow' | 'device';
 
-  overrides?: FlowActionOverrides | null;
-}
+    cooldownSeconds: number | null;
 
-export interface FlowCreateResponse {
-  data: WorkflowsAPI.Flow;
+    createdAt: string | null;
+
+    createdBy: string | null;
+
+    description: string | null;
+
+    deviceIds: Array<string>;
+
+    enabled: boolean;
+
+    healthMonitoringEnabled: boolean;
+
+    lastFailureAt: string | null;
+
+    lastFailureCode:
+      | 'device_not_found'
+      | 'permission_denied'
+      | 'client_error'
+      | 'transient'
+      | 'logic'
+      | 'invalid_config'
+      | null;
+
+    lastTriggeredAt: string | null;
+
+    name: string;
+
+    notifyOnFailure: boolean;
+
+    notifyOnSuccess: boolean;
+
+    notifyWebhookId: string | null;
+
+    ownerId: string;
+
+    recordingEnabled: boolean;
+
+    selfHealingEnabled: boolean;
+
+    selfHealingMaxAttempts: number;
+
+    status: 'healthy' | 'failing' | 'blocked';
+
+    /**
+     * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+     * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+     * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+     * to 2.
+     */
+    templateResolutionVersion: number;
+
+    triggerId: string;
+
+    updatedAt: string | null;
+
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
+  }
 }
 
 export interface FlowRetrieveResponse {
-  data: WorkflowsAPI.Flow;
+  data: FlowRetrieveResponse.Data;
+}
+
+export namespace FlowRetrieveResponse {
+  export interface Data {
+    id: string;
+
+    blockedAt: string | null;
+
+    consecutiveFailures: number;
+
+    cooldownScope: 'flow' | 'device';
+
+    cooldownSeconds: number | null;
+
+    createdAt: string | null;
+
+    createdBy: string | null;
+
+    description: string | null;
+
+    deviceIds: Array<string>;
+
+    enabled: boolean;
+
+    healthMonitoringEnabled: boolean;
+
+    lastFailureAt: string | null;
+
+    lastFailureCode:
+      | 'device_not_found'
+      | 'permission_denied'
+      | 'client_error'
+      | 'transient'
+      | 'logic'
+      | 'invalid_config'
+      | null;
+
+    lastTriggeredAt: string | null;
+
+    name: string;
+
+    notifyOnFailure: boolean;
+
+    notifyOnSuccess: boolean;
+
+    notifyWebhookId: string | null;
+
+    ownerId: string;
+
+    recordingEnabled: boolean;
+
+    selfHealingEnabled: boolean;
+
+    selfHealingMaxAttempts: number;
+
+    status: 'healthy' | 'failing' | 'blocked';
+
+    /**
+     * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+     * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+     * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+     * to 2.
+     */
+    templateResolutionVersion: number;
+
+    triggerId: string;
+
+    updatedAt: string | null;
+
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
+  }
 }
 
 export interface FlowUpdateResponse {
-  data: WorkflowsAPI.Flow;
+  data: FlowUpdateResponse.Data;
+}
+
+export namespace FlowUpdateResponse {
+  export interface Data {
+    id: string;
+
+    blockedAt: string | null;
+
+    consecutiveFailures: number;
+
+    cooldownScope: 'flow' | 'device';
+
+    cooldownSeconds: number | null;
+
+    createdAt: string | null;
+
+    createdBy: string | null;
+
+    description: string | null;
+
+    deviceIds: Array<string>;
+
+    enabled: boolean;
+
+    healthMonitoringEnabled: boolean;
+
+    lastFailureAt: string | null;
+
+    lastFailureCode:
+      | 'device_not_found'
+      | 'permission_denied'
+      | 'client_error'
+      | 'transient'
+      | 'logic'
+      | 'invalid_config'
+      | null;
+
+    lastTriggeredAt: string | null;
+
+    name: string;
+
+    notifyOnFailure: boolean;
+
+    notifyOnSuccess: boolean;
+
+    notifyWebhookId: string | null;
+
+    ownerId: string;
+
+    recordingEnabled: boolean;
+
+    selfHealingEnabled: boolean;
+
+    selfHealingMaxAttempts: number;
+
+    status: 'healthy' | 'failing' | 'blocked';
+
+    /**
+     * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+     * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+     * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+     * to 2.
+     */
+    templateResolutionVersion: number;
+
+    triggerId: string;
+
+    updatedAt: string | null;
+
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
+  }
 }
 
 export interface FlowListResponse {
-  items: Array<WorkflowsAPI.Flow>;
+  items: Array<FlowListResponse.Item>;
 
   pagination: Shared.Pagination;
 }
 
+export namespace FlowListResponse {
+  export interface Item {
+    id: string;
+
+    blockedAt: string | null;
+
+    consecutiveFailures: number;
+
+    cooldownScope: 'flow' | 'device';
+
+    cooldownSeconds: number | null;
+
+    createdAt: string | null;
+
+    createdBy: string | null;
+
+    description: string | null;
+
+    deviceIds: Array<string>;
+
+    enabled: boolean;
+
+    healthMonitoringEnabled: boolean;
+
+    lastFailureAt: string | null;
+
+    lastFailureCode:
+      | 'device_not_found'
+      | 'permission_denied'
+      | 'client_error'
+      | 'transient'
+      | 'logic'
+      | 'invalid_config'
+      | null;
+
+    lastTriggeredAt: string | null;
+
+    name: string;
+
+    notifyOnFailure: boolean;
+
+    notifyOnSuccess: boolean;
+
+    notifyWebhookId: string | null;
+
+    ownerId: string;
+
+    recordingEnabled: boolean;
+
+    selfHealingEnabled: boolean;
+
+    selfHealingMaxAttempts: number;
+
+    status: 'healthy' | 'failing' | 'blocked';
+
+    /**
+     * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+     * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+     * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+     * to 2.
+     */
+    templateResolutionVersion: number;
+
+    triggerId: string;
+
+    updatedAt: string | null;
+
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
+  }
+}
+
 export interface FlowDeleteResponse {
   message: string;
 }
 
 export interface FlowCloneResponse {
-  data: WorkflowsAPI.Flow;
+  data: FlowCloneResponse.Data;
+}
+
+export namespace FlowCloneResponse {
+  export interface Data {
+    id: string;
+
+    blockedAt: string | null;
+
+    consecutiveFailures: number;
+
+    cooldownScope: 'flow' | 'device';
+
+    cooldownSeconds: number | null;
+
+    createdAt: string | null;
+
+    createdBy: string | null;
+
+    description: string | null;
+
+    deviceIds: Array<string>;
+
+    enabled: boolean;
+
+    healthMonitoringEnabled: boolean;
+
+    lastFailureAt: string | null;
+
+    lastFailureCode:
+      | 'device_not_found'
+      | 'permission_denied'
+      | 'client_error'
+      | 'transient'
+      | 'logic'
+      | 'invalid_config'
+      | null;
+
+    lastTriggeredAt: string | null;
+
+    name: string;
+
+    notifyOnFailure: boolean;
+
+    notifyOnSuccess: boolean;
+
+    notifyWebhookId: string | null;
+
+    ownerId: string;
+
+    recordingEnabled: boolean;
+
+    selfHealingEnabled: boolean;
+
+    selfHealingMaxAttempts: number;
+
+    status: 'healthy' | 'failing' | 'blocked';
+
+    /**
+     * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+     * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+     * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+     * to 2.
+     */
+    templateResolutionVersion: number;
+
+    triggerId: string;
+
+    updatedAt: string | null;
+
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
+  }
+}
+
+export interface FlowDryRunResponse {
+  data: FlowDryRunResponse.Data;
+}
+
+export namespace FlowDryRunResponse {
+  export interface Data {
+    actions: Array<Data.Action>;
+
+    activation: 'event' | 'schedule' | 'custom';
+
+    conditionsPassed: boolean | null;
+
+    gates: Data.Gates;
+
+    nextFireTime: string | null;
+
+    rateLimited: boolean;
+
+    validation: Data.Validation;
+
+    wouldFire: boolean;
+  }
+
+  export namespace Data {
+    export interface Action {
+      continueOnError: boolean;
+
+      method: string;
+
+      name: string;
+
+      service: 'tasks_api' | 'devices_api' | 'agents_api' | 'webhooks';
+
+      /**
+       * Nested child actions (loop/branch bodies), each the same shape as a
+       * ResolvedAction.
+       */
+      children?: Array<unknown>;
+
+      params?: { [key: string]: unknown };
+    }
+
+    export interface Gates {
+      blocked: boolean;
+
+      cooldownActive: boolean | null;
+
+      deviceAttached: boolean;
+
+      deviceIds: Array<string>;
+
+      enabled: boolean;
+    }
+
+    export interface Validation {
+      valid: boolean;
+
+      errors?: Array<Validation.Error>;
+    }
+
+    export namespace Validation {
+      export interface Error {
+        field: string;
+
+        message: string;
+      }
+    }
+  }
+}
+
+export interface FlowListRepairsResponse {
+  data: Array<FlowListRepairsResponse.Data>;
+}
+
+export namespace FlowListRepairsResponse {
+  export interface Data {
+    id: string;
+
+    agentRunId: string | null;
+
+    attempt: number;
+
+    candidateSlug: string;
+
+    chatSessionId: string | null;
+
+    createdAt: string | null;
+
+    deviceId: string | null;
+
+    episode: number;
+
+    error: string | null;
+
+    failedStepIndex: number;
+
+    finishedAt: string | null;
+
+    flowId: string;
+
+    maxAttempts: number;
+
+    originalSlug: string;
+
+    sourceExecutionId: string;
+
+    startedAt: string | null;
+
+    status: 'pending' | 'running' | 'canary' | 'promoting' | 'repaired' | 'failed' | 'escalated';
+
+    updatedAt: string | null;
+
+    verdict: Data.Verdict | null;
+  }
+
+  export namespace Data {
+    export interface Verdict {
+      outcome: 'ok' | 'flaky' | 'broken';
+
+      summary: string;
+
+      reason?: string;
+    }
+  }
 }
 
 export interface FlowUnblockResponse {
-  data: WorkflowsAPI.Flow;
+  data: FlowUnblockResponse.Data;
+}
+
+export namespace FlowUnblockResponse {
+  export interface Data {
+    id: string;
+
+    blockedAt: string | null;
+
+    consecutiveFailures: number;
+
+    cooldownScope: 'flow' | 'device';
+
+    cooldownSeconds: number | null;
+
+    createdAt: string | null;
+
+    createdBy: string | null;
+
+    description: string | null;
+
+    deviceIds: Array<string>;
+
+    enabled: boolean;
+
+    healthMonitoringEnabled: boolean;
+
+    lastFailureAt: string | null;
+
+    lastFailureCode:
+      | 'device_not_found'
+      | 'permission_denied'
+      | 'client_error'
+      | 'transient'
+      | 'logic'
+      | 'invalid_config'
+      | null;
+
+    lastTriggeredAt: string | null;
+
+    name: string;
+
+    notifyOnFailure: boolean;
+
+    notifyOnSuccess: boolean;
+
+    notifyWebhookId: string | null;
+
+    ownerId: string;
+
+    recordingEnabled: boolean;
+
+    selfHealingEnabled: boolean;
+
+    selfHealingMaxAttempts: number;
+
+    status: 'healthy' | 'failing' | 'blocked';
+
+    /**
+     * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+     * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+     * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+     * to 2.
+     */
+    templateResolutionVersion: number;
+
+    triggerId: string;
+
+    updatedAt: string | null;
+
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
+  }
 }
 
 export interface FlowCreateParams {
@@ -168,6 +750,8 @@ export interface FlowCreateParams {
 
   notifyWebhookId?: string | null;
 
+  recordingEnabled?: boolean;
+
   selfHealingEnabled?: boolean;
 
   selfHealingMaxAttempts?: number;
@@ -179,13 +763,37 @@ export namespace FlowCreateParams {
 
     position: number;
 
-    children?: Array<FlowsAPI.FlowChildActionInput>;
+    children?: Array<Action.Child>;
 
     continueOnError?: boolean;
 
     nameOverride?: string;
 
-    overrides?: FlowsAPI.FlowActionOverrides | null;
+    overrides?: Action.Overrides | null;
+  }
+
+  export namespace Action {
+    export interface Child {
+      actionId: string;
+
+      position: number;
+
+      continueOnError?: boolean;
+
+      nameOverride?: string;
+
+      overrides?: Child.Overrides | null;
+    }
+
+    export namespace Child {
+      export interface Overrides {
+        params?: { [key: string]: unknown };
+      }
+    }
+
+    export interface Overrides {
+      params?: { [key: string]: unknown };
+    }
   }
 }
 
@@ -210,6 +818,8 @@ export interface FlowUpdateParams {
 
   notifyWebhookId?: string | null;
 
+  recordingEnabled?: boolean;
+
   selfHealingEnabled?: boolean;
 
   selfHealingMaxAttempts?: number;
@@ -251,28 +861,32 @@ export interface FlowCloneParams {
   name?: string;
 }
 
+export interface FlowDryRunParams {
+  payload?: { [key: string]: unknown };
+}
+
 Flows.Actions = Actions;
 
 export declare namespace Flows {
   export {
-    type FlowActionOverrides as FlowActionOverrides,
-    type FlowChildActionInput as FlowChildActionInput,
     type FlowCreateResponse as FlowCreateResponse,
     type FlowRetrieveResponse as FlowRetrieveResponse,
     type FlowUpdateResponse as FlowUpdateResponse,
     type FlowListResponse as FlowListResponse,
     type FlowDeleteResponse as FlowDeleteResponse,
     type FlowCloneResponse as FlowCloneResponse,
+    type FlowDryRunResponse as FlowDryRunResponse,
+    type FlowListRepairsResponse as FlowListRepairsResponse,
     type FlowUnblockResponse as FlowUnblockResponse,
     type FlowCreateParams as FlowCreateParams,
     type FlowUpdateParams as FlowUpdateParams,
     type FlowListParams as FlowListParams,
     type FlowCloneParams as FlowCloneParams,
+    type FlowDryRunParams as FlowDryRunParams,
   };
 
   export {
     Actions as Actions,
-    type FlowAction as FlowAction,
     type ActionListResponse as ActionListResponse,
     type ActionAddResponse as ActionAddResponse,
     type ActionRemoveResponse as ActionRemoveResponse,