@mobilerun/sdk 5.5.0 → 6.0.0

package/src/resources/tasks/tasks.ts

@@ -68,16 +68,8 @@ export class Tasks extends APIResource {
    * Create and dispatch a new agent task. Returns the task ID and device stream
    * details.
    */
-  run(params: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse> {
-    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
-    return this._client.post('/tasks', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-        options?.headers,
-      ]),
-    });
+  run(body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse> {
+    return this._client.post('/tasks', { body, ...options });
   }
 
   /**
@@ -179,6 +171,12 @@ export namespace TaskRetrieveResponse {
 
     finishedAt?: string | null;
 
+    /**
+     * Whether human-like input was requested. Always equal to the deprecated stealth
+     * field.
+     */
+    humanize?: boolean;
+
     maxSteps?: number;
 
     message?: string | null;
@@ -205,6 +203,10 @@ export namespace TaskRetrieveResponse {
      */
     source?: 'api' | 'agent';
 
+    /**
+     * @deprecated Deprecated: use humanize. Both names must agree when supplied
+     * together.
+     */
     stealth?: boolean;
 
     steps?: number | null;
@@ -315,6 +317,12 @@ export namespace TaskListResponse {
 
     finishedAt?: string | null;
 
+    /**
+     * Whether human-like input was requested. Always equal to the deprecated stealth
+     * field.
+     */
+    humanize?: boolean;
+
     maxSteps?: number;
 
     message?: string | null;
@@ -341,6 +349,10 @@ export namespace TaskListResponse {
      */
     source?: 'api' | 'agent';
 
+    /**
+     * @deprecated Deprecated: use humanize. Both names must agree when supplied
+     * together.
+     */
     stealth?: boolean;
 
     steps?: number | null;
@@ -561,27 +573,18 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryStartEvent {
-    /**
-     * Implicit entry event sent to kick off a `Workflow.run()`.
-     */
     data: unknown;
 
     event: 'StartEvent';
   }
 
   export interface TrajectoryFinalizeEvent {
-    /**
-     * Trigger finalization.
-     */
     data: TrajectoryFinalizeEvent.Data;
 
     event: 'FinalizeEvent';
   }
 
   export namespace TrajectoryFinalizeEvent {
-    /**
-     * Trigger finalization.
-     */
     export interface Data {
       reason: string;
 
@@ -590,26 +593,6 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryStopEvent {
-    /**
-     * Terminal event that signals the workflow has completed.
-     *
-     * The `result` property contains the return value of the workflow run. When a
-     * custom stop event subclass is used, the workflow result is that event instance
-     * itself.
-     *
-     * Examples:
-     * `python # default stop event: result holds the value return StopEvent(result={"answer": 42}) `
-     *
-     *     Subclassing to provide a custom result:
-     *
-     *     ```python
-     *     class MyStopEv(StopEvent):
-     *         pass
-     *
-     *     @step
-     *     async def my_step(self, ctx: Context, ev: StartEvent) -> MyStopEv:
-     *         return MyStopEv(result={"answer": 42})
-     */
     data: unknown;
 
     event: 'StopEvent';
@@ -617,10 +600,7 @@ export namespace TaskGetTrajectoryResponse {
 
   export interface TrajectoryResultEvent {
     /**
-     * Lazy wrapper — avoids importing droidrun at module level.
-     *
-     * The worker uses droidrun's ResultEvent directly; this model only exists so the
-     * API OpenAPI schema can reference it without the heavy droidrun import.
+     * Final result event of a task.
      */
     data: TrajectoryResultEvent.Data;
 
@@ -629,10 +609,7 @@ export namespace TaskGetTrajectoryResponse {
 
   export namespace TrajectoryResultEvent {
     /**
-     * Lazy wrapper — avoids importing droidrun at module level.
-     *
-     * The worker uses droidrun's ResultEvent directly; this model only exists so the
-     * API OpenAPI schema can reference it without the heavy droidrun import.
+     * Final result event of a task.
      */
     export interface Data {
       message?: string | null;
@@ -646,33 +623,18 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryManagerInputEvent {
-    /**
-     * Trigger Manager workflow for planning
-     */
     data: unknown;
 
     event: 'ManagerInputEvent';
   }
 
   export interface TrajectoryManagerPlanEvent {
-    /**
-     * Coordination event from ManagerAgent to MobileAgent.
-     *
-     * Used for workflow step routing only (NOT streamed to frontend). For internal
-     * events with memory_update metadata, see ManagerPlanDetailsEvent.
-     */
     data: TrajectoryManagerPlanEvent.Data;
 
     event: 'ManagerPlanEvent';
   }
 
   export namespace TrajectoryManagerPlanEvent {
-    /**
-     * Coordination event from ManagerAgent to MobileAgent.
-     *
-     * Used for workflow step routing only (NOT streamed to frontend). For internal
-     * events with memory_update metadata, see ManagerPlanDetailsEvent.
-     */
     export interface Data {
       current_subgoal: string;
 
@@ -687,36 +649,24 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryExecutorInputEvent {
-    /**
-     * Trigger Executor workflow for action execution
-     */
     data: TrajectoryExecutorInputEvent.Data;
 
     event: 'ExecutorInputEvent';
   }
 
   export namespace TrajectoryExecutorInputEvent {
-    /**
-     * Trigger Executor workflow for action execution
-     */
     export interface Data {
       current_subgoal: string;
     }
   }
 
   export interface TrajectoryExecutorResultEvent {
-    /**
-     * Executor finished with action result.
-     */
     data: TrajectoryExecutorResultEvent.Data;
 
     event: 'ExecutorResultEvent';
   }
 
   export namespace TrajectoryExecutorResultEvent {
-    /**
-     * Executor finished with action result.
-     */
     export interface Data {
       action: { [key: string]: unknown };
 
@@ -729,32 +679,28 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryFastAgentInputEvent {
-    /**
-     * Input ready for LLM.
-     */
     data: unknown;
 
     event: 'FastAgentInputEvent';
   }
 
   export interface TrajectoryFastAgentResponseEvent {
-    /**
-     * LLM response received.
-     */
     data: TrajectoryFastAgentResponseEvent.Data;
 
     event: 'FastAgentResponseEvent';
   }
 
   export namespace TrajectoryFastAgentResponseEvent {
-    /**
-     * LLM response received.
-     */
     export interface Data {
       thought: string;
 
       code?: string | null;
 
+      /**
+       * Classification of tool-call markup in an LLM response.
+       */
+      tool_call_status?: 'valid' | 'no_markup' | 'malformed';
+
       usage?: Data.Usage | null;
     }
 
@@ -772,54 +718,36 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryFastAgentToolCallEvent {
-    /**
-     * Tool calls ready to execute.
-     */
     data: TrajectoryFastAgentToolCallEvent.Data;
 
     event: 'FastAgentToolCallEvent';
   }
 
   export namespace TrajectoryFastAgentToolCallEvent {
-    /**
-     * Tool calls ready to execute.
-     */
     export interface Data {
       tool_calls_repr: string;
     }
   }
 
   export interface TrajectoryFastAgentOutputEvent {
-    /**
-     * Tool execution result.
-     */
     data: TrajectoryFastAgentOutputEvent.Data;
 
     event: 'FastAgentOutputEvent';
   }
 
   export namespace TrajectoryFastAgentOutputEvent {
-    /**
-     * Tool execution result.
-     */
     export interface Data {
       output: string;
     }
   }
 
   export interface TrajectoryFastAgentEndEvent {
-    /**
-     * FastAgent finished.
-     */
     data: TrajectoryFastAgentEndEvent.Data;
 
     event: 'FastAgentEndEvent';
   }
 
   export namespace TrajectoryFastAgentEndEvent {
-    /**
-     * FastAgent finished.
-     */
     export interface Data {
       reason: string;
 
@@ -858,18 +786,12 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryToolExecutionEvent {
-    /**
-     * Emitted after every tool call dispatched through ToolRegistry.
-     */
     data: TrajectoryToolExecutionEvent.Data;
 
     event: 'ToolExecutionEvent';
   }
 
   export namespace TrajectoryToolExecutionEvent {
-    /**
-     * Emitted after every tool call dispatched through ToolRegistry.
-     */
     export interface Data {
       success: boolean;
 
@@ -896,27 +818,18 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryManagerContextEvent {
-    /**
-     * Context prepared, ready for LLM call.
-     */
     data: unknown;
 
     event: 'ManagerContextEvent';
   }
 
   export interface TrajectoryManagerResponseEvent {
-    /**
-     * LLM response received, ready for parsing.
-     */
     data: TrajectoryManagerResponseEvent.Data;
 
     event: 'ManagerResponseEvent';
   }
 
   export namespace TrajectoryManagerResponseEvent {
-    /**
-     * LLM response received, ready for parsing.
-     */
     export interface Data {
       response: string;
 
@@ -937,18 +850,12 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryManagerPlanDetailsEvent {
-    /**
-     * Plan parsed and ready (internal event with full details).
-     */
     data: TrajectoryManagerPlanDetailsEvent.Data;
 
     event: 'ManagerPlanDetailsEvent';
   }
 
   export namespace TrajectoryManagerPlanDetailsEvent {
-    /**
-     * Plan parsed and ready (internal event with full details).
-     */
     export interface Data {
       plan: string;
 
@@ -969,36 +876,24 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryExecutorContextEvent {
-    /**
-     * Context prepared, ready for LLM call.
-     */
     data: TrajectoryExecutorContextEvent.Data;
 
     event: 'ExecutorContextEvent';
   }
 
   export namespace TrajectoryExecutorContextEvent {
-    /**
-     * Context prepared, ready for LLM call.
-     */
     export interface Data {
       subgoal: string;
     }
   }
 
   export interface TrajectoryExecutorResponseEvent {
-    /**
-     * LLM response received, ready for parsing.
-     */
     data: TrajectoryExecutorResponseEvent.Data;
 
     event: 'ExecutorResponseEvent';
   }
 
   export namespace TrajectoryExecutorResponseEvent {
-    /**
-     * LLM response received, ready for parsing.
-     */
     export interface Data {
       response: string;
 
@@ -1019,18 +914,12 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryExecutorActionEvent {
-    /**
-     * Action parsed, ready to execute.
-     */
     data: TrajectoryExecutorActionEvent.Data;
 
     event: 'ExecutorActionEvent';
   }
 
   export namespace TrajectoryExecutorActionEvent {
-    /**
-     * Action parsed, ready to execute.
-     */
     export interface Data {
       action_json: string;
 
@@ -1043,18 +932,12 @@ export namespace TaskGetTrajectoryResponse {
   }
 
   export interface TrajectoryExecutorActionResultEvent {
-    /**
-     * Action execution result (internal event with full details).
-     */
     data: TrajectoryExecutorActionResultEvent.Data;
 
     event: 'ExecutorActionResultEvent';
   }
 
   export namespace TrajectoryExecutorActionResultEvent {
-    /**
-     * Action execution result (internal event with full details).
-     */
     export interface Data {
       action: { [key: string]: unknown };
 
@@ -1179,114 +1062,80 @@ export interface TaskListParams {
 
 export interface TaskRunParams {
   /**
-   * Body param: The ID of the device to run the task on.
+   * The ID of the device to run the task on.
    */
   deviceId: string;
 
-  /**
-   * Body param
-   */
   task: string;
 
-  /**
-   * Body param
-   */
   accessibility?: boolean;
 
-  /**
-   * Body param
-   */
   apps?: Array<string>;
 
-  /**
-   * Body param
-   */
   continueOnFailure?: boolean;
 
-  /**
-   * Body param
-   */
   credentials?: Array<TaskRunParams.Credential>;
 
   /**
-   * Body param: The display ID of the device to run the task on.
+   * The display ID of the device to run the task on.
    */
   displayId?: number;
 
   /**
-   * Body param: Maximum agent execution time in seconds (1–2700).
+   * Maximum agent execution time in seconds (1–2700).
    */
   executionTimeout?: number;
 
-  /**
-   * Body param
-   */
   files?: Array<string>;
 
   /**
-   * Body param: The LLM model identifier to use for the task (e.g.
-   * 'openai/gpt-5.6-luna')
+   * Request human-like input where supported by the device. Replaces the deprecated
+   * stealth field; both must agree when supplied together.
    */
-  llmModel?: string;
+  humanize?: boolean;
 
   /**
-   * Body param
+   * The LLM model identifier to use for the task (e.g. 'openai/gpt-6-luna')
    */
+  llmModel?: string;
+
   maxSteps?: number;
 
-  /**
-   * Body param
-   */
   outputSchema?: { [key: string]: unknown } | null;
 
-  /**
-   * Body param
-   */
   reasoning?: boolean;
 
   /**
-   * Body param: Record device video for the whole task and persist a retrievable
-   * reference
+   * Record device video for the whole task and persist a retrievable reference
    */
   recordingEnabled?: boolean;
 
   /**
-   * Body param
+   * @deprecated Deprecated: use humanize. Both names must agree when supplied
+   * together.
    */
   stealth?: boolean;
 
   /**
-   * Body param: LLM model used by sub-agent roles: executor, app_opener,
-   * structured_output
+   * LLM model used by sub-agent roles: executor, app_opener, structured_output
    */
   subagentModel?: string;
 
   /**
-   * Body param: Optional custom behavioral overlay applied on top of the agent's
-   * default system prompts. Never echoed back in responses or errors.
+   * Optional custom behavioral overlay applied on top of the agent's default system
+   * prompts. Never echoed back in responses or errors.
    */
   systemPrompt?: string | null;
 
   /**
-   * @deprecated Body param: Deprecated and ignored. Sampling behavior is controlled
-   * by the model provider.
+   * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+   * provider.
    */
   temperature?: number;
 
-  /**
-   * Body param
-   */
   vision?: boolean;
 
-  /**
-   * Body param
-   */
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
-
-  /**
-   * Header param
-   */
-  'Idempotency-Key'?: string;
 }
 
 export namespace TaskRunParams {
@@ -1326,7 +1175,13 @@ export interface TaskRunStreamedParams {
   files?: Array<string>;
 
   /**
-   * The LLM model identifier to use for the task (e.g. 'openai/gpt-5.6-luna')
+   * Request human-like input where supported by the device. Replaces the deprecated
+   * stealth field; both must agree when supplied together.
+   */
+  humanize?: boolean;
+
+  /**
+   * The LLM model identifier to use for the task (e.g. 'openai/gpt-6-luna')
    */
   llmModel?: string;
 
@@ -1341,6 +1196,10 @@ export interface TaskRunStreamedParams {
    */
   recordingEnabled?: boolean;
 
+  /**
+   * @deprecated Deprecated: use humanize. Both names must agree when supplied
+   * together.
+   */
   stealth?: boolean;
 
   /**

package/src/resources/webhooks/deliveries.ts

@@ -11,12 +11,8 @@ export class Deliveries extends APIResource {
    * Returns a paginated feed of webhook deliveries across all of your subscriptions,
    * with the originating endpoint URL included on each record. Results can be
    * filtered by delivery status (pending, success, skipped, or dead), by a `since`
-   * timestamp, and by `eventId` (exact match against the originating event id).
-   *
-   * @example
-   * ```ts
-   * const deliveries = await client.webhooks.deliveries.list();
-   * ```
+   * timestamp, by `eventId` (exact match against the originating event id), and/or
+   * by endpoint delivery `kind`.
    */
   list(
     query: DeliveryListParams | null | undefined = {},
@@ -30,14 +26,6 @@ export class Deliveries extends APIResource {
    * identified by its id. Each record reports the event, delivery status, attempt
    * count, and the last response code or error. Results can be filtered by `eventId`
    * (exact match against the originating event id).
-   *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.webhooks.deliveries.listForWebhook(
-   *     '550e8400-e29b-41d4-a716-446655440000',
-   *   );
-   * ```
    */
   listForWebhook(
     id: string,
@@ -51,15 +39,6 @@ export class Deliveries extends APIResource {
    * Returns a single delivery for a webhook subscription along with the full list of
    * captured attempt records. Each attempt includes the request URL, method, headers
    * and body, whether it was signed, and the response status, headers, and snippet.
-   *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.webhooks.deliveries.retrieveAttempts(
-   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *     { id: '550e8400-e29b-41d4-a716-446655440000' },
-   *   );
-   * ```
    */
   retrieveAttempts(
     deliveryID: string,
@@ -73,13 +52,8 @@ export class Deliveries extends APIResource {
   /**
    * Returns aggregate delivery statistics across all of your webhooks, including the
    * total count, a breakdown by status (pending, success, skipped, dead), and the
-   * overall success rate. An optional `since` timestamp narrows the reporting
-   * window.
-   *
-   * @example
-   * ```ts
-   * const response = await client.webhooks.deliveries.stats();
-   * ```
+   * overall success rate. Optional `since` and endpoint delivery `kind` filters
+   * narrow the reporting window.
    */
   stats(
     query: DeliveryStatsParams | null | undefined = {},
@@ -115,7 +89,18 @@ export namespace DeliveryListResponse {
 
     endpointId: string;
 
-    endpointUrl: string;
+    endpointKind: 'http' | 'integration';
+
+    /**
+     * Integration target label of the parent webhook (e.g. `#ops`); null for `http`
+     * webhooks.
+     */
+    endpointLabel: string | null;
+
+    /**
+     * Delivery URL of the parent webhook; null for `integration` webhooks.
+     */
+    endpointUrl: string | null;
 
     eventId: string;
 
@@ -281,6 +266,11 @@ export interface DeliveryListParams {
    */
   eventId?: string;
 
+  /**
+   * Only include deliveries to endpoints of this kind.
+   */
+  kind?: 'http' | 'integration';
+
   page?: number;
 
   pageSize?: number;
@@ -306,6 +296,11 @@ export interface DeliveryRetrieveAttemptsParams {
 }
 
 export interface DeliveryStatsParams {
+  /**
+   * Only include deliveries to endpoints of this kind.
+   */
+  kind?: 'http' | 'integration';
+
   since?: string;
 }